Telit Wireless Solutions BlueMod plus S42/Central Safety guide

BlueMod+S42/Central Software User Guide
1VV0301318 Rev. 3 –2018-08-31
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 1 of 66
BlueMod+S42/Central
Software User Guide
1VV0301318 Rev. 3 –2018-08-31

BlueMod+S42/Central Software User Guide
1VV0301318 Rev. 3 –2018-08-31
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 2 of 66
APPLICABILITY TABLE
PRODUCT
BlueMod+S42/Central

BlueMod+S42/Central Software User Guide
1VV0301318 Rev. 3 –2018-08-31
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 3 of 66
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
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 4 of 66
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.
Copyright © Telit Communications S.p.A. 2018.

BlueMod+S42/Central Software User Guide
1VV0301318 Rev. 3 –2018-08-31
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 5 of 66
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
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 6 of 66
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
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 7 of 66
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
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 8 of 66
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
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 9 of 66
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
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 10 of 66
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.