In the ever-evolving landscape of IIoT technology, the ability to seamlessly connect and communicate with wireless sensors is paramount. NCD has emerged as a prominent player in this field, offering a range of innovative wireless sensors designed to monitor and collect data from various sources. In this article, we will delve into the exciting world of NCD wireless sensors and guide you through the process of integrating them with the HiveMQ MQTT broker. By the end of this tutorial, you will have the knowledge and skills needed to harness the power of NCD sensors and HiveMQ to create efficient and scalable IoT solutions that can transform the way you collect and manage data. Whether you’re a seasoned IoT enthusiast or just embarking on your journey into the world of wireless sensors, this article will be your comprehensive guide to achieving seamless connectivity and data exchange.
Takes wireless sensor data and sends it to any cloud or database
Click to Learn More
Long range wireless IIoT sensors
Click to Learn More
The first step will be creating a HiveMQ account if you have not already. Â Once the account is created log in and you should be taken to the console. Â HiveMQ automatically created a Cluster for me as shown in the image. Â This is essentially the MQTT Broker which we will publish sensor readings to and monitor them from our software client.
Â
Click Manage Cluster, then at the top of the following page click Access Management. Â Here we will create credentials for the Enterprise Gateway and our Software client. Â This will allow the two to communicate with each other.
For my Enterprise Gateway I set the username to the Gateway’s mDNS address to keep things easy. Â I then set a password I can remember and set the Permission to Publish Only. Â You could set to Publish and Subscribe but for now my Gateway will only publish sensor readings.
After clicking Create Credential for the Gateway we’ll create another credential for our software. Â I set mine to subscribe only. Â This is sort of one way communication with sensor readings coming from the Gateway to the software. Â This is totally optional, feel free to set yours to Publish and Subscribe. Â I also set the username to Explorer since I will be using these credentials with MQTT Explorer to test functionality.
After creating the credentials you can scroll down and see them below. Â This is all we need to do for now. Â We are already done with all configuration on HiveMQ. Â While you’re here however you can click on Overview at the top and copy the Cluster URL. Â After that feel free to close the browser window if you wish(once again optional).
There are permissions as well here further down but that is a topic for another day. Â Right now we just want to see sensor readings over HiveMQ.
We’ll start by getting our Enterprise gateway hooked up. Â If you have not yet reviewed the user guide for the Enterprise Gateway I encourage you to do that now.
Open the Enterprise Gateway’s Node-Red flow editor in your web browser. Â Let’s start by making sure it sees data from our sensor. Â There will be a flow deployed already with a Gateway node connected to a Debug node. Â Click the debug button in the upper right corner, then press the RST button on the sensor. Â You should see sensor data printed in the Debug panel.
To make things simpler I created a Node-Red flow you can import and edit. Â This will save you some steps.
Download the HiveMQ.json file here.
In Node-Red click the menu button in the upper right button that looks like 3 lines. Â Click Import, then click Select a file to import. Â Select the file you downloaded and click Import. Â If prompted click Import Copy. Â A tab for the new flow is created at the top. Â Click to view it.
Here you can see the complete flow. Â We need to edit it though.
Double click the HiveMQ node to open its editor. Â Click the edit button to the right of the Server Field. Â
Under the Connection tab paste the Cluster URL you copied from HiveMQ in a previous step.
Under the Security Tab enter the username and password you entered when creating credentials for the Enterprise Gateway. Â I also recommend setting Client ID to the Username, but you can set it to whatever you like. Â Then Click Done until the Settings window is closed. Â Finally click the Deploy button in the upper right corner. Â After a few seconds the Hive MQ Node should show Connected. Â Data from the sensor is now being published to the HiveMQ broker.
For my testing I will be using MQTT Explorer. Â It’s free, at the moment, and is cross platform so it runs on Windows, Mac, and I believe Linux. Â You can download it here. Â Be sure to support the Creator Thomas in any way you can.
Open MQTT Explorer. Â Then create a new Connection. Â I named mine HiveMQ. Â Uncheck Validate Certificate, make sure Encryption is enabled. Â Paste the Cluster URL from HiveMQ in the Host field, set port to 8883, then enter the username and password you set for the Software client in the previous step on HiveMQ. Â
Now click Advanced. Â Make sure there is a subscription to # Then click Back, then Connect.
You can press the RST button on your sensor to force a transmission. Â After a few seconds you should see an item appear on the list on the left labeled ncd, expand that and you will see a serial number unique to your sensor. Â Click it to view the data from the sensor. Â At this point you are successfully publishing data to HiveMQ from your sensor and monitoring it on HiveMQ.
Where you go from here is for your imagination to decide. Â Have fun.
NCD Atrium App Site Survey User Guide Get Started 01Overview 02Requirements 03Installing 04First-Time Setup▸ 1. Open the app 2. Check the thresholds 3. Test every sensor 4. Read the result Using the App 05The Sensor List▸ Summary strip Columns Filtering and sorting Expanding a row 06Testing Sensors▸ Starting a test What the Status column means Why it takes so long Failure messages 07RF Environment 08How Results Are Graded 09Survey Settings
IntroductionWhen Should a User Configure Sensor Settings?Wireless Gateway Sensor MessagesSensor BehaviorSync / Configuration ModeReset Button and Magnetic SwitchSync MessagesSync Check-In MessageThe Configuration Window in Node-REDSync Acknowledgment MessageSync End MessageSync Response Success MessageSync Response Skip MessageConfiguration Process ExampleUnderstanding the “Active” Checkbox in Sensor ConfigurationThe Configuration TimelineReset Settings to FactoryIntroduction Note This guide applies to users utilizing NCD sensors with the Enterprise IIoT Gateway or NCD Modem (USB or Ethernet versions) via
NCD Atrium REST API Guide v1.0 · Platform 2.5.3 Getting Started □1. Overview □2. Base URL & Access □3. Authentication □4. Conventions □5. Quick Start Sensor Data □6. Sensors & Inventory □7. Telemetry Readings □8. Metadata & Units □9. Device Management Alerts & Logic □10. Alerts & History □11. Triggers & Automations □12. Event Bus Gateway □13. Config & System □14. Network □15. Radio & Mesh □16. Monitor & Widgets
