Docs
ExamplesGet started with popular boardsGet started with our kits

In this article

Guard your high-value assets

Get notified when and where your high value assets move unexpectedly or are exposed to sudden and brusk shocks that could be the cause of damage. When you leave high value assets unguarded or trust them in the care of a 3rd party, you want to be able to monitor them and get notified when something unexpected occurs.

In case such unexpected events occur, next to notification, you would also be able to collect additional data which can help identify what caused such event and understand the circumstances. Additional data collection could proactively detect factors which could cause damage and thus enable you to intervene before such events actually occur.

Such data collection could enable other stakeholders such as insurance companies to better identify cause and circumstances of damage and thus offer individualised insurance policies.

In this experiment the device will trigger when a high value asset (eg a PV Panel) is exceeding a certain vibration shock. The device sends over a trigger state and the location of the event, also a Notification is sent with the timestamp & location of the event.

Prerequisites

Hardware

  • Sodaq SARA AFF

Software

Setup

Hardware

Hardware schema

  • Insert the SIM card in the SIM card holder on the SODAQ AFF board
  • Connect SODAQ Mbili to your computer through USB

Make sure you have good GPS coverage. Indoors can be a problem in certain cases.

Set up sketch

  • Connect the Sodaq SARA AFF board to your computer over USB
  • Open your Arduino IDE
    • Go to Tools > Board: and select the SODAQ Mbili board
    • Under Tools > Port select the USB port to which your device is connected

Select board and port in Arduino IDE

  • In your Arduino IDE, open the example ‘Guard_HighValue_Goods’ under File-> examples -> arduino-ltem-rdk-master.

Authenticate your device

  • Open the tab “keys.h” of the example sketch
  • Change the DeviceID and DeviceToken values with the values that can be found in the Authentication section of the Settings Menu of the previously created device in the Maker Application.

Authenticate your device

Run the example

Simply hit the upload icon in the Arduino IDE. This will save the sketch, compile it and upload it to your Arduino.

You can now watch the values change in Maker.

Next to that the LED located on the LTE-M RDK board, helps you identify the behaviour of the device.

LED sequence/timeline

Alternatively, you can open the Tools > Serial monitor of the Arduino IDE.

  • Make sure you select the correct COM port to listen (under Tools > Port )
  • When the monitor is open, make sure the Baud rate is set to 115000

Enable extended Debugging

Get more insights on how the behaviour of the LTE-M RDK, the modem and/or network by enabling the Debug function in the sketch. This can be done by changing the false statement to true in the function LTEmModem modem, as indicated in the screenshot below.

Enable extended Debugging

Next steps

Create pinboard

To visualise our data, we will create a pinboard. For more information on pinboards, please check how to use pinboards.

  • Select the “+ Create Pinboard” in the top right of the asset overview screen
  • Make sure you have checked the Assets you want to pin in this case Location and shock.
  • Select the Arrange pinboard icon (pencil) to enter the pinboard edit mode
  • Click the settings icon of the Asset Location, select size 4x2 and continue by clicking edit control where you choose for Location as control.
  • And save….

For extra options to customise your controls, please check the Controls page.

Set up & configure automation rule

Rules give devices the ability to interact, and create automation. Specifically for this kit and experiment we have created some example rules that can be switched on and adapted to your specific needs:

  • Guard your high-value assets

Time to configure and setup rules! We will activate a provisioned rule.

  • In the Ground menu on the left of the screen, Select Rules
  • Select the rule Guard your high-value assets, and discover how this rule is assembled.
  • Close the rule window, now activate the toggle to enable.
  • Now shake your SARA AFF board.

That’s it! You were notified in the Maker application, by mail and/or push notification on your mobile phone!

For more information on rules, please check how to use rules.