A place to hold WireShark Filters for Cyphal Headers. These filters are based on the specification from https://opencyphal.org/specification.
PROTOCOL | Status |
---|---|
Cyphal/UDP | working |
Cyphal/CAN | working |
Cyphal/serial | - |
Serial debugging with Wireshark may be possible with some tools which redirect the serial port over a named pipe.
The older Wireshark plugin which uses SocketCAN for UAVCAN/CAN is implemented in C in Wireshark itself.
Copy the *.lua
to your WireShark Plugins directory. The location of the Lua plugin directory can be found via Help → About → Folders:
![image](https://private-user-images.githubusercontent.com/3298404/262678491-7bde8f6d-8c1d-41f7-81d8-f6769ef456ae.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM5NjIwNTAsIm5iZiI6MTcyMzk2MTc1MCwicGF0aCI6Ii8zMjk4NDA0LzI2MjY3ODQ5MS03YmRlOGY2ZC04YzFkLTQxZjctODFkOC1mNjc2OWVmNDU2YWUucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDgxOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA4MThUMDYxNTUwWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9N2FmY2UzOWY1MWVlYzY2ODQyNDBiNWFiNzk4NDZiYWVkZWZjMzY5NWY1NjQ1ZGEwOTk3ZjA2NGJmNTkwNDliOSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.aBynArhIkAoIyrKfzHvEqa03Me-kQk5LIjJFirzIP3Y)
You may have to give your root password to install or sudo cp
.
The following BPF expression can be used to filter Cyphal/UDP traffic only (useful if the network traffic is high):
udp and dst net 239.0.0.0 mask 255.0.0.0 and dst port 9382
The Cyphal/UDP filter will automatically detect messages. The Cyphal/CAN filter however will not and will need to be added to the "Decode As" list.
Right-click on the CANFD messages stream and select "Decode As". Remove the initial entry from the list and add a new entry which sets the first column to "CAN next level dissector", and the "current" column to "CYPHALCAN".
Once added the message stream in the top of Wireshark will continue to say "CANFD" but the detail window will have all the decoded parts of the Cyphal/CAN header, payload (for Heartbeat and GetInfo) and the footer.
To add features to the protocol plugin, simply copy, reload (Cmd+Shift+L
on Mac, Ctrl+Shift+L
elsewhere), and test.
Happy Decoding!