Files

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

psid-vru.lua

Keep the colleague's microbu-esp32c5 tree in this repository

2026-09-23 17:46:40 +02:00

README.md

Keep the colleague's microbu-esp32c5 tree in this repository

2026-09-23 17:46:40 +02:00

README.md

Wireshark VRU Awareness Service (VAM) Dissector Extension

Purpose

Wireshark natively dissects IEEE 1609.2 / ETSI TS 103 097 secured packets, but stops dissecting at Ieee1609Dot2Data.unsecuredData unless the ITS Application ID (PSID) is registered in Wireshark's internal ieee1609dot2.psid dissector table.

Standard PSIDs like CAM (36) and DENM (37) are registered by default in Wireshark 4.x.
PSID 638 (VRU Awareness Service, ETSI TS 102 965) is not registered in Wireshark 4.x.

This Lua plugin registers PSID 638 to point to the GeoNetworking common header (gnw.comm), allowing Wireshark to continue dissecting the entire stack:

IEEE 802.11 (5.9 GHz ITS-G5) -> LLC/SNAP 0x8947 -> GeoNetworking -> BTP-B (port 2018) -> VAM (TS 103 300-3)

Installation

Windows

Copy psid-vru.lua into your personal Wireshark plugins directory:

Copy-Item tools/wireshark/psid-vru.lua "$env:APPDATA\Wireshark\plugins\"

Linux

Copy psid-vru.lua into:

mkdir -p ~/.local/lib/wireshark/plugins
cp tools/wireshark/psid-vru.lua ~/.local/lib/wireshark/plugins/

macOS

Copy psid-vru.lua into:

mkdir -p ~/.config/wireshark/plugins
cp tools/wireshark/psid-vru.lua ~/.config/wireshark/plugins/

Verification

Open Wireshark.
Navigate to Help -> About Wireshark -> Plugins.
Verify that psid-vru.lua is listed as active.

Command-Line Usage (tshark)

You can directly pass the Lua script to tshark without installing:

tshark -X lua_script:tools/wireshark/psid-vru.lua -r capture.pcap