Docs
ExamplesGet started with popular boardsGet started with our kits

In this article

Guard your stuff

Get notified when someone is tampering with one of your favourite paintings. This example shows how an NB-IoT device can be used to detect unexpected movement of an object and send out notifications to its owner.
Furthermore, it shows how you can track the object using its Geo-location when in open air.

Prerequisites

Hardware

  • Sodaq Mbili
  • NB-IoT module with antenna and SIM card
  • 3-axis digital accelerometer
  • GPS module

Software

Setup

Hardware

Guard your stuff schema

  • Insert the NB-IOT SIM card in the NB-IoT radio Module
  • Attach NB-IoT module with antenna to the MBili
  • Connect 3-axis digital accelerometer to SCL/SDA (I2C socket)
  • Connect GPS module to D20/D21
  • Connect SODAQ Mbili to your computer through USB
  • Turn power switch ON

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

Set up sketch

  • Connect the Sodaq Mbili 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

Choose Sodaq Mbili board and port

In your Arduino IDE, open the example guard-your-stuff under File > Examples > arduino-nbiot-rdk-master.

Setup device credentials

If you did the first application on the previous page, your device is ready for use, and you can continue and run the example.
If not, please complete the following step.

  • Browse and open the keys.h file located in the arduino-nbiot-sdk-master Library folder, by default you can find it in:
    • Mydocuments/Arduino/Libraries/Arduino-nbiot-sdk-master folder for Windows
    • Documents/Arduino/Libraries/Arduino-nbiot-sdk-master folder for MacOS
  • Change the DeviceID and DeviceToken values with the values that can be found under Device Settings > Authentication section of your device in the Maker Application. In the keys.h file you will notice that the APN is already pre configured and should not be changed.

AllThingsTalk Device ID and Token

1
2
3
4
5
6
7
8
9
/****
 * Enter your AllThingsTalk device credentials below
 */
#ifndef KEYS_h
#define KEYS_h
const char* DEVICE_ID = "LA1Sn4yuYx16YBAABqQQnSan";
const char* DEVICE_TOKEN = "maker:4VyRL0fr22kOm01qFyHqw3gE91MahfK1Q3zEfRg0";
const char* APN = "starter.att.iot";
#endif

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.

After uploading, you might need to flip the power switch on the Sodaq Mbili OFF and back ON to make sure the Mbili reboots and starts up our sketch.

You can now watch the values change in Maker.

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 57600

Next steps

Create pinboard

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

  • Select the Pinboards icon in the top left
  • Select the New pinboard icon
  • Select the Arrange pinboard icon to enter the pinboard edit mode

Now we will pin a control (visual representation) for our GPS asset.

  • Select Pin control
  • Select your device and GPS asset.
  • Select an appropriate control for the selected asset. To visualise our data it is best to select Map as control
  • Click Pin control

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

Set up automation rule

We want to get notified :

1
2
When motion = true
Then send notification

For a simple rule like this, we can use the rules wizard.

  • Click your name in the top right corner to enter the main menu
  • Select Your rules
  • Click + New Rule to create a new rule
  • Select Use rules wizard when creating a simple rule

Time to create our rule!

  • Select Device state change
  • Continue
  • Select your device from the dropdown menu
  • Select the Motion asset
  • Select Compare to some value
  • Select equal to (==) as Value to compare
  • Enter True
  • Continue
  • Select Notify me
  • Continue
  • Enter your notification message
  • Save and start
  • Enter a name for your rule and save

That’s it! When your device moves, the asset Motion will be set to True, and you now will get notified!