27 lines
1.4 KiB
Markdown
27 lines
1.4 KiB
Markdown
|
# Vanetza Upstream Provenance
|
||
|
|
|
||
|
|
This directory (`external/vanetza-idf`) contains the Vanetza protocol stack and its ESP-IDF integration for the micrOBU ESP32-C5 ITS-S station.
|
||
|
|
|
||
|
|
## Upstream Software Basis
|
||
|
|
|
||
|
|
- **Project**: Vanetza (ETSI C-ITS protocol stack implementation in C++17)
|
||
|
|
- **Upstream Repository**: `https://github.com/riebl/vanetza.git`
|
||
|
|
- **Pinned Upstream Revision**: `a7cacc1879f3e2124dfb8ef2d83886b1e82d3b36`
|
||
|
|
- **Author / Upstream Maintainer**: Raphael Riebl et al.
|
||
|
|
- **Citekey**: `rieblRieblVanetza2026`
|
||
|
|
- **License**: BSD-3-Clause (retained in `LICENSE.md`)
|
||
|
|
|
||
|
|
## Integrated Components & Third-Party Dependencies
|
||
|
|
|
||
|
|
1. **Boost C++ Libraries (v1.87.0)**:
|
||
|
|
- Located in `ports/esp_idf/third_party/` (`circular_buffer`, `geometry`, `heap`, `iostreams`, `multiprecision`, `rational`).
|
||
|
|
- License: Boost Software License 1.0 (`BSL-1.0`).
|
||
|
|
|
||
|
|
2. **OpenTrafficMap (OTM) Transmitter**:
|
||
|
|
- Upstream: `https://codeberg.org/opentrafficmap/its-g5-receiver-firmware_txenabled.git`
|
||
|
|
- Reviewed Revision: `674e34128279235ba34c9f8d778f43cf1d075397`
|
||
|
|
- Core file: `ports/esp_idf/third_party/otm/main/tx_custom.c` (guarded by SHA-256 in `firmware/CMakeLists.txt`).
|
||
|
|
|
||
|
|
3. **ESP-IDF Port (`ports/esp_idf`)**:
|
||
|
|
- Implements hardware-accelerated crypto (mbedTLS ECC/ECDSA/SHA), NVS credential persistence, ESP32-C5 802.11p PHY bindings (`radio_c5.cmake`), and localhost PKI verification tooling (`ports/esp_idf/tools/local_pki.py`, `pki_client.py`).
|