Google Git
Sign in
android / platform / external / rust / crates / pdl-compiler / d43572c91e7eeb47f80cc60baaef8a1afa9df225
commitd43572c91e7eeb47f80cc60baaef8a1afa9df225[log] [tgz]
authorHenri Chataing <[email protected]>Tue Jun 27 13:56:19 2023 +0000
committerHenri Chataing <[email protected]>Thu Jun 29 07:26:46 2023 -0700
treee00e76908c9390c398f7ffc6ca31cf93b9aaa8ea
parent57dd65382caf1a46525460d9de34952f2a01fcea [diff]
Update pdl-compiler to 0.1.3

Test: TreeHugger
Change-Id: I117a9881f4f11c1ebaef7565f6b48a3d176d25c2
99 files changed
tree: e00e76908c9390c398f7ffc6ca31cf93b9aaa8ea
  1. doc/
  2. examples/
  3. scripts/
  4. src/
  5. tests/
  6. .cargo_vcs_info.json
  7. .gitignore
  8. Android.bp
  9. Cargo.toml
  10. Cargo.toml.orig
  11. cargo2android.json
  12. cargo2android_toplevel.bp
  13. CONTRIBUTING.md
  14. LICENSE
  15. METADATA
  16. MODULE_LICENSE_APACHE2
  17. OWNERS
  18. README.md
  19. rustfmt.toml
README.md

Packet Description Language (PDL)

Crate Build workflow GitHub contributors GitHub stars

PDL is a domain specific language for writing the definition of binary protocol packets. Parsing and validating packets from raw bytes is tedious and error prone in any language. PDL generates memory safe and tailored backends for multiple target languages:

- Rust
- C++
- Python

Historically PDL was developed as part of the Android Bluetooth stack (bluetooth_packetgen) as a way to generate the parser and serializer for Bluetooth packets, and reduce the number of memory safety issues that come with manipulating and validating raw data.

How to use PDL

  1. Write the protocol definition
  2. cargo run my-protocol.pdl --output-format rust > my-protocol.rs

Language specific instructions are provided for all supported backends:

  1. Rust generated code guide
  2. Python generated code guide
  3. C++ generated code guide

Supported Features

Full reference documentation

  • Scalar values
  • Enumerators
  • Arrays
  • Nested packets
  • Conditional packet derivation
  • Custom field definitions

Similar projects