Ashin Walpola
d107534eb2
obu-firmware builds against the vanetza-idf C-ITS library, which until now came from the colleague's microbu-esp32c5 tree beside the repository and was not tracked here, so a clone of this repository could not build the firmware it ships. The library alone is now part of obu-firmware, as obu-firmware/external/vanetza-idf: their external/vanetza-idf at commit cf4b99f, unchanged (9775 files; see its PROVENANCE.md). CMake takes it from there by default; -DVANETZA_IDF_DIR still points the build elsewhere. The rest of the colleague's tree (their own VAM firmware, PKI tooling, station-link Python tools, the V2X2MAP bridge) stays out of this repository and gitignored; nothing is pushed to their repository. NOTES.md, docs/06, TODO.md and the pcap verifier's usage line point at the new location.
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`).
|