Google Git
Sign in
android / platform / external / rust / crates / pdl-compiler / b32d1823b491678db6f89438450945e8c973b5e2
commitb32d1823b491678db6f89438450945e8c973b5e2[log] [tgz]
authorHenri Chataing <[email protected]>Sat Aug 12 00:08:10 2023 +0000
committerHenri Chataing <[email protected]>Sat Aug 12 00:08:10 2023 +0000
tree897836674c74faac90707276de61c91a3c2e8c6b
parent6e418cc0c7efdd32cb92b38b3bbcae061436be75 [diff]
Upgrade pdl-compiler to 0.1.6

This project was upgraded with external_updater.
Usage: tools/external_updater/updater.sh update rust/crates/pdl-compiler
For more info, check https://cs.android.com/android/platform/superproject/+/main:tools/external_updater/README.md

Test: TreeHugger
Change-Id: I96ddca3eebd1c7ca647fa750f6329c83d05ab9ed
10 files changed
tree: 897836674c74faac90707276de61c91a3c2e8c6b
  1. doc/
  2. examples/
  3. patches/
  4. scripts/
  5. src/
  6. tests/
  7. .cargo_vcs_info.json
  8. .gitignore
  9. Android.bp
  10. Cargo.toml
  11. Cargo.toml.orig
  12. cargo2android.json
  13. cargo2android_toplevel.bp
  14. CONTRIBUTING.md
  15. LICENSE
  16. METADATA
  17. MODULE_LICENSE_APACHE2
  18. OWNERS
  19. README.md
  20. 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