ashin-walpola/MicrOBU
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
MicrOBU/obu-firmware/external/vanetza-idf/PROVENANCE.md
T
Ashin Walpola d107534eb2 Keep vanetza-idf in obu-firmware, so a plain clone builds the firmware 
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.
2026-09-24 10:56:05 +02:00

1.4 KiB
Raw Permalink Blame History

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).
Reference in New Issue View Git Blame Copy Permalink