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