Telit Wireless Solutions Bravo Installation and operating instructions

Telit Bravo Board Food
Delivery Demo Application
Example
Application Note
80652NT11950A Rev. 1 –2021-11-24
Telit Technical Documentation

Telit Bravo Food Delivery Application example
80652NT11950A Page 2of 35 2021-11-24
Not Subject to NDA
APPLICABILITY TABLE
PRODUCTS
TELIT BRAVO EVALUATION KIT

Telit Bravo Food Delivery Application example
80652NT11950A Page 3of 35 2021-11-24
Not Subject to NDA
CONTENTS
APPLICABILITY TABLE 2
CONTENTS 3
1. INTRODUCTION 5
Scope 5
Audience 5
Contact Information, Support 5
Symbol Conventions 6
Related Documents 6
2. PREREQUISITES 7
Hardware 7
2.1.1. Push-button 8
Software 10
3. SOFTWARE SETUP 11
Arduino IDE 11
Bravo Board Sensors 11
3.2.1. Firmware 11
3.2.2. Binary application 11
Telit AT Controller 13
4. SETUP IOT PORTAL ONEEDGE 19
Register your account 19
Setup the thing definition and device profile 21
4.2.1. Import the Thing definition 21
4.2.2. Import Device profiles 23
4.2.3. Import Trigger 24
4.2.4. Create a new Thing 24
Connection to the IoT portal 24
Add the 3336 and 32015 objects 24
5. STARTING THE TRACKING 26
6. STOP THE TRACKING 28

Telit Bravo Food Delivery Application example
80652NT11950A Page 4of 35 2021-11-24
Not Subject to NDA
7. PRODUCT AND SAFETY INFORMATION 29
Copyrights and Other Notices 29
7.1.1. Copyrights 29
7.1.2. Computer Software Copyrights 29
Usage and Disclosure Restrictions 30
7.2.1. License Agreements 30
7.2.2. Copyrighted Materials 30
7.2.3. High Risk Materials 30
7.2.4. Trademarks 31
7.2.5. Third Party Rights 31
7.2.6. Waiwer of Liability 31
Safety Recommendations 32
8. GLOSSARY 33
9. DOCUMENT HISTORY 34

Telit Bravo Food Delivery Application example
80652NT11950A Page 5of 35 2021-11-24
Not Subject to NDA
1. INTRODUCTION
Scope
This document describes a Food Delivery tracking application example for an Arduino
Zero-like board, connected to the Telit Bravo board.
Audience
This document is intended for Telit customers, especially system integrators, about to
implement their applications using the Telit Bravo Evaluation kit.
Contact Information, Support
For general contact, technical support services, technical questions and report of
documentation errors contact Telit Technical Support at:
• TS[email protected]
• TS[email protected]
• TS[email protected]
• TS[email protected]
• TS[email protected]
Alternatively, use:
https://www.telit.com/contact-us/
For detailed information about where you can buy the Telit modules or for
recommendations on accessories and components visit:
https://www.telit.com
Our aim is to make this guide as helpful as possible. Keep us informed of your comments
and suggestions for improvements.
Telit appreciates the user feedback on our information.

Telit Bravo Food Delivery Application example
80652NT11950A Page 6of 35 2021-11-24
Not Subject to NDA
Symbol Conventions
Danger: This information MUST be followed or catastrophic
equipment failure or personal injury may occur.
Warning: Alerts the user on important steps about the module
integration.
Note/Tip: Provides advice and suggestions that may be useful when
integrating the module.
Electro-static Discharge: Notifies the user to take proper grounding
precautions before handling the product.
Table 1: Symbol Conventions
All dates are in ISO 8601 format, that is YYYY-MM-DD.
Related Documents
•ME310C1/ML865C1 AT commands Reference Guide, 80529ST10815A Rev.15
•Bravo EVK HW User Guide, 1VV0301646 Rev. 4
•Bravo Evaluation Board Quick Start Guide, 1VV0301650 Rev. 3
•LwM2M AT Commands Reference Guide, 80529ST10974A Rev. 4

Telit Bravo Food Delivery Application example
80652NT11950A Page 7of 35 2021-11-24
Not Subject to NDA
2. PREREQUISITES
Hardware
You will need a Telit Bravo board, a GNSS antenna, an Arduino Zero or equivalent board
(with ARM Cortex M0+ processor), a pushbutton (to start/stop the tracking) and a micro-
USB cable to connect the host PC to the Arduino board.
A description of the Telit Bravo Evaluation kit can be found at:
https://www.telit.com/developer-zone/telit-bravo-evaluation-kit/
The Bravo Board Evaluation Kit requires some configurations and proper
handling.
Please read carefully the HW User Guide and Quick Start Guide first.
•Connect the Bravo board at the Arduino Zero board through the Berg connectors
previously soldered (as reported in the Bravo Quick Start Guide)
Figure 1 - Arduino Berg connections

Telit Bravo Food Delivery Application example
80652NT11950A Page 8of 35 2021-11-24
Not Subject to NDA
•External power is needed for both Arduino and Bravo board (5V DC)
•Set UART SEL dip switches as shown below:
Figure 2 - UART dip switches
•Insert a SIM card without PIN enabled or use the SimWISE virtual SIM profile as
explained in " Bravo Getting Started OneEdge” Guide.
2.1.1. Push-button
The sketch requires a push-button to control tracking operations. Picture 3 shows an
example connection with:
•One pin of the push-button connected to Ground
•One pin of the push-button connected to GPIO2, and with a 10KOhms pull-up
resistor to VCC
With this configuration, in the sketch you should redefine:
#define PINBUTTON <USER_PUSHBUTTON_GPIO_PIN>
To
#define PINBUTTON 2

Telit Bravo Food Delivery Application example
80652NT11950A Page 9of 35 2021-11-24
Not Subject to NDA
Figure 3 - Example push-button connection
Figure 4 - Schematic
A complete push-button connection example can be found at the link:
https://www.arduino.cc/en/Tutorial/BuiltInExamples/Button

Telit Bravo Food Delivery Application example
80652NT11950A Page 10 of 35 2021-11-24
Not Subject to NDA
Software
The software applications used on the PC are Arduino IDE version 1.8.15 and a serial
terminal tool (i.e. Tera Term). Telit AT Controller (TATC) is recommended, please
download it from:
https://www.telit.com/developer-zone/telit-bravo-evaluation-kit/
Also install Windows 10 Drivers, available at the same page.
You will also need a browser to connect the board with OneEdge.

Telit Bravo Food Delivery Application example
80652NT11950A Page 11 of 35 2021-11-24
Not Subject to NDA
3. SOFTWARE SETUP
Arduino IDE
Download the Arduino IDE and the Arduino library for Telit module ME310G1 at
https://github.com/telit/arduino-me310-library.
The minimum requirement is release 2.8.0 or higher.
To add the library, go on Sketch->Include library->Add .ZIP Library and select the folder
or ZIP file which would you import.
Bravo Board Sensors
3.2.1. Firmware
Verify that the ME910C1-WW firmware version is the one shown below:
AT#SWPKGV
30.01.800-P0B.800100
M0B.800005
P0B.800100
A0B.800000
OK
If required, please contact TS[email protected] to receive the Firmware Updater.
3.2.2. Binary application
Download the BSENS binary application with USB0 logs from
https://github.com/telit/bravo-at-sensors/releases/tag/v1.0.5
Direct link:
https://github.com/telit/bravo-at-
sensors/releases/download/v1.0.5/1.0.5_30_01_XX0_0_USB0_binary.zip

Telit Bravo Food Delivery Application example
80652NT11950A Page 12 of 35 2021-11-24
Not Subject to NDA
Extract the zip file: inside the archive there will be a folder called
“bravo_test_multisensors_ondemand”. It contains a file named “m2mapz.bin”, which is
the binary file providing custom AT commands to interface with the sensors on the Bravo
board.
Right-Click on the m2mapz.bin file and select properties to retrieve the file size
Figure 5 - File size
In this case, 245632 bytes.
Telit AT Controller can be used to upload the binary file inside the Bravo Board ME910C1-
WW module. Connect a microUSB cable to the Bravo board port marked as “xE910”. Two
modem ports will be visible in the Device Manager:

Telit Bravo Food Delivery Application example
80652NT11950A Page 13 of 35 2021-11-24
Not Subject to NDA
Figure 6 - Modem ports
Telit AT Controller
After the installation, double click on Telit AT Controller icon to launch the application:
Figure 7 - Telit AT controller icon
Click on the icon marked in red.

Telit Bravo Food Delivery Application example
80652NT11950A Page 14 of 35 2021-11-24
Not Subject to NDA
Figure 8 - Setting icon
In the next window, set the parameters like in Figure 7. Then click on OK button

Telit Bravo Food Delivery Application example
80652NT11950A Page 15 of 35 2021-11-24
Not Subject to NDA
Figure 9 - Setting window
Upon configuration, click on Connect button
Module information such as IMEI, Manufacter name, Model name an FW release will be
displayed. Now click on AT Terminal button

Telit Bravo Food Delivery Application example
80652NT11950A Page 16 of 35 2021-11-24
Not Subject to NDA
Figure 10 - Telit AT Console
Send the following command:
AT#M2MWRITE="m2mapz.bin",245632,1
After sending the command AT#M2MWRITE, a prompt >>> will appear: it indicates that
the module is waiting for the upload of the .xml file. Click on the Transfer Data button
marked in red in Figure 9 and select the m2mapz.bin file.

Telit Bravo Food Delivery Application example
80652NT11950A Page 17 of 35 2021-11-24
Not Subject to NDA
Figure 11 - File write
Figure 12 - Provide binary file
The transfer process will start:
Figure 13 - Transferring

Telit Bravo Food Delivery Application example
80652NT11950A Page 18 of 35 2021-11-24
Not Subject to NDA
And once completed, the module will reply OK.
Figure 14 - Transfer complete
Lastly, send the following AT commands:
AT#M2MRUN=2,"m2mapz.bin"
And
AT+M2M=1
The second command will cause a module reboot. The Software configuration on the
Bravo Board is now complete.

Telit Bravo Food Delivery Application example
80652NT11950A Page 19 of 35 2021-11-24
Not Subject to NDA
4. SETUP IOT PORTAL ONEEDGE
To manage the module through the IoT portal, it is necessary to have an account on
OneEdge IoT platform.
Register your account
Go to https://portal-dev.telit.com/app/login .
Figure 15 - Log in page
If you already have an account, please skip this and continue reading from 4.2 Setup the
thing definition and device profile .
Click on “Create account”, enter your email and check your email folder for an activation
link.

Telit Bravo Food Delivery Application example
80652NT11950A Page 20 of 35 2021-11-24
Not Subject to NDA
Figure 16 - Activation link
Click on link or copy and paste the link to your browser. The following form will appear:
Figure 17 - Account creation
The fields marked with * are mandatory. Please make sure all fields are correctly filled.