1. Manuals
  2. Brands
  3. Stollmann Manuals
  4. Control Unit
  5. BlueMod+S
  6. Command reference manual

Stollmann BlueMod+S Command Reference Manual

Bluetooth module
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
BlueMod+S
AT Command Reference
Release r02

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Stollmann BlueMod+S

Summary of Contents for Stollmann BlueMod+S

  • Page 1 BlueMod+S AT Command Reference Release r02...
  • Page 2 Stollmann reserves the right to make changes to the product without prior notice or to replace the product with a successor model.

  • Page 3: Table Of Contents

    BlueMod+S AT Command Reference Table of contents Introduction ......................5 1.1 AT Command Mode ..................5 1.2 Escape Sequence ..................5 1.3 Multiplexing Mode (MUX) ................6 1.4 Hangup ......................7 Commands ......................8 2.1 General ......................8 Baud Rate ..................8 &F...
  • Page 4 BlueMod+S AT Command Reference RFMAXTXPWR Maximum Output Power ............16 AT S Register ................17 UICP Set UART Interface Control Protocol ........... 17 Result Message Format .............. 18 Extended Result Codes .............. 18 2.2 Bluetooth Low Energy ................. 18 LEADINTMAX Maximum Advertising Interval ..........18 LEADINTMIN Minimum Advertising Interval ..........

  • Page 5: Introduction

    BlueMod+S AT Command Reference 1 Introduction This documentation specifies the command interface for the BlueMod+S. The BlueMod+S supports AT command mode. 1.1 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).

  • Page 6: Multiplexing Mode (Mux)

    AT command interface via MUX protocol Result messages like RING, CONNECT and NO CARRIER may be sent in multiple frames by the BlueMod+S module. The host controller application needs to collect the data until the closed “<CR><LF>” is received. If the multiplexing mode is enabled the commands ATH and the result messages RING, CONNECT and NO CARRIER includes the additional parameter “channel...

  • Page 7: Hangup

    (message NO CARRIER). For customer defined GATT services, the “channel ID” is assigned while service definition for each defined characteristic separately and is valid until the BlueMod+S is resetted. 1.4 Hangup An active data connection can be disconnected by setting the HANGUP pin (GPIO4) to high level.

  • Page 8: Commands

    BlueMod+S AT Command Reference 2 Commands The description of the commands is structured into the following parts:  General commands  Bluetooth Low Energy (BLE) specific commands The factory-default values of the commands are marked using the bold letter format.

  • Page 9: F Load Factory Defaults

    Set baud rate to 230,400 bps AT%B250000 Set baud rate to 250,000 bps Note: Information regarding the deviation of the real baud rate to the value set can be found in the BlueMod+S Hardware Reference [1]. &F Load Factory Defaults AT syntax: AT&F<value>...

  • Page 10: Store Active Configuration

    BlueMod+S AT Command Reference &W Store Active Configuration AT syntax: AT&W The active configuration is stored in non-volatile memory. Accept Incoming Call AT syntax (normal mode): AT syntax (MUX mode): ATA <channel ID> This command is supported for compatibility reasons only. A Bluetooth low energy device has to answer every connection automatically.

  • Page 11: Bmux Activate Multiplexing Mode

    In case the user choose a scenario where MITM protection is not possible but one of the communication devices is configured to BMITM=1 (MITM protection enabled), the pairing is refused. Possible combinations of I/O capabilities and the possibility of MITM protection are described in the BlueMod+S User Guide [2]. BMUX Activate Multiplexing Mode AT syntax: AT+BMUX=<value>...

  • Page 12: Bnddel Delete Bonding Information

    Delete all bonded devices from bndlist BNDLIST Show Bonded Device List AT syntax: AT+BNDLIST This command shows information about the devices bonded with the BlueMod+S. Each entry in the BNDLIST contains the Bluetooth address and the linktype (see chapter 3.1). Example: AT+BNDLIST...

  • Page 13: Bndsize Bonded Devices List Size

    BPAIRMODE Configure Pairable Mode AT syntax: AT+BPAIRMODE=<mode> This command controls the pairable mode of the BlueMod+S. 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+S advertises TIO as “functional”...

  • Page 14: Bssppin Ssp Passkey Response

    BlueMod+S AT Command Reference “AT+LEATTRIB=charval,uuid=2A19,perm=0022,len=1” with “perm” for read with authentication permitted and write with authentication permitted). BSSPPIN SSP Passkey Response AT syntax: AT+BSSPPIN <Bluetooth address>,<SSP passkey> If a SSP is initiated and MITM is active (BMITM=1), depending on the I/O capabilities (BIOCAP) the AT interface generates an event SSPPIN and asks the user for the SSP passkey.

  • Page 15: I Display Version Information

    Returns “0” Returns “OK” Returns the version string: “V1.xyz” Returns the manufacturers name: “Stollmann E+V GmbH” Returns “ERROR” Returns the copyright string: “(c) Copyright Stollmann E+V GmbH” Returns “OK” Returns “ERROR” Returns “OK” Returns bootloader version Returns the firmware creation date...

  • Page 16: Load Load Stored Parameter Setting

    This command loads all parameters stored in non-volatile RAM. Return to Online State AT syntax: If the BlueMod+S is in command mode after issuing an escape sequence while a connection is active, ATO returns the BlueMod+S to data mode. Suppress Results AT syntax: ATQ<value>...

  • Page 17: Sat S Register

    BlueMod+S AT Command Reference All other values in the range of -127 to 127 could be set with this command as well, but the equal or next lower value from the power table will be set internally. Furthermore the value will be set to a value amongst minimum and maximum output power value of the device.

  • Page 18: Result Message Format

    BlueMod+S AT Command Reference AT+UICP=1 AT&W AT+RESET Result Message Format AT syntax: ATV<value> This command determines the format of the result messages. Value Description 0 or empty Result message is presented numerically (followed by <CR>) Result message is presented as text...

  • Page 19: Leadintmin Minimum Advertising Interval

    AT Command Reference LEADINTMIN Minimum Advertising Interval AT syntax: AT+LEADINTMIN=<value> This command is not used in the BlueMod+S. It is just provided for compatibility reasons. The used advertising interval is set by AT+LEADINTMAX parameter. LECONINTMAX Maximum Connection Interval AT syntax: AT+LECONINTMAX=<value>...

  • Page 20: Lerole Bluetooth Low Energy Device Role

    BlueMod+S AT Command Reference LEROLE Bluetooth Low Energy Device Role AT syntax: AT+LEROLE=<value> This command configures the Bluetooth Low Energy role of the device. Value Description Set device role to “Peripheral” When set to “Peripheral” (default), the device advertises and accepts incoming BLE connections.

  • Page 21: Leaddata Setup Advertise Data For Customized Advertising

    BlueMod+S AT Command Reference LEADDATA Setup Advertise Data for Customized Advertising AT syntax: AT+LEADDATA=<value > .. <value > This command is used to setup the advertise data for a customized advertising. Value represents an octet in hexadecimal format, k <= 31.

  • Page 22: Leadpar Setup Parameters For Customized Advertising

    BlueMod+S AT Command Reference LEADPAR Setup Parameters for Customized Advertising AT syntax: AT+LEADPAR=par =<value >[, .. [,par =<value >]] This command is used to setup parameters for a customized advertising. value advtype Type of advertising: 0: undirected (default) Optional 2: scannable Coding: decimal.

  • Page 23: 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+Stollmann E+V GmbH and thus shall not be defined by the application! Release r02 www.stollmann.de...
  • Page 24 BlueMod+S 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 25 BlueMod+S 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. chardusrd usrd=<user description >...
  • Page 26 BlueMod+S 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 [3]. Value Properties Read Write without response Write Notify Indicate The values can be combined, for example read & notify result in 12.
  • Page 27 BlueMod+S AT Command Reference The 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, … … optional characteristic descriptors (AT+LEATTRIB=chardxxx) … AT+LEATTRIB=charval, … Definition of second characteristic of first service: AT+LEATTRIB=char, …...
  • Page 28 BlueMod+S 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 CC FF 1C 41 54 2B 4C 45 41 54 54 52 49 42 3D 70...

  • Page 29: Appendix

    BlueMod+S AT Command Reference Appendix 3.1 Linktype Linktype Meaning 0x02 Bluetooth low energy using public address 0x03 Bluetooth low energy using random address 0x0A Bluetooth low energy using resolved address 3.2 AT Result Codes Result codes (numerical and verbose): Numeric...

  • Page 30: No Carrier

    BlueMod+S AT Command Reference Examples: Normal mode Numerical (ATV0) 2 <00802501D11A 0x02> Verbose (ATV1) RING <00802501D11A 0x02> MUX mode Numerical (ATV0) 2 <00802501D11A 0x02 0x01> Verbose (ATV1) RING <00802501D11A 0x02 0x01> 3.3.3 NO CARRIER For the AT result code NO CARRIER the following extended result codes are...

  • Page 31: Events

    BlueMod+S AT Command Reference 3.4 Events Text Description SSPPIN <Bdaddr> ? SSP passkey request (see BSSPPIN command) Release r02 www.stollmann.de Page 31 of 33...

  • Page 32: Related Documents

    BlueMod+S AT Command Reference 4 Related Documents BlueMod+S Hardware Reference BlueMod+S User Guide Bluetooth 4.0 Core Specification BlueMod+S - BlueMod+SR Delta Reference Release r02 www.stollmann.de Page 32 of 33...

  • Page 33: History

    Added note for AT&F More detailed description for returned channel format Correct characteristic default value description Remove note from LEATTRIB table Revised description of LEADPAR Stollmann Entwicklungs- und Vertriebs-GmbH Phone: +49 (0)40 890 88-0 Mendelssohnstraße 15 D Fax: +49 (0)40 890 88-444 22761 Hamburg E-mail: info@stollmann.de...

Table of Contents