Gitiles
Code Review Sign In
android-review.linaro.org / platform / external / rust / crates / pdl-runtime / refs/tags/android-14.0.0_r33
tag1362acc5950f45e37cbcf0734a86f4e8c7d573a8
taggerThe Android Open Source Project <initial-contribution@android.com>Mon Apr 15 11:23:07 2024 -0700
object27f3222961c71e582932601bb5597a1c7cb1d71b 
Android 14.0.0 Release 33 (AP1A.240405.002.B1)
commit27f3222961c71e582932601bb5597a1c7cb1d71b[log] [tgz]
authorAndroid Build Coastguard Worker <android-build-coastguard-worker@google.com>Thu Nov 16 00:13:38 2023 +0000
committerAndroid Build Coastguard Worker <android-build-coastguard-worker@google.com>Thu Nov 16 00:13:38 2023 +0000
tree31bfbde306507249ed3a8e8e1dbbbf6b383c3152
parent26e50c43e4f90d0419ea926ad0847cf6cea3cc79 [diff]
parentd7cdc35b9f773b7595b997f5d07d455aedc65ae0 [diff]
Snap for 11104212 from d7cdc35b9f773b7595b997f5d07d455aedc65ae0 to 24Q1-release

Change-Id: I7083fccb6641fc5737606478d9a562061ba265d9
tree: 31bfbde306507249ed3a8e8e1dbbbf6b383c3152
  1. src/
  2. Android.bp
  3. Cargo.toml
  4. Cargo.toml.orig
  5. cargo_embargo.json
  6. LICENSE
  7. METADATA
  8. MODULE_LICENSE_APACHE2
  9. OWNERS
  10. 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