IEEE 1451 Wireshark Dissector
A high-performance LUA post-dissector for IEEE 1451.0 and IEEE 1451.1.6 protocols running over MQTT. The dissector utilizes a dynamic "Payload Engine" architecture to achieve full compliance with the IEEE 1451.0-2024 specification.
⚡ Download
You can download the latest version of the Wireshark dissector script here:
🏗 Key Features
1. Dynamic Payload Engine
The dissector utilizes a data-driven parsing engine. Instead of hardcoded logic, it uses a comprehensive dictionary of the entire IEEE 1451.0 API, supporting all command/reply formats and dynamically distinguishing datatype sizes.
2. Recursive TEDS Decoding
Deep packet inspection for Transducer Electronic Data Sheets (TEDS) including:
- Meta TEDS: UUIDs, operational timeouts, hold-off times.
- Transducer Channel TEDS: Data models, sample formats, sensor ranges.
- PhyUnits (Tag 12): Standard-compliant decoding of SI exponents (Meters, Kelvins, etc.) using the
(Raw - 128) / 2formula. - PHY TEDS: Radio types, data rates, security, and authentication flags.
3. Specialized Data Decoders
- ncap_address: Automatically detects and formats IPv4/IPv6 addresses.
- uuidarray / uint16array: Handles bulk ID lists from discovery and stream commands.
- channel_discovery_arrays: Decodes interleaved [ID][Name] pairs from announcements.
- TimeDuration & TimeInstance: Standard-compliant 64-bit duration and 80-bit timestamping (with safe Windows system guards).
📋 Compatibility
- Language: LUA 5.2+ (bundled with Wireshark)
- Tested Wireshark Version: 4.6.5 (fully compatible with Windows, macOS, and Linux)
⚡ Installation
To use this dissector to parse IEEE 1451 packets:
-
Copy the Dissector Script: Extract
ieee1451.luafrom the downloadedieee1451.ziparchive and copy it to your Wireshark plugins directory:- Windows:
%APPDATA%\Wireshark\plugins\ - macOS:
~/.local/lib/wireshark/plugins/ - Linux:
~/.local/lib/wireshark/plugins/
- Windows:
-
Reload Wireshark: Restart Wireshark or press
Ctrl + Shift + L(Cmd + Shift + L on Mac) to reload plugins. -
Verify Topic Mapping: Ensure your MQTT traffic is using the standard topic format:
_1451.1.6/D0/...