Skip to main content

Node-RED IEEE 1451 Nodes

A comprehensive set of Node-RED nodes fully compliant with the IEEE 1451 Smart Transducer Interface standard.

This library brings the interoperable power of the IEEE 1451 arrays and commands into the Node-RED visual programming environment, enabling you to rapidly construct, query, configure, and monitor intelligent sensors (TIMs/Transducers) using Network Capable Application Processors (NCAPs).


🏗 Architecture​

The library is strictly mapped to the formal IEEE standards, separated into beautiful, logical palette categories:

1. IEEE 1451 Network​

Addresses Clause 10 (Network Services) and the new IEEE 1451.1.6-2025 (MQTT) standard.

  • Discovery: NCAP Announcement, TIM Discovery, Transducer Departure, etc.
  • Data Access: Read/Write Sample Data, Block Data, Synchronous & Asynchronous variants.
  • Event Callbacks: Subscriptions, Notifications, and NCAP Heartbeats.
  • TEDS Handling: Query TEDS, Read/Write TEDS, WOT Decoder.
  • MQTT Topic Builders (1451.1.6): Fully standard-compliant topic generators to seamlessly route binary buffers via native Node-RED mqtt in / mqtt out bridges.

2. IEEE 1451 Transducer​

Addresses Clause 11 (Transducer Services) using a Hybrid design pattern.

  • Discrete Nodes: For high-level, single-operation states:
    • TIM Wakeup, TIM Sleep, TIM Reset, Read Version, etc.
  • Composed Nodes: For highly nested, complex operation trees:
    • Common Commands: Read/Write TEDS segments, Query TEDS, Status Registers.
    • Transducer Idle: Buffer management, Setting triggering modes, Sampling modes.
    • Transducer Operate: Read/Write Datasets, Trigger/Abort commands.
    • Transducer Either: Device clear, Read buffered states.

⚡ Installation​

To install these nodes locally into your Node-RED deployment:

  1. Download the Package: Download the pre-packaged Node-RED contribution archive: Download node-red-contrib-ieee1451-0.0.5.zip

  2. Navigate to your Node-RED user directory (often ~/.node-red):

    cd ~/.node-red
  3. Install the package via standard NPM:

    # If installing from the downloaded zip:
    npm install /path/to/downloads/node-red-contrib-ieee1451-0.0.5.zip

    # Or if installing from the local source directory:
    npm install /path/to/node-red-contrib-ieee1451
  4. Restart your Node-RED service:

    node-red restart

The nodes will now prominently display under the "IEEE 1451 Network" and "IEEE 1451 Transducer" categories in your left-hand palette!


🚀 How to Use (Quick Start)​

Example A: Reading Sensor Data (D0-OP)​

  1. Drop an Inject node onto your canvas.
  2. Connect it to an ieee1451-read-sample-data node. Provide the specific integer mapped channelId and timId variables via the properties UI.
  3. Connect the output of the Read Data node into a Debug node. When triggered, the node will output a compliant binary buffer into msg.payload.

Example B: IEEE 1451.1.6 MQTT Routing​

Rather than providing non-standard, custom MQTT listeners, this library allows you to use standard Node-RED native MQTT nodes by wrapping them in compliant topic generators.

  1. Gather an IEEE 1451 packet using an ieee1451-transducer-operate node (set to e.g., Trigger Command).
  2. Wire the output into an ieee1451.1.6-mqtt-topic node.
  3. Open the Topic Builder UI:
    • Set Type of Message (TOM) to D0 (Standard Backward Compatible Binary).
    • Set LNS to Building1/NCAP1.
  4. Connect the output into a standard Node-RED mqtt out node.
  5. The payload will now perfectly route over MQTT to the _1451.1.6/D0/Building1/NCAP1 destination topic tree according to the 2025 standard specifications!

🛠 Advanced Features​

Dynamic Command Generation​

For complex nodes like ieee1451-transducer-idle, a dynamic configuration system drops down into sub-registers (e.g., Data Transmission Mode). Instead of flooding the UI with hundreds of nodes, a singular UI cascades user inputs cleanly to generate the exact mapped bytes for the specific CommandClassID and CommandFunctionID.

Error Checking & Verification​

The library automatically asserts required payload sizes (UInt16 limits, TimeDuration blocks) and packs standard headers prior to delivery.


📝 License​

Released under the BSD 3-Clause License.