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
Страница 1: ...e 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 1...
Страница 2: ...al 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 Blu...
Страница 3: ...reserve 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 copyrighte...
Страница 4: ...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 Thi...
Страница 5: ...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 Bond...
Страница 6: ...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...
Страница 7: ...on 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 c...
Страница 8: ...arning 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 an...
Страница 9: ...heral 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...
Страница 10: ...ditional 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...
Страница 11: ...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...
Страница 12: ...erent 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 esta...
Страница 13: ...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 characteris...
Страница 14: ...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...
Страница 15: ...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 tha...
Страница 16: ...istic 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 deactiv...
Страница 17: ...c 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...
Страница 18: ...minal 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 insta...
Страница 19: ...ction 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 hand...
Страница 20: ...tions 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...
Страница 21: ...heral devices 3 1 3 1 Searching for Available Peripheral Devices Scan for available devices AT LESCAN GATT D0A4E9658F65 t3 RSSI 60 TYPE CONN NAME BM S 8F65 MNF 8F0009B0011000 UUID FEFB DE338F0D1A22 t3...
Страница 22: ...GATT connection to a peripheral device ATDDE338F0D1A22 t3 GATT CONNECT GATT 0x11 The BlueMod S42 Central reports the created GATT connection with the result message CONNECT include the connection typ...
Страница 23: ...lexing protocol Data has to be sent and are received in the following framing all values in hexadecimal format Name Description Length Value Start Start of frame 8 bit CC Data Channel ID Channel ident...
Страница 24: ...Mod S42 Central device Note The following example in the MUX mode is listing the serial data in hexadecimal coded form to identify the MUX framing For a better understanding the corresponding text mes...
Страница 25: ...4c 45 53 52 56 44 3d 30 78 31 30 0d AT LESRVD 0x10 cc ff 02 0d 0a cc ff 05 55 55 49 44 3a cc ff 04 31 38 30 30 cc ff 02 0d 0a cc ff 05 55 55 49 44 3a cc ff 04 31 38 30 31 cc ff 02 0d 0a cc ff 05 55 5...
Страница 26: ...30 30 30 38 30 30 30 30 30 38 30 32 35 30 30 30 30 30 30 cc ff 02 0d 0a cc ff 08 20 20 30 78 30 30 31 36 cc ff 0b 20 50 52 4f 50 3a 30 78 30 38 20 cc ff 05 55 55 49 44 3a cc ff 20 30 30 30 30 30 30 3...
Страница 27: ...erties PROP 0x20 characteristic UUID UUID 00000004000010008000008025000000 The characteristic handle is required for all access functions to use with this characteristic The characteristic properties...
Страница 28: ...s peripheral device in addition to the write type As result of the AT LEADDCHAN command the BlueMod S42 Central returns the MUX channel ID include the response message OK The reported MUX channel ID v...
Страница 29: ...local host and the GATT server characteristic during this active connection The following example demonstrates the data exchange between both given MUX channels of the service UUID FEFB GATT Server re...
Страница 30: ...connection handle 0x01 The given connection handle is required for further activities onto this Terminal I O connection 3 2 1 8 Exchange Data on the Terminal I O Connection During the active Terminal...
Страница 31: ...inal I O connection i e from a mobile phone the BlueMod S42 Central close the connection with the use of the connection handle cc ff 09 41 54 48 3d 30 78 30 31 0d ATH 0x01 cc ff 0c 0d 0a 4e 4f 20 43 4...
Страница 32: ...please refer to the document UICP UART Interface Control Protocol 4 1 Firmware Version 3 002 The following diagram shows the startup timing of the BlueMod S42 Central based on firmware version 3 002...
Страница 33: ...is affected by the following commands AT BNDLIST shows the devices stored in the bonded device list AT BNDSIZE determines the size of the bonded device list and deletes the whole list when modifying t...
Страница 34: ...ults are the same as for a display only configuration 5 3 Security Levels for Terminal I O The behavior of LE Security is configurable using the parameters for I O capabilities AT BIOCAP and a man in...
Страница 35: ...n the first case the display is used to show a six digit numeric code to the user who then enters the code on the keypad In the second case the user of each device enters the same six digit numeric co...
Страница 36: ...BT addr tx 1 Keyboard only AT BIOCAP 2 Passkey entry responder displays initiator inputs MITM protection SSPPIN BT addr tx AT BSSPPIN BT addr tx passkey Passkey entry responder displays initiator inpu...
Страница 37: ...the BlueMod S42 Central see also the connection example in chapter 3 1 2 The Target Application part will simulate the device at the end DTE which communicates to the BlueMod S42 Central with configur...
Страница 38: ...al Software User Guide 1VV0301318 Rev 3 2018 08 31 Reproduction forbidden without written authorization from Telit Communications S p A All Rights Reserved Page 38 of 66 5 4 Connection Example Termina...
Страница 39: ...ide 1VV0301318 Rev 3 2018 08 31 Reproduction forbidden without written authorization from Telit Communications S p A All Rights Reserved Page 39 of 66 5 5 Connection Example Terminal I O Passkey Entry...
Страница 40: ...ving support of the involved peers but implements mechanisms to allow the save usage of MCU power saving features like UART peripheral switched off 6 2 Requirements of Using UICP on BlueMod S42 Centra...
Страница 41: ...active IUC IN inactive I U R O U T a s s e r t e d I U C I N a s s e r t e d interface up IUR OUT active IUC IN don t care UART flowcontrol interface up normal operation RTS CTS hardware flow control...
Страница 42: ...that signal by de asserting its IUC OUT signal which is connected to the IUC IN signal of the initiator After the initiator detects a de asserted IUC IN signal both devices go into interface down stat...
Страница 43: ...signal which is connected to the IUC IN signal of the initiator Once the acceptor detects the assert of the IUR OUT signal from the initiator it can disable MCU power saving mechanisms but shall ensur...
Страница 44: ...BlueMod S42 Central the BlueMod S42 Central has send all data as well and is idle for t1 in its Tx direction so it signals the host that it is allowed to go to interface down state by de asserting IU...
Страница 45: ...r a maximum time t2 to detect the assertion via the IUC IN signal After receiving this input change of IUC IN both devices may assume that the interface of the remote device changed from state pending...
Страница 46: ...lue Description 0 NFC interface OFF 1 NFC interface ON Enable the NFC Handover functionality by using the following AT command 7 2 NFC Handover Example Make sure NFC is available and enabled in the sm...
Страница 47: ...ten authorization from Telit Communications S p A All Rights Reserved Page 47 of 66 After the pairing request ended successfully you will find the new paired device within the Bluetooth settings of yo...
Страница 48: ...ial lines UART RXD UART TXD UART CTS UART RTS and GND Serial firmware update requires a UART speed of 38400 bps Pin BOOT0 E 1 shall be pulled high to access the bootloader at start up 8 1 2 Telit IoT...
Страница 49: ...fore starting the update by pressing the Update button the device shall be reset COM Port The COM Port the device is attached to Update Starts the update procedure After the successful update close th...
Страница 50: ...te The actual size of each firmware binary file can be found in the firmware release notes 8 1 3 1 Layer Structure The device firmware update uses the HCI Three Wire UART Transport Layer specified in...
Страница 51: ...nit packet provided by Telit The data starting with Device type and ending with CRC of the image that will be transferred see the Nordic documentation is provided by Telit in the Telit delivery packag...
Страница 52: ...Packet bit a Packet Type of 4 bits a Payload Length of 12 bits and a 8 bit Header Checksum The used Packet Type is vendor specific 0xe LSB MSB 4 Octets 1 156 Octets 2 Octets Packet Header DFU packet l...
Страница 53: ...using the Nordic Master Control Panel and the corresponding Nordic Bluetooth hardware The firmware over the air update in the BlueMod S42 Central will be enabled with the commands below 1 AT DFUMODE...
Страница 54: ...ion from Telit Communications S p A All Rights Reserved Page 54 of 66 8 2 1 Firmware Update Over The Air using Nordic nRF Toolbox on Android Make sure the BlueMod S42 Central has already activated the...
Страница 55: ...thout written authorization from Telit Communications S p A All Rights Reserved Page 55 of 66 Select file type Distribution packet ZIP Search via file manager for the firmware package which was previo...
Страница 56: ...munications S p A All Rights Reserved Page 56 of 66 Press the button SELECT DEVICE and select the BM S_DFU from the list of available devices Press the UPLOAD button to upload the firmware package ove...
Страница 57: ...arameter It is also possible to monitor the UART flow control line UART RTS 9 1 Using System OFF Mode for Terminal I O The following example will list the communication between the host controller and...
Страница 58: ...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 58 of 66...
Страница 59: ...rom one another on a specific channel then meet at a new channel the link layer of the BLE stack handles the channel switching at a specific amount of time later This meeting where the two devices sen...
Страница 60: ...cy value 1 x 2 x Connection interval time x 2 Limitations of calculated Connection supervision timeout calculated value 10ms minimum value 100ms maximum value 32s 10 2 Optimize the Connection Interval...
Страница 61: ...onnection interval when selecting the connection parameters Selecting the correct group of connection parameters plays an important role in power optimization of the BLE device The following list give...
Страница 62: ...accepting or rejecting the new parameters The BlueMod S42 Central uses the configuration command AT LECONPARAM to initiate the Connection Parameter Update Request message or report the current connec...
Страница 63: ...al Software User Guide 1VV0301318 Rev 3 2018 08 31 Reproduction forbidden without written authorization from Telit Communications S p A All Rights Reserved Page 63 of 66 10 5 1 Central Side Initiates...
Страница 64: ...ftware User Guide 1VV0301318 Rev 3 2018 08 31 Reproduction forbidden without written authorization from Telit Communications S p A All Rights Reserved Page 64 of 66 10 5 2 Central Side Changed Initial...
Страница 65: ...e User Guide 1VV0301318 Rev 3 2018 08 31 Reproduction forbidden without written authorization from Telit Communications S p A All Rights Reserved Page 65 of 66 10 5 3 Peripheral Side Create a Connecti...
Страница 66: ...t issue r1 2016 10 05 Added new values 3 4 of AT LETIO command Added new chapter LE Secure Connections Corrected value of AT BIOCAP in connection example Terminal I O Passkey entry r2 2018 02 02 Repla...
