node-red-contrib-netpie 1.0.2

Node-RED module for connecting to NETPIE IoT Platform

npm install node-red-contrib-netpie

node-red-contrib-netpie

A Node-RED node collection for connecting to NETPIE IoT Platform. This package provides comprehensive IoT device simulation, data management, and cloud communication capabilities.

Installation

npm install node-red-contrib-netpie

Or install via the Node-RED Palette Manager.

Features

  • Device Simulation: Complete IoT device simulation with bidirectional communication
  • Real-time Messaging: Subscribe to and publish messages using MQTT topics
  • Shadow Management: Monitor and update device shadow data
  • Historical Data: Retrieve time-series feed data with flexible time ranges
  • Device Status: Monitor device connectivity and operational status
  • Push Notifications: Send notifications to mobile applications
  • Command Operations: Execute various device operations and commands

Nodes

Device Node

Simulates a real IoT device with full bidirectional communication capabilities.

  • Publishes and subscribes to MQTT topics
  • Handles shadow data updates
  • Supports private messaging
  • Configurable output formats (String, Buffer, JSON)

Command Node

Executes various operations on NETPIE devices:

  • Publish Message: Send data to device topics
  • Write Shadow: Update device shadow data
  • Get Shadow: Retrieve current shadow data
  • Get Device Status: Check device connectivity
  • Push Notification: Send mobile notifications

Shadow Node

Monitors device shadow data change and may alter if needed.

  • Real-time shadow update notifications
  • Configurable output modes (updated fields or entire shadow)
  • Manual data refresh capability

Feed Node

Retrieves both realtime and historical time-series data from devices.

  • Flexible time range queries (absolute or relative)
  • Data sampling and aggregation
  • Real-time feed monitoring
  • Multiple time format support

Message Node

Lightweight message subscription for specific topics.

  • Subscribe to @msg topics only
  • Configurable output formats
  • Topic pattern matching with wildcards
  • Dynamic topic management

Status Node

Monitors device connectivity and operational status.

  • Real-time status updates
  • Device information (ID, group, project)
  • Status change notifications

Configuration

Device Configuration

Before using any nodes, configure your NETPIE device credentials:

  1. Add a Device Config node
  2. Enter your Device ID and Token from NETPIE Portal
  3. Set up realtime channel configuration if needed

Real-time Features

Some nodes support real-time features that require channel connections:

  • Enabled: Automatic notifications when data changes
  • Disabled: Manual data retrieval only (still functional)

Usage Examples

Basic Device Simulation

// Device node configuration
{
  "name": "Temperature Sensor",
  "topics": "@msg/temperature\n@msg/humidity",
  "outputType": "JSON",
  "subshadow": true
}

Shadow Data Management

// Command node - Write Shadow
{
  "commandtype": "writeshadow",
  "inputformat": "json",
  "shadowproperty": "{\"temp\": 25.5, \"status\": \"online\"}"
}

Historical Data Query

// Feed node - Last 24 hours
{
  "beginrelativevalue": 24,
  "beginrelativeunit": "hours", 
  "endrelativevalue": 0,
  "samplingvalue": 1,
  "samplingunit": "hours"
}

Topic Conventions

NETPIE uses specific topic prefixes:

  • @msg/topic - Public message topics
  • @private/topic - Private message topics
  • # - Wildcard for all topics
  • + - Single level wildcard

Data Formats

Shadow Data Structure

{
  "data": {
    "temperature": 25.5,
    "humidity": 60.2,
    "status": "online"
  }
}

Device Status Structure

{
  "deviceid": "17a30f78-27da-9173-92b2-652ca0b20cf8",
  "groupid": "G713335850114", 
  "projectid": "P060627955206",
  "status": 1,
  "enabled": true
}

Requirements

  • Node-RED version 1.0.0+
  • NETPIE account and registered devices
  • Valid Device ID and Token from NETPIE Portal

Dependencies

  • mqtt: MQTT client for device communication
  • axios: HTTP client for API requests
  • deepmerge: Object merging utilities
  • jsonic: JSON parsing
  • object-path: Object property access

Support

License

ISC License

Author

[email protected]


For detailed node documentation, see the help panels in Node-RED editor or visit the NETPIE documentation.

Node Info

Version: 1.0.2
Updated 2 weeks, 4 days ago
License: ISC
Rating: not yet rated

Categories

Actions

Rate:

Downloads

178 in the last week

Nodes

  • flowchannel
  • deviceconfig
  • device
  • command
  • shadow
  • feed
  • message
  • devicestatus

Keywords

  • node-red
  • netpie.io
  • IoT
  • NETPIE

Maintainers