Hands-On LTE-M NB-IoT

Transcription

1 Hands-On LTE-M NB-IoT Workshop SODAQ Date: Author: Jan van Loenen

2 Unboxing 3 Installation 4 Arduino IDE 4 SODAQ Download URL 5 Add Boards 6 Libraries 8 LTE-M 9 AT Commands 9 Library 11 All Things Talk 12 Send ASCII to ATT 14 Sending the temperature to ATT 17 GPS 19 NB-IoT 23 AT Commands 23 Library 23

3 Unboxing - SODAQ SARA AFF - Universal telecom antenna - Usb cable - Vodafone NB-IoT SIM - KPN LTE-M SIM

4 Installation Arduino IDE This manual is written to use the Arduino IDE, feel free to use your own Arduino compatible IDE. I prefer to use Visual Studio with Visual Micro. Download the latest Arduino IDE from The Arduino IDE version is while writing this document.

5 SODAQ Download URL Add the Sodaq download URLs Go to File Preferences Add the following url in the Additional Boards Manager URLs This URL is to download SODAQ Arduino compatible SAMD Boards and libraries.

6 Add Boards We need to install the SODAQ SARA board before we can use it. Go to the Boards Manager. Tools Board Boards Manager Install the SODAQ SAMD boards

7 Select the correct Board and Port. The Board must be SODAQ SARA As for the port this name will be the first SAMD board in the list. This can be the SODAQ SARA or an other board, in the image the SAMD boards of Arduino are also installed and Arduino thinks we have an Arduino Zero attached.

8 Libraries Go to Sketch Include Library Manage Libraries Install the following libraries: Sodaq_wdt Sodaq_nbiot Sodaq_LSM303AGR Sodaq_UBlox_GPS

9 LTE-M AT Commands We will start with manually AT commands to make a connection with the network and send a basic massage. Upload the sketch from this page: Open the Serial Monitor Don t forget to change to Both NL & CR and baud

10 KPN NL ATE0 AT+CFUN=0 AT+URAT=7 AT+URAT? Disable echo Turn radio off Set communication to LTE-M (7 = LTE-M, 8 = NB-IoT) Returns the URAT setting AT+CMEE=2 AT+CGDCONT=1,"IP","internet.m2m" set APN AT+CGDCONT? AT+CFUN=1 AT+COPS=1,2,"20408" AT+CSQ AT+CGATT? AT+UDCONF=1,0 AT+USOCR=17 AT+USOST=0," ",3001,4,"Data" AT+UDCONF=1,1 AT+USOST=0," ",3001,4, " " Turn radio on Connect to KPN Wait for CSQ 99,99 means no signal Wait for attach, 1 = attached Set payload to ASCII Open socket Send 4 bytes data to the node-red server Set payload to Hexadecimal Send 4 bytes data in hex to the node-red server

11 Library In the Arduino Library manager it is possible to install the sodaq libraries. Search and install the following libraries: Click on an item in the list to get the install button. sodaq_wdt sodaq_nbiot sodaq_ublox_gps sodaq_lsm303agr The LteM library is not released yet. We are still making it ready for the public. Today you will need to download it from iot.sodaq.com Unzip the file Move it to Documents Arduino libraries Reopen Arduino to load the new library

12 All Things Talk Create an account on After Creating you will something like this Create a new device Go to WIFI/LAN

13 Select Your own Give your device any name you want If you would like AllThingsTalk to save your data and be able to view graphs. Go to settings Data Storage Turn on To send data to your device you need to pack your authentication keys into the packet. You can find your authentication keys under Settings Authentication.

14 Send ASCII to ATT Create a new asset Use ascii as name Choose type: String Load the example from the Arduino IDE to send Hello World! to AllThingsTalk.

15

16 Add your keys to the sketch, you can find these under Settings in your ATT account. Upload the sketch See if you get the data on your All Things Talk account. Change the string something else and reupload the sketch.

17 Sending the temperature to ATT Create a new asset. Name it temp Choose Number Open the LteM_UDP_ATT_Temperature. Add your keys!! And upload your sketch

18 It will send the temperature value every 5 seconds. If you have enabled the data storage you will be able to see the average data over time.

19 GPS Create a new asset. Name it gps Go to the advanced tab. And update it to: { "type": "object", "properties": { "latitude": { "type": "number" }, "longitude": { "type": "number" }, "altitude": { "type": "number" }, "timestamp": { "type": "number" } } }

20 Open the GPS example. Add your keys!! And upload your sketch

21 In AllThingsTalk you will see some JSON block as your data. To be able to show it into a map we have to create a Pinboard

22 Now you have a nice map of where your device is. By default when there is no data if will show 0,0 Your map will update when you have a valid GPS position.

23 NB-IoT Change your SIM to the Vodafone SIM. AT Commands Load the passthrough sketch from the examples OR the easy commands utility from iot.sodaq.com And try out the AT commands. AT+URAT=8 AT+URAT? AT+CMEE=2 AT+CGDCONT=1,"IP","dev.sodaq.com" AT+CGDCONT? AT+CFUN=1 AT+COPS=1,2,"20404" AT+CSQ AT+CREG=2 AT+CREG? AT+CGATT? AT+CGPADDR AT+USOCR=17 AT+USOST=0," ",3000,4,"Data" AT+USOCL=0 SODAQ SERVER: PORT: 3000 = DEBUG PORT: 8891 = AllThingsTalk

24 To update a value on AllThingsTalk you need to send something like: LA1Sn4yuYx16YBAABqQQnSan\nmaker: 4VyRL0fr22kOm01qFyHqw3gE91MahfK 1Q3zEfRg0 \n{ "t" :{ "value" : 33 }, "dl" :{ "value" : true }} Where you need to change your authentication keys Have two assets: t and dl AT+USOCR=17 AT+USOST=0," ",8891,112,"LA1Sn4yuYx16YBAABqQQnSan\nmaker:4VyRL0f r22kom01qfyhqw3ge91mahfk1q3zefrg0\n{"t":{"value":33},"dl":{"value":true}}" AT+USOCL=0 Learn more about ATT UDP here: Library Install the sodaq_nbiot library is not installed yet. Note: That the current ATT examples in the library are for the OLD T-Mobile NB-IoT network. Be warned, they will now work at this moment, but will be updated soon. You are able to use the UDP example.

25 More information about LTE-M and NB-IoT can be found here: SODAQ Forum: SODAQ Suport pages: KPN Forum: