Telit Wireless Solutions BlueMod plus S42/Central Software User's Manual

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-SRD@telit.com
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 useful when 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 in the 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 connections or 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.
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 11 of 66
3.1.1.1. Searching for Available Peripheral Devices
If the Bluetooth address of the peripheral device is unknown the BlueMod+S42/Central needs to scan for available peripheral devices first.
AT+LESCAN=GATT D0A4E9658F65,t3 RSSI:-60 TYPE:CONN NAME:BM+S 8F65 MNF:8F0009B0011000 UUID:FEFB DE338F0D1A22,t3 RSSI:-68 TYPE:CONN NAME:BM+S 1A22 MNF:8F0009B0011000 UUID:FEFB 0080254978B3,t2 RSSI:-62 TYPE:CONN NAME:BM+SR 7 MNF:8F0009B0011000 UUID:53544D544552494F5345525631303030 UUID:FEFB F1B9EB41D81E,t3 RSSI:-57 TYPE:CONN NAME:TESTDEVICE UUID:FF00 008025001162,t2 RSSI:-68 TYPE:CONN NAME:BM+SR 1 MNF:8F0009B0011000 UUID:53544D544552494F5345525631303030 UUID:FEFB OK
This output lists 5 different peripheral devices with different services.
To list peripheral devices with a specific UUID it is possible to add this UUID value in the AT+LESCAN command.
AT+LESCAN=uFF00 F1B9EB41D81E,t3 RSSI:-57 TYPE:CONN NAME:TESTDEVICE UUID:FF00 OK
The found peripheral device includes the following information: Bluetooth address and type: F1B9EB41D81E,t3
Signal strength in dbm: RSSI:-57 Advertisement type: TYPE:CONN Device name: NAME:TESTDEVICE Service UUID: UUID:FF00
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 12 of 66
3.1.1.2. Create GATT Connection
To establish a GATT connection to a peripheral device it is required to initiate a call request to the unique Bluetooth address.
ATDF1B9EB41D81E,t3,GATT CONNECT GATT 0x10
The BlueMod+S42/Central reports the created GATT connection with the result message „CONNECT“ include the connection type „GATT“ and a connection handle “0x10”.
This connection handle is not set to a fixed value and will be different for each connection. The given connection handle is required for further activities onto this peripheral device.
3.1.1.3. Discovering Services and Characteristics
After the GATT connection was established the BlueMod+S42/Central should search for available services and their characteristics using the AT+LESRVD command.
AT+LESRVD=0x10 UUID:1800 UUID:1801 UUID:180A UUID:FF00 OK
The BlueMod+S42/Central reports a list of GATT services from the peripheral device.
This list of available services also includes the UUID: “FF00”. This UUID was listed during
the LESCAN result of this peripheral device as well. If the required service UUID is already known, the service search function could be skipped.
In addition to the service UUID value it is required to get the characteristic values of the required service UUID.
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 13 of 66
AT+LESRVD=0x10,uFF00 UUID:FF00 0x0011 PROP:0x3E UUID:FF01 0x0014 PROP:0x3E UUID:FF02 0x0017 PROP:0x3E UUID:FF03 0x001A PROP:0x08 UUID:FF04 0x001C PROP:0x04 UUID:FF05 0x001E PROP:0x02 UUID:FF06 0x0020 PROP:0x10 UUID:FF07 0x0023 PROP:0x20 UUID:FF08 0x0026 PROP:0x30 UUID:FF09 0x0029 PROP:0x3E UUID:FF0A 0x002C PROP:0x3E UUID:FF0B 0x002F PROP:0x3E UUID:FF0C 0x0032 PROP:0x3E UUID:FF0D 0x0035 PROP:0x3E UUID:0000FF0A000010008000008025000000 0x0038 PROP:0x3E UUID:0000FF0B000010008000008025000000 0x003B PROP:0x3E UUID:0000FF0C000010008000008025000000 0x003E PROP:0x3E UUID:0000FF0D000010008000008025000000 OK
The BlueMod+S42/Central reports a list of GATT characteristics of the requested GATT service UUID: “FF00” from the peripheral device. This list of characteristics includes all characteristic specific values like, characteristic handle, characteristic properties, characteristic UUID.
The following example lists the information of the first characteristic in details: characteristic handle: 0x0011
characteristic properties: PROP:0x3E characteristic UUID: UUID:FF01
The characteristic handle is required for all access functions to use with this characteristic. The characteristic properties inform about the possible access functions available on this
characteristic, like: read, write, write without response, notify, indicate. In this example the properties PROP: 0x3E with the characteristic handle 0x0011 are set to all possible properties.
The characteristic UUID identifies the characteristic ID within this service.
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 14 of 66
3.1.1.4. Writing Data to a Characteristic
To write data to a characteristic it is required that the properties of this characteristic support “write” or “write without response”.
There are two different options to write data to the characteristic:
AT+LEWRITE: Initiate a write with response access
to the characteristic
AT+LEWRITECMD: Initiate a write without response access
(write command) to the characteristic
In addition it is important to know the data size of the GATT characteristic.
This information is listed in the service specification of the addressed service. In the example the data size is defined to two bytes. To write two data bytes (0xaa and 0xbb) to the GATT server on the peripheral side the host
controller needs to use the connection handle and characteristic handle from the ATD and AT+LESRVD commands. Additionally the data content has to be added to the command line.
AT+LEWRITE=0x10,0x0011,aabb OK
The command “AT+LEWRITE” uses a “write request” command which is confirmed by the peripheral side with a “write response” message.
The result “OK” means that the value was written to the peripherals GATT server successfully.
AT+LEWRITECMD=0x10,0x0011,aabb OK
The command “AT+LEWRITECMD” uses a “write command” which is not confirmed by the peripheral side. The result “OK” means that the data was sent over the air.
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 15 of 66
3.1.1.5. Reading Data from a Characteristic
To read data from a characteristic it is required that the properties of this characteristic supports “read”, “notifyor indicate.
To read data bytes from a characteristic of the GATT server on the peripheral side the host controller needs to use the connection handle and characteristic handle from the ATD and AT+LESRVD commands.
AT+LEREAD=0x10,0x0011 LEREAD:0x10,0x0011,AABB
OK
The answer is separated into two parts:
The result message “OK” reports that reading to the required connection handle and
characteristic handle was successful.
The “LEREAD:0x10,0x0011,AABB” message reports the read data of the requested connection handle “0x10” and characteristic handle “0x0011”.
The data is formatted as a hexadecimal stream “AABB” that includes two bytes 0xAA and
0xBB.
3.1.1.6. Reading Data with Indications or Notifications
Indications and notifications are messages that inform the GATT client when a characteristic on the GATT server changes its value.
INDICATIONS: The GATT client generated a response to the GATT server when
receiving data
NOTIFICATIONS: The GATT client generated no response to the GATT server when
receiving data This feature has to be enabled by the client for a specific characteristic. It is not possible to enable indications and notifications at the same time. To use this feature, it is required that the properties of the characteristic supports “notify” or
“indicate”. This information is given in the service discovery for the characteristic in the “PROP” value.
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 16 of 66
3.1.1.6.1. Enable Notifications:
AT+LECCCD=0x10,0x0011,1 OK
The result message “OK” reports that activating notifications to the required connection handle and characteristic handle was successful.
When the data of this characteristic on the GATT server changed to “0x36, 0x37” the
BlueMod+S42/Central generates an event (“LENOTI”) that reports these changes:
LENOTI:0x10,0x0011,3637
The reported “LENOTI” event of the BlueMod+S42/Central contains the new data of the
characteristic with handle “0x0011” and connection handle “0x10”. The data is formatted as a hexadecimal stream “3637” that includes two bytes 0x36 and 0x37.
Every data change on the remote GATT server characteristic generates a new “LENOTI” event until the notifications to this characteristic are switched off.
3.1.1.6.2. Disable Notifications:
AT+LECCCD=0x10,0x0011,0 OK
The result message “OK” reports that deactivating the notifications to the required connection handle and characteristic handle was successful.
3.1.1.6.3. Enable Indications:
AT+LECCCD=0x10,0x0011,2 OK
The result message “OK” reports that activating indications to the required connection handle
and characteristic handle was successful.
When the data of this characteristic on the GATT server changed to “0x36, 0x38” the
BlueMod+S42/Central generates an event (“LEIND”) that reports these changes:
LEIND:0x10,0x0011,3638
The reported “LEIND” event of the BlueMod+S42/Central contains the new data of the characteristic with handle “0x0011” and connection handle “0x10”.
The data is formatted as a hexadecimal stream “3638” that includes two bytes 0x36 and 0x38. Every data change on the remote GATT server characteristic generates a new “LEIND” event
until the indications to this characteristic are switched off.
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 17 of 66
3.1.1.6.4. Disable Indications:
AT+LECCCD=0x10,0x0011,0 OK
The result message “OK” reports that deactivating the indications to the required connection handle and characteristic handle was successful.
3.1.1.6.5. Close Connection:
When the connection is not needed anymore, it could be disconnected. To close a GATT connection to a peripheral device the host controller needs to use the connection handle.
ATH=0x10 NO CARRIER 0x10
The response of the disconnect request “ATH” is the event “NO CARRIER” followed by disconnected connection handle.
The same event is reported when the remote peripheral disconnects the connection. It is also possible to disconnect all existing GATT connection to different peripheral devices by using the GPIO “HANGUP”.
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 18 of 66
3.1.2. Peripheral Role as Terminal I/O Server
A Terminal I/O connection to the BlueMod+S42/Central can be created from each Bluetooth Low Energy device that supports the Terminal I/O client role.
Telit provide the Terminal I/O client implementation for iOS and Android. To establish a Bluetooth Low Energy connection from a smartphone to the
BlueMod+S42/Central the "Terminal IO Utility" app from Telit needs to be installed on the smartphone.
The following QR-Codes provide the link to download the "Terminal IO Utility" app.
iOS
Logo
Android
The Terminal IO Utility app allows the user to connect to Terminal I/O peripheral devices (BlueMod+S42/Central) and exchange data providing a simple terminal emulation.
As soon as the connection is established data can be sent from the smartphone to BlueMod+S42/Central and vice versa.
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 19 of 66
3.1.2.1. Incoming Terminal I/O Connection
For a Terminal I/O connection it is necessary that the Terminal I/O service and the advertising mode are enabled. This is the default behavior of the BlueMod+S42/Central.
The BlueMod+S42/Central signals an incoming Terminal I/O connection with the following event:
RING
CONNECT TIO 0x01
The BlueMod+S42/Central report the incoming Terminal I/O connection with the result
message “RING”. The established Terminal I/O connection is reported with the message
„CONNECT“ including the connection type „TIO“ and a connection handle “0x01”.
The given connection handle is required for detailed activities onto this Terminal I/O connection.
After reporting the “CONNECT” result message the BlueMod+S42/Central changed from the AT based “command mode” to the “online data mode”.
3.1.2.2. Exchange Terminal I/O Data
All data send on the serial interface is transparently sent to the Terminal I/O client side. All data send by the remote Terminal I/O client is binary output on the serial interface of the
BlueMod+S42/Central. When a peripheral Terminal I/O server connection is active, it is not possible to create a GATT
connection to a peripheral device.
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 20 of 66
3.1.2.3. Close Terminal I/O Connection
The Terminal I/O connection can be closed in the following two different options:
By using the GPIO “HANGUP”
(only available if this GPIO is controlled by the host controller)
Send the “ATH” command. Using the GPIO “HANGUP”
set GPIO “HANGUP” to high level
set GPIO “HANGUP” to low level
NO CARRIER 0x01
Using the “ATH” command
<wait 1 sec after data exchange> +++
ATH=0x01
OK
NO CARRIER 0x01
The response of the disconnect request reports the event “NO CARRIER” followed by
disconnected connection handle. The same event is reported when the remote Terminal I/O client side disconnects the connection.
Loading...
+ 46 hidden pages