Google Git
Sign in
android / platform / external / rust / crates / pdl-runtime / 681a3a2afaa35fae457992f7d7e83f232dbc465c
commit681a3a2afaa35fae457992f7d7e83f232dbc465c[log] [tgz]
authorJames Farrell <[email protected]>Wed Aug 07 22:37:06 2024 +0000
committerAutomerger Merge Worker <[email protected]>Wed Aug 07 22:37:06 2024 +0000
treefb582b12fb0cae4da93bc3f221eb007309772c1a
parent791671b63502e647d0321a7c4ec3184d9eca7aea [diff]
parent4b6ed01c67d29936013e4aae857012e0ab0fca1f [diff]
Update Android.bp by running cargo_embargo am: 4b6ed01c67

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/pdl-runtime/+/3209231

Change-Id: I8e06b4426a0c0061f943aa3ebe7c173b174a817e
Signed-off-by: Automerger Merge Worker <[email protected]>
tree: fb582b12fb0cae4da93bc3f221eb007309772c1a
  1. src/
  2. .cargo_vcs_info.json
  3. Android.bp
  4. Cargo.toml
  5. Cargo.toml.orig
  6. cargo_embargo.json
  7. LICENSE
  8. METADATA
  9. MODULE_LICENSE_APACHE2
  10. OWNERS
  11. README.md
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
  • Optional fields
  • Nested packets
  • Conditional packet derivation
  • Custom field definitions

Similar projects