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

Telit Wireless Solutions BlueMod+S42 Command Reference Manual

Adc/lua
Hide thumbs Also See for BlueMod+S42:
Table of Contents

Advertisement

Quick Links

Download this manual
BlueMod+S42/ADC/LUA
AT Command Reference
80512ST10860A Rev. 0 – 2017-10-06
Mod. 0815 2016-08 Rev.1

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Telit Wireless Solutions BlueMod+S42

Summary of Contents for Telit Wireless Solutions BlueMod+S42

  • Page 1 BlueMod+S42/ADC/LUA AT Command Reference 80512ST10860A Rev. 0 – 2017-10-06 Mod. 0815 2016-08 Rev.1...

  • Page 2: Notice

    BlueMod+S42/ADC/LUA 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+S42/ADC/LUA 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+S42/ADC/LUA AT Command Reference APPLICABILITY TABLE PRODUCTS BLUEMOD+S42/ADC/LUA 80512ST10860A Rev.0 Page 4 of 40 2017-10-06...

  • Page 5: Table Of Contents

    BlueMod+S42/ADC/LUA AT Command Reference CONTENTS NOTICE COPYRIGHTS ....................2 COMPUTER SOFTWARE COPYRIGHTS ............2 USAGE AND DISCLOSURE RESTRICTIONS ..........3 License Agreements ..............3 Copyrighted Materials ..............3 III. High Risk Materials ............... 3 Trademarks .................. 3 Third Party Rights ................. 3 APPLICABILITY TABLE ................
  • Page 6 BlueMod+S42/ADC/LUA AT Command Reference GLOSSARY AND ACRONYMS ..........38 DOCUMENT HISTORY .............. 39 80512ST10860A Rev.0 Page 6 of 40 2017-10-06...

  • Page 7: Introduction

    BlueMod+S42/ADC/LUA AT Command Reference 1. INTRODUCTION Scope This document specifies the command interface for the BlueMod+S42/ADC/LUA 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+S42/ADC/LUA 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+S42/ADC/LUA AT Command Reference Related Documents  [1] BlueMod+S42 Hardware User Guide, 1VV0301303  [2] BlueMod+S42 Lua Software User Guide, 1VV0301471  [3] BlueMod+S42 Lua API Documentation, 30512ST10861A  [4] Bluetooth 4.0 Core Specification 80512ST10860A Rev.0 Page 9 of 40...

  • Page 10: Features

    BlueMod+S42/ADC/LUA AT Command Reference 2. FEATURES The BlueMod+S42/ADC/LUA supports AT command mode. In the factory-default configuration the BlueMod+S42/ADC/LUA supports the AT command Mode via an internal Software interface. Each command line consists of a prefix, a body and a terminator.

  • Page 11: Command Summary

    BlueMod+S42/ADC/LUA 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 12 BlueMod+S42/ADC/LUA AT Command Reference +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 Display only n.a. SSPPIN Display Yes/No SSPPIN (LE legacy pairing)
  • Page 13 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+S42/ADC/LUA. Each entry in the bonded-device list contains the Bluetooth address and the linktype (see chapter 4.2). Example: AT+BNDLIST...
  • Page 14 AT+BNDSIZE=<value> This command reduces the number of devices (1…4) the bonded-device list can hold. The BlueMod+S42/ADC/LUA can store up to 4 devices. The default size is 4. Modification of this parameter will delete all devices in the bonded- device list.
  • Page 15 +BPAIRMODE Configure Pairable Mode AT syntax: AT+BPAIRMODE=<mode> This command controls the pairable mode of the BlueMod+S42/ADC/LUA. 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+S42/ADC/LUA advertises TIO as “functional”...
  • Page 16 BlueMod+S42/ADC/LUA AT Command Reference The user has to answer this request with the SSP passkey displayed on the remote device. Example: SSPPIN 00802507C08D,t2 ? Receive SSP passkey request AT+BSSPPIN 00802507C08D,t2,314546 Send SSP passkey response +BSSPDBG SSP Debug Mode AT syntax: AT+BSSPDBG=<value>...
  • Page 17 PnP Product ID AT syntax: AT+PNPPID=<value> This command sets the product ID provided in the device information service (DIS). The format is a 16 bit hex value. The default value is 0xB017 (Telit product ID for BlueMod+S42/ADC/LUA firmware). +PNPPVER PnP Product Version AT syntax: AT+PNPPVER=<value>...
  • Page 18 BlueMod+S42/ADC/LUA AT Command Reference After setting the vendor ID (AT+PNPVID) to a different value than the default 0x008F the user has to set his own product version (otherwise the value 0x0100 will be used). +PNPVID PnP Vendor ID AT syntax: AT+PNPVID=<value>...
  • Page 19 BlueMod+S42/ADC/LUA AT Command Reference +RESET Reset Device AT syntax: AT+RESET This command resets the whole functionality of the BlueMod+S42/ADC/LUA by a forced hardware reset (like power off/on). No OK response will be sent before the device performs a reset. +RFMAXTXPWR Maximum Output Power AT syntax: AT+RFMAXTXPWR=<value>...
  • Page 20 RESET signal. Value Description Wake-up by GPIO Wake-up by RESET signal Possible use cases and a usage example are described in the BlueMod+S42 Lua Software User Guide [2]. Result Message Format AT syntax: ATV<value> This command determines the format of the result messages.

  • Page 21: Bluetooth Low Energy

    AT+LEADINTMIN. +LEADINTMIN Minimum Advertising Interval AT syntax: AT+LEADINTMIN=<value> This command is not used in the BlueMod+S42/ADC/LUA. It is just provided for compatibility reasons. The used advertising interval is set by AT+LEADINTMAX parameter. 80512ST10860A Rev.0 Page 21 of 40 2017-10-06...
  • Page 22 BlueMod+S42/ADC/LUA 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 23 BlueMod+S42/ADC/LUA 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. Parameter Description connHnd Set to zero 6…3200 minimum connection interval in steps of 1.25 ms (mandatory...
  • Page 24 BlueMod+S42/ADC/LUA 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. Value Description Terminal I/O service disabled (no advertising, no characteristics) Terminal I/O service enabled, security is required with encryption (no...
  • Page 25 BlueMod+S42/ADC/LUA AT Command Reference With disabled internal TIO due to AT+LETIO=0, the values 0 and 3 show the same behavior. There will be no advertising and no connection. Value Description Customized advertising disabled, internal TIO advertising enabled Customized advertising enabled, internal TIO advertising disabled...

  • Page 26: Gatt

    3.3.1. GATT Client Functionality The BlueMod+S42\ADC\LUA does not support full GATT Client functionality but only a subset that allows to Scan for advertisement and scan response data of remote devices. It does not support GATT service discovery or connection setup.
  • Page 27 GATT Show all found devices Hexdump of advertising and scan response data without duplicate filtering Any character input while the BlueMod+S42\ADC\LUA is searching will abort the search procedure. The resulting list depends on the used command parameters. As a result, a list will be output containing the Bluetooth addresses of the visible devices in...

  • Page 28: Gatt Server Definition

    DATA:110730303031565245534F495245544D54530302FBFE080 86A75657267656E +LESCANDURATION Duration for +LESCAN AT syntax: AT+LESCANDURATION=<value> This command configures how long the BlueMod+S42\ADC\LUA is searching for discoverable Bluetooth Low Energy devices when the command AT+LESCAN is used. Value Description Sets duration time to infinite. 1..300 Sets duration time between 1 seconds and 300 seconds (default=10) 3.3.2.
  • Page 29 BlueMod+S42/ADC/LUA AT Command Reference The GAP and GATT services that each GATT server must expose are built-in services in the BlueMod+S and thus shall not be defined by the application! The presence of parameters par ,..,par depends on the value of <type>:...
  • Page 30 BlueMod+S42/ADC/LUA AT Command Reference type perm=<permissions> chardcccd 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 31 BlueMod+S42/ADC/LUA AT Command Reference The characteristic properties are coded as a hexadecimal bitmask as defined in Bluetooth Core Spec 4.0 Volume3 Part G Chapter 3.3.1.1 [4]. Value Properties Read Write without response Write Notify Indicate The values can be combined, for example read & notify result in 12.
  • Page 32 BlueMod+S42/ADC/LUA 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 33 BlueMod+S42/ADC/LUA 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 34: Gatt Server Data Handling On At

    BlueMod+S42/ADC/LUA AT Command Reference 3.3.3. GATT Server Data Handling on AT +LESRVDATA GATT Server Data Exchange AT syntax: AT+LESRVDATA=<channel>,<hexdata> Channels are created during GATT server definition using the AT+LEATTRIB command. After AT+LEATTRIB=complete, the GATT server is ready to be used.

  • Page 35: Appendix

    BlueMod+S42/ADC/LUA AT Command Reference 4. APPENDIX Bluetooth Address The BlueMod+S42/ADC/LUA 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 36 BlueMod+S42/ADC/LUA AT Command Reference SSPPIN SSP Passkey Request Syntax: SSPPIN Bdaddr,tx ? With this event the module requests the entry of the passkey displayed on the remote device. Parameter Description Bdaddr Remote Bluetooth address x is the remote Bluetooth address type (see chapter Bluetooth Address)
  • Page 37 BlueMod+S42/ADC/LUA AT Command Reference LESRVDATA GATT Server Data Exchange Syntax: LESRVDATA:<channel>,<data> With this event the user is informed about new data on a GATT server characteristic. Channels are created during GATT server definition using the AT+LEATTRIB command. After AT+LEATTRIB=complete, the GATT server is ready to be used.

  • Page 38: Glossary And Acronyms

    BlueMod+S42/ADC/LUA AT Command Reference 5. GLOSSARY AND ACRONYMS Analog Digital Converter Attention Command Generic Access Profile Generic Attribute Profile GATT Identity Resolving Key Secure Simple Pairing Two Wire Interface Universal Asynchronous Receiver/Transmitter UART UART Interface Control Protocol UICP Universal Unique Identifier UUID 80512ST10860A Rev.0...

  • Page 39: Document History

    BlueMod+S42/ADC/LUA AT Command Reference 6. DOCUMENT HISTORY Revision Date Changes 2017-10-06 First issue 80512ST10860A Rev.0 Page 39 of 40 2017-10-06...

Table of Contents