Files
MicrOBU/obu-firmware/external/vanetza-idf/docs/recipes/cube-evk-build.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

2.4 KiB

Building for cube:evk

The cube:evk from cubesys - an nfiniity company fully supports the Vanetza stack and its socktap application. An integrated V2X module listens for requests whether from a local or remote application. The communication protocol between host and V2X module is covered in Google's Protobuf that is used in the respective link-layer implementation.

Configuration

Before building and running socktap you need to configure the V2X module and the WiFi once.

V2X Radio Configuration - C-V2X or DSRC

First of all select your desired radio configuration using the v2xconfig tool on the cube:evk:

:::shell
# start dsrc or cv2x and enable auto-start
cube> v2xconfig start enable dsrc 

Connect to your local WiFi

This is only needed for the wireless remote radio mode.

:::shell
cube> sudo nmcli dev wifi connect '<ssid>' password '<password>'
# get your ip
cube> ip a

Building and Running Socktap for Wireless Remote Radio Mode

You can build and run socktap directly on your personal computer (host) and select cube-evk as link-layer. Further, gpsd daemon is running on the cube:evk that can feed socktap with GNSS data.

In wireless remote radio mode you develop, debug and run Vanetza/socktap on your personal computer. There is no need to flash or transfer the application onto your cube:evk. The V2X radio on the cube:evk listens for incoming requests from remote. Both devices need to be pingable from each other only.

:::shell
host> mkdir build && cd build
host> cmake -DBUILD_SOCKTAP=ON -DSOCKTAP_WITH_CUBE_EVK=ON ..

# use fix position data
host> ./bin/socktap -l cube-evk -p static --cube-ip <cube-ip>

# use the ublox module on the cube:evk for positioning data
host> ./bin/socktap -l cube-evk -p gpsd --gpsd-host <cube-ip> --cube-ip <cube-ip>

Moreover, the integrated LTE module allows the user to do field tests with the cube:evk from remote.

Building and Running Socktap on the cube:evk

You can also build and run socktap on the cube:evk itself and it will connect to the local V2X module.

:::shell
cube> mkdir build && cd build
cube> cmake -DBUILD_SOCKTAP=ON -DSOCKTAP_WITH_CUBE_EVK=ON ..

# use fix position data
cube> ./bin/socktap -l cube-evk -p static

# use the ublox module on the cube:evk for positioning data
cube> ./bin/socktap -l cube-evk -p gpsd --gpsd-host 127.0.0.1