Google Git
Sign in
android / platform / external / rust / crates / pdl-runtime / 789b1a846251c810ff7955817cf983198c4e6190
commit789b1a846251c810ff7955817cf983198c4e6190[log] [tgz]
authorAndroid Build Coastguard Worker <[email protected]>Tue May 21 23:14:18 2024 +0000
committerAndroid Build Coastguard Worker <[email protected]>Tue May 21 23:14:18 2024 +0000
treec93e0fb668b84918c7f625744efe3145a2af51a9
parent0352af0f7229f1d0f3d5f90144b7759f55a96305 [diff]
parent97f74011e835bbdf51fd6715b3bcd5a79d191311 [diff]
Snap for 11869550 from 97f74011e835bbdf51fd6715b3bcd5a79d191311 to 24Q3-release

Change-Id: Iae8fec510f6268aac70210a4bae0db9c0476fa0c
tree: c93e0fb668b84918c7f625744efe3145a2af51a9
  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