Page 1 Page 1 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Blue BT5.0 AT.s LE Command Set v5.1.1b BR-LE5.0-S1A Single Mode Low Energy Module (Actual Size Not Shown) AT HOME. AT WORK. ON THE ROAD. USING BT5.0 WIRELESS TECHNOLOGY MEANS TOTAL FREEDOM FROM THE CONSTRAINTS AND CLUTTER OF WIRES IN YOUR LIFE.
Page 2: Table Of Contents
Page 2 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Table of Contents TABLE OF CONTENTS .............................. 2 REVISION HISTORY ..............................7 INTRODUCTION ..............................12 ..................................12 COPE ................................12 ACKGROUND LE P ..............................13 ROTOCOL TACK BT5.0 N ................................
Page 3 Page 3 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc.................................. 21 TATE ........................21 UTPUT OWER ECEIVE ENSITIVITY ............................22 DVERTISING NTERVAL ..........................22 IGHER ONNECTION NTERVAL ................................. 22 LAVE ATENCY .................................. 22 HITELIST ....................... 22 ISABLE ONFIGURATION LASHING...
Page 4 Page 4 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GATT Discovered Characteristic (GATT_DC) ..................... 49 GATT Discovered Characteristic Descriptor (GATT_DCD) ................50 GATT Characteristic/Descriptor Value (GATT_VAL) ..................51 GATT Long Characteristic/Descriptor Value (GATT_LVAL) ................52 GATT S ................................
Page 5 Page 5 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. PIO Configuration (ATSPIO) ..........................87 PIO Level (ATPIOL) ............................. 89 LED Configuration (ATSLED) ..........................90 Get ADC (ATADC?) ............................. 91 Get Battery Level (ATBL?) ..........................93 Get Temperature (ATT?)...........................
Page 6 Page 6 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Characteristic Read (ATGR) ........................... 147 Characteristic Read Multiple (ATGRM) ......................148 Characteristic Read Long (ATGRL) ....................... 149 Characteristic Read by UUID (ATGRU) ......................150 Characteristic Write (ATGW) ......................... 151 Characteristic Write No Response (ATGWN) ....................
Page 7: Revision History
Page 7 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Revision History Rev # Date Description 5.0.6.0 11/27/2018 New Features: ▪ BT5.0 support – 2Mbps and Long Range PHY support, extended advertising packets, LE Secure Connections pairing. ▪...
Page 8 Page 8 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. once the MTU has been negotiated. Can be disabled using the ATSRM command. ▪ PHYU – Added to support the different BT5.0 PHYs and being able to change the current PHY during a connection.
Page 9 Page 9 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. ▪ ATSRM - Individual events can now be disabled using the Response_Event_Flags parameter. ▪ ATCFG? – The order of the response for the command has been changed to match the order of the commands in the document.
Page 10 Page 10 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. ▪ ATSDIS – Disabled characteristics will now actually be removed from the service. Any changes to this command now require a reset to take effect. ▪ ATSBAS –...
Page 11 Page 11 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. ▪ Fixed GATT Write Prepared offset not declared as unit16 Documentation Changes: ▪ ATRST - added Delay as optional with default value of 0=Reset Immediately ▪ ATSFC - marked Store_Last_Connected_Address as optional with default value 1=Enabled ▪...
Page 12: Introduction
Page 12 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Introduction “Our clients buy our products because they are reliable and easy to integrate, enabling them to quickly deploy cost-effective wireless solutions.” Mark J. Kramer – CEO of BlueRadios 1.1 Scope Blue™...
Page 13: Le Protocol Stack
Page 13 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 1.3 LE Protocol Stack The BT5.0 low energy protocol stack is built similarly to the BR/EDR stack, with a controller layer at the bottom, followed by a host layer, and finally the profile and application layers. The GAP and GATT layers and above are the only layers that should concern the user.
Page 14: Bt5.0 New Features
Page 14 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. BT5.0 New Features New LE Physical Layers (PHYs) BT5.0 supports 3 different LE physical layers (PHYs): 1Mbps Standard (1M), 2Mbps High Speed (2M) and 125kbps Coded Long Range (LR). Non-extended advertising (4.0 advertising) is done on the 1M PHY only, whereas the new 2M and LR PHYs can be used for extended advertising.
Page 15: Important Notes - Please Read Prior To Continuing
Page 15 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Important Notes – Please Read Prior To Continuing 2.1 Important Notes ▪ The module can be powered in normal voltage mode (1.7-3.6V) or high voltage mode (2.5-5.5V). In normal voltage mode, 1.7-3.6V is connected to both VDD and VDDH.
Page 16: Backwards Compatibility
Page 16 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 2.2 Backwards Compatibility ▪ To provide the best firmware architecture, design, and future profile support 100% backwards compatibility between releases cannot be guaranteed. 2.3 Known Issues Version 5.0.2.0: ▪...
Page 17: Hardware Notes
Page 17 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Hardware Notes This section is meant to provide a summary of the hardware specifications and details of specific AT.s hardware behavior. See the nBlue Module User’s Guide for detailed hardware specifications. The BR-LE5.0-S1 utilizes the Nordic nRF52840 SoC, for detailed specifications see the product specification: https://infocenter.nordicsemi.com/index.jsp?topic=%2Fps_nrf52840%2Fkeyfeatures_html5.html 3.1 Power Modes...
Page 18: Pio Functions
Page 18 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 3.5 PIO Functions NOTE: The LEDs (PIO_2/5/7/8) and buttons (PIO_3/4/6/14) on the PAN1780-AT are inverted compared to the BR-LE5.0-S1A. PIO_2/5/7/8 Status Indicators Outputs PIO_2 and PIO_5 are defaulted to outputs used to indicate th e current status of the module. By default, they will behave in the following manner.
Page 19: Pio_14 - Firmware Upgrade Mode / Advertising Control Input
Page 19 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. PIO_14 - Firmware Upgrade Mode / Advertising Control Input PIO_14 has multiple purposes. First, it can be used to manually put the module into firmware upgrade mode by setting it to VDD on the BR-LE5.0-S1 or GND on the PAN1780-AT during power up or reset by holding it at VDD on the BR-LE5.0-S1 or GND on the PAN1780-AT until the “nBoot”...
Page 20: Lowering Power Consumption
Page 20 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Lowering Power Consumption 4.1 Sleep Mode AT.s modules are controlled through AT commands sent to the module’s UART (although they can also receive commands over the air using BRSP Remote Command Mode). To receive commands and data via the UART, the UART needs to be active and for the UART to be active the module’s microcontroller needs to be in the active state.
Page 21: Shutdown Mode
Page 21 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Shutdown Mode If PIO_3 is held high on the BR-LE5.0-S1 or low for the PAN1780-AT for 500ms, shutdown will be enabled, and the module will enter its lowest power state where it can only be woken back up by a reset or by pulsing PIO_3 (which will trigger a reset).
Page 22: Advertising Interval
Page 22 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 4.5 Advertising Interval Use the ATSDSTLE command to set the advertising interval to the highest possible values acceptable for the intended application. Be aware that increasing the advertising interval will lower the rate of advertising which will increase the amount of time it may take to connect.
Page 23: Command Usage Guidelines
Page 23 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Command Usage Guidelines 5.1 Command Usage ▪ All commands are entered in the following format: “COMMAND”<cr>. ▪ All commands are typed exactly as shown in the examples. The commands themselves are not case sensitive, but the arguments may be, depending on the command.
Page 24: Bt5.0 Address Format
Page 24 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 5.3 BT5.0 Address Format <Addr> = <BT5.0 Address>:<Address Type> The BT5.0 Address and address type have now been combined into a single parameter for all commands/events using an address.
Page 25: Command Status Responses
Page 25 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Command Status Responses All commands with valid syntax will respond immediately with either an OK or an ERROR response. All commands with invalid syntax will not respond with anything. After an OK, any additional response is command specific. 6.1 OK OK STATUS RESPONSE Function: All successful commands will respond immediately with an OK response, except for ATRST...
Page 26: Events
Page 26 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Events 7.1 General Reset (RESET) RESET EVENT Function: The reset event will be printed as soon as the module is initialized and ready to receive commands after powering up or being reset. Event Format: RESET,<Factory_Reset>,<Reason>,<Module_Type>...
Page 27: Bootloader (Nboot)
Page 27 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Bootloader (NBOOT) BOOTLOADER EVENT Function: The bootloader event will occur when the module enters the bootloader. The reason will let the user know why the module entered the bootloader. For example, if an Over the Air update is started through the DFU service the bootloader event will occur with reason 2.
Page 28: Done (Done)
Page 28 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Done (DONE) DONE EVENT Function: The done event will be sent when a command that runs in the background times out. If a command is cancelled with ATDC, the DONE event will not be sent. Event Format: DONE,<Command_Type>,<Completed_Command>...
Page 29: Discovery
Page 29 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 7.2 Discovery Advertising and scan response data is made up of one or more data structures, as seen in the figure below. Each one consists of a different type of data which is defined by the AD/EIR Type. Non-extended advertising and scan response data can be up to 31 bytes long.
Page 30: Non-Extended Discovery (Discovery)
Page 30 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Non-Extended Discovery (DISCOVERY) NON-EXTENDED DISCOVERY EVENT Function: The non-extended discovery event will occur when a device is discovered using non-extended advertising packets after the ATDILE command has been issued. Event Format: DISCOVERY,<Discovery_Type>,<Addr>,<RSSI>, <Data_Structure_Count>,<Data_Structures>...
Page 31: Extended Discovery (Ext_Discovery)
Page 31 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Extended Discovery (EXT_DISCOVERY) EXTENDED DISCOVERY EVENT Function: The extended discovery event will occur when a device is discovered using extended advertising packets after the ATDILE command has been issued. Event Format: EXT_DISCOVERY,<Discovery_Type>,<Addr>,<RSSI>,<Primary_PHY>,<Secondary_PHY>,<Sed_ID>, <Data_ID>,<Data_Structure_Count>,<Data_Structures>...
Page 32: Connection
Page 32 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. EVENT: <cr_lf> EXT_DISCOVERY,7,ECFE7E000001:0,-45,4,2,0,295,6,020106-020A08- 051208001000-1107796022A0BEAFC0BDDE487962F1842BDA-05FF85000005- 1109BlueRadios000001<cr_lf> EVENT: <cr_lf> DONE,1,1<cr_lf> Note(s): ▪ An extended advertising event could be up to 600 characters long if the device is advertising the maximum length of 255 bytes with multiple ad data structures and hyphens are enabled in ATSDIF.
Page 33: Disconnect (Disconnect)
Page 33 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Disconnect (DISCONNECT) DISCONNECT EVENT Function: The disconnect event will be sent when a connection is terminated. Event Format: DISCONNECT,<Conn_Handle>,<Disconnect_Reason> Event Values: ▪ Conn_Handle: Connection handle ▪ Disconnect_Reason: 0 = Local Disconnect Requested 1 = Remote Disconnect Requested...
Page 34: Connection Parameter Update Status (Sccps)
Page 34 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Connection Parameter Update Status (SCCPS) CONNECTION PARAMETER UPDATE STATUS EVENT Function: The connection parameter update status event will be sent after issuing an ATSCCP command while in the slave role, letting the user know if the update request was accepted or rejected by the master.
Page 35: Connection Parameter Update (Cpu)
Page 35 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Connection Parameter Update (CPU) CONNECTION PARAMETER UPDATE EVENT Function: The connection parameter update event will be sent when the current connection parameters have changed. Event Format: CPU,<Conn_Handle>,<Conn_Interval>,<Slave_Latency>,<Supervision_Timeout> Event Values: ▪...
Page 36: Mtu Update (Mtu)
Page 36 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. MTU Update (MTU) MTU UPDATE EVENT Function: The MTU update event will be sent when an MTU exchange has completed. An MTU exchange is a GATT request, so GATT commands cannot be sent until the MTU event has occurred. If both devices being connected have their MTU set to 23 which is the minimum, then an MTU exchange will not be attempted and the MTU event will never occur.
Page 37: Phy Update (Phyu)
Page 37 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. PHY Update (PHYU) PHY UPDATE EVENT Function: The PHY update event will be sent when a connection PHY update request has been issued. In the case that the PHY update fails due to the receiving device not supporting one of the requested PHYs the PHYU event will still occur but the PHYs will stay the same.
Page 38: Rssi (Rssi)
Page 38 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. RSSI (RSSI) RSSI EVENT Function: The RSSI event will be sent after an RSSI reading has been requested using the ATRSSI? command. Event Format: RSSI,<Conn_Handle>,<RSSI_Value> Event Values: ▪...
Page 39: Pairing
Page 39 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 7.4 Pairing Pairing Request (PAIR_REQ) PAIRING REQUEST EVENT Function: The pairing request event will be sent when another device requests pairing and automatic pairing request accept is not enabled. The ATP or ATPLE command is used to accept a pairing request. Event Format: PAIR_REQ,<Conn_Handle>,<Addr>...
Page 40: Paired (Paired)
Page 40 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Paired (PAIRED) PAIRED EVENT Function: The paired event will be sent when pairing is successful. The connection is encrypted after this message is received. Event Format: PAIRED,<Conn_Handle>,<Bonded>,<Authenticated>,<Addr> Event Values: ▪...
Page 41: Pairing Failed (Pair_Fail)
Page 41 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Pairing Failed (PAIR_FAIL) PAIRING FAILED EVENT Function: The pairing failed event will be sent when a pairing request has failed. Event Format: PAIR_FAIL,<Conn_Handle>,<Addr>,<Reason> Event Values: ▪ Conn_Handle: Connection handle ▪...
Page 42: Passkey Request (Pk_Req)
Page 42 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Passkey Request (PK_REQ) PASSKEY REQUEST EVENT Function: The passkey request event will be sent when a passkey input is needed for authentication during the pairing process. The ATPKR command is used to respond to this event. Event Format: PK_REQ,<Conn_Handle>,<Addr>...
Page 43: Passkey Display (Pk_Dis)
Page 43 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Passkey Display (PK_DIS) PASSKEY DISPLAY EVENT Function: The passkey display event will be sent when a passkey needs to be displayed for authentication. When this event is received the Passkey shall be displayed to the user on the local device.
Page 44: Address Resolved (Resolved)
Page 44 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Address Resolved (RESOLVED) RESOLVED EVENT Function: This event will be sent when the module first pairs with a device that is using a private resolvable address type. It will inform the user of the device’s public address, which will be used in place of the private address from that point on.
Page 45 Page 45 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. COMMAND: ATDH,0<cr> RESPONSE: <cr_lf> OK<cr_lf> EVENT: <cr_lf> DISCONNECT,0,0<cr_lf> After disconnecting another discovery is performed. Now that the module is paired to the remote device and the address has been resolved, the public address is shown instead of the private address.
Page 46: Gatt Client
Page 46 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 7.5 GATT Client GATT Done (GATT_DONE) GATT DONE EVENT Function: This event will be sent when a GATT request is completed and report any errors that occurred.
Page 47 Page 47 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. EVENT: <cr_lf> GATT_DONE,0,4,1<cr_lf> 2. A GATT write is requested on handle 19, and after successfully completing a GATT_DONE is sent: COMMAND: ATGW,0,19,1,1<cr> RESPONSE: <cr_lf> OK<cr_lf> EVENT: <cr_lf>...
Page 48: Gatt Discovered Primary Service (Gatt_Dps)
Page 48 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GATT Discovered Primary Service (GATT_DPS) GATT DISCOVERED PRIMARY SERVICE EVENT Function: This event will be sent for each primary service discovered by an ATGDPS or ATGDPSU command.
Page 49: Gatt Discovered Characteristic (Gatt_Dc)
Page 49 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GATT Discovered Characteristic (GATT_DC) GATT DISCOVERED CHARACTERISTIC EVENT Function: This event will be sent for each characteristic discovered by an ATGDC or ATGDCU command. Event Format: GATT_DC,<Conn_Handle>,<Char_Value_Att_Handle>,<Char_Properties>, <Char_UUID>...
Page 50: Gatt Discovered Characteristic Descriptor (Gatt_Dcd)
Page 50 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GATT Discovered Characteristic Descriptor (GATT_DCD) GATT DISCOVER CHARACTERISTIC DESCRIPTOR EVENT Function: This event will be sent for each characteristic descriptor discovered by an ATGDCD command. Event Format: GATT_DCD,<Conn_Handle>,<Char_Desc_Att_Handle>,<Char_Desc_UUID> Event Values: ▪...
Page 51: Gatt Characteristic/Descriptor Value (Gatt_Val)
Page 51 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GATT Characteristic/Descriptor Value (GATT_VAL) GATT CHARACTERISTIC/DESCRIPTOR VALUE EVENT Function: This event will be sent when GATT data is received, either from a GATT read request or from a notification/indication.
Page 52: Gatt Long Characteristic/Descriptor Value (Gatt_Lval)
Page 52 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GATT Long Characteristic/Descriptor Value (GATT_LVAL) GATT LONG CHARACTERISTIC/DESCRIPTOR VALUE EVENT Function: This event will be sent when GATT data is received from a GATT read long request. A long read will come back in multiple chunks of 22 bytes at a time, with each consecutive GATT_LVAL returning at an offset 22 bytes further into the whole value.
Page 53: Gatt Service
Page 53 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 7.6 GATT Service Battery Level Event (BATT) BATTERY LEVEL EVENT Function: If BAS is enabled in Automatic mode with Critical_Level set to a non-zero value, the BATT event will fire to alert the application that the battery has dropped below the critical level.
Page 54: Brsp Status (Brsp)
Page 54 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. BRSP Status (BRSP) BRSP STATUS EVENT Function: The BRSP status event will be sent when the BRSP mode changes. Event Format: BRSP,<Conn_Handle>,<BRSP_Status>,<TX_Mode>,<RX_Mode> Event Values: ▪ Conn_Handle: Connection handle ▪...
Page 55: Brsp Data (Brspd)
Page 55 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. BRSP Data (BRSPD) BRSP DATA EVENT Function: The BRSP data event will be sent when BRSP data is received an BRSP RX_Mode is set to Event Mode in ATSBRSP. Event Format: BRSPD,<Conn_Handle>,<Data_Length>,<Data>...
Page 56: Custom Profile Read (Cp_Read)
Page 56 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Custom Profile Read (CP_READ) CUSTOM PROFILE READ EVENT Function: The custom profile read event will be sent when a GATT client device initiates a read on any of the characteristics or descriptors configured in the custom profile.
Page 57: Custom Profile Write (Cp_Write)
Page 57 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Custom Profile Write (CP_WRITE) CUSTOM PROFILE WRITE EVENT Function: The custom profile write event will be sent when a GATT client device initiates a write on any of the characteristics or descriptors configured in the custom profile.
Page 58: Commands
Page 58 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Commands 8.1 General Function: The AT prefix by itself can be used to check communication with the module. It will always respond with an OK. Example(s): COMMAND: AT<cr>...
Page 59: Response Mode (Atsrm)
Page 59 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Response Mode (ATSRM) SET RESPONSE MODE Function: Sets the module’s response mode, which configures how verbose the module will be. Command Format: ATSRM,<Response_Mode>,<Disconnected_Mode>,<Response_Event_Flags> Command Parameter(s): ▪ Response_Mode: The following events cannot be disabled: DISCOVERY, RSSI, GATT_DPS, GATT_DC, GATT_DCD, GATT_VAL, GATT_LVAL, BRSPD.
Page 60 Page 60 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Example(s): COMMAND: ATSRM,0,0<cr> RESPONSE: <cr_lf> OK<cr_lf> Note(s): ▪ When switching to limited or minimal response mode, the OK response will not come back after the ATSRM command. GET RESPONSE MODE Function: Sets the modules response mode.
Page 61: Reset
Page 61 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.2 Reset Reset (ATRST) RESET Function: Resets the module. Command Format: ATRST,<Delay> ▪ Delay: Integer value from 0 to 65535 [ms] to delay reset. Default: 0 (Reset immediately) Example(s): 1.
Page 62: Factory Reset (Atfrst)
Page 62 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Factory Reset (ATFRST) FACTORY RESET Function: Resets the module back to its factory defaults. Command Format: ATFRST,<Clear_Paired> ▪ Clear_Paired: 0 = Clear paired list 1 = Keep paired list Example(s): 1.
Page 63: Configuration Control
Page 63 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.3 Configuration Control By default, the module configuration will be automatically stored to flash any time an ATS prefixed command is sent. This behavior can be changed using the ATSFC command, allowing automatic flash storage to be disabled. When disabled the ATFC command can be used to manually store the module configuration in flash –...
Page 64 Page 64 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET CONFIGURATION LOCK Function: Gets the configuration lock setting. Command Format: ATSCL? Response Format: <Lock> Example(s): COMMAND: ATSCL?<cr> RESPONSE: <cr_lf> OK<cr_lf> <cr_lf> 0<cr_lf> 200 S. Wilcox St., Unit 158 • Castle Rock, CO 80104 • USA • 303-957-1003 • sales@blueradios.com www.BlueRadios.com...
Page 65: Configure Flash Storage Configuration (Atsfc)
Page 65 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Configure Flash Storage Configuration (ATSFC) SET FLASH STORAGE CONFIGURATION Function: Sets the flash storage configuration settings. Command Format: ATSFC,<Store_Config>,<Store_Last_Connected_Address> Command Parameter(s): ▪ Store_Config: 0 = Disabled – Any configuration changes must be manually stored using ATFC. 1 = Enabled –...
Page 66: Flash Configuration (Atfc)
Page 66 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Flash Configuration (ATFC) FLASH CONFIG Function: Stores the current configuration in flash. This command is intended to be used after all settings have been configured. If Store_Config is enabled in ATSFC, then each time a command is used to change configuration the configuration will be stored to flash, which is inefficient if multiple changes are being made.
Page 67 Page 67 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Note(s): ▪ After configuring the module using ATSCFG the module needs to be reset for the new configuration to take effect. GET CONFIGURATION Function: Reads the current configuration in hex format. Command Format: ATSCFG?,<Config_Index>...
Page 68: Configuration Dump (Atcfg?)
Page 68 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Configuration Dump (ATCFG?) GET CONFIGURATION Function: Dumps the current configuration. The configuration can be read in a readable format or a hex format that can be applied using the ATSCFG command. Command Format: ATCFG? Example(s): COMMAND:...
Page 69: Sleep
Page 69 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.4 Sleep Sleep (ATZ) SLEEP Function: Enables sleep mode. When sleep mode is enabled the module will enter a low power state when its MCU is idle. By default, the module will not be in sleep mode upon power up, but for maximum power savings it should be put into sleep mode as soon as possible after all configura tion is complete.
Page 70: Sleep Configuration (Atsz)
Page 70 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Sleep Configuration (ATSZ) SET SLEEP Function: Configures sleep mode. Command Format: ATSZ,<Sleep_On_Reset>,<Wake_On_Rx>,<PIO_7_Sleep_Status>, <Shutdown_PIO_State> Command Parameter(s): ▪ Sleep_On_Reset: 0 = Disabled. 1 = Sleep mode will automatically be enabled on power up or after a reset. ▪...
Page 71: Module Information
Page 71 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET SLEEP Function: Gets the sleep configuration. Command Format: ATSZ? Response Format: <Sleep_On_Reset>,<Wake_On_Rx>,<PIO_7_Sleep_Status>, <Shutdown_PIO_State> Example(s): COMMAND: ATSZ?<cr> RESPONSE: <cr_lf> OK<cr_lf> <cr_lf> 1,0,1,0<cr_lf> 8.5 Module Information Module Type (ATMT?) GET MODULE TYPE Function: Gets the module type.
Page 72: Stack Type (Atst?)
Page 72 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Stack Type (ATST?) GET STACK TYPE Function: Gets the stack type. Command Format: ATST? Response Format: BlueRadios nBlue Example(s): COMMAND: ATST?<cr> RESPONSE: <cr_lf> OK<cr_lf> <cr_lf> BlueRadios nBlue<cr_lf>...
Page 73: Bt5.0 Device Address (Ata?)
Page 73 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. BT5.0 Device Address (ATA?) GET ADDRESS Function: Gets the module’s BT5.0 Device Address. Command Format: ATA? Response Format: <Addr> Response Values: ▪ Addr: Local BT5.0 device address and address type. Example(s): COMMAND: ATA?<cr>...
Page 74: Bt5.0 Device Name (Atsn)
Page 74 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. BT5.0 Device Name (ATSN) SET NAME Function: Sets the module’s BT5.0 Device Name. This will be the GAP Device Name in the GAP Service Profile which can be read through the GATT layer. The name will also be placed in the scan response data, so when another device performs a discovery, the name will be returned in the scan response.
Page 75: Appearance (Atsapp)
Page 75 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Appearance (ATSAPP) SET APPEARANCE Function: Sets the value of the Appearance Characteristic, which represents the external appearance of the module. Command Format: ATSAPP,<Appearance> Command Parameters: ▪ Appearance: 16-bit integer value.
Page 76: Address Type (Atsat)
Page 76 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Address Type (ATSAT) SET ADDRESS TYPE Function: Sets the module’s BT5.0 identity address, which identifies the module to other devices. Also allows LE Privacy to be enabled or disabled. This address will be exchanged with a peer device during bonding.
Page 77 Page 77 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET ADDRESS TYPE Function: Gets the current address type and address being used by the module. Command Format: ATSAT? Response Format: <Addr_Type>,<Privacy_Type>,<Private_Addr_Cycle_Time> Example: COMMAND: ATSAT?<cr> RESPONSE: <cr_lf>...
Page 78: Module State
Page 78 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.6 Module State Get State (ATSLE?) GET STATE Function: Gets the current LE state of the module. Command Format: ATSLE? Response Format: <Idle_Testing>,<Advertising>,<Discovering>,<Connecting>,<Connected> Response Values: ▪ Idle_Testing: 0 = Not Idle 1 = Idle...
Page 79: Default Behavior (Atsdble)
Page 79 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Default Behavior (ATSDBLE) SET DEFAULT BEHAVIOR Function: Sets the module’s default behavior. Allows the user to select a command to automatically execute based on a trigger. Command Format: ATSDBLE,<Command>,<Trigger>...
Page 80: Cancel/Idle Command (Atdc)
Page 80 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET DEFAULT BEHAVIOR LE Function: Gets the module’s default behavior. Command Format: ATSDBLE? Response Format: <Command>,<Trigger>,<Bridge> Example(s): COMMAND: ATSDBLE?<cr> RESPONSE: <cr_lf> OK<cr_lf> <cr_lf> 1,0<cr_lf> Cancel/Idle Command (ATDC) CANCEL/IDLE Function: This command tells the radio to cancel commands that run in the background such as ATDM, ATDS, or ATDI.
Page 81: Hardware Configuration / Control
Page 81 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.7 Hardware Configuration / Control Set Default Power Levels (ATSDPL) SET DEFAULT POWER LEVELS Function: Sets the default transmit power levels. Command Format: ATSDPL,<Ad_TX_Power>,<Scan_TX_Power> Command Parameter(s): ▪...
Page 82: Set Current Power Level (Atscpl)
Page 82 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Set Current Power Level (ATSCPL) SET CURRENT POWER LEVEL Function: Sets the current power level for an active connection. Command Format: ATSCPL,<Conn_Handle>,<TX_Power> Command Parameter(s): ▪ Conn_Handle: Connection handle of connection to update. ▪...
Page 83: Uart Configuration (Atsuart)
Page 83 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. UART Configuration (ATSUART) SET UART Function: Configures the module’s UART. The new settings will take effect after the OK response has been sent. Command Format: ATSUART,<Baud_Rate>,<Parity>,<Stop_Bits>,<Flow_Control> Command Parameter(s): ▪...
Page 84 Page 84 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET UART Function: Gets the UART configuration. Command Format: ATSUART? Response Format: <Baud_Rate>,<Parity>,<Stop_Bits>,<Flow_Control> Example(s): COMMAND: ATSUART?<cr> RESPONSE: <cr_lf> OK<cr_lf> <cr_lf> 7,0,0,1<cr_lf> 200 S. Wilcox St., Unit 158 • Castle Rock, CO 80104 • USA • 303-957-1003 • sales@blueradios.com www.BlueRadios.com...
Page 85: Usb Configuration (Atsusb)
Page 85 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. USB Configuration (ATSUSB) SET USB Function: Configures the module’s USB port. Command Format: ATSUSB,<Enable_USB >,<Enable_Event_Port> Command Parameter(s): ▪ Enable_USB: If enabled, the module’s USB port will be enabled and a USB CDC ACM virtual serial port will be available.
Page 86: Nfc Configuration (Atsnfc)
Page 86 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. NFC Configuration (ATSNFC) SET NFC Function: Enables/disables the module’s NFC (Near Filed Communication) subsystem. When enabled the module can pair with another device using NFC. Command Format: ATSNFC,<Enable> Command Parameter(s): ▪...
Page 87: Pio Configuration (Atspio)
Page 87 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. PIO Configuration (ATSPIO) SET PIO CONFIG Warning: Applying an external voltage to a PIO assigned as an output may permanently damage the module. The maximum voltage level on any pin should not exceed 3.6V. The I/O is NOT 5V tolerant.
Page 88 Page 88 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET PIO CONFIG Function: Reads PIO settings. Command Format: ATSPIO?,<PIO_Num> Command Parameter(s): ▪ PIO Number: 0-46 (Excluding 3,4,6,17,18,23,24) Response Format: <Direction>,<Value>,<Pull_Drive_Strength> Example(s): COMMAND: ATSPIO?,7<cr> RESPONSE: <cr_lf> OK<cr_lf>...
Page 89: Pio Level (Atpiol)
Page 89 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. PIO Level (ATPIOL) SET PIO LEVEL Warning: Applying an external voltage to a PIO assigned as an output may permanently damage the module. The maximum voltage level on any pin should not exceed 3.6V. The I/O is NOT 5V tolerant.
Page 90: Led Configuration (Atsled)
Page 90 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. LED Configuration (ATSLED) SET LED Function: Sets the status LED (PIO_2/PIO_5) parameters. Command Format: ATSLED,<Led_Num>,<Duty_Cycle>,<Period>,<Override_Default_Behavior> Command Parameter(s): ▪ Led_Num: 0 = PIO_2 – Will pulse when the module is connected. 1 = PIO_5 –...
Page 91: Get Adc (Atadc?)
Page 91 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET LED Function: Gets the LED (PIO_2/PIO_5) parameters. Command Format: ATSLED?,<Led_Num> Command Parameter(s): ▪ Led_Num: 0 = PIO_2 1 = PIO_5 Response Format: <Duty Cycle>,<Period>,<Override_Default_Behavior> Example(s): COMMAND: ATSLED?,1<cr>...
Page 93: Get Battery Level (Atbl?)
Page 93 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Get Battery Level (ATBL?) GET BATTERY LEVEL Function: Gets the battery level as a percentage from 0-100. The level is only valid if a 3.0V coin cell is connected directly to VDD.
Page 94: Get Temperature (Att?)
Page 94 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Get Temperature (ATT?) GET TEMPERATURE Function: Get the current temperature of the module’s internal temperature sensor. Command Format: ATT? Response Format: <Temp_Celsius>,<Temp_Fahrenheit> Response Value(s): ▪ Temp_Celsius: Temperature in Celsius. ▪...
Page 95: Advertising
Page 95 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.8 Advertising Advertising can now be done using either legacy non-extended advertising with a maximum packet size of 31 bytes or using the new extended advertising packets with a maximum packet size of 255 bytes. Extended advertising takes place in 2 stages and a different PHY can be used for each stage.
Page 96: Advertising Configuration (Atsdsle)
Page 96 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. ▪ Direct_Duty_Cycle: (Only applies to non-extended advertising) 0 = Low Duty Cycle – A power efficient directed advertising mode for cases where reconnection with a specific device is required, but time is not of the essence or it is not known if the central device is in range or not.
Page 97 Page 97 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. ▪ Channel_Map: 1 = 37 2 = 38 3 = 37,38 4 = 39 5 = 37,39 6 = 38,39 7 = 37,38,39 ▪ Extended_Primary_PHY: (Only applies if using an extended Ad_Type) 1 = 1M (1Mbps Standard) 4 = LR (125Kbps Coded Long Range) ▪...
Page 98: Advertising Timing Configuration (Atsdstle)
Page 98 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Advertising Timing Configuration (ATSDSTLE) SET ADVERTISING TIMING Function: Sets a module’s advertising (ATDSLE) timing parameters. Command Format: ATSDSTLE,<Ad_Timeout>,<Unconnected_Ad_Interval>, <Connected_Ad_Interval> Command Parameter(s): ▪ Ad_Timeout: Integer value from 0 to 180 [s]. A value of 0 will disable the timeout and set the General Discoverable Flag in the advertising flags structure.
Page 99: Advertising/Scan Response Data (Atsdsdle)
Page 99 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Advertising/Scan Response Data (ATSDSDLE) SET ADVERTISING/SCAN RESPONSE DATA Function: This command is used to configure the module’s advertising and scan response data. The advertising data is transmitted in an advertising packet at the advertising interval set in ATSDIT, the scan response data will only be sent if requested by a device performing an active scan.
Page 100 Page 100 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. member company that requests one: https://www.bluetooth.org/Technical/AssignedNumbers/identifiers.htm Auto Populating Ad Data Structures: Certain ad data structures can now be set to automatically populate their data by setting the data to 0xFF.
Page 101 Page 101 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. • Manufacturer Specific Data = 05FFFFFFFFFF This ad data structure will automatically populate with BlueRadios manufacturer specific data identifying the module type. Command Format: ATSDSDLE,<Data_Type>,<Data> Command Parameter(s): ▪...
Page 102 Page 102 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 2. The same data as in example 1, but without specifying the flags. Since the flags are automatically inserted at the front of the ad data, the actual advertising data will be: 02010607FF8500FF010203.
Page 103 Page 103 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Note(s): ▪ When Auto_Flash is enabled in ATSFC, the ad/scan data will be stored in flash each time this command is called. Advertising will be automatically cancelled and restarted to store the data in flash, so a new advertising packet will go out and the interval will start again from that point.
Page 104: Discovery
Page 104 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.9 Discovery ▪ Active vs. Passive Mode – A master in the discovering state will receive advertising packets from slaves in the advertising state. In a passive scan the master will only print the data contained in these advertising packets.
Page 105: Discovery Configuration (Atsdile)
Page 105 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. EVENT: <cr_lf> DISCOVERY,3,ECFE7E000002:0,-45,4,020106-020A04-051208000800- 1107796022A0BEAFC0BDDE487962F1842BDA<cr_lf> EVENT: <cr_lf> DONE,1,1<cr_lf> Note(s): ▪ An OK response is returned immediately following this command. A DONE event will appear after all devices have been found, or an inquiry timeout has occurred while searching for the number of devices specified.
Page 106 Page 106 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. ▪ Channel_Map: 1 = 37 2 = 38 3 = 37,38 4 = 39 5 = 37,39 6 = 38,39 7 = 37,38,39 Example(s): COMMAND: ATSDILE,0,0,1,10,0,7<cr> RESPONSE: <cr_lf>...
Page 107: Discovery Timing Configuration (Atsditle)
Page 107 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Discovery Timing Configuration (ATSDITLE) SET DISCOVERY TIMING Function: Sets the module’s discovery (ATDILE) timing parameters. The Interval and Window set the scanning duty cycle used during discovery. The Interval sets how frequently the module should scan and the Window sets how long it will scan at each Interval.
Page 108: Discovery Event Formatting (Atsdif)
Page 108 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Discovery Event Formatting (ATSDIF) SET DISCOVERY FORMATTING Function: Sets discovery event formatting parameters. Command Format: ATSDIF,<Data_Structure_Flags>,<Name_Format>,<Hyphens>, <Discovery_Type_Format>,<Global_Format> Command Parameter(s): ▪ Data_Structure_Flags: Data structures enabled in the mask will be printed in discovery events. If set to 0, no data structures will be printed.
Page 109 Page 109 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 2 = String Format – The Discovery_Type will be a string composed of a combination of the strings in the table below. For example, an extended connectable advertisement would be: String Value Connectable...
Page 110: Connection
Page 110 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.10 Connection ▪ Extended Advertising – Whether the module can connect to a device using extended advertising PHYs or not can be controlled through the Extended_Primary_Phys parameter. Connect (ATDMLE) DIAL AS MASTER (CONNECT) Function: This command initiates a connection to a slave device.
Page 111 Page 111 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. ▪ The ATDMLE command is used to initiate an LE connection with BRSP_Mode set to Data Mode and once connected the CONNECT event is sent. Once Data Mode is ready, the BRSP,0,1 message is sent.
Page 112: Connect Last (Atdmlle)
Page 112 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Connect Last (ATDMLLE) DIAL AS MASTER LAST (CONNECT LAST) Function: Initiates a connection to the LE device address from the last LE CONNECT event. This address can be read using the ATLCALE? Command Format: ATDMLLE,<BRSP_Mode>...
Page 113: Last Connect Address (Atlcale?)
Page 113 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Last Connect Address (ATLCALE?) GET LAST CONNECT ADDRESS Function: Gets the BT5.0 device address from the last LE CONNECT event. Command Format: ATLCALE? Response Format: <Addr> Response Values: ▪...
Page 114: Connect Configuration (Atsdmle)
Page 114 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Connect Configuration (ATSDMLE) SET CONNECT CONFIGURATION Function: Sets the connection command parameters. Command Format: ATSDMLE,<Channel_Map>,<BRSP_On_Connect> Command Parameter(s): ▪ Channel_Map: 1 = 37 2 = 38 3 = 37,38 4 = 39 5 = 37,39 6 = 38,39...
Page 115: Connect Timing Configuration (Atsdmtle)
Page 115 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Connect Timing Configuration (ATSDMTLE) SET CONNECT TIMING Function: Sets the connection initiation timing parameters. The Interval and Window set the scanning duty cycle used during connection establishment. The Interval sets how frequently the module should scan and the Window sets how long it will scan at each Interval.
Page 116: Connection Parameters
Page 116 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET CONNECT TIMING LE Function: Gets the connection initiation timing parameters. Command Format: ATSDMTLE? Response Format: <Timeout>,<Interval>,<Window> Example(s): COMMAND: ATSDMTLE?<cr> RESPONSE: <cr_lf> OK<cr_lf> <cr_lf> 0,16,16<cr_lf> Connection Parameters The connection parameters control how often two devices in a connection will meet up to exchange data in a connection event.
Page 117 Page 117 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.10.6.1 Default Connection Parameters (ATSDCP) SET DEFAULT CONNECTION PARAMETERS Function: Sets the module’s default connection parameters. Command Format: ATSDCP,<Min_Conn_Interval>,<Max_Conn_Interval>,<Slave_Latency>, <Supervision_Timeout>,<Slave_Auto_Update> Command Parameter(s): ▪ Min_Conn_Interval: Integer value from 6 to 3200 [1.25ms]. Can be set to 65535 (No specific interval preferred) on a slave role module.
Page 118 Page 118 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET DEFAULT CONNECTION PARAMETERS Function: Gets the module’s default connection parameters. Command Format: ATSDCP? Response Format: <Min_Conn_Interval>,<Max_Conn_Interval>,<Slave_Latency>, <Supervision_Timeout>,<Slave_Auto_Update> Example(s): COMMAND: ATSDCP?<cr> RESPONSE: <cr_lf> OK<cr_lf> <cr_lf> 8,16,0,400,0<cr_lf> 200 S.
Page 119 Page 119 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.10.6.2 Current Connection Parameters (ATSCCP) SET CURRENT CONNECTION PARAMETERS Function: Attempts to update the current connection parameters for an existing connection. If the module is in the master role of a connection, the connection parameter update will always be successful if the command is accepted and a CPU event will be generated when the parameters have been changed.
Page 120: Default Mtu (Atsdmtu)
Page 120 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Note(s): ▪ Effective Connection Interval = Connection Interval * (1+Slave Latency) GET CURRENT CONNECTION PARAMETERS Function: Gets the current connection parameters for an existing connection. Command Format: ATSCCP?,<Conn_Handle> Command Parameter(s): ▪...
Page 121: Connection Phys
Page 121 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET DEFAULT MTU Function: Gets the module’s default MTU. Command Format: ATSDMTU? Response Format: <MTU> Example(s): COMMAND: ATSDMTU?<cr> RESPONSE: <cr_lf> OK<cr_lf> <cr_lf> 247<cr_lf> Connection PHYS 8.10.8.1 Supported PHYS (ATSSPHY) SET SUPPORTED PHYS Function: Sets the PHYs the module will accept if a connection PHY update is requested by another...
Page 122 Page 122 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET SUPPORTED PHYS Function: Gets the module’s supported PHYs. Command Format: ATSSPHY? Response Format: <RX_PHYS>,<TX_PHYS> ▪ RX_PHYS: 1 = 1M (1Mbps Standard) 2 = 2M (2Mbps High Speed) 3 = 1M, 2M 4 = LR (125Kbps Coded Long Range) 5 = 1M, LR...
Page 123 Page 123 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. ▪ TX_PHY: 1 = 1M (1Mbps Standard) 2 = 2M (2Mbps High Speed) 4 = LR (125Kbps Coded Long Range) Example(s): 1. A PHY update to 2M is requested on connection handle 0 and succeeds. COMMAND: ATSCPHY,0,2,2<cr>...
Page 124: Connection Status (Atcs?)
Page 124 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Connection Status (ATCS?) GET CONNECTION STATUS Function: Gets the details of an existing connection. If no connection handle is specified, then the connection status for all open connections will be returned followed by a DONE event to signal the end of the connection list.
Page 125 Page 125 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Example(s): 1. Connection status for connection handle 0 is requested, it is an unpaired LE connection to ECFE7E000000. COMMAND: ATCS?,0<cr> RESPONSE: <cr_lf> OK<cr_lf> <cr_lf> 0,2,1,ECFE7E000000:0,16,0,400,247,1,1,8<cr_lf> 2. Connection status for all connections is requested. One active connection is found, it is an unpaired LE connection to ECFE7E00000.
Page 126: Connection Rssi (Atrssi?)
Page 126 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Connection RSSI (ATRSSI?) GET CONNECTION RSSI VALUE Function: Used to obtain the Received Signal Strength Indication (RSSI) value of the last packet received when connected. The radio has a built-in received signal-strength indication, which calculates an 8-bit signed digital value that is the result of averaging the received power over eight symbol periods (128µs).
Page 127: Continuous Connection Rssi (Atcrssi)
Page 127 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. RSSI,1,-38<cr_lf> <cr_lf> DONE,2,0<cr_lf> Note(s): ▪ The module must be connected to read the RSSI. Continuous Connection RSSI (ATCRSSI) CONTINUOUS CONNECTION RSSI Function: Used to continuously obtain the Received Signal Strength Indication (RSSI) value of the last packet received when connected.
Page 128: Disconnect Command (Atdh)
Page 128 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Disconnect Command (ATDH) DISCONNECT Function: This command will terminate a specific connection or all active connections. Command Format: ATDH,<Conn_Handle> Command Parameter(s): ▪ Conn_Handle: Connection handle of connection to terminate. If not specified all active connections will be terminated.
Page 129: Pairing
Page 129 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.11 Pairing Pair Command (ATPLE) PAIR DEVICE Function: This command is used to initiate LE pairing, which will enable encryption. It is also used to respond to a pairing request. The module must be in the connected state to use this command. Command Format: ATPLE,<Addr_Conn_Handle>,<Accept_Request>...
Page 130 Page 130 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET PAIRED DEVICES LE Function: This command is used to read the paired LE devices. Command Format: ATPLE? Response Format: <Count>,<Addrs> Response Value(s): ▪ Count: Number of paired devices Addrs: List of paired addresses, separated by ‘-‘...
Page 131: Pairing Configuration (Atsple)
Page 131 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Pairing Configuration (ATSPLE) PAIRING PARAMETERS Function: This command is used to configure LE pairing. Command Format: ATSPLE,<Request_Handling>,<Authentication>,<IO_Capabilities>, <Sync_White_List>,<Disconnect_Unpaired>,<LESC> Command Parameter(s): ▪ Request_Handling: 0 = Reject all pairing requests. (Disable Pairing) 1 = Prompt for all pairing requests with PAIR_REQ event.
Page 132 Page 132 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Example(s): COMMAND: ATSPLE,2,0,3<cr> RESPONSE: <cr_lf> OK<cr_lf> Non-LESC IO Capability/Authentication Mapping: Numeric Display Pairing Display Display No Input Initiator → Keyboard Only with Only Numeric Yes/No Output Keyboard Buttons Pairing...
Page 133 Page 133 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. LESC IO Capability/Authentication Mapping: Numeric Display Pairing Display Display No Input Initiator → Keyboard Only with or Output Only Numeric Yes/No Buttons Keyboard Pairing Responder ↓ Display Just Works: Just Works:...
Page 134: Unpair Device (Atuple)
Page 134 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Unpair Device (ATUPLE) UN PAIR DEVICE Function: This command is used to delete the pairing information for an LE device. Command Format: ATUPLE,<Addr> Command Parameter(s): ▪ Addr: Device address and address type.
Page 135: Passkey Response (Atpkr)
Page 135 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Passkey Response (ATPKR) PASSKEY RESPONSE Function: Responds to a passkey request (PK_REQ) event. The passkey request event will be sent when a passkey input is needed for authentication during the pairing process. Command Format: ATPKR,<Addr_Conn_Handle>,<Passkey>...
Page 136: Passkey Confirm (Atpkc)
Page 136 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Passkey Confirm (ATPKC) PASSKEY CONFIRM Function: Responds to a passkey display (PK_DIS) event that required confirmation. Command Format: ATPKC,<Conn_Handle>,<Confirm> Command Parameter(s): ▪ Conn_Handle: Connection handle. ▪ Confirm: 0 = Passkey does not match.
Page 137: Fixed Passkey (Atspk)
Page 137 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Fixed Passkey (ATSPK) SET PASSKEY Function: Sets a fixed passkey to be used for Low Energy pairing authentication. A fixed passkey can be used to support authentication on a device without a keypad or display, although it does not provide the same level of security that a randomly generated passkey would.
Page 138 Page 138 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET PASSKEY Function: Gets the fixed passkey. Command Format: ATSPK? Response Format: <Passkey> Example(s): COMMAND: ATSPK?<cr> RESPONSE: <cr_lf> OK<cr_lf> <cr_lf> 123456<cr_lf> 200 S. Wilcox St., Unit 158 • Castle Rock, CO 80104 • USA • 303-957-1003 • sales@blueradios.com www.BlueRadios.com...
Page 139: White List
Page 139 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.12 White List White List Device (ATSWL) WHITE LIST Function: This command is used to add a device to the White List. The White List allows an LE device to filter out only the devices it cares about and ignore all others.
Page 140: Un White List Device (Atuwl)
Page 140 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET WHITE LIST Function: This command is used to read the White List. Command Format: ATSWL? Response Format: <Count>,<Addrs> Response Value(s): ▪ Count: Number of devices in the White List. Addrs: List of addresses in the White List, separated by ‘-‘...
Page 141: Clear White List (Atcwl)
Page 141 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Clear White List (ATCWL) CLEAR WHITE LIST Function: This command is used to remove all devices from the White List. Command Format: ATCWL Example(s): COMMAND: ATCWL<cr> RESPONSE: <cr_lf>...
Page 142: Gatt Client
Page 142 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.13 GATT Client The GATT client commands allow the module to use the Generic Attribute Profile (GATT) to discover and use the services on a remote device. GATT commands cannot be cancelled using the ATDC command. Discover All Primary Services (ATGDPS) GATT DISCOVER ALL PRIMARY SERVICES Function: This command is used to discover all the primary services on a server.
Page 143: Discover Primary Services By Uuid (Atgdpsu)
Page 143 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. EVENT: <cr_lf> GATT_DPS,0,14,24,DIS<cr_lf> EVENT: <cr_lf> GATT_DPS,0,25,28,BAS<cr_lf> EVENT: <cr_lf> GATT_DPS,0,29,32,DFU<cr_lf> EVENT: <cr_lf> GATT_DPS,0,33,65535,BRSP<cr_lf> EVENT: <cr_lf> GATT_DONE,0,0,0<cr_lf> Discover Primary Services by UUID (ATGDPSU) GATT DISCOVER PRIMARY SERVICES BY UUID Function: This command is used to discover a specific primary service on a server.
Page 144: Discover All Characteristics (Atgdc)
Page 144 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Discover All Characteristics (ATGDC) GATT DISCOVER ALL CHARACTERISTICS Function: This command is used to discover all the characteristics on a server or all the characteristics within a specific attribute handle range. Command Format: ATGDC,<Conn_Handle>,<Start_Att_Handle>,<End_Att_Handle>...
Page 145: Discover Characteristics By Uuid (Atgdcu)
Page 145 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Discover Characteristics by UUID (ATGDCU) GATT DISCOVER CHARACTERISTICS BY UUID Function: This command is used to discover specific characteristics on a server or specific characteristics within a specific attribute handle range. Command Format: ATGDCU,<Conn_Handle>,<UUID>,<Start_Att_Handle>,<End_Att_Handle>...
Page 146: Characteristic Descriptor Discovery (Atgdcd)
Page 146 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Characteristic Descriptor Discovery (ATGDCD) GATT DISCOVER CHARACTERISTIC DESCRIPTORS Function: This command is used to discover all the characteristic descriptors within a characteristic definition. It will return all attributes within the specified handle range, so if the range is not correctly specified, attribute types other than descriptors will be returned.
Page 147: Characteristic Read (Atgr)
Page 147 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. EVENT: <cr_lf> GATT_DCD,0,28,2902<cr_lf> EVENT: <cr_lf> GATT_DONE,0,3,0<cr_lf> Characteristic Read (ATGR) GATT READ Function: This command is used to read specific characteristic values or descriptors from a server when the attribute handle of the characteristic value or descriptor is known.
Page 148: Characteristic Read Multiple (Atgrm)
Page 148 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Characteristic Read Multiple (ATGRM) GATT READ MULTIPLE Function: This command is used to read multiple characteristic values or descriptors from a server when the attribute handle of the characteristic values or descriptors is known. The data is returned as one blob of data since the module has no way to know the length of the multiple characteristic values being returned.
Page 149: Characteristic Read Long (Atgrl)
Page 149 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Characteristic Read Long (ATGRL) GATT READ LONG Function: This command is used to read specific characteristic values or descriptors from a server when the attribute handle of the characteristic value or descriptor is known. This command allows reads greater than MTU-1 bytes in length.
Page 150: Characteristic Read By Uuid (Atgru)
Page 150 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Characteristic Read by UUID (ATGRU) GATT READ BY UUID Function: This command is used to read specific characteristic values or descriptors from a server when the handle of the characteristic value or descriptor is not known. If Start_Att_Handle is specified, End_Att_Handle must also be specified.
Page 151: Characteristic Write (Atgw)
Page 151 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. EVENT: <cr_lf> GATT_DONE,0,4,0<cr_lf> Characteristic Write (ATGW) GATT WRITE Function: This command is used to write a specific characteristic value or descriptor from a server when the attribute handle of the characteristic value or descriptor is known. The server will return a response confirming the value was written, which will trigger a GATT_DONE event.
Page 152 Page 152 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 3. Writing the string “HELLO” using Value_Format 5. COMMAND: ATGW,0,99,5,HELLO<cr> RESPONSE: <cr_lf> OK<cr_lf> EVENT: <cr_lf> GATT_DONE,0,5,0<cr_lf> 4. Writing the string “HELLO” using Value_Format 0. This is equivalent to example 3. COMMAND: ATGW,0,99,0,48454C4C4F<cr>...
Page 153: Characteristic Write No Response (Atgwn)
Page 153 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Characteristic Write No Response (ATGWN) GATT WRITE NO RESPONSE Function: This command is used to write a specific characteristic value or descriptor on a server when the attribute handle of the characteristic value or descriptor is known.
Page 154: Characteristic Write Prepared (Atgwp/Atgwpe)
Page 154 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Characteristic Write Prepared (ATGWP/ATGWPE) GATT WRITE PREPARED Function: This command can be used to manually perform a long write, allowing more bytes to be sent than with the ATGW command. It can also be used when multiple characteristic values must be written, in order, in a single operation.
Page 155 Page 155 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. COMMAND: ATGWP,0,99,5,7890,36<cr> RESPONSE: <cr_lf> OK<cr_lf> EVENT: <cr_lf> GATT_DONE,0,7,0<cr_lf> COMMAND: ATGWPE,0<cr> RESPONSE: <cr_lf> OK<cr_lf> EVENT: <cr_lf> GATT_DONE,0,8,0<cr_lf> GATT WRITE PREPARED EXECUTE Function: This command is used to finalize a prepared write. Command Format: ATGWPE,<Conn_Handle>,<Execute>...
Page 156: Gatt Service Configuration
Page 156 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.14 GATT Service Configuration Device Information Service (ATSDIS) SET DIS CONFIGURATION Function: Configures the Device Information Service (DIS) on modules running Peripheral Observer firmware. DIS exposes manufacturer and/or vendor information about a device. All characteristics are optional though, so individual characteristics can be disabled if not needed.
Page 157 Page 157 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Default: Disabled, “FE006578706572696D656E74616C” 8 = PnP ID Default: Enabled, “01850000000001” ▪ Enable: 0 = Characteristic Disabled 1 = Characteristic Enabled ▪ Value: The value characteristic is optional to allow enabling/disabling without changing the value. Characteristic_ID 0-5: 1-20-byte ASCII string Characteristic_ID 6: 8-byte ASCII Hex string (16 characters) Characteristic_ID 7: 1-20-byte ASCII Hex string (2-40 characters)
Page 158 Page 158 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET DIS CONFIGURATION Function: Gets the DIS service configuration. Command Format: ATSDIS?,<Characteristic_ID> Command Parameter(s): ▪ Characteristic_ID: 0 = Manufacturer Name String 1 = Model Number String 2 = Serial Number String 3 = Hardware Revision String 4 = Firmware Revision String...
Page 159: Battery Service (Atsbas)
Page 159 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Battery Service (ATSBAS) SET BAS CONFIGURATION Function: Configures the Battery Service (BAS). The Battery Service specification can be found here: https://www.bluetooth.com/specifications/gatt Command Format: ATSBAS,<Service_Enable>,<Mode>,<Update_Interval>,<Critical_Level> Command Parameter(s): ▪...
Page 160 Page 160 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 3. Enables the BAS service in automatic mode, set to update the level every hour (3600s) with a critical level of 10%. COMMAND: ATSBAS,1,1,3600,10<cr> RESPONSE: <cr_lf> OK<cr_lf>...
Page 161 Page 161 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.14.2.1 Battery Service Level (ATSBASL) SET BAS LEVEL Function: Sets the Battery Service battery level. Command Format: ATSBASL,<Level> Command Parameter(s): ▪ Level: 0-100% Example(s): 1. Sets the battery level to 100%. COMMAND: ATSBASL,100<cr>...
Page 162: Dfu Service (Atsdfu)
Page 162 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. DFU Service (ATSDFU) SET DFU CONFIGURATION Function: Configures the Over the Air Firmware Update Service (DFU). Command Format: ATSDFU,<Service_Enable>,<Active> Command Parameter(s): ▪ Service_Enable: [Reset required for change to take effect] 0 = DFU Service Disabled 1 = DFU Service Enabled ▪...
Page 163: Brsp Service (Atsbrsp)
Page 163 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. BRSP Service (ATSBRSP) Blue™ modules use a proprietary GATT profile developed by BlueRadios to stream data; it is not an official BT5.0 profile. BlueRadios serial port implementation simplifies the user experience, allowing users to stream data Blue™...
Page 164 Page 164 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Note(s): ▪ To set Security_Mode to 2 or 3 the IO_Capabilities of ATSPLE must not be set to 3 (No Input No Output.) ▪ A reset is required for a change to the Service_Enable parameter to take effect. GET BRSP CONFIGURATION Function: Gets the BRSP service parameters.
Page 165 Page 165 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. GET SERIAL PROFILE Function: Gets the escape character and no data timeout parameters. Command Format: ATSSP? Response Format: <Escape_Char>,<No_Data_Timeout> Example(s): COMMAND: ATSSP?<cr> RESPONSE: <cr_lf> OK<cr_lf> <cr_lf> 43,0<cr_lf>...
Page 166 Page 166 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Note(s): ▪ The three escape characters will not be passed through to the remote module. ▪ The escape character can be changed using the ATSSP command. 8.14.4.3 Data Mode (ATMD) DATA MODE...
Page 167 Page 167 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.14.4.4 Remote Command Mode (ATMRC) REMOTE COMMAND MODE Function: Attempts to put the module into Remote Command Mode. In Remote Command Mode all UART data is sent to the remote device using the BRSP service for LE connections. On the remote device the data is then interpreted as an AT command, executed on the remote device, and then responded to over the air.
Page 168 Page 168 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.14.4.5 BRSP Write (ATBRSPW) BRSP WRITE Function: Used to send BRSP data when BRSP TX_Mode is set to Command Mode. Command Format: ATBRSPW,<Conn_Handle>,<Data>,<Carriage_Return> Command Parameter(s): ▪ Conn_Handle: Connection handle to send the data to.
Page 169: Rf Testing
Page 169 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.15 RF Testing LE Direct Test Mode (ATDTM) LE DIRECT TEST MODE Function: This command is used to put the module into the LE Direct Test Mode (DTM) described in Volume 6 Part F of the BT5.0 Specification.
Page 170: Transmitter Test (Attxt)
Page 170 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Transmitter Test (ATTXT) TRANSMITTER TEST Function: This command is used to start an RF transmitter test. This can be used to satisfy in part radio regulation requirements as specific in standards such as ARIB STD-T66. Command Format: ATTXT,<Mode>,<Channel_Hop_Rate>,<TX_Power>,<Data_Rate>...
Page 171: Receiver Test (Atrxt)
Page 171 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Receiver Test (ATRXT) RECEIVER TEST Function: This command is used to start an RF receiver test. The module can receive from a module in the transmitter test mode 0 on the same channel. The module will sample the RSSI at a specified rate for a specified duration and report back the values, with an average being reported at the end of the test.
Page 172: Rf Observation (Atrfo)
Page 172 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. -42<cr_lf> <cr_lf> -43<cr_lf> <cr_lf> -44<cr_lf> <cr_lf> AVG,-43.00<cr_lf> <cr_lf> Note(s): ▪ The module must be in test mode (ATTEST) before executing an ATRXT. The test can be canceled with an ATDC command.
Page 173: Bootloader
Page 173 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.16 Bootloader Run Bootloader (ATBOOT) RUN BOOTLOADER Function: This commands the module into the bootloader, after the specified delay. Command Format: ATBOOT,<Delay> Command Parameter(s): ▪ Delay: Integer value from 0 to 65535 [ms]. Default: 0 [ms] Example(s): COMMAND: ATBOOT<cr>...
Page 174: Bootloader Configuration (Atsboot)
Page 174 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Bootloader Configuration (ATSBOOT) SET BOOTLOADER Function: Configures the module’s bootloader transport settings. The UART transport mode cannot be disabled. Command Format: ATSBOOT,<USB_Enable>,<UART_Baud_Rate>,<UART_Flow_Control> Command Parameter(s): ▪ USB_Enable 0 = Disabled 1 = Enabled ▪...
Page 175: Custom Profile
Page 175 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 8.17 Custom Profile The custom profile allows the user to add custom services to the GATT server profile. Custom profile requires a host controller connected via the UART or USB interfaces to responded to Custom Profile Read Custom Profile Write...
Page 176: Custom Profile Settings (Atscp)
Page 176 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Custom Profile Settings (ATSCP) SET CUSTOM PROFILE SETTINGS Function: Configures the custom profile settings. Command Format: ATSCP,<No_Response_Timeout> Command Parameter(s): ▪ No_Response_Timeout: Integer value from 1-65535 [ms]. The timeout after no response received from the host to CP_READ and CP_WRITE events.
Page 177: Custom Profile Service (Atscps)
Page 177 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Custom Profile Service (ATSCPS) ADD CUSTOM PROFILE SERVICE Function: Adds a custom profile service. Service Structure UUID (uint8[16]) 128-bit base UUID, do not include hyphens. Example: A3040000E8DF4E40A8EC5EB89C80E29D Characteristics Count (uint8) The number of characteristics included.
Page 178 Page 178 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Write Permission (uint8) Security Access Value Description SEC_NO_ACCESS 0x00 Not possible to access SEC_OPEN 0x01 Access open SEC_JUST_WORKS 0x02 Access possible with 'Just Works' security at least SEC_MITM 0x03 Access possible with 'MITM' security at least...
Page 179 Page 179 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Write Permission (uint8) Security Access Value Description SEC_NO_ACCESS 0x00 Not possible to access SEC_OPEN 0x01 Access open SEC_JUST_WORKS 0x02 Access possible with 'Just Works' security at least SEC_MITM 0x03 Access possible with 'MITM' security at least...
Page 180 Page 180 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 2AA8 Descriptor 2 UUID SEC_NO_ACCESS Descriptor 2 Read Permission SEC_OPEN Descriptor 2 Write Permission 0400 Descriptor 2 Max Attribute Value Length Characteristic 2 Settings Hex Value Value B3040002E8DF4E40A8EC5EB89C80E29D Characteristic UUID...
Page 181: Custom Profile Update Value (Atcpuv)
Page 181 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Custom Profile Update Value (ATCPUV) SET CUSTOM PROFILE UPDATE VALUE Function: This command is used to update the characteristic values and descriptors in the custom profile service. Read Longs are handled internally by the module, so send all data in one ATCPUV command.
Page 182: Custom Profile Read Response (Atcprr)
Page 182 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Custom Profile Read Response (ATCPRR) SET CUSTOM PROFILE READ RESPONSE Function: This command is used to respond to CP_READ events. If this does not follow a Custom Profile Update Value (ATCPUV) command, the value stored in the stack will be sent.
Page 183: Custom Profile Write Response (Atcpwr)
Page 183 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Custom Profile Write Response (ATCPWR) SET CUSTOM PROFILE WRITE RESPONSE Function: This command is used to respond to CP_WRITE events. Command Format: ATCPWR,<Conn_Handle ><Svc_Index>,<Char_Index>,<Desc_Index>,<Result> Command Parameter(s): ▪...
Page 184: Extended Examples
Page 184 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Extended Examples The examples in this section will demonstrate using various commands together to accomplish common scenarios and use cases, as opposed to the command specific examples shown in the command definitions. New examples will be continually added to this section.
Page 185 Page 185 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. EVENT: <cr_lf> GATT_DCD,0,28,2902<cr_lf> EVENT: <cr_lf> GATT_DONE,0,3,0<cr_lf> 5. Enable notifications by writing the value 0x0001 to the characteristic configuration descriptor. COMMAND: ATGW,0,28,2,1<cr> RESPONSE: <cr_lf> OK<cr_lf> EVENT: <cr_lf> GATT_DONE,0,5,0<cr_lf>...
Page 186: Discovering And Connecting With Extended Advertising
Page 186 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 9.2 Discovering and Connecting with Extended Advertising On the advertising module ATSDSLE to configure the module to advertise using extended connectable advertisements. For this example, we will also use long range mode for the primary PHY and 2M for the secondary PHY.
Page 187 Page 187 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. 5. If we do an ATCS? on the central module the RX and TX PHYs will show 0 for Unknown. This is because internally the secondary PHY that the connection was made on is not available. This should be fixed in a future release.
Page 188: Advertising Data Format
Page 188 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. iBeacon Example AT.s modules can be easily configured to advertise as iBeacons. Advertising Data Format iBeacon advertising packets consist of manufacturer specific data defined by Apple with the following fields: •...
Page 189: House Example
Page 189 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. House Example In this example we will create a set of beacons for a house. First generate a unique Proximity UUID to group all the beacons in the house: F5DA8F6E-CDEA-4B93-84F6-992103233A65 Then assign Major ID’s based on each level: 0=Basement, 1=Main Floor, 2=Second Floor.
Page 190: Command Set Summary Table
Page 190 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Command Set Summary Table 10.1 Command Status Responses Response Description Command Accepted Error ERROR Command Not Accepted No Response Invalid Command 10.2 Events Event Description General RESET Reset NBOOT...
Page 191: Commands
Page 191 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Gatt Server BATT Battery Event BRSP BRSP Status BRSPD BRSP Data CP_READ Custom Profile Read CP_WRITE Custom Profile Write 10.3 Commands Command Description Factory Default Stored? General Attention ATHELP...
Page 192 Page 192 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. ATSLED/ATSLED? Set/Get LED Led 0 = 100,65535,0 Led 1 = 10,2000,0 Led 2 = 100,65535,0 Led 3 = 100,20,0 ATADC? Get ADC ATBL? Get Battery Level ATT? Get Temperature ATCT...
Page 193 Page 193 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Pairing ATPLE/ATPLE? Pair Device/Get Paired Device List ATSPLE/ATSPLE? Set/Get Pairing Parameters LE 2,0,3,1,0,1 ATUPLE Un Pair Device LE ATCPLE Clear Pair List LE ATPKR Passkey Response ATPKC Passkey Confirm ATSPK/ATSPK?
Page 194 Page 194 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Custom Profile ATSCP/ATSCP? Set Custom Profile Settings/Get 3000 Custom Profile Settings ATSCPS Add Custom Profile Service ATCPUV Custom Profile Update Value ATCPRR Custom Profile Read Response ATCPWR Custom Profile Write Response 200 S.
Page 195: Appendix A: Acronyms/Abbreviations
Page 195 of 195 AT.s LE Command Set v5.1.1b Copyright © 2002-2021 BlueRadios, Inc. Appendix A: Acronyms/Abbreviations AD – Advertisement LF – Line Feed API – Application Protocol Interface MCU – Microcontroller Unit AT – Attention MISO – Master In Slave Out ASCII –...