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.