- Short range radio modules
- Positioning chips and modules
u-blox Products
- Product selector
- Previous generations
- Contact sales
Find products
- Product documentation
Documentation
AT Command | Description |
|---|---|
Bluetooth Mode | |
Bluetooth Connect | |
Bluetooth Persistent | |
Bluetooth Persistent Remove | |
Bluetooth Persistent List | |
Bluetooth Disconnect | |
Bluetooth Local Name | |
Bluetooth Discovery | |
Bluetooth Background Discovery | |
Bluetooth RSSI | |
Bluetooth Connection List | |
Bluetooth Connection Status | |
Bluetooth Advertising Data | |
Bluetooth Scan Data | |
Bluetooth Advertisements | |
Bluetooth Directed Advertisement | |
Bluetooth Connection Settings | |
Bluetooth Advertisement Settings. | |
Bluetooth I/O Capabilities | |
Bluetooth Bond Security Mode | |
Bluetooth Pairing Mode | |
Bluetooth User Confirmation | |
User passkey entry | |
Bluetooth Bond | |
Bluetooth Unbond | |
Bluetooth Bonded Devices List | |
Bluetooth Device Information Service | |
Bluetooth PHY Request |
AT Command | Description |
|---|---|
AT+UBTM=<bt_mode> | |
AT+UBTM? | Read Bluetooth Mode. |
Response | Description |
|---|---|
+UBTM:<bt_mode> | Successful read response. |
Parameter | Type | Description |
|---|---|---|
bt_mode | enumerator | Valid values: 0: Disabled. 1: Bluetooth Low Energy Central. In this mode, starting advertisements, direct advertisements and other functions associated with the Peripheral role is not possible. 2: Bluetooth Low Energy Peripheral. In this mode, initiating connections, discovery and other functions associated with the Central role is not possible. 3: Bluetooth Low Energy Simultaneous Central and Peripheral. This is the factory default for NORA-W36. |
AT Command | Description |
|---|---|
AT+UBTC=<bd_addr> | Initiate connection. |
Parameter | Type | Description |
|---|---|---|
bd_addr | bd_addr | Bluetooth device address of the remote device. |
AT Command | Description |
|---|---|
AT+UBTP=<bd_addr>,<connect_sps> | Configure an ACL link with automatic re-connection. As opposed to AT+UBTC, this command will not initiate a connection directly but is used for storing a connection configuration persistently so that the link is automatically setup on boot. See also AT+USOP Notes: Requires AT&W and a reboot before taking effect. |
Response | Description |
|---|---|
+UBTP:<config_id> | Successful write response, returning a configuration id identifying the configuration |
Parameter | Type | Description |
|---|---|---|
bd_addr | bd_addr | Bluetooth device address of the remote device. |
connect_sps | integer | Should start a SPS connection when ACL link is up. Integer Boolean flag 0 = No, 1 = Yes Valid values: 0 or 1 |
config_id | integer | Configuration id Valid values: 200 only |
AT Command | Description |
|---|---|
AT+UBTPR=<config_id> | Removes a persistent bluetooth connection configuration Notes: The corresponding link will be automatically disconnected Can be stored using AT&W. |
Parameter | Type | Description |
|---|---|---|
config_id | integer | Configuration id Valid values: 200 only |
AT Command | Description |
|---|---|
AT+UBTPL? | List the currently configured Persistent Bluetooth Connections |
Response | Description |
|---|---|
+UBTPL:<config_id>,<bd_addr>,<connect_sps> | Successful read response |
Parameter | Type | Description |
|---|---|---|
config_id | integer | Configuration id Valid values: 200 only |
bd_addr | bd_addr | Bluetooth device address of the remote device. |
connect_sps | integer | Should start a SPS connection when ACL link is up. Integer Boolean flag 0 = No, 1 = Yes Valid values: 0 or 1 |
AT Command | Description |
|---|---|
AT+UBTDC=<conn_handle> | Close an existing ACL connection. |
Parameter | Type | Description |
|---|---|---|
conn_handle | integer | Connection handle of the Bluetooth low energy connection. |
AT Command | Description |
|---|---|
AT+UBTLN? | Reads the local Bluetooth device name. |
AT+UBTLN=<device_name> |
Response | Description |
|---|---|
+UBTLN:<device_name> | Successful read response. |
Parameter | Type | Description |
|---|---|---|
device_name | string | For Bluetooth low energy the maximum size is 29 characters. Valid length: 0..29 |
AT Command | Description |
|---|---|
AT+UBTD | Start discovery using default parameters |
AT+UBTD=<discovery_type>[,<discovery_mode>[,<discovery_length>]] | Start discovery. |
Response | Description |
|---|---|
+UBTD:<bd_addr>,<rssi>,<device_name>,<data_type>,<data> | This response is sent for every found device. If no name is found, <device_name> is an empty string, if is set to Active, both Scan responses and Advertisements will be shown. |
Parameter | Type | Description |
|---|---|---|
discovery_type | enumerator | Valid values: 0: All with no filter. Displays all found devices; devices can be displayed multiple times. 1: General inquiry. Displays devices in General or Limited discoverability mode; each device is displayed only once. |
discovery_mode | enumerator | Valid values: 0: Active discovery. 1: Passive, no scan response data will be received. Default value: 0 |
discovery_length | integer | Timeout measured in milliseconds. Time range: 10 ms - 40 s Valid values: 10..40000 Default value: 5000 |
device_name | string | Name of the discovered device. |
data_type | enumerator | Valid values: 0: Scan response data. 1: Advertise data. |
data | byte_array | Complete advertise/scan response data received from the remote device. |
bd_addr | bd_addr | Bluetooth device address of the remote device. |
rssi | integer | Received signal strength in dBm. |
AT Command | Description |
|---|---|
AT+UBTBGD=<background_discovery_mode> | Start/Stop background discovery |
AT+UBTBGD? | Read background discovery mode |
Response | Description |
|---|---|
+UBTBGD:<background_discovery_mode> | Successful read response |
Parameter | Type | Description |
|---|---|---|
background_discovery_mode | enumerator | Valid values: 0: Set background discovery off 1: Set background discovery on |
AT Command | Description |
|---|---|
AT+UBTRSS=<conn_handle> | Returns the current RSSI for a specified Bluetooth connection. |
Response | Description |
|---|---|
+UBTRSS:<rssi> | Successful response. |
Parameter | Type | Description |
|---|---|---|
conn_handle | integer | Connection handle of the Bluetooth low energy connection. |
rssi | integer | Received signal strength in dBm. |
AT Command | Description |
|---|---|
AT+UBTCL | List all Bluetooth low energy ACL connections. |
Response | Description |
|---|---|
+UBTCL:<conn_handle>,<bd_addr> | Sent for every connection. |
Parameter | Type | Description |
|---|---|---|
conn_handle | integer | Connection handle of the Bluetooth low energy connection. |
bd_addr | bd_addr | Bluetooth device address of the remote device. |
AT Command | Description |
|---|---|
AT+UBTCST=<conn_handle> | Read all properties of an existing Bluetooth low energy ACL connection. |
AT+UBTCST=<conn_handle>,<property_id> | Read a specific property of an existing Bluetooth low energy ACL connection. |
Response | Description |
|---|---|
+UBTCST:<property_id>,<status_val> | One response for each property_id. |
Parameter | Type | Description |
|---|---|---|
status_val | integer | Value of the preceding property. |
property_id | enumerator | Valid values: 0: Connection interval used on this connection. Range: 6 to 3200 Time = status_val * 1.25 ms Time range: 7.5 ms to 4000 ms 1: Peripheral latency for the connection in number of connection events. Range: 0 to 499 2: Supervision timeout (in ms) for this connections. Range: 100 ms to 32000 ms 3: MTU size for this connections. 4: Data Channel TX PDU Payload Length. 5: Data Channel RX PDU Payload Length. 6: Data Length Extension state. 0: Data Length Extension Off \ 1: Data Length Extension On 7: Local role in this connection. 1: Low Energy Central \ 2: Low Energy Peripheral 8: TX Phy used in this connection Bit 0: 1 Mbps Bit 1: 2 Mbps Bit 2: reserved for future use 9: RX Phy used in this connection Bit 0: 1 Mbps Bit 1: 2 Mbps Bit 2: reserved for future use |
conn_handle | integer | Connection handle of the Bluetooth low energy connection. |
AT Command | Description |
|---|---|
AT+UBTAD=<adv_data> | |
AT+UBTAD? | Read custom advertising data. |
Response | Description |
|---|---|
+UBTAD:<adv_data> | Successful read response. |
Parameter | Type | Description |
|---|---|---|
adv_data | byte_array | Valid length: 2..28 |
AT Command | Description |
|---|---|
AT+UBTSD=<scan_rsp_data> | |
AT+UBTSD? | Read scan response data. |
Response | Description |
|---|---|
+UBTSD:<scan_rsp_data> | Successful read response. |
Parameter | Type | Description |
|---|---|---|
scan_rsp_data | byte_array | Valid length: 1..31 |
AT Command | Description |
|---|---|
AT+UBTA=<adv_mode> | |
AT+UBTA? | Read advertisement mode. |
Response | Description |
|---|---|
+UBTA:<adv_mode> | Successful read response. |
Parameter | Type | Description |
|---|---|---|
adv_mode | enumerator | Valid values: 0: Set Bluetooth Advertisements off 1: Set Bluetooth Advertisements on |
AT Command | Description |
|---|---|
AT+UBTDA=<bd_addr>[,<timeout>] | Starts directed advertisements to Bluetooth Address. If bd_addr is FFFFFFFFFFFF, direct advertisements will be disabled. By default the timeout is 1280 ms, and uses High Duty Cycle Advertising. A timeout greater than this will result in Low Duty Cycle Advertising as High Duty Cycle Advertising has a limited use of only 1280 ms. Setting timeout to 0 will let the device advertise indefinitely in Low Duty Cycle mode. |
Parameter | Type | Description |
|---|---|---|
timeout | integer | Timeout for Directed Advertisements. Default value: 1280 |
bd_addr | bd_addr | Bluetooth device address of the remote device. |
AT Command | Description |
|---|---|
AT+UBTCS0=<connection_interval_minimum> | |
AT+UBTCS0? | Read Connection Interval minium. |
AT+UBTCS1=<connection_interval_maximum> | |
AT+UBTCS1? | Read Connection Interval maximum. |
AT+UBTCS2=<connection_peripheral_latency> | |
AT+UBTCS2? | Read connection peripheral latency. |
AT+UBTCS3=<connection_linkloss_timeout> | |
AT+UBTCS3? | Read connection linkloss timeout. |
AT+UBTCS4=<preferred_tx_phy> | |
AT+UBTCS4? | Read Preferred TX PHY. |
AT+UBTCS5=<preferred_rx_phy> | |
AT+UBTCS5? | Read Preferred RX PHY. |
AT+UBTCS? | Read all Bluetooth Configuration param values. |
Response | Description |
|---|---|
+UBTCS0:<connection_interval_minimum> | Successful read of connection interval minimum. |
+UBTCS1:<connection_interval_maximum> | Successful read of connection interval maximum. |
+UBTCS2:<connection_peripheral_latency> | Successful read of connection peripheral latency. |
+UBTCS3:<connection_linkloss_timeout> | Successful read of connection linkloss timeout. |
+UBTCS4:<preferred_tx_phy> | Successful read of Preferred TX PHY. |
+UBTCS5:<preferred_rx_phy> | Successful read of Preferred RX PHY. |
+UBTCS:<param>,<value> | Successful read response for AT+UBTCS. |
Parameter | Type | Description |
|---|---|---|
connection_interval_minimum | integer | Connection interval minimum (must be <= Connection interval maximum). Final results will be a result of negotiation between devices. Default: 24. Calculation: connection_interval_minimum * 1.25. ms Valid values: 6..3200 Default value: 24 |
connection_interval_maximum | integer | Connection interval maximum (must be >= Connection interval minimum). Final results will be a result of negotiation between devices. Default: 40. Calculation: connection_interval_maximum * 1.25 ms. Valid values: 6..3200 Default value: 40 |
connection_peripheral_latency | integer | Connection peripheral latency. Default: 0 Calculation: Number of connection events. Valid values: 0..500 Default value: 0 |
connection_linkloss_timeout | integer | Connection linkloss timeout. Default: 2000 Calculation: connection_linkloss_timeout ms Valid values: 100..32000 Default value: 2000 |
preferred_tx_phy | integer | Preferred Transmitter PHY 0: Let other side decide OR a bit field with three bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: reserved for future use Valid values: 0..7 Default value: 0 |
preferred_rx_phy | integer | Preferred Receiver PHY 0: Let other side decide OR a bit field with three bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: reserved for future use Valid values: 0..7 Default value: 0 |
param | enumerator | Connection parameter. Valid values: 0: Connection interval minimum. 1: Connection interval maximum. 2: Connection peripheral latency. 3: Connection linkloss timeout. 4: Preferred Transmitter PHY 5: Preferred Receiver PHY |
value | integer | Value of connection parameter. Valid values: 0..65535 |
AT Command | Description |
|---|---|
AT+UBTAS0=<advertisement_interval_minimum> | Write advertisement interval minimum. |
AT+UBTAS0? | Read advertisement Interval miniumum. |
AT+UBTAS1=<advertisement_interval_maximum> | Write advertisement interval maximum. |
AT+UBTAS1? | Read advertisement Interval maximum. |
AT+UBTAS? | Read all Advertising parameter setting values. |
Response | Description |
|---|---|
+UBTAS0:<advertisement_interval_minimum> | Successful read of connection interval minimum. |
+UBTAS1:<advertisement_interval_maximum> | Successful read of advertisement interval maximum. |
+UBTAS:<adv_param>,<value> | Successful read response for AT+UBTAS?. |
Parameter | Type | Description |
|---|---|---|
advertisement_interval_minimum | integer | Advertising interval minimum (must be <= Advertising interval maximum. Default: 1600. Calculation: advertisement_interval_minimum * 0.625 ms) Valid values: 32..16384 Default value: 1600 |
advertisement_interval_maximum | integer | Advertising interval maximum (must be >= Advertising interval minimum. Default: 2000. Calculation: advertisement_interval_maximum * 0.625 ms) Valid values: 32..16384 Default value: 2000 |
value | integer | Value of advertisement parameter. Valid values: 0..65535 |
adv_param | enumerator | Advertisement parameter. Valid values: 0: Advertisement interval minimum. 1: Advertisement interval maximum. |
AT Command | Description |
|---|---|
AT+UBTIOC=<io_capabilities> | |
AT+UBTIOC? | Read I/O Capabilities |
Response | Description |
|---|---|
+UBTIOC:<io_capabilities> | Successful read response for AT+UBTIOC?. |
Parameter | Type | Description |
|---|---|---|
io_capabilities | enumerator | Valid values: 0: Set I/O Capabilities to No Input No Output. 1: Set I/O Capabilities to Display Only. 2: Set I/O Capabilities to Display Yes/No 3: Set I/O Capabilities to Keyboard Only. 4: Set I/O Capabilities to Keyboard Display. Default value: 0 |
AT Command | Description |
|---|---|
AT+UBTBSM=<bt_security_mode> | |
AT+UBTBSM? | Reads the security mode |
Response | Description |
|---|---|
+UBTBSM:<bt_security_mode> | Successful read response for AT+UBTBSM? |
Parameter | Type | Description |
|---|---|---|
bt_security_mode | enumerator | Valid values: 0: Security Disabled. 1: Allow unauthenticated bonding. 2: Only allow authenticated bonding. 3: Only allow authenticated bonding with encrypted Bluetooth link. Fallback to simple pairing if the remote side does not support secure connections. 4: Only allow authenticated bonding with encrypted Bluetooth link. Strictly uses secure connections. Default value: 0 |
AT Command | Description |
|---|---|
AT+UBTPM=<pairing_mode> | |
AT+UBTPM? | Read current pairing mode. |
Response | Description |
|---|---|
+UBTPM:<pairing_mode> | Successful read response for AT+UBTPM? |
Parameter | Type | Description |
|---|---|---|
pairing_mode | enumerator | Valid values: 0: Disable pairing mode. 1: Enable pairing mode. Default value: 0 |
AT Command | Description |
|---|---|
AT+UBTUC=<bd_addr>,<yes_no> | Respond to +UEUBTUC and confirm/deny bonding. |
Parameter | Type | Description |
|---|---|---|
bd_addr | bd_addr | Bluetooth device address of the remote device. |
yes_no | enumerator | Valid values: 0: Deny bonding. 1: Confirm bonding. |
AT Command | Description |
|---|---|
AT+UBTUPE=<bd_addr>,<yes_no>[,<passkey>] | Respond to +UEBTUPE event and confirm/deny bonding. |
Parameter | Type | Description |
|---|---|---|
passkey | integer | Passkey used to confirm bonding, if yes_no is set to no, this can be omitted. Valid values: 0..999999 |
bd_addr | bd_addr | Bluetooth device address of the remote device. |
yes_no | enumerator | Valid values: 0: Deny bonding. 1: Confirm bonding. |
AT Command | Description |
|---|---|
AT+UBTB=<bd_addr> | Initiate bonding. To perform the bonding, the remote device must be in a pairable and connectable mode. Bond Event +UEBTB is genereated once the bond is complete. |
Parameter | Type | Description |
|---|---|---|
bd_addr | bd_addr | Bluetooth device address of the remote device. |
AT Command | Description |
|---|---|
AT+UBTUB=<bd_addr> | Removes a single previously bonded device. |
AT+UBTUB | Removes all previously bonded devices. |
Parameter | Type | Description |
|---|---|---|
bd_addr | bd_addr | Bluetooth device address of the remote device. |
AT Command | Description |
|---|---|
AT+UBTBDL | Read list of bonded devices. |
Response | Description |
|---|---|
+UBTBDL:<bd_addr> | This response is sent for every found device. |
Parameter | Type | Description |
|---|---|---|
bd_addr | bd_addr | Bluetooth device address of the remote device. |
AT Command | Description |
|---|---|
AT+UBTDIS=<characteristic_id>,<characteristic_value> | |
AT+UBTDIS=<characteristic_id> | Read a characteristic value. |
AT+UBTDIS? | Read all individual characteristic of the Device Information Service characteristics. |
Response | Description |
|---|---|
+UBTDIS:<characteristic_id>,<characteristic_value> | Successful read response. |
Parameter | Type | Description |
|---|---|---|
characteristic_id | enumerator | Valid values: 0: Manufacturer name string. Maximum length of the custom string is 31 characters. 1: Model name string. Maximum length of the custom string is 20 characters. 2: Firmware revision string. Maximum length of the custom string is 20 characters. 3: Software revision string. Maximum length of the custom string is 20 characters. |
characteristic_value | string | Value of Device Information Service characteristic. |
AT Command | Description |
|---|---|
AT+UBTPHYR=<conn_handle>,<tx_phy>,<rx_phy> | Requests a Bluetooth Low Energy PHY update. |
AT+UBTPHYR=<conn_handle> | Reads current PHYs for a connection. |
Response | Description |
|---|---|
+UBTPHYR:<conn_handle>,<tx_phy>,<rx_phy> | Successful read response. |
Parameter | Type | Description |
|---|---|---|
conn_handle | integer | Connection handle of the Bluetooth low energy connection. |
tx_phy | integer | Requested PHY for Transmitter: 0: Let other side decide OR a bit field with three bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: Coded PHY (S=8). Not supported by NORA-W36 Valid values: 0..7 |
rx_phy | integer | Requested PHY for Receiver 0: Let other side decide OR a bit field with three bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: Coded PHY (S=8). Not supported by NORA-W36 Valid values: 0..7 |
Unsolicited Response Code | Description |
|---|---|
Event Bluetooth Connected | |
Event Bluetooth Disconnected | |
Event Bluetooth Bond status | |
Event Bluetooth User Confirmation | |
Event Bluetooth Passkey entry | |
Event Bluetooth Passkey request | |
Event Bluetooth PHY update |
+UEBTC:<conn_handle>,<bd_addr>Parameter | Type | Description |
|---|---|---|
conn_handle | integer | Connection handle of the Bluetooth low energy connection. |
bd_addr | bd_addr | Bluetooth device address of the remote device. |
+UEBTDC:<conn_handle>Parameter | Type | Description |
|---|---|---|
conn_handle | integer | Connection handle of the Bluetooth low energy connection. |
+UEBTB:<bd_addr>,<bond_status>Parameter | Type | Description |
|---|---|---|
bd_addr | bd_addr | Bluetooth device address of the remote device. |
bond_status | enumerator | Bonding status Valid values: 0: Bonding procedure succeeded. 1: Bonding procedure failed due to page timeout. 2: Bonding failed because of authentication or pairing failed. This could be due to incorrect PIN/passkey. 3: Bonding failed because the protection against Man-In-The-Middle attack could not be guaranteed; the generated link key was too weak. |
+UEBTUC:<bd_addr>,<numeric_value>Parameter | Type | Description |
|---|---|---|
bd_addr | bd_addr | Bluetooth device address of the remote device. |
numeric_value | integer | Numeric value. Valid values: 0..999999 |
+UEBTUPD:<bd_addr>,<numeric_value>Parameter | Type | Description |
|---|---|---|
bd_addr | bd_addr | Bluetooth device address of the remote device. |
numeric_value | integer | Numeric value. Valid values: 0..999999 |
+UEBTUPE:<bd_addr>Parameter | Type | Description |
|---|---|---|
bd_addr | bd_addr | Bluetooth device address of the remote device. |
+UEBTPHYU:<conn_handle>,<phy_status>,<tx_phy>,<rx_phy>Parameter | Type | Description |
|---|---|---|
conn_handle | integer | Connection handle of the Bluetooth low energy connection. |
phy_status | integer | Bluetooth status codes: 0: Success 0x01-0xFF: Error, see Bluetooth Core Specifications, Vol 2, Part D. Valid values: 0..255 |
tx_phy | integer | Requested PHY for Transmitter: 0: Let other side decide OR a bit field with three bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: Coded PHY (S=8). Not supported by NORA-W36 Valid values: 0..7 |
rx_phy | integer | Requested PHY for Receiver 0: Let other side decide OR a bit field with three bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: Coded PHY (S=8). Not supported by NORA-W36 Valid values: 0..7 |