Industrial IoT Wireless Tilt and Inclinometer Sensor Product Manual

Features

  • Industrial Grade Tilt Sensor with Roll and Pitch Detection
  • Configurable Roll and Pitch Angle Parameters
  • Uses Interrupts for Tilt detection with little power consumption
  • Measuring range: Roll: ±90°, Pitch: ±90°
  • Angle detection resolution ±0.5° for high precision application
  • Operating Temperature Range -40 to +85 °C
  • Superior LOS Range of up to 28 miles with 900MHz High-Gain Antennas
  • Interface to Raspberry Pi, Microsoft Azure, Arduino and More
  • Example Software for Visual Studio and LabVIEW
  • Wireless Mesh Networking using DigiMesh®
  • 256 Sensor Node per Network
  • Open Communication Protocol for custom interfacing applications
  • Small Form Factor Wireless Sensor (3×3 inch)
  • Two modes of Operation
  • Configuration mode for Sensor and X-bee Settings
  • Factory Default Option using combination of hardware buttons
  • Power efficient Built-in Sleep mode
    • User Configurable Sleep duration
    • Up to 300,000 Transmissions from 2 AA Batteries
  • X-bee API mode use for reliable communication
  • Improved reliability incorporating Re try feature in case of packet loss
  • Real time battery status

Applications

  • Wireless Activity Detection
  • Security Systems
  • Component of Low Power IoT System
  • Home Automation

1. Description

Introducing NCD’s IoT Wireless Tilt and Inclinometer  Sensor, boasting up to a 28 Mile range using a 900MHz wireless mesh networking architecture or 1 Mile using 2.4GHz wireless mesh networking architecture. It incorporates a MEMS accelerometer sensor to calculate roll and Pict angle with extremely high precision and accuracy .

User can configure the Tilt Detection condition using the configuration mode. User can configure roll angle, pitch angle. Note that the absolute value of actual tilt angle is compared with it therefore it works for both positive and negative angle exceeding threshold.

Powered by just 2 AA batteries and an operational lifetime of 300,000 wireless transmissions, a 10 year battery life can be expected depending on environmental conditions and the data transmission interval.  Optionally, this sensor may be externally powered.

With an open communication protocol this Tilt and Inclinometer  Sensor sensor can be integrated with just about any control system or gateway.  Data can be transmitted to a PC, a Raspberry Pi, to Microsoft Azure® IoT, or Arduino. Sensor parameters and wireless transmission settings can be changed on the go using the open communication protocol providing maximum configurability depending on the intended application.

The long range, price, accuracy, battery life and security features of Wireless Tilt and Inclinometer  Sensor makes it an affordable choice which exceeds the requirements for most of the industrial as well as consumer market applications.

To complete a network with an industrial sensor at one end, a Zigmo/Router is required at the receiving end (PC end) that receives data from sensor. A set of sensor and Zigmo is shown in following figure.

Any ncd modem or gateway can be used with any ncd wireless sensors. 

Tilt and Inclinometer Sensor Type is 47. 

Wireless Activity Detection Sensor

Sensor with Zigmo/Router

2. Getting Started

The sensor and Zigmo/Router come pre-programmed and work out of the box. In this section we will setup a sensor and Zigmo link and start receiving data on our PC. Though this guide shows how to visualize data on LabVIEW utility, you can also use a simple serial terminal to see raw data by following these steps.

Resources Required

Steps
 Power-up the Wireless Sensor and make sure its antenna is installed
Connect your Zigmo/Router to your PC

Connect your Zigmo/Router to your PC

  1. Identify the serial port allocated to it by going into device manager (You can also find the serial port using Digi provided utility XCTU)

At this stage, both the Sensor and Zigmo have automatically established communication and the data can be read from the serial port at which Zigmo has been installed.

a

Connect your Zigmo/Router to your PC

a

a

a

a

  1. Install the Alpha Station utility for the sensor you are working with. Run this utility.
  2. Press the port configure button and select the PORT you identified in step 3. Select baud rate of 115200 and press OK.

a

a

a

a

a

a

Connect your Zigmo/Router to your PC

a

a

a

a

a

a

  1. Press the Run button to visualize incoming data

If you were not able to communicate after completing the above steps then there might be a fault at either end of the communication network. Please refer to the troubleshooting section for identifying and resolving some common issues. If you are still not able to communicate after troubleshooting then please contact us at any time.

The sensor and Zigmo/Router come pre-programmed and work out of the box.
Figure 1: Connect Zigmo/Router to PC
Figure 2: Serial port identification
Note:
Sensor Type of this sensor is 0x2F. The figures are for demonstration purposes only and might contain a different Sensor type or a different UI version than the latest version available for download.
The packet received from this Sensor will have its own sensor type in the Sensor type field.

3. Troubleshooting

Changed/Unknown setting at sensor end

One of the issues for unsuccessful communication can be a changed setting at the sensor end due to which the sensor and Zigmo are unable to establish a connection. You can resolve this problem by going back to the factory default settings which are provided in Table 1. Please refer to Figure 7 and follow steps shown in it for applying factory default settings.

Once the sensor resets it will start sending a frame every 600 seconds after factory reset.

Please refer to the detailed document available to Digi website to understand X-bee communication parameters and its operation mechanism.

Changed/Unknown setting at PC end

Sometimes a changed setting at Zigmo end, whether intentional or unintentional, can cause a network failure and no data reception at PC end. To fix this issue when the sensor end is operating at factory default settings you will have to bring the Zigmo/Router to factory default settings as well. For that, please download the configuration file for Zigmo from our website. You will also require XCTU utility provided by Digi.

After installing XCTU Utility, run it and go to add a radio module. Select the serial port at which Zigmo is connected and press finish. This will connect the Zigmo to XCTU.

 After double clicking the added module, a list of parameters will be displayed on the right side. Select the load configuration file from the top and select configuration file form the location where you downloaded it earlier.  

Now press the write button on top to write these parameters. Close the XCTU utility and open the LabVIEW utility and follow the steps in getting started section to communicate with sensor.

Table 1: Default Parameters programmed after Factory reset sequence

Figure 5: Connecting Zigmo/Router to XCTU
Figure 6: Loading a default profile to Zigmo/Router

4. Modes of Operation

This module incorporates 2 modes of operation, these are

  • Run Mode
  • Configuration Mode

Run mode is the standard mode, the module will always enter Run mode if no button is pressed during Power-up/Reset. Configuration mode is intended to configure sensor parameters and the X-bee parameters on the sensor end. Note that the Sensor end X-bee is only configurable via the sensor controller using the commands provided in device manual. Figure 7 illustrates these modes.

The device sends a startup packet which can be used to determine the mode in which it is operating. These packets are shown in Table 2.

Mode Selection Process

The CFG button on the module is used to change mode. If CFG button is pressed and the module reset button is pressed, the module will enter the configuration mode. The amount of time CFG button has to be pressed is shown in Figure 7.

Note that settings only take effect after the reset.

Frame Communication at Power up

In figure 8,  Mode bytes highlighted in red can be compared with the values provided in Table 2 to determine the mode in which the sensor is operating. Node ID is the ID of the given sensor while sensor type determines the type of sensor. Both of these can be used to determine the exact sensor which is sending the information.

A shown in second column in Table 2, the sensor configures its PAN ID automatically depending upon the mode it is working in. During factory reset it sets the PAN ID to the value given in table therefore the factory reset frame will only be received if your Zigmo/Router PAN ID matches this ID. Please note that right after factory reset the sensor enters configuration mode therefore its PAN ID is changed again and a new frame is generated. All 3 type of frames are shown in Figure 9, Figure 10 and Figure 11.

The factory default settings are shown in Table 1. For parameter description please refer to the section on configuration.

Figure 7: Mode Selection Process
Table 2: Mode Bytes for different sensor modes (* this frame is followed by configuration frame as shown Figure 7)
Figure 8: Typical Communication at Power Up, Transmitted packet (left) Received packet (right)

Figure 9: Run Mode Power up frame

Figure 10: Configuration Mode Power up frame

Figure 11: Factory Default Power up frame

1. Run Mode

Run mode is the default mode of operation of this sensor. In this mode the sensor sends periodic packets to destination receiver. During the time it is not sending packets, it sleeps and conserves power. Sensor end X-bee operates in API mode and sends packets to the saved destination address on the network specified by the saved PAN ID. Figure 12 illustrates an API packet transmission and reception.

Packet reception at receiver end is ensured by the device by retrying up to 3 times if no acknowledgement is received that the packet has been successfully received. The device uses the acknowledgement functionality available in API mode in X-bee devices therefore user does not need to worry about sending acknowledgements for every packet.

Figure 12: Transmit packet detail (left), Received packet detail (right)

3. The detail for API packet received at PC end can be read from the X-bee manual available from Digi. The detail of Payload section of packet is shown in Table 3.

Typical response from the device in Run mode is shown in Figure 13 and Figure 14. The utility shown in Figure 14 can be downloaded from the website.

Frame FieldOffset (Payload Section)Fixed Value
(if any)
Description
Header00x7F
Header to differentiate various type of packets
Node ID10x00 Factory Default
Node ID to differentiate up to 256 nodes in a network. User configural values
Firmware2
Used to determine firmware version programmed in the device
Battery VoltageMSB 3

Sampled battery voltage of the device.

Battery Voltage=((Battery Voltage MSB x 256+Battery Voltage LSB) x 0.00322 V

LSB 4
Packet Counter5
It is an 8-bit counter that increments with each packet transmission. It can be used to detect missing packets.
Sensor TypeMSB 60x00
Two bytes to determine sensor type. It can be used in conjunction with Node ID to create sensor networks of up to 256 nodes for a single type of sensor and multiple such networks can coexist and can be differentiated in processing software on PC end
MSB 70x18
Reserved80x00

For future use

Tilt Angle Data9/Data[0]

Roll in Degree (16 bit Signed Output)

          Roll = (Data[0]<<8)+Data[1])/100

10/Data[1]
11/Data[0]

Pitch In Degree (16 bit Signed Output)

          Pitch = (Data[0]<<8)+Data[1]/100)

12/Data[1]

Figure 13: Run mode packets being received in a terminal (Hex mode)

Wireless Tilt Sensor User Interface

Figure 14: Run mode packets being received in our free to use Alpha Station Software (For custom made utility for your specific requirements please contact support)

2. Configuration Mode

Configuration mode is intended to setup the device over the wireless link. Entering configuration mode was already explained in the section “mode selection procedure”. User can also setup X-bee communication and networking parameters using this mode via PC. Note that settings only take effect after reset and are stored inside the device.

In configuration mode, the device sets its X-bee pan id to 7BCD (Hex). Also, the destination address used by the sensor is extracted from the incoming packet (source address). This ensures that once you put a device in configuration mode you just need to change the PAN ID of your Zigmo to match with sensor and start configuring your device. You can change the PAN ID of your Zigmo using XCTU from Digi. If you use our LabVIEW utility, it will automatically change Zigmo PAN ID once you open the configuration window. When you exit this window your PAN ID will be restored to old value.

A standard configuration packet and its fields are explained in Figure 15. Its possible responses are also shown. The commands supported by this sensor are shown in Table 4, these can be used in the Parameters field of Payload section. The sensor responds to these commands with an acknowledgement if the process completed successfully or with an error if it failed to setup a parameter. The respective Data and Reserve section length and values are shown in Table 5 for the case of acknowledgement. In the case of error, the reserved section will be fixed and not used, while the Error number byte will determine the type of error returned. These errors are mentioned in Table 6.

Figure 15 depicts standard communication between Zigmo/Router and sensor. Sensor commands have variable length frames whereas responses received from sensor are fixed length. The 2 scenarios are also shown, where a command can result in an acknowledgement reception or an error reception at the Zigmo end.

Examples for setting parameters in configuration mode are shown in Appendix A.

Figure 15: Configuration mode communication

Table 4: Configuration Commands and their respective headers, sub command and Parameter field

Table 5: Acknowledgment data for various commands and the size of reserve section in each case

Table 6: Error numbers and their description

A. Appendix

Configuration Commands

1. Set Broadcast Transmission

Command For COPY: 

 

7E00 1310 0000 0000 0000 00FF FFFF FE00 00F7 0100 0018 E4

2. Set ID and Delay

Command For COPY: 

 

7E00 1710 0000 0000 0000 00FF FFFF FE00 00F7 0200 0018 0000 0004 DF

3. Set Destination Address

Command For COPY: 

 

7E00 1710 0000 0000 0000 00FF FFFF FE00 00F7 0300 0018 1234 5678 CE

4. Set Power

Command For COPY: 

 

7E00 1410 0000 0000 0000 00FF FFFF FE00 00F7 0400 0018 02DF

5. Set PANID

Command For COPY: 

 

7E00 1510 0000 0000 0000 00FF FFFF FE00 00F7 0500 0018 7CDE 86

6. Set Retries

Command For COPY: 

 

7E00 1410 0000 0000 0000 00FF FFFF FE00 00F7 0600 0018 03DC

7. Read Delay

Command For COPY: 

 

7E00 1310 0000 0000 0000 00FF FFFF FE00 00F7 1500 0018 D0

8. Read Power

Command For COPY:

 

7E00 1310 0000 0000 0000 00FF FFFF FE00 00F7 1600 0018 CF

9. Read Retries

Command For COPY:

 

7E00 1310 0000 0000 0000 00FF FFFF FE00 00F7 1700 0018 CE

10. Read Destination Address

Command For COPY: 

 

7E00 1310 0000 0000 0000 00FF FFFF FE00 00F7 1800 0018 CD

11. Read PANID

Command For COPY: 

 

7E00 1310 0000 0000 0000 00FF FFFF FE00 00F7 1900 0018 CC

12. Enable Encryption

Command For COPY: 

 

7E00 1310 0000 0000 0000 00FF FFFF FE00 00F2 0100 0018 E9

13. Disable Encryption

Command For COPY: 

 

7E00 1310 0000 0000 0000 00FF FFFF FE00 00F2 0200 0018 E8

14. Set Encryption Key

Command For COPY:

7E00 2410 0000 0000 0000 00FF FFFF FE00 00F2 0300 0018 0011 2211 2211 2211 2233 4433 4433 4433 443F

Wireless Tilt Sensor User Interface - Configuration Mode

Configuration Mode packets being received in our free to use Alpha Station Software (For custom made utility for your specific requirements please contact support)

14. Set Roll Angle Threshold

This command can be used to set roll angle threshold.  For example if this value is set to 1 then the sensor will sends wireless transmission contains all sensor info every time sensor roll tilts by 1′. 

The set Roll angle value should be between 1′ and 90′.

7E 00 15 10 00 00 00 00 00 00 00 FF FF FF FE 00 00 F4 01 00 00 2F 00 01 CF

Command — F4 01 00 00 2F 00 01

F4 — Command Header

01 — Sub command

00 — Node ID

00 2F — Sensor Type

00 — Reserve 

01 — Roll Angle Threshold Value 

Sensor Response —

7E 00 1C 90 00 13 A2 00 41 A2 70 EA FF FE C1 7C 00 08 00 2F 00 00 FF 00 00 00 00 00 00 00 00 0D

Sensor response Payload — 7C 00 08 00 2F 00 00 FF 00 00 00 00 00 00 00 00

7C — Header

00 — Node ID

08 — Packet Counter

00 2F — Sensor Type

00 00 — Reserve 

FF — Command was successfully executed 

00 00 00 00 00 00 00 00 — Reserve

15. Read Roll Angle Threshold

This command can be used to read the set roll angle threshold. 

7E 00 13 10 00 00 00 00 00 00 00 FF FF FF FE 00 00 F4 02 00 00 2F CF

Command — F4 02 00 00 2F

F4 — Command Header

02 — Sub command

00 — Node ID

00 2F — Sensor Type

 

Sensor Response —

7E 00 1C 90 00 13 A2 00 41 A2 70 EA FF FE C1 7C 00 07 00 2F 00 00 00 01 00 00 00 00 00 00 00 0C

Sensor response Payload — 7C 00 07 00 2F 00 00 00 01 00 00 00 00 00 00 00

7C — Header

00 — Node ID

07 — Packet Counter

00 2F — Sensor Type

00 00 00  — Reserve 

01 — Roll Threshold Angle 

00 00 00 00 00 00 00 — Reserve

16. Set Pitch Angle Threshold

This command can be used to set pitch angle threshold.  For example if this value is set to 1 then the sensor will sends wireless transmission contains all sensor info every time sensor pitch tilts by 1′. 

The set Pitch angle value should be between 1′ and 90′.

7E 00 15 10 00 00 00 00 00 00 00 FF FF FF FE 00 00 F4 03 00 00 2F 00 01 CD

Command — F4 01 00 00 2F 00 01

F4 — Command Header

03 — Sub command

00 — Node ID

00 2F — Sensor Type

00 — Reserve 

01 — Roll Angle Threshold Value 

Sensor Response —

7E 00 1C 90 00 13 A2 00 41 A2 70 EA FF FE C1 7C 00 08 00 2F 00 00 FF 00 00 00 00 00 00 00 00 0D

Sensor response Payload — 7C 00 08 00 2F 00 00 FF 00 00 00 00 00 00 00 00

7C — Header

00 — Node ID

08 — Packet Counter

00 2F — Sensor Type

00 00 — Reserve 

FF — Command was successfully executed 

00 00 00 00 00 00 00 00 — Reserve

17. Read Pitch Angle Threshold

This command can be used to read the set roll angle threshold. 

7E 00 13 10 00 00 00 00 00 00 00 FF FF FF FE 00 00 F4 04 00 00 2F CD

Command — F4 04 00 00 2F

F4 — Command Header

04 — Sub command

00 — Node ID

00 2F — Sensor Type

Sensor Response —

7E 00 1C 90 00 13 A2 00 41 A2 70 EA FF FE C1 7C 00 07 00 2F 00 00 00 01 00 00 00 00 00 00 00 0C

Sensor response Payload — 7C 00 07 00 2F 00 00 00 01 00 00 00 00 00 00 00

7C — Header

00 — Node ID

07 — Packet Counter

00 2F — Sensor Type

00 00 00  — Reserve 

01 — Pitch Threshold Angle 

00 00 00 00 00 00 00 — Reserve

B. Appendix

Frame Checksum Calculation

In order to successfully communicate over the API protocol, checksum is of vital importance. The X-bee at either end will reject packets if the checksum is not matched. Checksum is also checked by the sensor controller and LabVIEW utility for added security.

For sending packets, checksum calculation works as follows

  1.  Not including the frame delimiter and length, add all the bytes and keep the lower 8 bits of result
  2.  Subtract this value from 0xFF (hex)
  3. The resultant value is the checksum
  4.  Append this byte to the original packet for sending

Consider the example for the command Set Broadcast shown in Figure 19 in A APPENDIX and see that the calculated checksum matches with the checksum sent by the terminal/LabVIEW

Although checksum is matched by the X-bee itself, but for understanding follow these steps to match checksum at reception

  1. Not including the frame delimiter and length, add all the bytes including the received checksum
  2. Keep only the last 8 bits
  3.  If the result is 0xFF, the checksum is correct and the packet can be processed.

Consider the example of the command Set Broadcast shown in Figure 19 in A APPENDIX and see that the received packet checksum verifies since the result is 0xFF.