@tosolve/node-red-datacodec 0.18.1
Decode string data to a respective sensor on IC
@tosolve/node-red-datacodec
A Node-RED node that decodes hexadecimal IoT sensor packets into structured JSON, powered by @tosolve/datacodec.
Installation
Via the Node-RED palette manager, or from the command line:
cd ~/.node-red
npm install @tosolve/node-red-datacodec
Restart Node-RED after installation.
Node: 2stools-datacodec
Category: Function
Inputs: 1 | Outputs: 1
How it works
The node reads the incoming payload, decodes the hex-encoded sensor packet using the @tosolve/datacodec library, and outputs the decoded sensor data as a JSON object on msg.payload.
Input
| Property | Type | Description |
|---|---|---|
msg.payload |
string | object |
Raw hex string, or an object containing a payload_raw field |
msg.offset |
number |
(optional) Byte offset to apply when decoding. Overrides the node's configured offset |
If msg.payload is an object with a payload_raw field (e.g. a LoRaWAN uplink envelope), that field is used as the raw payload automatically.
Output
| Property | Type | Description |
|---|---|---|
msg.payload |
object |
Decoded sensor data as a key-value JSON object |
Configuration
| Property | Default | Description |
|---|---|---|
| Name | — | Optional label displayed in the Node-RED editor |
| Offset | 0 |
Byte offset applied during decoding |
Usage example
Minimal flow:
[inject] → [2stools-datacodec] → [debug]
Set the inject node payload to a hex string such as 010045001B0200FA and connect it to the node. The debug panel will show the decoded sensor values.
LoRaWAN envelope input:
If the upstream node outputs a LoRaWAN envelope, the node automatically extracts msg.payload.payload_raw before decoding — no function node required.
Migration from node-red-2stools-packetdecode
If you are upgrading from the previous package, see the CHANGELOG for full migration instructions, including how to update existing flows that reference the old node type 2stools-packetdecode.
Requirements
- Node-RED
>= 1.0.0 - Node.js
>= 12.0.0
Author
2Solve Engenharia e Tecnologia Ltda
