node-red-contrib-3dm-space 0.0.8
Node-RED nodes for 3DM.space SCADA Cloud telemetry and attributes
node-red-contrib-3dm-space
Node-RED nodes for sending telemetry data to 3DM.space SCADA Cloud and receiving cloud attribute commands.
This package is designed for Smithtek PassPort gateways and provides simple 3DM Cloud communication without exposing MQTT details to the user.
Nodes Included
3DM Cloud Login
Shared configuration node used by the 3DM input and output nodes.
The user only needs to enter:
- Name
- Username
- Password
- Optional Client ID
Connection details are handled internally.
3DM Out
Sends JSON telemetry data to 3DM.space SCADA Cloud.
The node automatically:
- Adds a timestamp
- Formats the payload for 3DM Cloud time-series data
- Publishes to the correct cloud endpoint
- Applies a publish rate limit
- Stores messages locally if the cloud connection is offline
- Replays stored messages when the connection returns
Example input:
{
"pump_run": true,
"flow_lpm": 125.5,
"tank_level_percent": 64,
"dc_voltage": 24.1
}
3DM In
Receives cloud attribute updates from 3DM.space.
The node can:
- Allow all incoming attributes through
- Filter by a single key
- Output the selected value only
- Output an object containing the selected key and value
Example cloud attribute:
{
"pump_cmd": 1
}
Store and Forward
The 3DM Out node includes built-in store and forward.
If the cloud connection is lost, valid telemetry messages are stored locally using a persistent queue. Each message is timestamped when it arrives at the node, not when it is replayed.
When the cloud connection returns, stored messages are replayed automatically.
Default replay speed:
250 ms per packet
This equals approximately:
4 packets per second
Rate Limiting
The 3DM Out node includes a live publish throttle to prevent users from publishing too quickly.
Default live publish limit:
1 message every 10 seconds
If valid telemetry arrives faster than the live publish limit, it is queued rather than discarded.
License
GPL-3.0-or-later
Author
Smithtek
