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