Laird Sentrius™ RS1xx

The Sentrius™ RS1xx temperature and humidity sensors enable battery-powered, local and wide-area sensor applications using LoRaWAN and Bluetooth 4.2! The RS1xx are small, rugged, and easily configurable sensors making it easier than ever to monitor environmental data with your own network of sensors.

Online resources

You can learn more about the Sentrius™ product from the manufacturer’s product page here

Mobile App for Configuring

Laird provides a great app to help connect to the Sentrius™ sensor over Bluetooth using a mobile app. You can use it to get your Device EUI and App Key as well as change them for each of your Sentrius™ RS1xx sensors.

iOS	Android

Using with Atmosphere IoT

You can integrate and use your Laird Sentrius™ RS1xx sensors directly in Atmosphere IoT by utilizing an API Project and an account with The Things Network.

By using the Atmosphere Studio project provided in this guide you’ll be able to get the data from your Sentrius™ device through The Things Network and be able to create dashboards using it.

Setting up Atmosphere IoT

Prerequisite: You should already have an Atmosphere account.

Importing the Laird Sentrius™ RS1xx Project into Studio

1. Download the following Atmosphere Studio project file and save to your local file system here
2. Navigate to the Studio using the right navigation bar in Atmosphere IoT
3. Click on Import Project and select from the file browser the Atmosphere Studio project file you downloaded in step 1.
4. Once the project is loaded click on the Info button at the top left and copy the UUID of the project for later

You now have the project available in your Atmosphere IoT account.

Setting up The Things Network

Prerequisite: You should already have a Things Network account.

Creating an application

When you add your TTN application to your TTN account it is best to name your TTN application the same as the project in Atmosphere IoT in case you need to reference back to the TTN console.

1. Navigate to your Things Network console
2. Navigate to the Applications section of the TTN console
3. Click Add Application
4. Set your application name and select a region

Configure Application EUIs

Laird devices use their own EUIs so the one generated by TTN will not work so we need to insert the correct Application EUI into the TTN settings.

1. Click on manage euis
2. Remove the pre-generate EUI by clicking the remove next to it’s entry
3. Click add EUI
4. Click on the pencil to then manually set the EUI to be the same as listed on the Sentrius™ device

Setting up the integration to Atmosphere IoT

In this step we will be connecting the TTN application we created to our Atmosphere IoT account so that devices can be automatically registered for us on Atmosphere IoT as well as get our data.

1. To generate an API token, open the account menu inside Atmosphere IoT from the navigation bar and click Security.
2. In the Security section’s Authentication Tokens area, click the Generate Token button to make a new API token. This will be the token you use to provide The Things Network the ability to send data to your Atmosphere account.
3. Select your application in the TTN console, and from its Overview page click on the Integrations tab. On the page, click Add Integration to add a new integration.
4. From the Add Integration list select HTTP Integration. This is where we’ll enter the API token to connect The Things Network to Atmosphere.
5. In the new integration, enter the following information:
   • Process ID: The unique ID for the integration; effectively the integration’s name so choose an ID you like, such as atmointegration.
   • Access Key: Select Default Key from the list of available options.
   • URL: The URL the data is forwarded to. Enter the following URL: https://platform.atmosphereiot.com/user/things/protocols/thethingsnetwork.
     • If this project is being built on a platform variant that uses a different base URL (such as DK IoT Studio), replace the base URL with the variant URL.
   • Method: The HTTP method to use. Enter POST in the field.
   • Authorization: The API token you generated from Atmosphere earlier in part 1 of step 3.
   • Custom Header Name: Enable auto provisioning. Enter the following value projectUUID.
   • Custome Header Value: Select the project to use for auto provisioning. Enter the Project UUID that was copied from the previous step. When finished click Add Integration to finish the integration.

With the HTTP integration created, data sent to The Things Network from devices within the application will be sent to the integration end point (Atmosphere).

Registering devices

Now we are ready to register our devices to the TTN network. As devices report data through TTN the devices will automatically be registered for you.

1. In the TTN console return to the Overview section and click register device
2. Setting a unique id for the device. Enter a name to reference the device in TTN under the DeviceID field.
3. Set the Device EUI exactly as it appears on the Laird device.
4. Set the App Key exactly as it appears on the Laird device.
5. The App EUI should already be set to the follow that was established in the previous step.

You can register new devices to your TTN application at any time and they'll automatically be added to your Atmosphere IoT account

Modifying the Project

With your devices reporting in and collecting data you may find that you wish to modify the behaviour of the device in the cloud. You can do this by opening the project we are using for the Sentrius™ devices and then modify and save the changes in the project. To deploy the changes you will need to click the Compile button in your project to have it update and deploy the changes to devices using the project.

Example

In this example we will connect a condition that will check for a high temperature level and then send a Cloud Notification to alert users.

1. Open the Laird Sentrius RS1xx Sensor project in Studio.
2. Navigate to the Cloud plane of the project.
3. Add from the toolbox on the right a Condition element by clicking on the icon.
4. Click and select the element named “Expression” already in the work area and scroll down to the triggers section and make sure the “Expression True” trigger type is selected from the drop down menu.
5. We now want to click Add Event at the bottom, you will be prompted to select another element which you will then select the newly added “Condition” element
6. Click on the connector between the “Expression” element and the “Condition” element to focus on the events between them.
7. In the field labeled Value you are going to enter our logic to check for the condition we are looking for in this case we can use the following expression value['Temperature (°C)'] > 30.0.
8. From the toolbox we now want to add a Cloud Notification element to the workspace. You can do that by simply clicking on the element in the toolbox.
9. Select the “Condition” element and with the trigger “Condition True” selected click Add Event and then select the “CloudNotification” element in the work space.
10. You can now select the connector between the two element and set the Message field to something like "Temperature to High! (>30.0°C)".
11. Press the Compile button to save your project and deploy the changes to your devices.

Now if the Sentrius™ devices that are using this project send a temperature value greater than 30.0 °C you will get a notification in Atmosphere IoT.

You can use this to create more alarms, available values that are exposed from the “Expression” element in the project are as follows. 'Temperature (°C)' 'Temperature (°F)' 'Humidity (%rH)' 'Battery (%)' '_timestamp'

---