ARM mbed

For programming this board we'll use the online developer environment ARMmbed. With this online

With this online code editor offers a lot of benefits such as libraries for all ARM-based developer boards and shared work by other people.

1. Create an account

First you'll need to create an account before we can get started

1- Go to ARMmbed and create an account and login

2. Setup the environment

1- First you'll need to add the compiler. Get the mDot developer board .

2- Click on Add to your mbed compiler

3- Now get The Things Network mDot ABP-example

4- Click on import this program

5- Leave all setting as they are and click Import

3. Next step

Configure your node  ABP or OTAA

Connect with OTAA

This chapter will tell everything about registering and connecting the mDot with OTAA.

Every mDot has its own unique Dev EUI (device address) that is printed on  the sticker. 

1. Register the node

1. Got the The Things Network Console

2. Register/Login
3. Create a new application
4. Register a OTAA device

    1- Click on register device:

    2- Enter the unique EUI of your node:

    3- Click Register:

5. Now you'll be guided to the Node page:

    1- Copy the App EUI

    2- Copy the App Key

2. Open the sketch

1. Go to the ARMmbed environment

2. You should see the following files in the mDot_Workshop:

3. Open main.cpp

3. Modify the sketch

1. Configure join_mode to true

static bool join_mode = true;

2. Configure the config_network_deveui to your own EUI

static uint8_t config_network_deveui [] = { 0x00, 0x80, 0x00, 0x00, 0x00, 0x00, 0x9F, 0xA6 };

3. Configure the config_network_appeui to your own AppEui

static uint8_t config_network_appeui [] = { 0x70, 0xB3, 0xD5, 0x7E, 0xD0, 0x00, 0x03, 0xDD };

4. Configure the config_network_appkey to your own AppKey  

static uint8_t config_network_appkey [] = { 0xD0, 0xC1, 0xDC, 0xC9, 0x83, 0x43, 0x7E, 0x4C, 0x54, 0xE7, 0x61, 0xE0, 0x8D, 0xDA, 0xA8, 0x2E };

// Message you want to send
    std::string data_str = "Hello!";

4. Compile the sketch

1. Click compile:

2. Now the code is compiled to binary file and automatically downloaded

3. Use this file to program the mDot in the next step

5. Next step

Upload the sketch to the mDot

Connect with ABP

This chapter will tell everything about registering and connecting the mDot with OTAA.

1. Register the node

1. Got the The Things Network Console
2. Register/Login
3. Create a new application
4. Register a ABP device

    1- Click on register device:

    2- Let the registration tool generate the EUI and Key

    3- Click Register:

5. Now you'll be guided to the Node page:

   1- Copy the Dev Address

    2- Copy the App Session Key

    3- Copy the Network Session Key

2. Open the sketch

1. Go to the ARMmbed environment

2. You should see the following files in the mDot_Workshop:

3. Open main.cpp

3. Modify the sketch

1. Configure the devAddr to your own Dev Address

static uint8_t devAddr[] = { 0x6C, 0x63, 0x6F, 0x4B };

2. Configure the nwkSKeyto your own App Session Key

static uint8_t nwkSKey[] = { 0x7A, 0xAC, 0x4E, 0xAD, 0xFF, 0x06, 0xFD, 0xBC, 0x2F, 0xF8, 0x2B, 0xE3, 0x9C, 0x5C, 0x78, 0x1A };

3. Configure the appSKey to your own Data Session Key 

static uint8_t appSKey[] = { 0xD0, 0x3F, 0x29, 0xCD, 0xFE, 0x43, 0x96, 0xC1, 0xCD, 0x3F, 0x2E, 0x5B, 0x81, 0x3E, 0xC6, 0x9E };

4. Configure the message

// Message you want to send
    std::string data_str = "Hello!";

4. Compile the sketch

1. Click compile:

2. Now the code is compiled to binary file and automatically downloaded

3. Use this file to program the mDot in the next step

5. Next step

Upload the sketch to the mDot

Uploading the sketch

In the previous step you compiled your OTAA/ABP sketch to binary code file. This step will explain how to program the mDot with the binary file.

1. Connect the board

To program the mDot you'll need one of the developer boards from Microchip.

1. For this tutorial we'll use the MTUDK2-ST-MDOT

2. Connect the mDot to the MTUDK2-ST-MDOT

3. Connect the board to your computer with a Micro-USB cable

Windows users need to install an additional driver for the developer board.

4. It is important to note that the programming pins on the mDot  should be connected to the MTUDK2-ST-MDOT. There should be headers on these pins, but this is not always the case. Without this connection, it is not possible to program the Mdot.

2. Upload your binary files

1. When you connect the developer board to your computer, it is automatically detected as a storage device and is mount as Multitech.

2.  Copy your binary file to the MULTITECH storage device

3. While the file is being copied the green and red LED's on the board will flash. When the uploading is done only the Green LED will be on.

4. Push the reset button on the board :

5. Now the binary file is loaded on the mDot

3. Serial Monitor

Now that your sketch is running on the mDot, the debug data can be displayed on the serial monitor.

1. Open your serial monitor of choice

    - Windows: putty

2. Select the serial port that is connected to the developer board: STMicroelectronics STLink Virtual COM Port

3. Configure your serial monitor:

    - Baud rate = 115200

    - Data bits = 8

    - Parity = N

    - Stop bits = 1

    - Flow control = Off

3. Open the serial monitor

4. Control data transmission

1. Make sure that your developer board is connected and that the serial monitor is opened

2. Sometimes the serial port of the doesn't open. This can be fixed by reconnecting the developerboard.

3. Reset the board

4. The mDot will first try to connect with OTAA

[INFO] Version: 1.0.8-1-g7ae9ef7
[INFO] Setting frequency sub band
[INFO] setting Device EUI
[INFO] setting App Eui
[INFO] setting App Key
[INFO] Setting TX spreading factor
[INFO] Disabling ACKs
[INFO] Saving config
[INFO] Joining network
[INFO] Successfully joined the network
[INFO] TX Frequency: 868300000 SF: 9 BW: 125 kHz POW: 11 dBm

5. Now the mDot will transmit data

[INFO] TX Frequency: 868500000 SF: 8 BW: 125 kHz POW: 11 dBm
[INFO] Successfully sent data

5. Next step

Now the mDot transmits data. In the next step we'll retrieve the transmitted data from the cloud.

Receiving data in the Dashboard

This chapter will explain how to receive and decode data on the dashboard. 

1. Go to the console  and open your app

2. Click edit to edit the payload function

3. Copy the code that suits your data type that you transmit from the Node:

Bytes to integer

function (bytes) {
  var data  = ((bytes[1] << 8) | bytes[0]) * (5/1024);
  //data =* (5/1024); //in case the intger represents a 1024 bit register
  return {
    light: data
  };
}

    Bytes to float

function (bytes) {
  var data  = ((bytes[1] << 8) | bytes[0]) /100;
  return {
    light: data
  };
}

    Bytes to String

//

copy the examples code into the code window:

4. Save 

5. Look for the data in the Messages window:

Connect a sensor [BETA]

This chapter will cover how to connect a sensor to the Mdot and how to transmit this data.

1. Connecting the sensor

There are multiple ways to connect a sensor to the  MTUDK2-ST-MDOT.

This tutorial features two options for connecting the sensor.

Connect an  Arduino Grove shield

1. The MTUDK2-ST-MDOT features a set of headers to support Arduino headers.

2. Connect the Arduino grove shield to the developer board

3. Connect the light sensor to port A1

Connect the sensor with jumpers

1. Connect the sensor pins:

    5.0V     <->  VCC

    GND    <->  GND

    A1         <->   SIG

2. Modify the sensor sketch

1. Open the light sensor example sketch

2. Modify the Keys and Eui's

    OTAA

    1- Configure the Dev Eui

    2- Configure the App Eui 

    3- Configure the App Key

    ABP

    1- Configure the Dev Addr

     2- Configure the appSkey

    3-  Configure the nwSKey

3. Reading the data:

    1- Get the voltage of the Analog pin

//PB_0 = Analog pin 1
AnalogIn pinn(PB_0); 
        
//read voltage
uint16_t light = (int)(pinn.read()*1023);

    2- Put the data into a byte array

std::vector<uint8_t> data;
for (int i = 0; i <= sizeof(light); i++)
    data.push_back((uint8_t)(light >> ((8*i-8) & 0xFF)));

4. Send data

ret = dot->send(data);

3. Modify the payload function