AWS IoT ExpressLink SARA-R5 Starter Kit Getting started guide for u-blox AWS IoT ExpressLink SARA-R5 Starter Kit Getting started Abstract This document describes how to begin working with the u-blox AWS IoT ExpressLink SARA-R5 Starter Kit, which consists of a u-blox AWS IoT ExpressLink SARA-R5 module mounted on a SparkFun carrier board such that it can be used with a variety of microcontrollers or an attached PC.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started Document information Title AWS IoT ExpressLink SARA-R5 Starter Kit Subtitle Getting started guide for u-blox AWS IoT ExpressLink SARA-R5 Starter Kit Document type Getting started Document number UBX-21042016 Revision and date R02 Disclosure restriction C1-Public 1-Dec-2021 This document applies to the following products: Product name u-blox AWS IoT ExpressLink SARA-R5 Starter Kit u-blox or third parties may hold intellectual property r
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started Contents Document information ................................................................................................................................ 2 Contents .......................................................................................................................................................... 3 1 Overview ..................................................................................................................
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started 1 Overview The u-blox AWS IoT ExpressLink SARA-R5 Starter Kit provides access to AWS IoT Core and AWS IoT services over a cellular LTE-M (also known as LTE Cat M1) connection. The kit includes a u-blox AWS IoT ExpressLink SARA-R5 module mounted on a SparkFun MicroMod Asset Tracker Carrier Board into which a Sparkfun MicroMod processor board can be inserted, allowing the module to be used with many different microprocessors.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started ⚠ This means that the power-on procedure for the u-blox AWS IoT ExpressLink SARA-R5 module is NOT the AWS one, it is the original u-blox SARA-R5 one and there is no WAKE pin, see section 8. 2.2 Standard kit contents This kit includes: • • • • the board with the SARA-R5 module, a cellular antenna, a Thingstream SIM card, which will have already been inserted into the board, an Asset Tracker Update Tool M.2 board.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started Open a terminal application on your host machine (e.g., TeraTerm or Docklight for Windows or CoolTerm for Mac) and select the port corresponding to the evaluation kit. Configure the terminal application as follows – and take special note of the first three items: • • • • • • • ⚠ End of line: Local echo: Flow control: Baud rate: Bits: Parity: Stop: line feed (i.e.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started 5 Registering AWS IoT ExpressLink SARA-R5 with your development account 5.1 Setting up the module Before a cellular module can be registered with your development account for the first time, it must have registered with the cellular network for the first time.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started After a short while, in your terminal application the text Welcome to u-blox AWS IoT ExpressLink SARA-R5 should appear. 3. ⚠ In the terminal application type the command AT+CONF EndPoint= and press . The configuration parameter name EndPoint is case sensitive. You should get OK back. 4. In the terminal application, type the command AT+CONNECT and press .
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started 2. Click Create things, select Create single thing and click Next. 3. With the u-blox AWS IoT ExpressLink SARA-R5 module still switched on, In the terminal application type the command AT+CONF? ThingName and press . ⚠ 4. The configuration parameter name ThingName is case sensitive. Copy the sequence of numeric characters (i.e., the equivalent of “357862090000000” in the image above) from the terminal.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started 5. ⚠ In the terminal application type the command AT+CONF? Certificate and press . You must use the name Certificate and NOT the more recently introduced Certificate pem, which is not supported/necessary in this release. 6. Copy the returned string, including -----BEGIN CERTIFICATE----- and -----END CERTIFICATE---- but not including the line beginning with OK, into a text file on your host machine named “ThingName.cert.pem”. 7.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started 8. Under Certificate, select Choose file and upload the file “ThingName.cert.pem” from step 6. 9. Under Certificate status, select Active and click Next. 10.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started 11. Type in a policy name of your choosing (e.g., “IoTDevPolicy”) and click Advanced mode. 12. Replace the contents of the black console area that appears with the single line of text below: { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "*", "Resource": "*" } ] } …then click Create to create the policy. ☞ Note: the examples in this document are intended only for development environments.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started 13. Return to the original browser tab, select the policy you just created (you can close the policy creation tab now) and click Create thing to complete your Thing creation. 14. Congratulations! You have successfully created a new Thing in your AWS account. 15. Return to the terminal application, type the command AT+CONNECT once more and press . After a short while you should receive the response OK 1 CONNECTED.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started 6 Connecting to and interacting with the AWS cloud We will use the MQTT client in the AWS IoT console to help us monitor the communication between your evaluation kit and the AWS Cloud. 1. Navigate to the AWS IoT console and select Test from the navigation pane to open the MQTT test client. 2. In Subscribe to a topic, enter # as the Topic filter and then click Subscribe. 6.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started After a short while, you should receive the response OK. You should see the Hello World! message appear on the AWS IoT console under the topic data. ☞ In poor coverage conditions there may be up to a 30 second delay between the message arriving in the AWS IoT console and OK being returned in the terminal application. 6.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started Wait for a handful of seconds for the message to arrive at the device (or monitor the EVENT pin) and then, in the terminal application, type the command AT+GET1 and press . You should receive the response OK Hello from AWS IoT console. 6.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started 7 Troubleshooting Problem Action No lights come on. Ensure power is supplied to the board, e.g., via the USB-C connector. No welcome message is displayed when an AT terminal application is attached to the board. Check that the white LED marked “On” is illuminated; the cellular module does NOT come on automatically when the board is powered, you must press the “SARA On” button for around one second to power the module on.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started 8 Features supported The firmware provided on the u-blox AWS IoT ExpressLink SARA-R5 module in this evaluation kit is a preview release and hence it does NOT support all the features of the AWS IoT ExpressLink command set. The following commands are supported: CONNECT, DISCONNECT, SLEEP2, RESET, FACTORY_RESET, SEND3, GET4, SUBSCRIBE, UNSUBSCRIBE, CONF, EVENT, DIAG, TIME5.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started Related documentation [1] [2] [3] [4] [5] [6] [7] ☞ AWS IoT ExpressLink website AWS IoT ExpressLink SARA-R5 Starter Kit product page AWS IoT ExpressLink programmers manual AWS IoT ExpressLink example code u-blox SARA-R5 series data sheet, UBX-19016638 u-blox SARA-R5 series system integration manual, UBX-19041356 ESP32 development guide For product change notifications and regular updates of u-blox documentation, register on our website, www.
AWS IoT ExpressLink SARA-R5 Starter Kit - Getting started Contact For complete contact information, visit us at www.u-blox.com. u-blox Offices North, Central and South America u-blox America, Inc. Phone: Email: +1 703 483 3180 info_us@u-blox.com Regional Office West Coast: Phone: Email: Headquarters Europe, Middle East, Africa Asia, Australia, Pacific u-blox AG Phone: +65 6734 3811 Email: info_ap@u-blox.com Support: support_ap@u-blox.com Phone: +41 44 722 74 44 Email: info@u-blox.
