Telit Wireless Solutions BlueMod+S42M Operating manual

BlueMod+S42M
AT Command Reference
80527ST10839A Rev. 2 –2018-09-18

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 2 of 46 2018-09-18
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 tonotify 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+S42M AT Command Reference
80527ST10839A Rev.2 Page 3 of 46 2018-09-18
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.

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 4 of 46 2018-09-18
APPLICABILITY TABLE
PRODUCTS
BLUEMOD+S42M
BLUEEVA+S42M

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 5 of 46 2018-09-18
CONTENTS
NOTICE ..................................................................................................... 2
COPYRIGHTS................................................................................................ 2
COMPUTER SOFTWARE COPYRIGHTS...................................................... 2
USAGE AND DISCLOSURE RESTRICTIONS............................................... 3
APPLICABILITY TABLE................................................................................ 4
CONTENTS.................................................................................................... 5
1. INTRODUCTION.......................................................................... 7
Scope........................................................................................... 7
Audience....................................................................................... 7
Contact and Support Information .................................................. 7
Text Conventions.......................................................................... 8
Related Documents...................................................................... 9
2. FEATURES ................................................................................ 10
AT Command Mode.................................................................... 10
Escape Sequence....................................................................... 11
Connection Establishment Procedure......................................... 11
Hangup....................................................................................... 11
3. COMMAND SUMMARY ............................................................. 12
General....................................................................................... 12
Bluetooth Low Energy................................................................. 26
GATT.......................................................................................... 31
3.3.1. GATT Server Definition............................................................... 31
3.3.2. GATT Server Data Handling....................................................... 36
3.3.3. Data Handling with or without Connection................................... 36
4. APPENDIX ................................................................................. 38
Data Formats.............................................................................. 38
4.1.1. Data Array .................................................................................. 38
4.1.2. Bluetooth Address ...................................................................... 38
4.1.3. UUID........................................................................................... 38
4.1.4. Values ........................................................................................ 38
4.1.5. Bit Arrays.................................................................................... 38
Linktype...................................................................................... 39

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 6 of 46 2018-09-18
AT Result Codes......................................................................... 39
Release/Error Codes.................................................................. 41
Events ........................................................................................ 42
5. GLOSSARY AND ACRONYMS................................................. 44
6. DOCUMENT HISTORY .............................................................. 45

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 7 of 46 2018-09-18
1. INTRODUCTION
Scope
This document specifies the command interface for the BlueMod+S42M firmware.
Audience
This document is intended for Telit customers, especially system integrators, about to
implement Bluetooth modules in their application.
Contact and Support Information
For general contact, technical support services, technical questions and report
documentation errors contact Telit Technical Support at:
•[e-mail]
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
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+S42M AT Command Reference
80527ST10839A Rev.2 Page 8 of 46 2018-09-18
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.

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 9 of 46 2018-09-18
Related Documents
•[1] BlueMod+S42M Hardware User Guide, 1VV0301379
•[2] BlueMod+S42M Software User Guide, 1VV0301391
•[3] Bluetooth Core Specification Version 4.2
•[4] UICP+ UART Interface Control Protocol, 30507ST10756A

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 10 of 46 2018-09-18
2. FEATURES
The BlueMod+S42M supports AT command mode.
In the factory-default configuration the BlueMod+S42M is set to AT command mode using
a UART baud rate of 115,200 bps, 8 data bits, no parity, 1 stop bit (8N1) and hardware flow
control.
AT Command Mode
Each command line consists of a prefix, a body and a terminator.
All command lines begin with the prefix AT (ASCII 065, 084) or at (ASCII 097, 116).
The body is a string of characters in the ASCII range 032-255. Control characters other than
<CR> (carriage return; ASCII 013) and <BS> (back space; ASCII 008) in a command line
are ignored.
Note: The control characters are configurable via S registers.
•Carriage return character (CR) S3 register
•Line feed character (LF) S4 register
•Back space character (BS) S5 register
The terminator is <CR>.
There is no distinction between upper-case and lower-case characters. A command line
can have a maximum length of 80 characters. It is automatically discarded if the input is
longer. Corrections are made using <BS>. Multiple commands on the same command line
are not allowed.
Commands have the following syntax:
Syntax
Description
AT<command>=<value><CR>
Write the value of the command
AT<command>?<CR>
Read the value of the command
Exceptions of this syntax are marked separately.

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 11 of 46 2018-09-18
Responses are sent back to the host and can be any of the following:
Responses
Description
<CR><LF>value<CR><LF>
Current value
<CR><LF>
list entry 1<CR><LF>
list entry 2<CR><LF>
…
list entry n<CR><LF>
<CR><LF>
List value (e.g. AT+BNDLIST)
<CR><LF>OK<CR><LF>
Successful final message
<CR><LF>ERROR<CR><LF>
Error message, command not supported
Escape Sequence
To enter the command mode during an active data connection the following sequence
(escape sequence) can be used:
<delay time
1
><+><+><+><delay time>
The time interval between each of the three plus signs must not exceed 1 second. The
escape sequence remains transparent to the remote device.
The escape sequence character is configurable via S2 register.
Connection Establishment Procedure
On a peripheral, 200 ms after an incoming connection establishment the peripheral will
check if the used connection parameters are compatible with the parameters
AT+LECONINTMIN, AT+LECONINTMAX and AT+LESLAVELAT. If theparameters are not
compatible, the peripheral will update the connection parameters automatically to the
configured parameters. The connection supervision timeout used by automatic parameter
update is calculated due to conform to the Bluetooth core spec. If connection parameter
update fails, the peripheral retries the connection parameter update. The maximum number
of attempts is 3 and the time between the retries is 5 seconds.
Hangup
All active data connections will be disconnected at once by setting the HANGUP pin
(GPIO4) to high level.
1
Delay time defined in the S12 register (see page 27)

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 12 of 46 2018-09-18
3. COMMAND SUMMARY
The description of the commands is structured into the following parts:
•General commands
•Bluetooth Low Energy (BLE) specific commands
•Generic Attribute Profile (GATT) specific commands
The factory-default values of the commands are marked using the bold letter format.
General
%B Baud Rate
AT syntax: AT%B<value>
This command determines the baud rate for the UART.
The following standard baud rates are supported:
Value
Description
4
9,600 bps
5
19,200 bps
6
38,400 bps
7
57,600 bps
8
115,200 bps
9
230,400 bps
22
460,800 bps
23
921,600 bps
Additionally to the standard baud rates described above, it is possible to set the following
baud rates.

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 13 of 46 2018-09-18
Value
Description
1200
1,200 bps
2400
2,400 bps
4800
4,800 bps
9600
9,600 bps
14400
14,400 bps
19200
19,200 bps
28800
28,800 bps
38400
38,400 bps
57600
57,600 bps
76800
76,800 bps
115200
115,200 bps
230400
230,400 bps
250000
250,000 bps
460800
460,800 bps
921600
921,600 bps
1000000
1,000,000 bps
To set a baud rate write the desired value in the command.
Examples:
AT%B9
Set baud rate to 230,400 bps
AT%B250000
Set baud rate to 250,000 bps
Information regarding the deviation of the real baud rate to the value
set can be found in the BlueMod+S42M Hardware User Guide [1].
&F Load Factory Defaults
AT syntax: AT&F<value>
The factory-default values will be loaded. Forstoring values in non-volatile memory, usethe
AT&W command.

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 14 of 46 2018-09-18
Value
Description
0
Set all parameters except bndlist to factory defaults
1
Set all parameters to factory defaults
Some restored values require an additional reset to get active (e.g.
AT+LETIO, AT+UICP).
&W Store Active Configuration
AT syntax: AT&W
The active configuration is stored in non-volatile memory.
A Accept Incoming Call
AT syntax: ATA
This command is supported for compatibility reasons only. A Bluetooth low energy device
has to answer every connection automatically. See also register S0 description.
+BIOCAP SSP I/O Capabilities
AT syntax: AT+BIOCAP=<value>
This command sets the input and output capabilities of the device used for SSP.
Value
Description
Related commands
Related events
0
Display only
n.a.
SSPPIN
1
Display Yes/No
+BSSPCONF (secure connection)
SSPPIN (LE legacy pairing)
SSPCONF (secure connection)
2
Keyboard only
+BSSPPIN
SSPPIN
3
No input
no output
n.a.
n.a.
4
Display and
keyboard
+BSSPPIN (LE legacy pairing)
+BSSPCONF (secure connection)
SSPPIN (LE legacy pairing)
SSPCONF (secure connection)

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 15 of 46 2018-09-18
+BMITM SSP Man in the Middle Protection
AT syntax: AT+BMITM=<value>
This command controls the man in the middle (MITM) protection of the device during SSP.
It has to be set in context with AT+BIOCAP command. In SSP there are scenarios where
MITM protection is not possible.
Value
Description
0
Man in the middle protection disabled
1
Man in the middle protection enabled
In case the user choose a scenario where MITM protection is not possible but one of the
communication devices is configured to AT+BMITM=1 (MITM protection enabled), the
pairing is refused.
For possible combinations of I/O capabilities and the possibility of MITM
protection/authentication level see command BIOCAP and the BlueMod+S42M Software
User Guide [2].
+BNAME Local Device Name
AT syntax: AT+BNAME=<name>
This command allows the modification of the local device name. The device name is shown
on a remote Bluetooth device during device/service discovery. It is limited to 19 characters.
The device name can contain a format element to include the device’s own address or parts
of it in the name.
In BLE advertising the name is truncated to the first 19 characters.
Format: “%[<s>][<d>]a”
“%”
Identifier start format element
<s>
Character separator on byte order (optional)
<d>
Number (1-12) of digits included in device name (optional, default is 4)
“a”
Identifier end format element

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 16 of 46 2018-09-18
Examples: Device address = “0123456789AB”
AT+BNAME=BM+S42M/SRV %4a
Display on remote end: BM+S42M/SRV 89AB
AT+BNAME=BM+S42M/SRV %4a
Display on remote end: BM+S42M/SRV 89AB
AT+BNAME=BM+S42M/SRV %:3a
Display on remote end: BM+S42M/SRV 9:AB
AT+BNAME=BM+S42M/SRV %3a
Display on remote end: BM+S42M/SRV 9AB
AT+BNAME=BM+S42M/SRV %:12a
Display on remote end: BM+S42M/SRV
01:23:45:67:89:AB
+BNDDEL Delete Bonding Information
AT syntax: AT+BNDDEL=<value>
This command deletes the bonding information stored by the BlueMod+S42M.
Value
Description
Bluetooth address
Delete the bond of the device with specified address from the
bonded-device list
*
Delete all bonded devices from the bonded-device list
This command can only be executed while not connected.
+BNDLIST Show Bonded Device List
AT syntax: AT+BNDLIST
This command shows information about the devices bonded with the BlueMod+S42M.
Each entry in the bonded-device list contains the Bluetooth address and the linktype (see
chapter 4.2).
Example:
AT+BNDLIST
0080254800DA 0x02
9C04EB06ACA2 0x03
OK

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 17 of 46 2018-09-18
+BOAD Bluetooth Own Device Address
AT syntax: AT+BOAD
This command reads the Bluetooth devices’ own device address.
This command is read only.
+BPAIRMODE Configure Pairable Mode
AT syntax: AT+BPAIRMODE=<mode>
This command controls the pairable mode of the BlueMod+S42M.
When set to “0” the module is only connectable for clients stored in the local bondlist. New
pairing requests will be rejected.
Mode
Description
0
No pairing allowed, BlueMod+S42M advertises TIO as “functional”
1
Pairing allowed, BlueMod+S42M advertises TIO as “bondable and
functional”
This command restricts the access only to security enabled
characteristics.
For Terminal I/O this means AT+LETIO has to be set to a value
different than 0 or 2.
For the GATT Server the permission parameters of the command
AT+LEATTRIB have to be set to a value that requires authentication
(e.g. “AT+LEATTRIB=charval,uuid=2A19,perm=0022,len=1” with
“perm” for read with authentication permitted and write with
authentication permitted).

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 18 of 46 2018-09-18
+BSSPCONF Security Pairing Confirmation
AT syntax: AT+BSSPCONF <Bluetooth address>,<address type>,<value>
If a pairing is initiated and LE secure connection is supported, depending on the security
settings AT interface generates an event SSPCONF and asks the user for confirmation.
Event: SSPCONF <Bluetooth address>,<address type> <passkey> ?
The user has to confirm the passkey with the above command. If no confirmation is sent by
the user within the bonding timeout or in case of active reject, the pairing is rejected with
NO CARRIER message.
Value
Description
0
Reject passkey confirmation request
1
Accept passkey confirmation request
Example:
SSPCONF 00802507C08D,t2 794851 ?
AT+BSSPCONF 00802507C08D,t2,1
OK
RING
CONNECT
Receive SSP pairing request
Send SSP pairing confirmation
+BSSPPIN SSP Passkey Response
AT syntax: AT+BSSPPIN <Bluetooth address>,<address type>,
<SSP passkey>
If an authentication is initiated, depending on the I/O capabilities (AT+BIOCAP) the AT
interface generates an event SSPPIN and asks the user for the SSP passkey.
Event: SSPPIN <Bluetooth address>,<address type> ?
The user has to answer this request with the SSP passkey displayed on the remote device.
Example:
SSPPIN 00802507C08D,t2 ?
AT+BSSPPIN 00802507C08D,t2,314546
OK
RING
CONNECT
Receive SSP passkey request
Send SSP passkey response

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 19 of 46 2018-09-18
+DFUSTART Start Bootloader
AT syntax: AT+DFUSTART
This command sets the device into the configured firmware update mode. This command
never times out, only a reset of the device brings it to normal mode .
E Local Echo
AT syntax: ATE<value>
This command selects the local echo in command mode.
Value
Description
0 or empty
No local echo
1
Local echo on in command phase
H Disconnect
AT syntax: ATH
This command disconnects the existing Bluetooth connection.
I Display Version Information
AT syntax: ATI<value>
Displays different information about version number and settings.

BlueMod+S42M AT Command Reference
80527ST10839A Rev.2 Page 20 of 46 2018-09-18
Value
Description
0 or empty
Returns the device name (e.g. “BM+S42M/SRV %4a“)
1
Returns “0”
2
Returns “OK”
3
Returns the version string: “V1.xyz”
4
Returns the manufacturers name: “Telit”
5
Returns “ERROR”
6
Returns the copyright string: “(c) Copyright Telit”
7
Returns “OK”
8
Returns “ERROR”
9
Returns “OK”
77
Returns patch versions and sensor configuration
99
Returns the detailed firmware version
+IOACFG Config of Pin IOA
AT syntax: AT+IOACFG=<value>
This command configures the function of the IOA pin (GPIO8). GPIO8 can be configured
as output signal “Device Ready". The signal is low active, a low level shows the device
ready to process commands and establish Bluetooth connections after startup.
Early engineering hardware samples uses GPIO2 instead of GPIO8.
Value
Description
0
Disconnected (no function, lowest power consumption)
1
Output: Signal “Device Ready”
+IOBCFG Config of Pin IOB
AT syntax: AT+IOBCFG=<value>
This command configures the function of the IOB pin (GPIO3). GPIO3 can be configured
as output signal "Data Carrier Detect" (DCD). The signal is low active. A low level signals