Telit Bravo User Manual

Mod. 0809 2017-01 Rev.8

Bravo Evaluation Board

Getting started with OneEdge

1VV0301678 Rev.5– 2021-02-01

1VV0301678 Rev. 5 Page 2 of 39 01/02/2021

SPECIFICATIONS ARE SUBJECT TO CHANGE WITHOUT NOTICE

NOTICE

While reasonable efforts have been made to assure the accuracy of this document, Telit
assumes no liability resulting from any inaccuracies or omissions in this document, or from
use of the information obtained herein. The information in this document has been carefully
checked and is believed to be reliable. However, no responsibility is assumed for
inaccuracies or omissions. Telit reserves the right to make changes to any products
described herein and reserves the right to revise this document and to make changes from
time to time in content hereof with no obligation to notify any person of revisions or changes.
Telit does not assume any liability arising out of the application or use of any product,
software, or circuit described herein; neither does it convey license under its patent rights
or the rights of others.

It is possible that this publication may contain references to, or information about Telit
products (machines and programs), programming, or services that are not announced in
your country. Such references or information must not be construed to mean that Telit
intends to announce such Telit products, programming, or services in your country.

COPYRIGHTS

This instruction manual and the Telit products described in this instruction manual may be,
include or describe copyrighted Telit material, such as computer programs stored in
semiconductor memories or other media. Laws in the Italy and other countries preserve for
Telit and its licensors certain exclusive rights for copyrighted material, including the
exclusive right to copy, reproduce in any form, distribute and make derivative works of the
copyrighted material. Accordingly, any copyrighted material of Telit and its licensors
contained herein or in the Telit products described in this instruction manual may not be
copied, reproduced, distributed, merged or modified in any manner without the express
written permission of Telit. Furthermore, the purchase of Telit products shall not be deemed
to grant either directly or by implication, estoppel, or otherwise, any license under the
copyrights, patents or patent applications of Telit, as arises by operation of law in the sale
of a product.

COMPUTER SOFTWARE COPYRIGHTS

The Telit and 3rd Party supplied Software (SW) products described in this instruction
manual may include copyrighted Telit and other 3rd Party supplied computer programs
stored in semiconductor memories or other media. Laws in the Italy and other countries
preserve for Telit and other 3rd Party supplied SW certain exclusive rights for copyrighted
computer programs, including the exclusive right to copy or reproduce in any form the
copyrighted computer program. Accordingly, any copyrighted Telit or other 3rd Party
supplied SW computer programs contained in the Telit products described in this instruction
manual may not be copied (reverse engineered) or reproduced in any manner without the
express written permission of Telit or the 3rd Party SW supplier. Furthermore, the purchase
of Telit products shall not be deemed to grant either directly or by implication, estoppel, or
otherwise, any license under the copyrights, patents or patent applications of Telit or other
3rd Party supplied SW, except for the normal non-exclusive, royalty free license to use that
arises by operation of law in the sale of a product.

1VV0301678 Rev. 5 Page 3 of 39 01/02/2021

USAGE AND DISCLOSURE RESTRICTIONS

I. License Agreements

The software described in this document is the property of Telit and its licensors. It is
furnished by express license agreement only and may be used only in accordance with the
terms of such an agreement.

II. Copyrighted Materials

Software and documentation are copyrighted materials. Making unauthorized copies is
prohibited by law. No part of the software or documentation may be reproduced,
transmitted, transcribed, stored in a retrieval system, or translated into any language or
computer language, in any form or by any means, without prior written permission of Telit

III. High Risk Materials

Components, units, or third-party products used in the product described herein are NOT
fault-tolerant and are NOT designed, manufactured, or intended for use as on-line control
equipment in the following hazardous environments requiring fail-safe controls: the
operation of Nuclear Facilities, Aircraft Navigation or Aircraft Communication Systems, Air
Traffic Control, Life Support, or Weapons Systems (High Risk Activities"). Telit and its
supplier(s) specifically disclaim any expressed or implied warranty of fitness for such High
Risk Activities.

IV. Trademarks

TELIT and the Stylized T Logo are registered in Trademark Office. All other product or
service names are the property of their respective owners.

V. Third Party Rights

The software may include Third Party Right software. In this case you agree to comply with
all terms and conditions imposed on you in respect of such separate software. In addition
to Third Party Terms, the disclaimer of warranty and limitation of liability provisions in this
License shall apply to the Third Party Right software.

TELIT HEREBY DISCLAIMS ANY AND ALL WARRANTIES EXPRESS OR IMPLIED
FROM ANY THIRD PARTIES REGARDING ANY SEPARATE FILES, ANY THIRD PARTY
MATERIALS INCLUDED IN THE SOFTWARE, ANY THIRD PARTY MATERIALS FROM

WHICH THE SOFTWARE IS DERIVED (COLLECTIVELY “OTHER CODE”), AND THE

USE OF ANY OR ALL THE OTHER CODE IN CONNECTION WITH THE SOFTWARE,
INCLUDING (WITHOUT LIMITATION) ANY WARRANTIES OF SATISFACTORY
QUALITY OR FITNESS FOR A PARTICULAR PURPOSE.

NO THIRD PARTY LICENSORS OF OTHER CODE SHALL HAVE ANY LIABILITY FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED
AND WHETHER MADE UNDER CONTRACT, TORT OR OTHER LEGAL THEORY,
ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE OTHER CODE
OR THE EXERCISE OF ANY RIGHTS GRANTED UNDER EITHER OR BOTH THIS
LICENSE AND THE LEGAL TERMS APPLICABLE TO ANY SEPARATE FILES, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

1VV0301678 Rev. 5 Page 4 of 39 01/02/2021

APPLICABILITY TABLE

PRODUCTS

BRAVO EVALUATION KIT

1VV0301678 Rev. 5 Page 5 of 39 01/02/2021

CONTENTS

NOTICE 2

COPYRIGHTS .................................................................................................. 2

COMPUTER SOFTWARE COPYRIGHTS ....................................................... 2

USAGE AND DISCLOSURE RESTRICTIONS ................................................ 3

APPLICABILITY TABLE .................................................................................. 4

CONTENTS ...................................................................................................... 5

1. INTRODUCTION ............................................................................ 7

Overview ........................................................................................ 7

2. PREREQUISITES ........................................................................ 10

Bravo Board ................................................................................. 10

A browser ..................................................................................... 10

A host PC ..................................................................................... 10

Bravo documentation ................................................................... 10

3. CREATE YOUR ACCOUNT ON ONEEDGE ............................... 11

Register your account .................................................................. 11

3.1.1. Accept privacy policy and Terms and Conditions ......................... 14

Setup the thing definition and device profiles ............................... 14

3.2.1. Download the thing definition and device profile files ................... 14

3.2.2. Import the Thing definitions .......................................................... 15

3.2.3. Import the Device profiles ............................................................. 17

3.2.4. Import the object definitions (XML) ............................................... 18

3.2.5. Import the Triggers definition ........................................................ 20

4. ONBOARD YOUR BRAVO BOARD ........................................... 22

Get the Telit ID ............................................................................. 22

Create a new thing ....................................................................... 22

5. CONNECT BRAVO BOARD TO ONEEDGE ............................... 24

Use simWISE connectivity............................................................ 24

5.1.1. Set simWISE profile ..................................................................... 24

5.1.2. List available profiles .................................................................... 24

Disable WWAN connection in Windows ....................................... 24

5.2.1. Disable network adapter at runtime .............................................. 25

1VV0301678 Rev. 5 Page 6 of 39 01/02/2021

Connect the module ..................................................................... 25

Test LwM2M agent ....................................................................... 26

Deploy and run Environmental demo ........................................... 27

5.5.1. Browse data on the portal ............................................................ 32

Deploy and run Tampering demo ................................................. 32

Deploy and run 3D vector demo ................................................... 35

6. GLOSSARY AND ACRONYMS ................................................... 37

7. DOCUMENT HISTORY ................................................................ 38

1VV0301678 Rev. 5 Page 7 of 39 01/02/2021

1. INTRODUCTION

1.1. Scope

Scope of this document is to provide a quick getting start guide for Bravo Evaluation Kit and
OneEdge.

Overview

With Telit Bravo board evaluation kit and OneEdge you will be able to develop a full IoT solution
consisting of: data delivery for telemetry applications, triggers for alerting and monitoring, commands
for remote control of the device.
In addition to that, OneEdge features a fully-fledged Data management solution enabling developers
to onboard new devices, control their operational status and connectivity performances,
decommission faulty devices and manage software upgrades.

1.2. Audience

This document is intended for Telit Bravo Kit users.

1.3. Contact Information, Support

For general contact, technical support services, technical questions and report
documentation errors contact Telit Technical Support at:

• [e-mail]

• [e-mail]

• [e-mail]

Alternatively, use:
http://www.telit.com/support

For detailed information about where you can buy the Telit modules or for recommendations
on accessories and components visit:
http://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 feedback from the users of our information.

1VV0301678 Rev. 5 Page 8 of 39 01/02/2021

1.4. Text Conventions

Danger – This information MUST be followed or catastrophic equipment
failure or bodily injury may occur.

Caution or Warning – Alerts the user to important points about integrating the
module, if these points are not followed, the module and end user equipment
may fail or malfunction.

Tip or Information – Provides advice and suggestions that may be useful
when integrating the module.

All dates are in ISO 8601 format, i.e. YYYY-MM-DD.

1VV0301678 Rev. 5 Page 9 of 39 01/02/2021

1.5. Related Documents

[1] Bravo Board resource page https://www.telit.com/developer-zone/telit-bravo-

evaluation-kit/

[2] Bravo EVK HW User Guide, 1VV0301646
[3] Bravo EVK Quick Start Guide 1VV0301650
[4] ME910C1 HW User Guide, 1VV0301351
[5] ME910C1 Quick Start Guide, 80529NT11661A
[6] ME910C1 AT Reference Guide 80529ST10815A
[7] OneEdge getting started Guide 1VV0301585
[8] xE910 Global Form Factor Application Note, 80000NT10060A
[9] OneEdge for Bravo portal https://oneedge.devicewise.net/app/login

1VV0301678 Rev. 5 Page 10 of 39 01/02/2021

2. PREREQUISITES

Bravo Board

Make sure you have a Bravo Board evaluation kit. For full information please browse

https://www.telit.com/developer-zone/telit-bravo-evaluation-kit/ and request an evaluation

kit.

Bravo Board Evaluation Kit comes with different manuals and user
guides to help developers to get familiar with the board and build a
full IoT solution.

It is highly recommended to read the Bravo Quick Start Guide
first.

A browser

To connect your Bravo evaluation kit to OneEdge you will need a browser.

A host PC

Any host PC with a serial terminal tool (i.e. Tera Term) and UART/USB connection to the
module. Telit AT Controller (TATC) is recommended, please download it here [1]

Bravo documentation

The board comes with various documents and contains a 3.7V linear power supply. Itcan
be powered:

- Through the native USB port, using the supplied USB cable

- By connecting an external 5V DC power supply to the coaxial connector marked
“+5V”.

Powering the board through the USB port relies on the host device
(eg PC or USB hub) capability to provide at least 500 mA.

Using 2G connectivity requires 5V DC power supply, see below.

It is highly recommended to use either an external DC power
supply or a battery pack.

Please check carefully that the external power supply:

- Provides 5V DC (while not exceeding 7V at most)

- Can provide at least 600 mA continuously

Or connect a 3.7 V battery pack to the connector marked “Li-Po 3.7V”.

Please read carefully the battery pack and charging requirements
described in the Bravo EVK HW Manual.

1VV0301678 Rev. 5 Page 11 of 39 01/02/2021

3. CREATE YOUR ACCOUNT ON ONEEDGE

Warning – OneEdge for Bravo is a custom version of OneEdge with all
services available. Regular OneEdge accounts are not suitable for the
following Bravo onboarding process: please create a new account.
If you already have a Bravo Evaluation kit onboarded and, therefore, a
OneEdge for Bravo account, please log in with your existing account and
proceed to §4 to onboard your new Bravo Board.

Register your account

Go to https://oneedge.devicewise.net/app/login

1VV0301678 Rev. 5 Page 12 of 39 01/02/2021

Click on “Create Account” and look for an activation link in your email folder

1VV0301678 Rev. 5 Page 13 of 39 01/02/2021

All fields marked with asterisk are mandatory. Please make sure all fields are correctly

filled.

1VV0301678 Rev. 5 Page 14 of 39 01/02/2021

Warning – Organization names may be duplicated. Organizaton keys are
unique, please choose a different key value.

Figure 1 - The organization key is reserved or in use, please create a new one

3.1.1. Accept privacy policy and Terms and Conditions

Setup the thing definition and device profiles

Thing definition and device profiles define which capabilities are provided by the device.
Specifically, the device profile provides all the information to bind the LwM2M object to the

real properties, events and commands - the device data model.

3.2.1. Download the thing definition and device profile files

Please visit [1] and download the zip file containing OneEdge Demo resources, named
Bravo Sample Apps 1.0.3.

Into the archive you can find all the required JSON files for the available demos:
bravo_sample_apps_1.0.3\BRAVO_Environment_BSEC_Demo\json\bravo_Environmenta

lDemo_device_profile.json
bravo_sample_apps_1.0.3\BRAVO_Environment_BSEC_Demo\json\bravo_Environmenta

lDemo_thing_def.json

1VV0301678 Rev. 5 Page 15 of 39 01/02/2021

bravo_sample_apps_1.0.3\BRAVO_Rotation_Demo\json\bravo_3D­RotationDemo_device_profile.json

bravo_sample_apps_1.0.3\BRAVO_Rotation_Demo\json\ bravo_3D­RotationDemo_thing_def.json

bravo_sample_apps_1.0.3\BRAVO_Tampering_Demo\json\bravo_TamperDemo_thing_d
ef.json

bravo_sample_apps_1.0.3\BRAVO_Tampering_Demo\json\bravo_TamperDemo_device_
profile.json

bravo_sample_apps_1.0.3\BRAVO_Tampering_Demo\json\bravo_TamperDemo_triggers.
json

3.2.2. Import the Thing definitions

Select the three lines menu icon (hamburger menu), choose “Developer” then, under
“Things” section, “Things definition”.

Select “Import”

1VV0301678 Rev. 5 Page 16 of 39 01/02/2021

Click “Attach file” and select the “bravo_EnvironmentalDemo_thing_def.json”

Note – Please make sure that the JSON file imported on the thing definition
is reporting “thing definition” and not “device profile” in the name.

1VV0301678 Rev. 5 Page 17 of 39 01/02/2021

Import all the other *_thing_def.json files for the other apps repeating the steps above.

3.2.3. Import the Device profiles

Go back on the “Developer” section and select “Device Profiles”.

Here, click on “Import” in the top right corner and upload the
“bravo_EnvironmentalDemo_device_profile.json”

After the import procedure, a new device profile populates the list

1VV0301678 Rev. 5 Page 18 of 39 01/02/2021

Note – Make sure that the new item contains “device profile” and not “thing
definition”

After importing the device profile, click on the “edit” icon (marked in green in the above
screen) and make sure that the device profile objects are properly registered. See the
message in the screen below.

3.2.4. Import the object definitions (XML)

Go back on the “Developer” section and select “object registry”

1VV0301678 Rev. 5 Page 19 of 39 01/02/2021

Click on New object
Open the object_26251.xml file and paste the content into the text box as shown below

After submitting the code, make sure that the top page is showing the “object registered”
confirmation.

Import all the other *_device_profile.json files and related object XML files for the other
apps repeating the steps above.

1VV0301678 Rev. 5 Page 20 of 39 01/02/2021

3.2.5. Import the Triggers definition

Go back on the “Developer” section and select “Triggers”, then on the Actions Button on
the right, choose “Import”

Click “Attach file” and select the “bravo_TamperDemo_triggers.json”, then press Import

1VV0301678 Rev. 5 Page 21 of 39 01/02/2021

In the Triggers Table, identify the newly created trigger and press the “start” icon to make
it run.

The icon will change to an notifying the trigger is now running.

Import all the other *_triggers.json files for the other apps repeating the steps above.

1VV0301678 Rev. 5 Page 22 of 39 01/02/2021

4. ONBOARD YOUR BRAVO BOARD

Get the Telit ID

Please refer to the Bravo EVK Quick Start Guide [3] for information on how to
communicate with Bravo Board via AT commands through a serial connection.

To retrieve the Telit ID data, issue

• AT#TID to get the Telit ID. The command response will be similar to

#TID: xxxxxxxxxxxxxxxxxxxxxxxxxxx,1
OK

Take note of the Telit ID highlighted in red above (or copy it on a text editor): this ID it will
be needed for the onboarding process.

Create a new thing

On “Things” section, click “New Thing” button in the top right corner.

In the Create a new thing dialog, select “Telit Module”

A dialog appears: select “Bravo Board” thing definition

1VV0301678 Rev. 5 Page 23 of 39 01/02/2021

In the following screen, provide the Telit ID as “Identifier”

Click on “Find” and make sure that model, firmware and the other details are properly
populated.

Click on lwm2m tab and set the device profile previously imported as shown in the
screenshot below

Click “Add” to complete the new thing creation procedure

1VV0301678 Rev. 5 Page 24 of 39 01/02/2021

5. CONNECT BRAVO BOARD TO ONEEDGE

Use simWISE connectivity

simWISE is Telit embedded software-based SIM card. The SIM card operating system is
integrated directly in the modem system and enables device makers reducing the final
device BOM, optimize form-factor design and save on onboarding processes.

No need to install SIM trays, plug-in SIM cards or chip-based SIMs.
simWISE acts as a normal SIM card and therefore doesn’t require special integration with

the device, simWISE can even coexist with an external physical SIM card: that is why
Bravo Evaluation Kit is equipped with a physical SIM tray.

5.1.1. Set simWISE profile

Unless a physical SIM is inserted into the tray, you need to select simWISE profile. Type
the following AT command after a serial connection with the Bravo is established:

AT#VSIMSETPROF=1

If you want to use the physical SIM:

AT#VSIMSETPROF=0

You can check what profile is active with:

AT#VSIMSETPROF?
#VSIMSETPROF: 0

In this case the physical SIM is selected

5.1.2. List available profiles

If you have a physical SIM or multiple profiles in your Bravo Evaluation kit this command
is useful to get the ICCIDs

AT#VSIMLISTPROF
#VSIMLISTPROF: #ICCIDs

Disable WWAN connection in Windows

Windows 10 users: by default, the OS is detecting and taking control of ME910
cellular connection. Please ensure this option is disabled as described in the
following paragraph.

Whenever the Bravo Board is set up with a valid APN, Windows 10 network manager is
able to detect this valid configuration and can automatically start a Dial-up connection as
soon as the module is connected to the PC.

In this scenario the context is already enabled by Windows, the agents inside the module
will get an error when trying to perform any connection using the same PDP context.

To avoid this scenario, it’s necessary to disable the network adapter at runtime or change
the default setting in the Windows registry.

1VV0301678 Rev. 5 Page 25 of 39 01/02/2021

5.2.1. Disable network adapter at runtime

• Open the Device Manager Windows tool

• Open “Network adapters” section

• Search for “Telit USB WWAN Adapter” element

• Right-click and disable the device

Please note that this setting is applied only to the device currently connected to
the computer, so the user should repeat this procedure for all new devices
connected to the computer. If permanent setting is needed please check [7]

Connect the module

The LwM2M client requires an active connection in order to be able to start the LwM2M
handshake with the server and perform following interactions.

In case the LwM2M client is enabled before having an active connection, it will stay on hold
until a data connection is active.

To manually connect the module and then enable the LwM2M connection please follow the
steps:

1. Set the PDP context to be used by the LwM2M client (by default PDP 1 is used):

AT+CGDCONT=1, "IP","YOUR_APN".

1VV0301678 Rev. 5 Page 26 of 39 01/02/2021

For simWISE, the setting shall be:
AT+CGDCONT=1, "IP","NXT17.NET"
Refer to [6] §3.6.4 for further information

2. Quickly test that connectivity is working. Issue

AT#PING="www.telit.com" and wait for response like this #PING:
01,"35.202.235.194",4,4

3. Let the LwM2M client handle the connection and the PDP context startup by issuing:

AT#SGACT=1,0
This sets the connection in inactive state.

Test LwM2M agent

1. Run the AT#LWM2MENA=1 (refer to the AT definition: AT#LWM2MENA=<en>).

2. The LwM2M client will perform the Bootstrap (only the first time or when forced)

and the terminal will receive the following URC:

LWM2M-TLT:"BOOTSTRAPPING",SSID=0,"coaps://bs.telit.io"

LWM2M-TLT:"BOOTSTRAPPED",SSID=0,"coaps://bs.telit.io"

3. After the Bootstrap, the LwM2M client will perform the registration on the DM

server, and if the service is enabled through AT#LWM2MW=0,33211,0,0,1,1
command, the following URC are received:

LWM2M-TLT:"REGISTERING",SSID=99,"coaps://api-

dev.devicewise.com"

LWM2M-TLT:"REGISTERED",SSID=99,"coaps://api-dev.devicewise.com"

At this point, as soon as the bootstrap phase has been completed, the user must check on
the IoT Portal if the registration has been completed correctly, on the IoT Portal > Things >
Overview the “Last seen” field reports:

• Lifetime expired/not expired (green/red clip)

• Elapsed time since the last Registration Update

To make sure that the connection is up, it is recommended to check that the PDP context
settings are correct. After enabling LwM2M, context should be active: this can be verified
by running AT+COPS? and AT+CGACT?
The following examples show an active PDP context is present on slot 1

AT+CGACT?

+CGACT: 1,1
+CGACT: 2,0
+CGACT: 3,0
+CGACT: 4,0
+CGACT: 5,0
+CGACT: 6,0

OK).

at+cops?

+COPS: 0,0,"vodafone IT",0

OK

1VV0301678 Rev. 5 Page 27 of 39 01/02/2021

For more details about the Lifetime parameter check [7] §5.3.2 Adjust the Lifetime
parameter

Figure 5-2

Well Done – Your onboarding is done. Please proceed with the next steps to
set up the module with the environmental demo application

Deploy and run Environmental demo

To run the application, it is required to load two files on the Bravo board:

• m2mapz.bin (the application proper binary file)

• object_26251.xml the LwM2M object definition (please refer to §3.2.4 for the

XML)

Files are available in “Bravo Sample Apps SDK” archive file hosted on [1]. Files are in
bravo_sample_apps_1.0.3\BRAVO_Environment_BSEC_Demo\bin\m2mapz.bin
bravo_sample_apps_1.0.3\BRAVO_Environment_BSEC_Demo\object_26251.xml

In this section, Telit AT Controller tool (TATC from now on) will be used to send the
commands and store the files content. It can be downloaded from [1]

Please follow the steps below to deploy the files and start the application.

1. Be sure to have both m2mapz.bin and object_26251.xml files available locally

2. Turn the Bravo Board ON by pressing the ON_OFF button for at least 5 seconds

3. Open Telit AT Controller and set the COM port number and parameters from the

Settings button

1VV0301678 Rev. 5 Page 28 of 39 01/02/2021

4. Press the connect button

5. The device will reply with some details (IMEI, models, FW release). Press the AT

Terminal button

6. Send the command

1VV0301678 Rev. 5 Page 29 of 39 01/02/2021

AT#M2MWRITE=/mod/object_26251.xml,1971

Where “1971” is the file size in bytes.
The device will reply with a prompt

>>>

7. Now send the file content by pressing the Transfer Data button

A popup window will allow to browse and select the proper file

1VV0301678 Rev. 5 Page 30 of 39 01/02/2021

The file content will be uploaded into the module. An OK is received on the
terminal.

8. Repeat the same procedure for the binary file, using the command below

AT#M2MWRITE=m2mapz.bin,194208,1

9. Configure the application to be executed from next boot-up

AT#M2MRUN=2,m2mapz.bin

10. Restart the module and run the application

AT+M2M=4,10

11. The application will start and print the output on USB 1 (FTDI) port. AT the first

boot, it will check for the xml file and properly load it, then automatically reboot.

1VV0301678 Rev. 5 Page 31 of 39 01/02/2021

At the next boot, the application will run the proper environmental demo, reading
data from the sensor and sending them to the OneEdge portal.

1VV0301678 Rev. 5 Page 32 of 39 01/02/2021

5.5.1. Browse data on the portal

After deploying the Environmental demo and connecting to OneEdge, it is possible to
observe the data transferred to the portal.

To check for detailed information, please go to LwM2M - object browser as shown in the
picture below.

Deploy and run Tampering demo

To run the application, it is required to load two files on the Bravo board:

• m2mapz.bin (the application proper binary file)

• object_26242.xml the LwM2M object definition (please refer to §3.2.4 for the

XML)

Files are available in “Bravo Sample Apps SDK” archive file hosted on [1] . Files are in
bravo_sample_apps_1.0.3\BRAVO_Tampering_Demo\bin\m2mapz.bin
bravo_sample_apps_1.0.3\BRAVO_Tampering_Demo\object_26242.xml

To run this demo, the same thing from the Environmental demo will be reused. This
requires changing the thing definition and the device profile for the thing.

From the thing Overview, press on the Change definition button, then select Bravo Board
– TamperDemo thing definition from the list.

1VV0301678 Rev. 5 Page 33 of 39 01/02/2021

Press Change Definition button.

The portal will prompt to accept the changes, as existing properties/alarms or other
definitions will be replaced with the new schema. Press Submit to accept.

To change the device profile, from the thing Overview press Actions button, then Edit.

In the Editing view, change the device profile to Bravo Board – TamperDemo profile, then
press Update.

1VV0301678 Rev. 5 Page 34 of 39 01/02/2021

Follow the same steps shown in §5.5 to load the files into the module, then start the
application.

After it starts, in the Alarms tab the “STILL” state will be shown.

As soon as the board is moved, the device will recognize the tampering event and update
the portal:

Additional states will be shown depending on the computed status:

The same values are also provided in attributes tab with a numeric value for each event.

1VV0301678 Rev. 5 Page 35 of 39 01/02/2021

Deploy and run 3D vector demo

To run the application, it is required to load two files on the Bravo board:

• m2mapz.bin (the application proper binary file)

• object_26250.xml the LwM2M object definition (please refer to §3.2.4 for the

XML)

Files are available in “Bravo Sample Apps SDK” archive file hosted on [1] . Files are in
bravo_sample_apps_1.0.3\BRAVO_Rotation_Demo\bin\m2mapz.bin
bravo_sample_apps_1.0.3\BRAVO_Rotation_Demo\object_26250.xml

To run this demo, the same thing from the previous demos will be reused. This requires
changing the thing definition and the device profile for the thing.

Follow the same steps shown in §5.6 to change thing definition and device profile for the
thing to 3D RotationDemo profiles.

Follow the same steps shown in §5.5 to load the files into the module.

Once the app starts, it will constantly provide the read values for X, Y, Z and W values, as
well as the computed accuracy. These values can be seen in the Properties tab on the
Thing page.

1VV0301678 Rev. 5 Page 36 of 39 01/02/2021

1VV0301678 Rev. 5 Page 37 of 39 01/02/2021

6. GLOSSARY AND ACRONYMS

Description

APN

Access Point Name – it is the name of a gateway between a GSM,
GPRS, 3G or 4G mobile network and another computer network
(usually the Internet)

DC

Direct Current

GPIO

General Purpose Input Output

IMEI

International Mobile Equipment Identity – it is a unique number that is
associated with all 2G-5G devices

IMSI

International Mobile Subscriber Identity – it is a unique number that is
associated with all SIM cards

I/O

Input Output

JSON

JavaScript Object Notation. It is a text-based data interchange format
designed for transmitting and storing structured data, both human
readable and machine readable.

LwM2M

Lightweight Machine To Machine – IoT Application Protocol designed
for bidirectional communication between devices and a central server

PC

Personal Computer

PCB

Printed Circuit Board

PDP

Packed Data Protocol – Often used in conjunction with “context” to
define a specific data structure that allows the device to communicate
using the Internet Protocol

RTC

Real Time Clock

SIM

Subscriber Identification Module

SPI

Serial Peripheral Interface

UART

Universal Asynchronous Receiver Transmitter

USB

Universal Serial Bus

URC

Unsolicited Result Code – it is the message returned by the mobile
equipment (the modem) that is not a direct result of an AT command. It
could be a soft interrupt or the response of an AT asynchronous
command

XML

eXtensible Markup File. It is a markup language that defines a set of
rules for encoding documents in a format that is both human-readable
and machine-readable

WWAN

Wireless wide area network (WWAN), is a form of wireless network
usually associated to mobile broadband connection.

1VV0301678 Rev. 5 Page 38 of 39 01/02/2021

7. DOCUMENT HISTORY

Revision

Date

Changes

1

2020-09-07

Initial Revision

2

2020-09-20

Cosmetic review

3

2020-10-01

Environmental demo description

4

2020-10-21

Added all samples description

5

2020-12-11

Added simWISE connectivity section, added
APN configuration, improved the connectivity
step

Mod. 0809 2017-01 Rev.8