Telit Wireless Solutions BlueMod+S42M Command Reference Manual
  1. Manuals
  2. Brands
  3. Telit Wireless Solutions Manuals
  4. Control Unit
  5. BlueMod+S42M
  6. Command reference manual
Telit Wireless Solutions BlueMod+S42M Command Reference Manual

Telit Wireless Solutions BlueMod+S42M Command Reference Manual

Hide thumbs Also See for BlueMod+S42M:
Table of Contents

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the BlueMod+S42M and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Telit Wireless Solutions BlueMod+S42M

Summary of Contents for Telit Wireless Solutions BlueMod+S42M

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

  • Page 2: Notice

    BlueMod+S42M AT Command Reference 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.

  • Page 3: Usage And Disclosure Restrictions

    BlueMod+S42M AT Command Reference 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.

  • Page 4: Applicability Table

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

  • Page 5: Table Of Contents

    BlueMod+S42M AT Command Reference CONTENTS NOTICE ..................... 2 COPYRIGHTS ....................2 COMPUTER SOFTWARE COPYRIGHTS ............2 USAGE AND DISCLOSURE RESTRICTIONS ..........3 APPLICABILITY TABLE ................4 CONTENTS ....................5 INTRODUCTION ................7 Scope ................... 7 Audience..................7 Contact and Support Information ..........7 Text Conventions ................
  • Page 6 BlueMod+S42M AT Command Reference AT Result Codes ................. 39 Release/Error Codes ..............41 Events ..................42 GLOSSARY AND ACRONYMS ..........44 DOCUMENT HISTORY .............. 45 Page 6 of 46 80527ST10839A Rev.2 2018-09-18...

  • Page 7: Introduction

    BlueMod+S42M AT Command Reference 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...

  • Page 8: Text Conventions

    BlueMod+S42M AT Command Reference 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.

  • Page 9: Related Documents

    BlueMod+S42M AT Command Reference 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 Page 9 of 46 80527ST10839A Rev.2...

  • Page 10: Features

    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.

  • Page 11: Escape Sequence

    BlueMod+S42M AT Command Reference 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 value (e.g. AT+BNDLIST) list entry 1<CR><LF> list entry 2<CR><LF> … list entry n<CR><LF> <CR><LF> <CR><LF>OK<CR><LF>...

  • Page 12: Command Summary

    BlueMod+S42M AT Command Reference 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.
  • Page 13 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>...
  • Page 14 BlueMod+S42M AT Command Reference Value Description Set all parameters except bndlist to factory defaults 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.
  • Page 15 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.
  • Page 16 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...
  • Page 17 +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 No pairing allowed, BlueMod+S42M advertises TIO as “functional”...
  • Page 18 BlueMod+S42M AT Command Reference +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.
  • Page 19 BlueMod+S42M AT Command Reference +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 . Local Echo AT syntax: ATE<value>...
  • Page 20 BlueMod+S42M AT Command Reference Value Description Returns the device name (e.g. “BM+S42M/SRV %4a“) 0 or empty Returns “0” Returns “OK” Returns the version string: “V1.xyz” Returns the manufacturers name: “Telit” Returns “ERROR” Returns the copyright string: “(c) Copyright Telit” Returns “OK”...
  • Page 21 This command loads all parameters stored in non-volatile RAM. Return to Online State AT syntax: If the BlueMod+S42M is in command mode after issuing an escape sequence while a connection is active, ATO returns the BlueMod+S42M to data mode. +PNPPID...
  • Page 22 The format is a 16 bit hex value. The default value is the version number of the particular Telit BlueMod+S42M firmware, e.g. 0x0100 for firmware version 1.00. To activate a new value it is necessary to store the settings (AT&W) and perform a reset (AT+RESET).
  • Page 23 Enable result messages after command input Suppress result messages after command input +RESET Reset Device AT syntax: AT+RESET This command resets the whole functionality of the BlueMod+S42M by a forced hardware reset (like power off/on). +RFMAXTXPWR Maximum Output Power AT syntax: AT+RFMAXTXPWR=<value>...
  • Page 24 This command sets the module into low power mode during the time the module is not used. The module will restart on GPIO activity. The host can use the IOA pin to monitor the system status. Possible use cases and an usage example are described in the BlueMod+S42M Software User Guide [2]. +UICP...
  • Page 25 BlueMod+S42M AT Command Reference Value Description 0 or empty Result message is presented numerically (followed by <CR>) Result message is presented as text Extended Result Codes AT syntax: ATW<value> This command enables/disables extended result codes. Value Description 0 or empty...

  • Page 26: Bluetooth Low Energy

    AT+LEADINTMIN. +LEADINTMIN Minimum Advertising Interval AT syntax: AT+LEADINTMIN=<value> This command is not used in the BlueMod+S42M. It is just provided for compatibility reasons. The used advertising interval is set by AT+LEADINTMAX parameter. Page 26 of 46 80527ST10839A Rev.2 2018-09-18...
  • Page 27 BlueMod+S42M AT Command Reference +LECONINTMAX Maximum Connection Interval AT syntax: AT+LECONINTMAX=<value> This command configures the maximum connection interval for a Bluetooth Low Energy connection. The unit is in 1.25 milliseconds timeslots. Value Description n=6…3200 Use maximum connection interval of n * 1.25 ms...
  • Page 28 BlueMod+S42M AT Command Reference The command “AT+LECONPARAM” used with “?” shows the active connection parameters used by the connection defined by connHnd. A LECONPARAM event is generated containing the active connection parameters. If the device does not support a connection handle in the CONNECT message use 0x00 as fix value for connHnd.
  • Page 29 BlueMod+S42M AT Command Reference +LETIO Enable Terminal I/O Service AT syntax: AT+LETIO=<value> This command controls the Terminal I/O service. If set to 0 the Terminal I/O service is disabled. To activate the change, it is necessary to store the settings (AT&W) and perform a reset (AT+RESET).
  • Page 30 BlueMod+S42M AT Command Reference With AT+LEADE=0 only the build in Terminal I/O service is advertised. With AT+LEADE=1 only the customized advertising value is advertised. With AT+LEADE=3 the module stops all advertising. With disabled advertising the client (e.g. iPhone) is not able to discover the device or to connect to the device. This should only be done when the service is not in use to save battery power.

  • Page 31: Gatt

    If the space is completely used the command “AT+LEATTRIB=charval,…” returns “ERROR”. The GAP and GATT services that each GATT server must expose are built-in services in the BlueMod+S42M and thus shall not be defined by the application! Page 31 of 46 80527ST10839A Rev.2...
  • Page 32 BlueMod+S42M AT Command Reference The presence of parameters par ,..,par depends on the value of <type>: type pserv uuid=<16/128bit UUID> Mandatory Mandatory Coding: hexadecimal. char prop=<properties> Mandatory Mandatory Coding: hexadecimal. properties may have the bitmask values Read, Write Without Response, Write, Notify and Indicate set.
  • Page 33 BlueMod+S42M AT Command Reference type chardcccd perm=<permissions> Optional Mandatory Coding: hexadecimal. This command is needed only if a CCCD shall be generated with permissions other than „readable and writable without authentication or authorization“. See note in type=char description. CCCDs are required to...
  • Page 34 BlueMod+S42M AT Command Reference The characteristic properties are coded as a hexadecimal bitmask as defined in Bluetooth Core Spec 4.2 Volume3 Part G Chapter 3.3.1.1 [3]. Value Properties Read Write without response Write Notify Indicate The values can be combined, for example read & notify result in 12.
  • Page 35 BlueMod+S42M AT Command Reference The complete service/s is/are defined through repeated submissions of the AT+LEATTRIB command (see example below). The AT+LEATTRIB commands must be submitted in a specific order: Definition of first service: AT+LEATTRIB=pserv, … Definition of first characteristic of first service: AT+LEATTRIB=char, …...

  • Page 36: Gatt Server Data Handling

    BlueMod+S42M AT Command Reference Example: The example below shows the Battery Service. Battery Service is a simple service which exposes the battery charging level as single characteristic value. Command Response Description Declares the AT+LEATTRIB=pserv,uuid=180F properties of the battery level value...
  • Page 37 BlueMod+S42M AT Command Reference Only the last value written to a characteristic is stored in the local server. With every new connection all not signaled data in the server is sent over the link if possible. Page 37 of 46 80527ST10839A Rev.2...

  • Page 38: Appendix

    11223344 4.1.2. Bluetooth Address The BlueMod+S42M supports public and random Bluetooth addresses. The differentiation between the address types is done using the parameter “t2” for public addresses and “t3” for random addresses. A Bluetooth address value itself is a special byte array variant. There are two valid representations.

  • Page 39: Linktype

    BlueMod+S42M AT Command Reference Linktype Linktype Meaning 0x02 Bluetooth low energy using public address 0x03 Bluetooth low energy using random address AT Result Codes Result codes (numerical and verbose): Numeric Text Meaning Extended Result Codes Command completed CONNECT Connection established...
  • Page 40 BlueMod+S42M AT Command Reference With this result code the user is informed about the disconnection of a connection. Parameter Description errorcode Bluetooth release code RING Link Request Received Syntax: RING [<bdaddr linktype>] With this result code the user is informed about an incoming connection request.

  • Page 41: Release/Error Codes

    BlueMod+S42M AT Command Reference Release/Error Codes Error code Meaning 0x0000 Success 0x0001 Accept 0x0002 Reject 0x0003 Resource error 0x0004 Invalid parameter 0x0005 Invalid state 0x0006 Connection disconnect 0x0007 Connection paused 0x0008 Connection lost 0x0009 Authentication failed 0x000A Flow control violation...

  • Page 42: Events

    BlueMod+S42M AT Command Reference Events SSPCONF SSP Passkey Confirmation Syntax: SSPCONF Bdaddr,tx Passkey ? With this event the module requests the confirmation of the passkey displayed on both devices. Parameter Description Bdaddr Remote Bluetooth address x is the remote Bluetooth address type (see chapter Bluetooth Address)
  • Page 43 BlueMod+S42M AT Command Reference Parameter Description connHnd Connection handle from CONNECT event connInt Actual connection interval in steps of 1.25 ms slaveLat Actual slave latency in connection intervals connTimeout Actual connection supervision timeout in steps of 10 ms If the device does not support a connection handle in the CONNECT message use 0x01 as fix value for connHnd.

  • Page 44: Glossary And Acronyms

    BlueMod+S42M AT Command Reference 5. GLOSSARY AND ACRONYMS Attention Command Generic Access Profile Generic Attribute Profile GATT Secure Simple Pairing Universal Asynchronous Receiver/Transmitter UART UART Interface Control Protocol UICP Universal Unique Identifier UUID Page 44 of 46 80527ST10839A Rev.2 2018-09-18...

  • Page 45: Document History

    BlueMod+S42M AT Command Reference 6. DOCUMENT HISTORY Revision Date Changes 2017-06-26 First issue 2017-08-21 Change ATI4 response to Telit 2018-09-18 Added +LECONPARAM, +LECPEVENT. +PNPPID, +PNPPVER, +PNPVID, +PNPVSRC Revised description of +LEFIXPIN Revised note of +BPAIRMODE Added +IOBCFG=3 value Page 45 of 46 80527ST10839A Rev.2...

Table of Contents