Telit Wireless Solutions BlueMod plus S42/Central Safety guide

BlueMod+S42/Central Software User Guide

1VV0301318 Rev. 3 –2018-08-31

BlueMod+S42/Central

Software User Guide

1VV0301318 Rev. 3 –2018-08-31

BlueMod+S42/Central Software User Guide

1VV0301318 Rev. 3 –2018-08-31

APPLICABILITY TABLE

PRODUCT

BlueMod+S42/Central

BlueMod+S42/Central Software User Guide

1VV0301318 Rev. 3 –2018-08-31

SPECIFICATIONS 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

entirely 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.

BlueMod+S42/Central Software User Guide

1VV0301318 Rev. 3 –2018-08-31

Usage and Disclosure Restrictions

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.

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.

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.

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.

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.

BlueMod+S42/Central Software User Guide

1VV0301318 Rev. 3 –2018-08-31

Contents

1. Introduction...................................................................................................................7

1.1. Scope.......................................................................................................................7

1.2. Audience..................................................................................................................7

1.3. Contact Information, Support ...................................................................................7

1.4. Text Conventions.....................................................................................................8

1.5. Related Documents..................................................................................................8

2. Introduction...................................................................................................................9

2.1. Overview..................................................................................................................9

2.2. Feature Set ..............................................................................................................9

3. Modes and Connections............................................................................................10

3.1. AT Command Mode...............................................................................................10

3.1.1. Central Role as GATT Client......................................................................................10

3.1.2. Peripheral Role as Terminal I/O Server......................................................................18

3.1.3. Multiple GATT Connections.......................................................................................21

3.2. MUX Mode.............................................................................................................23

3.2.1. Central Role as GATT Client......................................................................................23

4. Startup Timing ............................................................................................................32

4.1. Firmware Version 3.002.........................................................................................32

5. Security .......................................................................................................................33

5.1. Pairable and Bondable Mode.................................................................................33

5.2. LE Secure Connections .........................................................................................33

5.3. Security Levels for Terminal I/O.............................................................................34

5.4. Connection Example Terminal I/O “Just Works” ....................................................38

5.5. Connection Example Terminal I/O “Passkey Entry” ...............................................39

6. UART Interface Control Protocol (UICP)...................................................................40

6.1. General Protocol Description .................................................................................40

6.2. Requirements of Using UICP on BlueMod+S42/Central........................................40

6.3. Connection Example between BlueMod+S42/Central and Host Controller............40

6.4. UICP Protocol States .............................................................................................41

6.4.1. Drive from "interface up" to "interface down" State.....................................................42

BlueMod+S42/Central Software User Guide

1VV0301318 Rev. 3 –2018-08-31

6.4.2. Drive from "interface down" to "interface up" State.....................................................43

6.5. Example of UICP Usage ........................................................................................44

6.5.1. State Change from "interface up" to "interface down" ................................................44

6.5.2. State Change from "interface down" to "interface up" ................................................45

7. NFC Handover.............................................................................................................46

7.1. NFC Mode..............................................................................................................46

7.2. NFC Handover Example ........................................................................................46

8. Firmware Upgrade......................................................................................................48

8.1. Serial Firmware Upgrade .......................................................................................48

8.1.1. Prerequisites for Serial Firmware Upgrade ................................................................48

8.1.2. Telit IoT Updater........................................................................................................48

8.1.3. Firmware Update Protocol on the Host System..........................................................50

8.2. Firmware Update over The Air (OTA) ....................................................................53

8.2.1. Firmware Update Over The Air using Nordic nRF Toolbox on Android ......................54

9. System OFF Mode ......................................................................................................57

9.1. Using System OFF Mode for Terminal I/O.............................................................57

10. LE Connection Parameters.....................................................................................59

10.1. Create a Bluetooth Low Energy Connection.......................................................59

10.2. Optimize the Connection Interval from Slave by using the Slave Latency..........60

10.3. Identify the Required Connection Interval...........................................................61

10.4. Update the Connection Parameters....................................................................62

10.5. Connection Examples of Different Use Cases....................................................62

10.5.1. Central Side Initiates a GATT Connection..............................................................63

10.5.2. Central Side Changed Initial Connection Parameter...............................................64

10.5.3. Peripheral Side Create a Connection Parameter Update Request .........................65

11. Document History ...................................................................................................66

BlueMod+S42/Central Software User Guide

1VV0301318 Rev. 3 –2018-08-31

1. Introduction

1.1. Scope

This document describes the usage of the BlueMod+S42/Central Bluetooth module.

1.2. Audience

This document is intended for Telit customers, especially system integrators, about to

implement Bluetooth modules in their application.

1.3. Contact Information, Support

For general contact, technical support, to report documentation errors and to order manuals,

contact Telit Technical Support Center (TTSC) at:

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

To register for product news and announcements or for product questions contact Telit

Technical Support Center (TTSC).

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.

BlueMod+S42/Central Software User Guide

1VV0301318 Rev. 3 –2018-08-31

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 usefulwhen integrating

the module.

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

1.5. Related Documents

[1] BlueMod+S42 Hardware User Guide, 1VV0301303

[2] BlueMod+S42/Central AT Command Reference, 80512ST10771A

[3] Bluetooth 4.0 Core Specification

[4] UICP+ UART Interface Control Protocol, 30507ST10756A

BlueMod+S42/Central Software User Guide

1VV0301318 Rev. 3 –2018-08-31

2. Introduction

2.1. Overview

This document describes the usage of the BlueMod+S42/Central Bluetooth module featuring

firmware version V3.001 or later.

For a detailed description of the commands refer to the BlueMod+S42/Central AT Command

Reference.

2.2. Feature Set

The combined central and peripheral BlueMod+S42/Central firmware includes the following

feature set:

•Handling for 4 parallel links (3 in central role and 1 in peripheral role)

•Generic GATT client support in central role

•Terminal I/O server role in peripheral role

•Up to 60 characteristics shared by all GATT clients

•10 configurable 128 bit UUIDs

•Fix pin for easy security

•AT command mode and multiplexing mode

•Easy control over all connection parameters

•Advanced power saving features like UICP and SYSTEMOFF

•Firmware over the air update

This document shows the practical use of some commands listed inthe AT command reference.

For command details it is referred to the BlueMod+S42/Central AT Command Reference.

BlueMod+S42/Central Software User Guide

1VV0301318 Rev. 3 –2018-08-31

3. Modes and Connections

In AT command mode the BlueMod+S42/Central supports 3 parallel central connectionsor one

peripheral Terminal I/O server connection. This means that the BlueMod+S42/Central stops

advertising (being connectable) as peripheral as soon a central connection is established.

When a peripheral Terminal I/O server connection is active, it is not possible to establish a

central connection to be used as GATT client.

The reason for this behavior is that a Terminal I/O connection in AT mode puts the serial

interface in data mode, where it is not possible to handle AT commands or events for an

additional central connection. Therefore it is not possible to use the ATD command for

connection establishment during a Terminal I/O connection.

To use peripheral and central connections in parallel the BlueMod+S42/Central supports the

multiplexing (MUX) mode. In this mode there is an always accessible AT command channel.

This makes it possible to handle all 4 links in parallel (3 central connections and one peripheral

Terminal I/O server connection). The host has to implement the simple to use multiplexing

protocol.

3.1. AT Command Mode

This chapter describes connection examples for different roles:

•Central role: GATT client connections to BLE peripheral devices in AT command mode

•Peripheral role as Terminal I/O server

3.1.1. Central Role as GATT Client

In central role the BlueMod+S42/Central supports the possibility to connect to any Bluetooth

low energy peripheral devices.

The following example lists the GATT connection in multiple steps include an explanation of

the different result messages.

Table of contents

Other Telit Wireless Solutions Control Unit manuals

Telit Wireless Solutions

Telit Wireless Solutions ML865G1 User manual

Telit Wireless Solutions

Telit Wireless Solutions LM940 User manual

Telit Wireless Solutions

Telit Wireless Solutions GC864-QUAD V2 Installation manual

Telit Wireless Solutions

Telit Wireless Solutions WL865E4-P User manual

Telit Wireless Solutions

Telit Wireless Solutions LE50-868 User manual

Telit Wireless Solutions

Telit Wireless Solutions LN940 WWAN M.2 User manual

Telit Wireless Solutions

Telit Wireless Solutions DE910-DUAL User manual

Telit Wireless Solutions

Telit Wireless Solutions G30 Installation manual

Telit Wireless Solutions

Telit Wireless Solutions LM960 Guide

Telit Wireless Solutions

Telit Wireless Solutions GL865-QUAD V4 Safety guide

Telit Wireless Solutions

Telit Wireless Solutions GE864-QUAD Automotive V2 Installation manual

Telit Wireless Solutions

Telit Wireless Solutions BlueMod+S42M Operating manual

Telit Wireless Solutions

Telit Wireless Solutions ME70-169 User manual

Telit Wireless Solutions

Telit Wireless Solutions GE864 DUAL V2 Installation manual

Telit Wireless Solutions

Telit Wireless Solutions UL865N3G Installation manual

Telit Wireless Solutions

Telit Wireless Solutions FN980m TLB Guide

Telit Wireless Solutions

Telit Wireless Solutions GM862PYT Series Technical specifications

Telit Wireless Solutions

Telit Wireless Solutions E922-3GR Series Installation manual

Telit Wireless Solutions

Telit Wireless Solutions ZE60-2.4 User manual

Telit Wireless Solutions

Telit Wireless Solutions GE866-QUAD Installation manual

Telit Wireless Solutions

Telit Wireless Solutions JF2 Installation manual

Telit Wireless Solutions

Telit Wireless Solutions HE863 Series Installation manual

Telit Wireless Solutions

Telit Wireless Solutions M.2 N930 Series Installation manual

Telit Wireless Solutions

Telit Wireless Solutions LE51-868S DemoUnit User manual

Popular Control Unit manuals by other brands

Festo

Festo Compact Performance CP-FB6-E Brief description

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Quick installation guide

JS Automation

JS Automation MPC3034A user manual

JAUDT

JAUDT SW GII 6406 Series Translation of the original operating instructions

Spektrum

Spektrum Air Module System manual

BOC Edwards

BOC Edwards Q Series instruction manual

KHADAS

KHADAS BT Magic quick start

Etherma

Etherma eNEXHO-IL Assembly and operating instructions

PMFoundations

PMFoundations Attenuverter Assembly guide

GEA

GEA VARIVENT Operating instruction

Walther Systemtechnik

Walther Systemtechnik VMS-05 Assembly instructions

Altronix

Altronix LINQ8PD Installation and programming manual

Eaton

Eaton Powerware Series user guide

WAGO

WAGO 750-407/040-000 manual

Sony

Sony CCU-590 Operation manual

Graco

Graco 25D614 instructions

Task Force Tips

Task Force Tips YE-RF-900 Instructions for installation, safe operation and maintenance

Shini

Shini SPV-U Series manual