Google Git
Sign in
android / platform / external / rust / crates / pdl-compiler / db9fffe8304d4c6c59b5695c1394495d8c3290e5
commitdb9fffe8304d4c6c59b5695c1394495d8c3290e5[log] [tgz]
authorHenri Chataing <[email protected]>Tue May 30 13:52:32 2023 -0700
committerHenri Chataing <[email protected]>Tue May 30 13:54:21 2023 -0700
treede918cbafbfa71e45fdf16b1d0f349dbb1868a83
parent6962663d43643d0336b1b2e0ef75be115e12d373 [diff]
Add system/nfc/src to the default visibility

Test: NA
Bug: 284980692
Change-Id: I0ce8120877463e33027bfc65bef518fe0fcd37f5
2 files changed
tree: de918cbafbfa71e45fdf16b1d0f349dbb1868a83
  1. doc/
  2. scripts/
  3. src/
  4. tests/
  5. Android.bp
  6. Cargo.toml
  7. Cargo.toml.orig
  8. cargo2android.json
  9. cargo2android_toplevel.bp
  10. CONTRIBUTING.md
  11. LICENSE
  12. METADATA
  13. MODULE_LICENSE_APACHE2
  14. OWNERS
  15. README.md
  16. 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