Ashin Walpola
0e9525162d
obu-firmware builds against vanetza-idf from microbu-esp32c5/external, but that tree was gitignored, so a clone of this repository could not build the firmware it ships. It is now committed here as ordinary files in its own folder, microbu-esp32c5/: the colleague's commit cf4b99f plus the V2X2MAP bridge's signature verification (--trust) used on the bench. Nothing is fetched from or pushed to the colleague's repository; this repository and its remotes carry everything. The folder's own .gitignore keeps build output, downloaded components and private key material out, as it did there; the committed file set is identical to that repository's tracked files. The ESP32-C5 is still flashed from obu-firmware/, which only takes vanetza-idf from microbu-esp32c5/, so the two stay separate folders. FLASHING.md says how to take a newer version of the colleague's tree (copy it over the folder, rebuild, test, commit).
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`).
|