Files
MicrOBU/microbu-esp32c5/external/vanetza-idf/PROVENANCE.md
T
Ashin Walpola 0e9525162d Keep the colleague's microbu-esp32c5 tree in this repository
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).
2026-09-23 17:46:40 +02:00

1.4 KiB

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