Skip to content

Sensor Node Operation Guide

1 PREPARATION

1.1 MQTT Command Sender

(1) Computer:

It is recommended to install MQTTX for publishing MQTT commands. Download Link

After installation, first establish a connection with the server as follows:

Then subscribe to the topic "ArduinoNode/node"

Once completed, you will start receiving messages published by various nodes.

iOS users are recommended to use MyMQTT.

1.2 Sensor Network

  • It is recommended to charge the batteries before use.

  • Ensure all nodes are securely connected and the SD card is properly inserted.

  • It is advisable to power on the leaf nodes first, followed by the gateway node.

2 DEPLOY THE SENSOR NETWORK

Deploy the sensor nodes in the areas that need monitoring, ideally ensuring that the distance between leaf nodes and the gateway does not exceed 25 meters.

3 ISSUE COLLECTION COMMANDS

  • First, ensure that the connection to the server is active.

  • Enter the topic for publishing commands: "ArduinoNode/server"

  • Input the command content according to your sampling needs and the command descriptions.

Appendix - ArduinoNode Command Set

A. Command Rules

  • All commands are strings sent via MQTT or RF channels.

  • Time-related commands must ensure that the scheduled time is later than the current time, with at least 60 seconds reserved for time synchronization (otherwise, the command will be rejected).

  • Sampling frequency, duration, and other parameters must be integers, with units in Hz and seconds, respectively.

  • File retrieval commands must specify the filename (excluding the extension).

B. Command List and Examples

Basic Commands

Command Description Example
CMD_REBOOT Reboot both gateway and leaf nodes CMD_REBOOT
CMD_GATEWAY_REBOOT Reboot gateway only CMD_GATEWAY_REBOOT
CMD_LEAFNODE_REBOOT Reboot leaf nodes only CMD_LEAFNODE_REBOOT
CMD_RF_SYNC RF time synchronization CMD_RF_SYNC
CMD_NTP NTP time synchronization CMD_NTP
CMD_SN Schedule sensing with default params CMD_SN

Scheduled / Fixed-Time Sensing Commands

  • Scheduled Sensing (delay in seconds, sampling frequency, duration) Format: CMD_SFN_delay_frequencyHz_durationS Example: CMD_SFN_120_10Hz_60s

  • Fixed-Time Sensing (specific time, sampling frequency, duration) Format: CMD_SENSING_YYYY-MM-DD_HH:MM:SS_frequencyHz_durationS Example: CMD_SENSING_2025-09-11_14:30:00_10Hz_60s

Data Retrieval Command

  • Data Retrieval (file name without extension) Format: CMD_RETRIEVAL_filename Example: CMD_RETRIEVAL_20250911_143000

C. Errors & Feedback

  • If the command format is incorrect, time is invalid, or parameters are unreasonable, you will receive error feedback.
  • The device will also indicate error status via red LED.

D. Additional Notes

For extended commands or detailed parameter instructions, please refer to the source code or contact the developer.

Warning

Please ensure command format and parameters are correct, otherwise the command will be rejected. For example, the maximum sampling frequency is 250Hz, recommended value is 100Hz, which is sufficient for most civil vibration monitoring needs.

Warning

Data retrieval functionality is currently limited. It is recommended to obtain data directly from the SD card of each node.

Tip

The most commonly used command is CMD_SN, which triggers sensing with default parameters. These defaults can be modified in the source code. Currently, the default sampling frequency is 200 Hz and the duration is 300 seconds.
Another frequently used command is the scheduled sensing command CMD_SFN_Delay_FrequencyHz_DurationSec. For example: CMD_SFN_120_100Hz_300s means sensing will start 120 seconds later, with a sampling frequency of 100 Hz and a duration of 300 seconds.

Appendix - LED Status Indicators

Status Color Description
BOOT White Booting/Self-test
IDLE Green Idle/Standby
PREPARING Yellow Preparing for sampling
SAMPLING Purple Sampling in progress
RF_COMMUNICATING Cyan RF communication
WIFI_COMMUNICATING Blue WiFi communication
ERROR Red Error/Alarm
Other/Unknown Off Undefined/Shutdown