Skip to main content

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) / 2 formula.
  • 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:

  1. Copy the Dissector Script: Extract ieee1451.lua from the downloaded ieee1451.zip archive and copy it to your Wireshark plugins directory:

    • Windows: %APPDATA%\Wireshark\plugins\
    • macOS: ~/.local/lib/wireshark/plugins/
    • Linux: ~/.local/lib/wireshark/plugins/
  2. Reload Wireshark: Restart Wireshark or press Ctrl + Shift + L (Cmd + Shift + L on Mac) to reload plugins.

  3. Verify Topic Mapping: Ensure your MQTT traffic is using the standard topic format: _1451.1.6/D0/...