# 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`).