NORA-B26 u-connectXpress

Stand-alone multiradio modules

AT commands manual

Abstract
u-blox AT commands reference manual for the short range stand-alone modules. This document lists both the standard and proprietary AT commands for u-connectXpress based modules with Bluetooth low energy.

Document information

Title	NORA-B26 series u-connectXpress
Subtitle	u-blox short range stand-alone modules
Document type	Manual
Document number	UBXDOC-465451970-4663
Revision and date	R01, 13-Aug-2025
Disclosure restriction	C1-Public

This document applies to the following products

Product name	Software version
NORA-B26 series	3.0.1

For changes see 11 Change log

u-blox or third parties may hold intellectual property rights in the products, names, logos, and designs included in this document. Copying, reproduction, or modification of this document or any part thereof is only permitted with the express written permission of u-blox. Disclosure to third parties is permitted for clearly public documents only.
The information contained herein is provided “as is” and u-blox assumes no liability for its use. No warranty, either express or implied, is given, including but not limited to, with respect to the accuracy, correctness, reliability, and fitness for a particular purpose of the information. This document may be revised by u-blox at any time without notice. For the most recent documents, visit www.u-blox.com.

Copyright © u-blox AG

---

How to use this manual

The u-connectXpress AT command for Commands Manual provides the necessary information to successfully design in and configure the applicable u-blox short range modules.

This manual has a modular structure. It is not necessary to read it from the beginning to the end.

The following symbols are used to highlight important information within the manual:
 

• An index finger points out key information pertaining to module integration and performance.
   
• warning symbol indicates actions that could negatively impact or damage the module.
   

Contents

1 AT command settings

u-blox short range modules provide at least one physical serial interface for configuration and data transport.
At module power on, the module enters the command mode. For more details on the command mode, see

For module and terminal connection and settings, see the corresponding evaluation kit user guide.

1.1 Definitions

In this document, the following naming conventions are used:

• DCE (Data Communications Equipment): u-blox short range module
• DTE (Data Terminal Equipment) or TE (Terminal Equipment): The terminal that issues the command to the
  module.

The terms DCE and DTE are used in the serial interface context. The DCE interface can operate in the following
modes:

• AT mode: The DCE waits for AT command instructions. The DCE interprets all the characters
  received as commands to execute. The DCE may send responses back to the DTE indicating the outcome
  of the command or further information without having received any command from the DTE (for example,
  unsolicited response code - URC).
• Transparent mode (TM): The DCE transfers data after having sent the AT+UTM or AT+UTMP command; all characters sent to the DCE
  are intended to be transmitted to the remote party. Any further characters received over the serial link are
  deemed to be from the remote party, and any characters sent are transmitted to the remote party.
• Transparent mode persistent (TMP): The same as Transparent mode (TM) but it is possible to store the setting and enter this mode at start up.

It is possible to switch from the Transparent mode (TM) and Transparent mode persistent (TMP)to command mode in the following ways:
• Using the escape sequence: For more details, see Escape Character S2

1.1.1 Command description

The AT commands configure and enable the short range module functionality according to 3GPP normative
and u-blox specifications. The AT commands are issued to the module via a hyper terminal through a command
line and are described in the following sections. A general description of each command is provided including
functionalities, correct syntax to be provided by the TE/DTE and allowed responses.
The command description defines each named parameter with its type, range (valid / acceptable values),
default value (when available) and factory default setting (when applicable).
In this document, are intentionally omitted in the command syntax. See Chapter 1.1.2 and
Chapter 1.1.4 for more information.

1.1.2 Command line

The AT commands are typically issued to the short range modules using a command line with the following
generic syntax:
"AT"<command_name><S3_character>
Where:

• "AT": The prefix to be set at the beginning of each command line
• <command_name>: The command name string; it can have a "+" character as prefix
• <string>: The string consisting of the value parameters following the syntax provided in this manual.

The following rules are used when describing the command syntax:

• <...>: The name in angle brackets is a parameter. The brackets themselves do not appear in the
  command line
• [...]: The square brackets represent the optional parameters of a command or an optional part of the DCE
  information text response. Brackets themselves do not appear in the command line. When a parameter
  is not given, the value will be set to the default value provided in the command description
• <S3_character>: The command line termination character; it can be set with Command line termination
  character S3 command; the factory-programmed termination character is
  The command line is not case sensitive.
  The serial interface driver generally does not allow a new command until the previous one has been terminated
  by "OK" or an error message.

1.1.3 Default values

If the command has optional parameters, and default values are not specified, the default values are assumed
as follows:

• For parameters of type Number, the default value is 0
• For parameters of type String, the default value is an empty string

1.1.4 Information text responses and result codes

The response format is as follows:

• Information text response(s): <S3_character><S4_character><S3_character><S4_character>
• Result codes: <S3_character><S4_character><S3_character><S4_character>
  where
• <S3_character> is the command line termination character; it can be set with S3 command
• <S4_character> is the linefeed character; it can be set with S4 command
  If the command line is successfully processed and the command is correctly executed, in verbose response
  format the string "OK" is sent as a final result code.
  Intermediate output and descriptive output of a command are formatted as information text responses;
  If more than one string has to be printed out (see for example Scan AT+UWSSC command description),
  additional command line termination and linefeed characters can be inserted for the sake of readability.
  If the command is not accepted by the DCE, an error result code will be displayed. The error result has the
  following format:
  • <S3_character><S4_character>ERROR<S3_character><S4_character>
  When using commands in <data_format> Binary, for example +AT+USPSWB, the formating of the AT command differs a bit from regular AT commands.

1.1.5 S-parameters

The S-parameters, as specified in ITU-T recommendation V250, constitute a group of commands that begin
with the string "ATS". They are generally indicated as S registers and are used to configure the way the module
operates. Their syntax is:
ATS<parameter_number>?
ATS<parameter_number>=
The number following the "ATS" is the referenced S parameter.
u-blox short range modules support the following set of S-parameters (<parameter_number>):

• 2: escape character setting (for more details see the S2)
• 3: command line termination character setting (for more details see the S3)
• 4: response formatting character setting (for more details see the S4)
• 5: command line editing character setting (for more details see the S5)

2 General operation

2.1 Start up

Start up mode is AT mode by default, if Persistant Transparent mode is use see AT+UTMP command.

2.2 AT Command types

2.2.1 Set command

A set command configures preferred settings for the specified command. The set command is the only way to
set the preferred settings in the DCE. Parameters set with a set command will be used immediately and the
parameters can be stored to the start up database using &W.
Some Set commands requires a reboot before using. Store with &W and reset with +CPWROFF.

2.2.2 Read command

A read command provides current setting of the command parameters. It is used to find out the current
command configuration.

2.2.3 Status command

A status command provides current operating status of the module.

2.2.4 Unsolicited result code (URC)

An unsolicited result code is a string message (provided by the DCE) that is not triggered as a information
text response to a previous AT command and can be output, when enabled, at any time to inform the DTE of
a specific event or status change. The URC can have the same name of the command that enables it or can
be enabled by another command.

2.3 Data types

The definition of each command specifies the data types used for values associated with the command. The
different data types are listed below and are described in the following subsections:

• String
• Integer
• Enumerator
• Byte_Array
• IPv4_Addr
• IPv6_Addr
• MAC_Addr
• Bd_Addr
• List
• Binary

2.3.1 String

A string shall consist of a sequence of displayable characters from the ISO 8859-1 character set, except for characters \, " and some special characters, see table below. A string constant shall be delimited by two double quote " characters, for example, "Donald Duck". If the double quote character " is to be used within a string, for example, "My friend "Bono" is a singer", they have to be represented as the escape character \". If the backslash character \ is to be used within a string constant, it has to be represented as the escape character \\. An empty string is represented by two adjacent delimiters - "".

Escape character	Special character
\r	Carriage return
\n	New line
\t	Tab
\b	Backspace
\"	For using " character inside an AT string
\\	Backslash
\0	Null character
\xHH	For representing any byte. HH is 2 hex characters

2.3.2 Integer

An integer value consists of a sequence of characters, all in the range {0..9} plus a possible minus ("-") sign for
negative values. Numeric constants are expressed in decimal format only.

2.3.3 Enumerator

An enumerator value is actually an integer, where all its possible values are specified in each case. Only the
defined values are accepted for the command in question.

2.3.4 Byte_Array

A Byte_Array consists of a sequence of characters expressed in two digit hexadecimal in the ranges {0..9}, {a..f}
and {A..F}. The hexadecimal values are grouped together without delimiters; an example of Byte_Array (three
values) is "800000" (Bit 23 is set), excluding the double quote characters.

2.3.5 IPv4_Addr

An IPv4_Addr is a special text string in dotted decimal notation form (that is, four numbers in the range 0-255
separated by periods). An example IP address is "192.168.0.1", excluding the double quote characters.

2.3.6 IPv6_Addr

An IPv6_Addr is a special text string represented as eight groups of four hexadecimal digits, each group
representing 16 bits (two octets) and surrounded by brackets. The groups are separated by colons (:). An
example of an IPv6 address is "[2001:0db8:85a3:0000:0000:8a2e:0370:7334]", excluding the double quote
characters.

2.3.7 MAC_Addr

A MAC_Addr is a Byte_Array of fixed length (6 values). An example MAC_Addr is "01A0F7101C08", excluding
the double quote characters.

2.3.8 Bd_Addr

A Bd_Addr is a MAC_Addr followed an optional address type, "r" for random address and "p" for public address.
If the address type is omitted, it will default to public. An example Bd_Addr is "01A0F7101C08p", excluding the
double quote characters.

2.3.9 List

A List is a comma (,) separated list of items, where items can be any of the other data types. For example,
channel list is a list of integers, [1,6,11], inluding the two brackets characters. Example AT+UWCL=[1,6,11]

2.3.10 Binary

The binary data starts with \x01 (SOH - Start Of Header), following by the length of the data in two bytes format (UINT16) follwed by the binary data.
The binary data shall not be terminated with the normal \x0D (\r - Carriage Return).

The binary header is three bytes:
{0x01(SOH Start Of Header), MSB_datalength, LSB_datalength}

All commands and URC that use binary data are "complete" without the binary data, the binary data is sent directy after the AT command, in most case after the handle.

The AT command follows direcly by the binary data, without any "," or "\r" or anyting in between.

Example:
AT+USOWB=0{0x01,0x00,0x02,0xFF,0xEE}
This command writes to socket 0, 2 bytes data the data is 0xFF 0xEE.
Note that the brackets { } should not be sent, only indicates the start and end of binary data.

Binary data for Socket, SPS and certicitate upload all use the same Binary data format.

2.3.11 Buffered mode

This is the default data mode, the data is read out after an event has been received. It is possible to stop and control the incoming data flow.

2.3.12 Direct mode

In this mode the data is included in the received event, then data will be sent to the host as soon it is avaliable. It is not possible to stop the incoming data flow.

2.3.13 Transparent mode

In this mode the data is sent and received without any AT commands, the limitation that this mode only works with a point-to-point connection.

2.3.14 Transparent mode persistent

This is the same as transparent mode, but can be storted in flash and be active at startup.

3 General

3.1 AT Commands

AT Command	Description
AT	Attention
AT+CGMI	Manufacturer identification
AT+GMI	Manufacturer identification
AT+CGMM	Model identification
AT+GMM	Model identification
AT+CGMR	Software version identification
AT+GMR	Software version identification
AT+CGSN	Serial number
AT+GSN	Serial number
ATI	Identification information
AT+CSGT	Greeting Text

3.1.1 AT - Attention

Attention command that determines the presence of a Data Communication Equipment (DCE).

Syntax
 

AT Command	Description
AT	Attention command.

3.1.2 AT+CGMI - Manufacturer identification

Read a text string that identifies the manufacturer.

Syntax
 

AT Command	Description
AT+CGMI	Read manufacturer text string.

Response	Description
<manufacturer>	Successful read response. Note: The manufacturer string is returned without any response prefix.

Defined values
 

Parameter	Type	Description
manufacturer	string	Manufacturer ("u-blox").

3.1.3 AT+GMI - Manufacturer identification

Read a text string that identifies the manufacturer.

Syntax
 

AT Command	Description
AT+GMI	Read manufacturer text string.

Response	Description
<manufacturer>	Successful read response. Note: The manufacturer string is returned without any response prefix.

Defined values
 

Parameter	Type	Description
manufacturer	string	Manufacturer ("u-blox").

3.1.4 AT+CGMM - Model identification

Read a text string that identifies the device model.

Syntax
 

AT Command	Description
AT+CGMM	Read device model.

Response	Description
<device_model>	Successful read response. Note: The device_model string is returned without any response prefix.

Defined values
 

Parameter	Type	Description
device_model	string	Device model

3.1.5 AT+GMM - Model identification

Read a text string that identifies the device model.

Syntax
 

AT Command	Description
AT+GMM	Read device model.

Response	Description
<device_model>	Successful read response. Note: The device_model string is returned without any response prefix.

Defined values
 

Parameter	Type	Description
device_model	string	Device model

3.1.6 AT+CGMR - Software version identification

Read a text string that identifies the software version of the module.

Syntax
 

AT Command	Description
AT+CGMR	Read software version.

Response	Description
<version>	Successful read response. Note: The version string is returned without any response prefix.

Defined values
 

Parameter	Type	Description
version	string	Version.

3.1.7 AT+GMR - Software version identification

Read a text string that identifies the software version of the module.

Syntax
 

AT Command	Description
AT+GMR	Read software version.

Response	Description
<version>	Successful read response. Note: The version string is returned without any response prefix.

Defined values
 

Parameter	Type	Description
version	string	Version.

3.1.8 AT+CGSN - Serial number

Read the product serial number.

Syntax
 

AT Command	Description
AT+CGSN	Read serial number.

Response	Description
<serial_number>	Successful read response. Note: The serial_number string is returned without any response prefix.

Defined values
 

Parameter	Type	Description
serial_number	string	Serial number.

3.1.9 AT+GSN - Serial number

Read the product serial number.

Syntax
 

AT Command	Description
AT+GSN	Read serial number.

Response	Description
<serial_number>	Successful read response. Note: The serial_number string is returned without any response prefix.

Defined values
 

Parameter	Type	Description
serial_number	string	Serial number.

3.1.10 ATI - Identification information

Read identification information.

Syntax
 

AT Command	Description
ATI9	Read identification information.
ATI0	Read type code.

Response	Description
<application_version>,<unique_identifier>	Successful read response. Note: The application_version and unique_identifier strings are returned without any response prefix.
<type_code>	Successful read response. Note: The type_code string is returned without any response prefix.

Defined values
 

Parameter	Type	Description
application_version	string	Application version.
unique_identifier	string	Unique identifier.
type_code	string	Type code for the module.

3.1.11 AT+CSGT - Greeting Text

Configures and activates/deactivates the greeting text.
The configuration change in the greeting text will be applied at the subsequent boot.
When active, the greeting text is sent at boot once. The default greeting text is +STARTUP.

Syntax
 

AT Command	Description
AT+CSGT=<greeting_mode>[,<text>]	Set the greeting text and mode. Notes: Requires AT&W and a reboot before taking effect.
AT+CSGT?	Read the greeting text.

Response	Description
+CSGT:<greeting_mode>,<text>	Successful read response.

Defined values
 

Parameter	Type	Description
greeting_mode	enumerator	Valid values: 0: Turn off the greeting text. 1: Turn on the greeting text.
text	string	The greeting text. Note: Can not be an empty string. Valid length: 1..49

4 System

System AT commands

4.1 AT Commands

AT Command	Description
AT+CPWROFF	Module switch off
AT&W	Store current configuration
AT+USYLA	Local Address
AT+USYFR	Factory Restore
AT+USYDS	Default Settings
AT+USYUS	Uart Settings
AT+USYFWUS	Firmware Update using serial port
AT+USYBL	Start the boot loader command line interface
AT+USYEC	Error Code
AT+USYEE	Extended Error codes on/off
ATE	Echo On/Off
ATS	S-registers
AT+UTMES	Transparent mode escape sequence settings

4.1.1 AT+CPWROFF - Module switch off

Syntax
 

AT Command	Description
AT+CPWROFF	Reboot the DCE.

4.1.2 AT+USYFWUS - Firmware Update using serial port

Start serial port firmware upgrade. The module will indicate that it is ready to receive
the new firmware by regularly sending the XModem start byte C until either an XModem transfer has started,
or a timeout has occurred
Syntax
 

AT Command	Description
AT+USYFWUS=<baud_rate>[,<flow_control>]	Start firmware upgrade on the serial port with provided settings
AT+USYFWUS	Start firmware upgrade on the serial port with default settings, baudrate 115200 and no flow control

Defined values
 

Parameter	Type	Description
flow_control	integer	Valid values: 0 or 1 Default value: 0
baud_rate	integer	Baudrate Valid values: 1200, 2400, 4800, 9600, 14400, 28800, 31250, 38400, 56000, 57600, 76800, 115200, 230400, 250000, 460800, 921600, 1000000 Default value: 115200

4.1.3 AT+USYBL - Start the boot loader command line interface

Force start of the boot loader. The boot loader will start at the defined baud rate.

Syntax
 

AT Command	Description
AT+USYBL=<baud_rate>[,<flow_control>]	Force start of the boot loader.
AT+USYBL	Force start of the boot loader with default settings. Baudrate 115200 and flow control off.

Defined values
 

Parameter	Type	Description
flow_control	integer	Valid values: 0 or 1 Default value: 0
baud_rate	integer	Baudrate Valid values: 1200, 2400, 4800, 9600, 14400, 28800, 31250, 38400, 56000, 57600, 76800, 115200, 230400, 250000, 460800, 921600, 1000000 Default value: 115200

4.1.4 AT&W - Store current configuration

Store the current configuration to flash

Syntax
 

AT Command	Description
AT&W	Write the current configuration to flash. The configuration is stored immediately when AT&W is issued.

4.1.5 AT+USYLA - Local Address

Syntax
 

AT Command	Description
AT+USYLA=<interface_id>	Get interface address
AT+USYLA=<interface_id>,<address>	Set interface address Notes: Requires AT&W and a reboot before taking effect.

Response	Description
+USYLA:<address>	Successful read response

Defined values
 

Parameter	Type	Description
interface_id	enumerator	Valid values: 0: Bluetooth
address	mac_addr	MAC address of the interface id. If the address is set to 000000000000, the local address will be restored to factory-programmed value. The least significant bit of the first octet of the address must be 0.

4.1.6 AT+USYFR - Factory Restore

Syntax
 

AT Command	Description
AT+USYFR	The module is completely restored to factory defaults. All settings are reset to default values. All certificates and Bluetooth bonding information will be removed. Notes: Requires AT&W and a reboot before taking effect.

4.1.7 AT+USYDS - Default Settings

Syntax
 

AT Command	Description
AT+USYDS	Reset all settings to default values. Certificates and Bluetooth bonding information will be left untouched. Notes: Requires AT&W and a reboot before taking effect.

4.1.8 AT+USYUS - Uart Settings

Syntax
 

AT Command	Description
AT+USYUS=<baud_rate>[,<flow_control>[,<change_after_confirm>]]	Configure new UART settings that will be used after restart. Baudrates above 4000000 bps can be set, but are unsupported. If the flow_control parameter is omitted then no flow control will be used. If change_after_confirm is not provided the baudrate will be changed only after a store and reboot. Notes: Can be stored using AT&W.
AT+USYUS?	Reads current UART settings from the module

Response	Description
+USYUS:<baud_rate>,<flow_control>	Successful read response

Defined values
 

Parameter	Type	Description
flow_control	integer	0: No flow control 1: Use CTS/RTS flow control Valid values: 0 or 1
change_after_confirm	integer	0: Switch baudrate after reboot. When set AT&W must be called. 1: Switch baudrate directly after status OK have been sent. Valid values: 0 or 1
baud_rate	integer	Baudrate Valid values: 1200, 2400, 4800, 9600, 14400, 28800, 31250, 38400, 56000, 57600, 76800, 115200, 230400, 250000, 460800, 921600, 1000000 Default value: 115200

4.1.9 AT+USYEC - Error Code

Syntax
 

AT Command	Description
AT+USYEC?	Read the last error code

Response	Description
+USYEC:<error_code>	Latest error code

Defined values
 

Parameter	Type	Description
error_code	integer	Error code

4.1.10 AT+USYEE - Extended Error codes on/off

Syntax
 

AT Command	Description
AT+USYEE=<extended_errors>	Enable or disable extended error codes Notes: Can be stored using AT&W.
AT+USYEE?	Read extended error codes enabled/disabled

Response	Description
+USYEE:<extended_errors>	Extended error codes setting

Defined values
 

Parameter	Type	Description
extended_errors	enumerator	Extended error codes setting Valid values: 0: (Factory default) Extended error codes will not be displayed 1: Extended error code will be displayed on every error

4.1.11 ATE - Echo On/Off

This command configures whether or not the module echoes the characters received from the host.

Syntax
 

AT Command	Description
ATE0	Set echo off Notes: Can be stored using AT&W.
ATE1	Set echo on Notes: Can be stored using AT&W.
ATE?	Read current echo setting

Response	Description
<echo_on>	Current echo setting

Defined values
 

Parameter	Type	Description
echo_on	enumerator	Valid values: 0: Module does not echo the characters 1: (Factory default) Module echoes the characters

4.1.12 ATS - S-registers

Used to set different configuration parameters

Syntax
 

AT Command	Description
ATS2=<escape_char>	Write escape character. This settings change the decimal value of the escape character used by some modes, such as transparent mode for example, to detect an escape sequence and exit. Notes: Can be stored using AT&W.
ATS2?	Read escape character
ATS3=<line_term>	Write line termination character. This setting changes the decimal value of the character recognized by the DCE from the DTE to terminate an incoming command line. It is also generated by the DCE as part of the header, trailer, and terminator for result codes and information text along with the S4 parameter. The previous value of S3 is used to determine the command line termination character for entry of the command line containing the S3 setting command. However, the result code issued shall use the value of S3 as set during the processing of the command line. For example, if S3 was previously set to 13 and the command line "ATS3=30" is issued, the command line shall be terminated with a CR, character (13), but the result code issued will use the character with the ordinal value 30 instead of the CR. Notes: Can be stored using AT&W.
ATS3?	Read line termination character
ATS4=<resp_format>	Write response format character. This setting changes the decimal value of the character generated by the DCE as part of the header, trailer, and terminator for result codes and information text, along with the S3 parameter. If the value of S4 is changed in a command line, the result code issued in response to that command line will use the new value of S4. Notes: Can be stored using AT&W.
ATS4?	Read response format character
ATS5=<backspace>	Writes backspace character. This setting changes the decimal value of the character recognized by the DCE as a request to delete from the command line, the immediately preceding character. Notes: Can be stored using AT&W.
ATS5?	Read backspace character

Response	Description
<escape_char>	Current escape character
<line_term>	Current line termination character
<resp_format>	Current response format character
<backspace>	Current backspace character

Defined values
 

Parameter	Type	Description
line_term	integer	Command line termination character. Factory default: 13 Valid values: 0..127
resp_format	integer	Response format character. Factory default: 10 Valid values: 0..127
backspace	integer	Backspace character. Factory default: 8 Valid values: 0..127
escape_char	integer	Escape character. Factory default: 43 Valid values: 0..127

4.1.13 AT+UTMES - Transparent mode escape sequence settings

Syntax
 

AT Command	Description
AT+UTMES=<pre_timeout>,<post_timeout>,<escape_timeout>	Configures the transparent mode escape sequence settings.
AT+UTMES?	Reads current transparent mode escape sequence settings.

Response	Description
+UTMES:<pre_timeout>,<post_timeout>,<escape_timeout>	Successful read response

Defined values
 

Parameter	Type	Description
pre_timeout	integer	Minimum time (ms) of no data activity required before the escape sequence is sent. Factory default: 1000 Valid values: 50..5000
post_timeout	integer	Minimum time (ms) of no data activity required after the escape sequence is sent. Factory default: 1000 Valid values: 50..5000
escape_timeout	integer	Maximum time interval (ms) between escape characters. Factory default: 200 Valid values: 50..5000

5 Bluetooth

Bluetooth commands

NORA-B26 supports up to 6 connections as BLE central and 2 as peripheral.

5.1 AT Commands

AT Command	Description
AT+UBTM	Bluetooth Mode
AT+UBTC	Bluetooth Connect
AT+UBTP	Bluetooth Persistent
AT+UBTPR	Bluetooth Persistent Remove
AT+UBTPL	Bluetooth Persistent List
AT+UBTDC	Bluetooth Disconnect
AT+UBTLN	Bluetooth Local Name
AT+UBTD	Bluetooth Discovery
AT+UBTBGD	Bluetooth Background Discovery
AT+UBTRSS	Bluetooth RSSI
AT+UBTCL	Bluetooth Connection List
AT+UBTCST	Bluetooth Connection Status
AT+UBTA	Read which advertisments are currently running
AT+UBTADL	Bluetooth Advertisement Data Legacy
AT+UBTADLC	Bluetooth Advertising Data Legacy Clear
AT+UBTADE	Bluetooth Advertising Data Extended
AT+UBTADEC	Bluetooth Advertising Data Extended Clear
AT+UBTAE	Bluetooth Advertise Extended
AT+UBTAED	Bluetooth Advertise Extended Disable
AT+UBTASD	Bluetooth Advertisement Scan Data
AT+UBTASDC	Bluetooth Scan Data Clear
AT+UBTAL	Bluetooth Advertise Legacy Enable
AT+UBTALD	Bluetooth Advertise Legacy Disable
AT+UBTAD	Bluetooth Directed Advertisement
AT+UBTADD	Bluetooth Advertise Directed Disable
AT+UBTCS	Bluetooth Connection Settings
AT+UBTALS	Bluetooth Advertisement Legacy Settings
AT+UBTSS	Bluetooth Scan Settings
AT+UBTIOC	Bluetooth I/O Capabilities
AT+UBTBSM	Bluetooth Bond Security Mode
AT+UBTPM	Bluetooth Pairing Mode
AT+UBTUC	Bluetooth User Confirmation
AT+UBTUPE	User passkey entry
AT+UBTB	Bluetooth Bond
AT+UBTUB	Bluetooth Unbond
AT+UBTBDL	Bluetooth Bonded Devices List
AT+UBTDIS	Bluetooth Device Information Service
AT+UBTPHYR	Bluetooth PHY Request

5.1.1 AT+UBTM - Bluetooth Mode

Set and read Bluetooth Mode.

Syntax
 

AT Command	Description
AT+UBTM=<bt_mode>	Set Bluetooth Mode. Notes: Requires AT&W and a reboot before taking effect.
AT+UBTM?	Read Bluetooth Mode.

Response	Description
+UBTM:<bt_mode>	Successful read response.

Defined values
 

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.

5.1.2 AT+UBTC - Bluetooth Connect

Make an ACL connection to a remote device with defined protocol type. Unsolicited events +UEBTC or +UEBTDC will be sent out to confirm the connection establishment.

Syntax
 

AT Command	Description
AT+UBTC=<bd_addr>	Initiate connection.

Defined values
 

Parameter	Type	Description
bd_addr	bd_addr	Bluetooth device address of the remote device.

5.1.3 AT+UBTP - Bluetooth Persistent

Syntax
 

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. 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

Defined values
 

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

5.1.4 AT+UBTPR - Bluetooth Persistent Remove

Remove a Persistent Bluetooth Connection configuration

Syntax
 

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.

Defined values
 

Parameter	Type	Description
config_id	integer	Configuration id Valid values: 200 only

5.1.5 AT+UBTPL - Bluetooth Persistent List

List all configured persistent bluetooth connections

Syntax
 

AT Command	Description
AT+UBTPL?	List the currently configured Persistent Bluetooth Connections

Response	Description
+UBTPL:<config_id>,<bd_addr>,<connect_sps>	Successful read response

Defined values
 

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

5.1.6 AT+UBTDC - Bluetooth Disconnect

Used to close an ACL connection.

Syntax
 

AT Command	Description
AT+UBTDC=<conn_handle>	Close an existing ACL connection.

Defined values
 

Parameter	Type	Description
conn_handle	integer	Connection handle of the Bluetooth low energy connection.

5.1.7 AT+UBTLN - Bluetooth Local Name

Set the local name used as device name for Bluetooth Classic, in the advertising data of the device and in the Device Information service for Bluetooth low energy.

Syntax
 

AT Command	Description
AT+UBTLN?	Reads the local Bluetooth device name.
AT+UBTLN=<device_name>	Writes the local Bluetooth device name. Notes: Can be stored using AT&W.

Response	Description
+UBTLN:<device_name>	Successful read response.

Defined values
 

Parameter	Type	Description
device_name	string	For Bluetooth low energy the maximum size is 29 characters. Valid length: 0..29

5.1.8 AT+UBTD - Bluetooth Discovery

Performs a discovery procedure to find any advertising devices in the vicinity.

Syntax
 

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 <mode> is set to Active, both Scan responses and Advertisements will be shown.

Defined values
 

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. 2: Extended 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.

5.1.9 AT+UBTBGD - Bluetooth Background Discovery

Start a background discovery.

Syntax
 

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

Defined values
 

Parameter	Type	Description
background_discovery_mode	enumerator	Valid values: 0: Set background discovery off 1: Set background discovery on

5.1.10 AT+UBTRSS - Bluetooth RSSI

Returns the current received RSSI for a specified Bluetooth connection.

Syntax
 

AT Command	Description
AT+UBTRSS=<conn_handle>	Returns the current RSSI for a specified Bluetooth connection.

Response	Description
+UBTRSS:<rssi>	Successful response.

Defined values
 

Parameter	Type	Description
conn_handle	integer	Connection handle of the Bluetooth low energy connection.
rssi	integer	Received signal strength in dBm.

5.1.11 AT+UBTCL - Bluetooth Connection List

List all active Bluetooth low energy ACl connections.

Syntax
 

AT Command	Description
AT+UBTCL	List all Bluetooth low energy ACL connections.

Response	Description
+UBTCL:<conn_handle>,<bd_addr>	Sent for every connection.

Defined values
 

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.

5.1.12 AT+UBTCST - Bluetooth Connection Status

Read negotiated properties of a Bluetooth low energy ACL connection.
Some of the properties are a result of negotiation when a connections is set up, and this command gives the possibility
to see what properties the connection actually uses.

Syntax
 

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.

Defined values
 

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: Coded 9: RX Phy used in this connection Bit 0: 1 Mbps Bit 1: 2 Mbps Bit 2: Coded
conn_handle	integer	Connection handle of the Bluetooth low energy connection.

5.1.13 AT+UBTA - Read which advertisments are currently running

Syntax
 

AT Command	Description
AT+UBTA?	Read the current advertisements

Response	Description
+UBTA:<legacy_advertisement>,<directed_advertisement>,<enabled_extended_advertisements>	Successful read

Defined values
 

Parameter	Type	Description
legacy_advertisement	enumerator	Valid values: 0: Legacy Advertisement Not Running 1: Legacy Advertisement Running
directed_advertisement	enumerator	Valid values: 0: Directed Advertisement Not Running 1: Directed Advertisement Running
enabled_extended_advertisements	int_list	Valid length: 0 or 1

5.1.14 AT+UBTADL - Bluetooth Advertisement Data Legacy

Command for setting custom legacy advertise data in Bluetooth low energy. Maximum of 28 bytes.
Any custom advertising data will be appended to the default mandatory flags field.
Note that the AT command AT+UBTD supports scan modes that can be used to see the complete advertising data.
This is useful when testing the advertise data set with the AT+UBTALD. By default, the service UUID for the u-blox Serial Port Service is part of the advertising data.

Syntax
 

AT Command	Description
AT+UBTADL=<adv_data>	Write custom advertising data. Notes: Can be stored using AT&W.
AT+UBTADL?	Read custom advertising data.

Response	Description
+UBTADL:<adv_data>	Successful read response.

Defined values
 

Parameter	Type	Description
adv_data	byte_array	Valid length: 3..28

5.1.15 AT+UBTADLC - Bluetooth Advertising Data Legacy Clear

Clear the custom advertise data, i.e.use the default value when advertising
Syntax
 

AT Command	Description
AT+UBTADLC	Clear the custom legacy advertise data.

5.1.16 AT+UBTADE - Bluetooth Advertising Data Extended

Command for setting extended advertising data in Bluetooth low energy. Maximum of 226 bytes.
Any custom advertising data will be appended to the default mandatory flags field.

Syntax
 

AT Command	Description
AT+UBTADE=<index>,<adv_data>	Write custom advertising data for configuration index. Notes: Can be stored using AT&W.
AT+UBTADE=<index>	Read custom advertising data for configuration index.

Response	Description
+UBTADE:<index>,<adv_data>	Successful read response.

Defined values
 

Parameter	Type	Description
index	integer	Valid values: 0 only
adv_data	byte_array	Valid length: 3..226

5.1.17 AT+UBTADEC - Bluetooth Advertising Data Extended Clear

Clear the custom extended advertise data, i.e. use to the default value during extended advertising

Syntax
 

AT Command	Description
AT+UBTADEC=<index>	Clear the extended advertise data for the specified index.

Defined values
 

Parameter	Type	Description
index	integer	Valid values: 0 only

5.1.18 AT+UBTAE - Bluetooth Advertise Extended

Start extended advertisement for the specified configuration

Syntax
 

AT Command	Description
AT+UBTAE=<indexes_to_advertise>	Start/stop advertisements for the specified index(es). Notes: Can be stored using AT&W.

Defined values
 

Parameter	Type	Description
indexes_to_advertise	int_list	Valid length: 1 or 2

5.1.19 AT+UBTAED - Bluetooth Advertise Extended Disable

Stop extended advertisements

Syntax
 

AT Command	Description
AT+UBTAED	Stop any running extended advertisements
AT+UBTAED=<index>	Stop extended advertisements for the specified index

Defined values
 

Parameter	Type	Description
index	integer	Valid values: 0 only

5.1.20 AT+UBTASD - Bluetooth Advertisement Scan Data

Command for setting custom scan response data in Bluetooth low energy. Any custom scan response data will override the default scan response data. By default, the local name is part of the scan response data.

Syntax
 

AT Command	Description
AT+UBTASD=<scan_rsp_data>	Write custom scan response data. Notes: Can be stored using AT&W.
AT+UBTASD?	Read custom scan response data.

Response	Description
+UBTASD:<scan_rsp_data>	Successful read response.

Defined values
 

Parameter	Type	Description
scan_rsp_data	byte_array	Valid length: 1..31

5.1.21 AT+UBTASDC - Bluetooth Scan Data Clear

Clear the custom scan response data, i.e. use the default value when advertising

Syntax
 

AT Command	Description
AT+UBTASDC	Clear the custom scan response data.

5.1.22 AT+UBTAL - Bluetooth Advertise Legacy Enable

Start legacy advertisements if not started

Syntax
 

AT Command	Description
AT+UBTAL	Start legacy advertisements if not started. Notes: Can be stored using AT&W.

5.1.23 AT+UBTALD - Bluetooth Advertise Legacy Disable

Stop legacy advertisement if started

Syntax
 

AT Command	Description
AT+UBTALD	Stop legacy advertisements if started. Notes: Can be stored using AT&W.

5.1.24 AT+UBTAD - Bluetooth Directed Advertisement

Start a directed advertisement to a given Bluetooth Address

Syntax
 

AT Command	Description
AT+UBTAD=<bd_addr>[,<timeout>]	Starts directed advertisements to Bluetooth Address. 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.

Defined values
 

Parameter	Type	Description
timeout	integer	Timeout for Directed Advertisements. Default value: 1280
bd_addr	bd_addr	Bluetooth device address of the remote device.

5.1.25 AT+UBTADD - Bluetooth Advertise Directed Disable

Stop any ongoing directed advertisement

Syntax
 

AT Command	Description
AT+UBTADD	Stop directed advertisements.

5.1.26 AT+UBTCS - Bluetooth Connection Settings

Get and set connection related settings

Syntax
 

AT Command	Description
AT+UBTCS0=<connection_interval_minimum>	Write connection interval minimum. Notes: Can be stored using AT&W.
AT+UBTCS0?	Read Connection Interval minium.
AT+UBTCS1=<connection_interval_maximum>	Write connection interval maximum. Notes: Can be stored using AT&W.
AT+UBTCS1?	Read Connection Interval maximum.
AT+UBTCS2=<connection_peripheral_latency>	Write connection peripheral latency. Notes: Can be stored using AT&W.
AT+UBTCS2?	Read connection peripheral latency.
AT+UBTCS3=<connection_linkloss_timeout>	Write connection linkloss timeout. Notes: Can be stored using AT&W.
AT+UBTCS3?	Read connection linkloss timeout.
AT+UBTCS4=<preferred_tx_phy>	Write Preferred TX PHY. Notes: Can be stored using AT&W.
AT+UBTCS4?	Read Preferred TX PHY.
AT+UBTCS5=<preferred_rx_phy>	Write Preferred RX PHY. Notes: Can be stored using AT&W.
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.

Defined values
 

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 bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: Coded PHY Bit 3: Coded PHY type. 0: Use S8 coding, 1: Use S2 coding Valid values: 0..15 Default value: 0
preferred_rx_phy	integer	Preferred PHY for Receiver 0: Let other side decide OR a bit field with bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: Coded PHY Valid values: 0..15 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

5.1.27 AT+UBTALS - Bluetooth Advertisement Legacy Settings

Get and Set Advertisement Legacy Settings.

Syntax
 

AT Command	Description
AT+UBTALS=<advertisement_interval_minimum>,<advertisement_interval_maximum>	Configure advertisement parameters for legacy advertisements
AT+UBTALS?	Read advertisement parameters for legacy advertisements

Response	Description
+UBTALS:<advertisement_interval_minimum>,<advertisement_interval_maximum>	Successful read of advertisement configuration.

Defined values
 

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

5.1.28 AT+UBTSS - Bluetooth Scan Settings

Get and Set Scan Settings.

Syntax
 

AT Command	Description
AT+UBTSS0=<scan_interval>	Write scan interval.
AT+UBTSS0?	Read scan Interval.
AT+UBTSS1=<scan_window>	Write scan window.
AT+UBTSS1?	Read scan Interval.
AT+UBTSS?	Read all scanning parameter setting values.

Response	Description
+UBTSS0:<scan_interval>	Successful read of scan interval.
+UBTSS1:<scan_window>	Successful read of scan window.
+UBTSS:<scan_param>,<value>	Successful read response for AT+UBTSS?.

Defined values
 

Parameter	Type	Description
scan_interval	integer	Scan interval (must be >= Scan window.  Default: 160. Calculation: scan_interval * 0.625 ms) Valid values: 16..16384 Default value: 160
scan_window	integer	Scan window (must be <= Scan interval.  Default: 128. Calculation: scan_interval * 0.625 ms) Valid values: 16..16384 Default value: 128
value	integer	Value of scan parameter. Valid values: 0..65535
scan_param	enumerator	Scan parameter. Valid values: 0: Scan interval. 1: Scan interval.

5.1.29 AT+UBTIOC - Bluetooth I/O Capabilities

Set Bluetooth I/O Capabilities, this impacts the possible bonding procedure between devices.

Syntax
 

AT Command	Description
AT+UBTIOC=<io_capabilities>	Set I/O Capabilities Notes: Can be stored using AT&W.
AT+UBTIOC?	Read I/O Capabilities

Response	Description
+UBTIOC:<io_capabilities>	Successful read response for AT+UBTIOC?.

Defined values
 

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

5.1.30 AT+UBTBSM - Bluetooth Bond Security Mode

Set the security mode of the device. This command works together with AT+UBTIOC to determine the bonding procedure used.

Syntax
 

AT Command	Description
AT+UBTBSM=<bt_security_mode>	Writes the security mode Notes: Can be stored using AT&W.
AT+UBTBSM?	Reads the security mode

Response	Description
+UBTBSM:<bt_security_mode>	Successful read response for AT+UBTBSM?

Defined values
 

Parameter	Type	Description
bt_security_mode	enumerator	Valid values: 0: Security Disabled. 1: Allow unauthenticated bonding. 2: Only allow authenticated bonding. No secure connections. 3: Only allow authenticated bonding with encrypted Bluetooth link. Support secure connections. 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

5.1.31 AT+UBTPM - Bluetooth Pairing Mode

Enable or disable pairing.

Syntax
 

AT Command	Description
AT+UBTPM=<pairing_mode>	Writes the pairing mode. Notes: Can be stored using AT&W.
AT+UBTPM?	Read current pairing mode.

Response	Description
+UBTPM:<pairing_mode>	Successful read response for AT+UBTPM?

Defined values
 

Parameter	Type	Description
pairing_mode	enumerator	Valid values: 0: Disable pairing mode. 1: Enable pairing mode. Default value: 0

5.1.32 AT+UBTUC - Bluetooth User Confirmation

The user confirmation is used together with IO capability DisplayYesNo to repond to a user confirmation request (+UEBTUC). The command shall be used only after +UEBTUC has been received.

Syntax
 

AT Command	Description
AT+UBTUC=<bd_addr>,<yes_no>	Respond to +UEUBTUC and confirm/deny bonding.

Defined values
 

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.

5.1.33 AT+UBTUPE - User passkey entry

The user passkey entry is used together with IO capability KeyboardOnly to respond on a user passkey entry request (+UEBTUPE). This command shall be used only after +UEBTUPE has been received.

Syntax
 

AT Command	Description
AT+UBTUPE=<bd_addr>,<yes_no>[,<passkey>]	Respond to +UEBTUPE event and confirm/deny bonding.

Defined values
 

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.

5.1.34 AT+UBTB - Bluetooth Bond

Performs a GAP bond procedure with another Bluetooth device. For some I/O Capabilities, user interaction is required during the bonding procedure. The procedure to use is determined by the I/O Capabilities and security mode.

Syntax
 

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.

Defined values
 

Parameter	Type	Description
bd_addr	bd_addr	Bluetooth device address of the remote device.

5.1.35 AT+UBTUB - Bluetooth Unbond

Unbond from a previously bonded device.

Syntax
 

AT Command	Description
AT+UBTUB=<bd_addr>	Removes a single previously bonded device.
AT+UBTUB	Removes all previously bonded devices.

Defined values
 

Parameter	Type	Description
bd_addr	bd_addr	Bluetooth device address of the remote device.

Notes

These AT commands will remove the bond from the local device only.

5.1.36 AT+UBTBDL - Bluetooth Bonded Devices List

Reads the list of bonded devices.

Syntax
 

AT Command	Description
AT+UBTBDL	Read list of bonded devices.

Response	Description
+UBTBDL:<bd_addr>	This response is sent for every found device.

Defined values
 

Parameter	Type	Description
bd_addr	bd_addr	Bluetooth device address of the remote device.

5.1.37 AT+UBTDIS - Bluetooth Device Information Service

Write and read the module's Device Information Service (DIS) characteristics.

Syntax
 

AT Command	Description
AT+UBTDIS=<characteristic_id>,<characteristic_value>	Set a characteristic value. Notes: Can be stored using AT&W.
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.

Defined values
 

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.

5.1.38 AT+UBTPHYR - Bluetooth PHY Request

Request a new PHY configuration for a connection. If tx PHY or rx PHY is 0, the module will select PHYs
based on the peer requirements on that specific direction. If the peer does not support the PHY update procedure,
then the resulting +UEBTPHYU event will have a error status other than success.

Syntax
 

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.

Defined values
 

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 bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: Coded PHY Bit 3: Coded PHY type. 0: Use S8 coding, 1: Use S2 coding Valid values: 0..15
rx_phy	integer	Requested PHY for Receiver 0: Let other side decide OR a bit field with bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: Coded PHY Valid values: 0..7

5.2 Unsolicited Response Codes

Unsolicited Response Code	Description
+UEBTC	Event Bluetooth Connected
+UEBTDC	Event Bluetooth Disconnected
+UEBTB	Event Bluetooth Bond status
+UEBTUC	Event Bluetooth User Confirmation
+UEBTUPD	Event Bluetooth Passkey entry
+UEBTUPE	Event Bluetooth Passkey request
+UEBTPHYU	Event Bluetooth PHY update

5.2.1 +UEBTC - Event Bluetooth Connected

Event indicating successful Bluetooth connection.

Syntax

+UEBTC:<conn_handle>,<bd_addr>

Defined values
 

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.

5.2.2 +UEBTDC - Event Bluetooth Disconnected

Event indicating a disconnected Bluetooth connection.

Syntax

+UEBTDC:<conn_handle>

Defined values
 

Parameter	Type	Description
conn_handle	integer	Connection handle of the Bluetooth low energy connection.

5.2.3 +UEBTB - Event Bluetooth Bond status

Event indicates that a bonding procedure is completed.

Syntax

+UEBTB:<bd_addr>,<bond_status>

Defined values
 

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. 4: Bonding failed because peer have lost the bonding info. Use AT+UBTUB to delete the local bond to allow re-bonding.

5.2.4 +UEBTUC - Event Bluetooth User Confirmation

This event is used while bonding with IO capability DisplayYesNo. This event indicates that the user confirmation of a numeric value is required.

Syntax

+UEBTUC:<bd_addr>,<numeric_value>

Defined values
 

Parameter	Type	Description
bd_addr	bd_addr	Bluetooth device address of the remote device.
numeric_value	integer	Numeric value. Valid values: 0..999999

5.2.5 +UEBTUPD - Event Bluetooth Passkey entry

This event is used to indicate to the user that a passkey has to be entered on the remote device during a bonding procedure with the IO capability DisplayOnly.

Syntax

+UEBTUPD:<bd_addr>,<numeric_value>

Defined values
 

Parameter	Type	Description
bd_addr	bd_addr	Bluetooth device address of the remote device.
numeric_value	integer	Numeric value. Valid values: 0..999999

5.2.6 +UEBTUPE - Event Bluetooth Passkey request

This event is used during bonding with IO capability KeyboardOnly to indicate that a passkey is required from the user. User should respond to this event with the AT+UBTUPE command.

Syntax

+UEBTUPE:<bd_addr>

Defined values
 

Parameter	Type	Description
bd_addr	bd_addr	Bluetooth device address of the remote device.

5.2.7 +UEBTPHYU - Event Bluetooth PHY update

This event informs the result of a PHY update procedure. It may be generated as a result of the command AT+UBTPHYR or as a successful event, if the operation has been initiated by the remote peer.

Syntax

+UEBTPHYU:<conn_handle>,<phy_status>,<tx_phy>,<rx_phy>

Defined values
 

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 bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: Coded PHY Bit 3: Coded PHY type. 0: Use S8 coding, 1: Use S2 coding Valid values: 0..15
rx_phy	integer	Requested PHY for Receiver 0: Let other side decide OR a bit field with bits: Bit 0: 1 Mbps preferred Bit 1: 2 Mbps preferred Bit 2: Coded PHY Valid values: 0..7

6 GATT Client

GATT Client

6.1 AT Commands

AT Command	Description
AT+UBTGPSD	GATT Primary Services Discover
AT+UBTGPSDU	GATT Primary Services Discover by UUID
AT+UBTGSCD	GATT Service Characteristics Discover
AT+UBTGCDD	GATT Characteristic Descriptors Discover
AT+UBTGR	GATT Read
AT+UBTGRU	GATT Read characteristic by UUID
AT+UBTGW	GATT Write
AT+UBTGCCW	GATT Client Configuration Write
AT+UBTGWNR	GATT Write with No Response
AT+UBTGWL	GATT Write long

6.1.1 AT+UBTGPSD - GATT Primary Services Discover

List all GATT services on the GATT server.

Syntax
 

AT Command	Description
AT+UBTGPSD=<conn_handle>	Discover all primary services on the remote device.

Response	Description
+UBTGPSD:<conn_handle>,<start_handle>,<end_handle>,<uuid>	This response is sent for each service found.

Defined values
 

Parameter	Type	Description
conn_handle	integer	Bluetooth Low Energy connection handle.
start_handle	integer	Service start handle.
end_handle	integer	Service end handle.
uuid	byte_array	UUID of attribute. Either 16-bit or 128-bit.

6.1.2 AT+UBTGPSDU - GATT Primary Services Discover by UUID

Discovers all primary services by UUID on the remote device.

Syntax
 

AT Command	Description
AT+UBTGPSDU=<conn_handle>,<uuid>	Start discovery.

Response	Description
+UBTGPSDU:<conn_handle>,<start_handle>,<end_handle>	This response is sent for each service found.

Defined values
 

Parameter	Type	Description
conn_handle	integer	Bluetooth Low Energy connection handle.
uuid	byte_array	UUID of attribute. Either 16-bit or 128-bit.
start_handle	integer	Service start handle.
end_handle	integer	Service end handle.

6.1.3 AT+UBTGSCD - GATT Service Characteristics Discover

This command will list all characteristics belonging to a service on the GATT server.

Syntax
 

AT Command	Description
AT+UBTGSCD=<conn_handle>,<start>,<end>	Discover all characteristics of a service.

Response	Description
+UBTGSCD:<conn_handle>,<attr_handle>,<properties>,<value_handle>,<uuid>	This response is sent for each characteristic found.

Defined values
 

Parameter	Type	Description
start	integer	Service start handle.
end	integer	Service end handle.
attr_handle	integer	Attribute handle of the characteristic
properties	byte_array	Bit mask describing the properties of the characteristic
conn_handle	integer	Bluetooth Low Energy connection handle.
value_handle	integer	Attribute handle of the characteristic value.
uuid	byte_array	UUID of attribute. Either 16-bit or 128-bit.

6.1.4 AT+UBTGCDD - GATT Characteristic Descriptors Discover

Discover Characteristics Descriptors. This command will list all descriptors of a characteristic on the GATT server.

Syntax
 

AT Command	Description
AT+UBTGCDD=<conn_handle>,<value_handle>,<characteristic_end_handle>	Discover all descriptors of a characteristic.

Response	Description
+UBTGCDD:<conn_handle>,<char_handle>,<desc_handle>,<uuid>	This response is sent for each descriptor found.

Defined values
 

Parameter	Type	Description
char_handle	integer	Characteristic handle.
characteristic_end_handle	integer	End handle of characteristic to which descriptor discovery is being performed.
desc_handle	integer	Descriptor handle.
conn_handle	integer	Bluetooth Low Energy connection handle.
value_handle	integer	Attribute handle of the characteristic value.
uuid	byte_array	UUID of attribute. Either 16-bit or 128-bit.

6.1.5 AT+UBTGR - GATT Read

Read a characteristic value.

Syntax
 

AT Command	Description
AT+UBTGR=<conn_handle>,<value_handle>	Reads the characteristic; all bytes included.

Response	Description
+UBTGR:<conn_handle>,<value_handle>,<hex_data>	Successful read response.

Defined values
 

Parameter	Type	Description
conn_handle	integer	Bluetooth Low Energy connection handle.
value_handle	integer	Attribute handle of the characteristic value.
hex_data	byte_array	Characteristic data in hexadecimal form. For example, 070809AABBCC

6.1.6 AT+UBTGRU - GATT Read characteristic by UUID

Read GATT characteristic values by UUID.

Syntax
 

AT Command	Description
AT+UBTGRU=<conn_handle>,<start>,<end>,<uuid>	Read all the characteristics by UUID. It will read all the bytes in each characteristic.

Response	Description
+UBTGRU:<conn_handle>,<value_handle>,<hex_data>	Successful read response.

Defined values
 

Parameter	Type	Description
start	integer	Start handle.
end	integer	End handle.
conn_handle	integer	Bluetooth Low Energy connection handle.
uuid	byte_array	UUID of attribute. Either 16-bit or 128-bit.
value_handle	integer	Attribute handle of the characteristic value.
hex_data	byte_array	Characteristic data in hexadecimal form. For example, 070809AABBCC

6.1.7 AT+UBTGW - GATT Write

Write a characteristic value.

Syntax
 

AT Command	Description
AT+UBTGW=<conn_handle>,<value_handle>,<hex_data>	Write the characteristic value.

Defined values
 

Parameter	Type	Description
conn_handle	integer	Bluetooth Low Energy connection handle.
value_handle	integer	Attribute handle of the characteristic value.
hex_data	byte_array	Characteristic data in hexadecimal form. For example, 070809AABBCC

6.1.8 AT+UBTGCCW - GATT Client Configuration Write

Write characteristic configuration to enable notifications or indications.

Syntax
 

AT Command	Description
AT+UBTGCCW=<conn_handle>,<desc_handle>,<config>	Writes the client characteristic configuration.

Defined values
 

Parameter	Type	Description
desc_handle	integer	Descriptor handle.
config	enumerator	Valid values: 0: None 1: Enable notifications 2: Enable indications 3: Enable notifications and indications
conn_handle	integer	Bluetooth Low Energy connection handle.

6.1.9 AT+UBTGWNR - GATT Write with No Response

Write the characteristic with no response message from the remote side.

Syntax
 

AT Command	Description
AT+UBTGWNR=<conn_handle>,<value_handle>,<hex_data>	Write characteristic.

Defined values
 

Parameter	Type	Description
conn_handle	integer	Bluetooth Low Energy connection handle.
value_handle	integer	Attribute handle of the characteristic value.
hex_data	byte_array	Characteristic data in hexadecimal form. For example, 070809AABBCC

6.1.10 AT+UBTGWL - GATT Write long

Write a long characteristic.

Syntax
 

AT Command	Description
AT+UBTGWL=<conn_handle>,<value_handle>,<hex_data>,<reliable>,<flag>,<offset>	Write long characteristic.

Defined values
 

Parameter	Type	Description
reliable	enumerator	Valid values: 0: Not reliable 1: Reliable
flag	enumerator	Valid values: 0: Final data 1: More data 2: Cancel
offset	integer
conn_handle	integer	Bluetooth Low Energy connection handle.
value_handle	integer	Attribute handle of the characteristic value.
hex_data	byte_array	Characteristic data in hexadecimal form. For example, 070809AABBCC

6.2 Unsolicited Response Codes

Unsolicited Response Code	Description
+UEBTGCN	Event GATT Client Notification
+UEBTGCI	Event GATT Client Indication

6.2.1 +UEBTGCN - Event GATT Client Notification

GATT Client Notification. This event is received when the remote side sends a notification.

Syntax

+UEBTGCN:<conn_handle>,<value_handle>,<hex_data>

Defined values
 

Parameter	Type	Description
conn_handle	integer	Bluetooth Low Energy connection handle.
value_handle	integer	Attribute handle of the characteristic value.
hex_data	byte_array	Characteristic data in hexadecimal form. For example, 070809AABBCC

6.2.2 +UEBTGCI - Event GATT Client Indication

GATT Client Indication. This event is received when the remote side sends an indication.

Syntax

+UEBTGCI:<conn_handle>,<value_handle>,<hex_data>

Defined values
 

Parameter	Type	Description
conn_handle	integer	Bluetooth Low Energy connection handle.
value_handle	integer	Attribute handle of the characteristic value.
hex_data	byte_array	Characteristic data in hexadecimal form. For example, 070809AABBCC

7 GATT Server

GATT Server

7.1 AT Commands

AT Command	Description
AT+UBTGS	GATT Service define
AT+UBTGC	GATT Characteristic define
AT+UBTGHCC	GATT Host Controlled Characteristic
AT+UBTGD	GATT Descriptor define
AT+UBTGSA	GATT Service Activate
AT+UBTGRRR	GATT Read Request Respond
AT+UBTGNS	GATT Notification Send
AT+UBTGIS	GATT Indication Send
AT+UBTGAV	GATT Attribute Value
AT+UBTGRRRE	GATT Read Request Respond with error code
AT+UBTGWRE	GATT Write Respond with Error code
AT+UBTGWRR	GATT Write Request Respond

7.1.1 AT+UBTGS - GATT Service define

Command to define a GATT service according to a 16-bit Service Assigned Number from Bluetooth SIG or a 128-bit user defined service number.

Syntax
 

AT Command	Description
AT+UBTGS=<uuid>	Defines a service.

Response	Description
+UBTGS:<ser_handle>	Successful write response.

Defined values
 

Parameter	Type	Description
uuid	byte_array	UUID of service. This can be either 16 bit or 128 bit.
ser_handle	integer	Handle of the created service.

7.1.2 AT+UBTGC - GATT Characteristic define

Command to add a GATT characteristic to the most recent GATT service record created with AT+UBTGS.

Syntax
 

AT Command	Description
AT+UBTGC=<uuid>,<properties>,<security_read>,<security_write>,<value>[,<max_length>]	Create a new characteristic in the GATT table for a GATT server. The CCCD for the characteristic, if applicable, is created here. Extended properties such as CPFD, CUDD, and SCCD are not supported.

Response	Description
+UBTGC:<value_handle>,<cccd_handle>	Successful write response.

Defined values
 

Parameter	Type	Description
uuid	byte_array	UUID of characteristic. This can be either 16 bit or 128 bit.
value	byte_array	Default characteristic value before any value is pushed to it. A characteristic value can be 244 bytes long.
max_length	integer	Maximum length of the characteristic in bytes. The maximum value is 244 bytes. Valid values: 1..244
value_handle	integer	Added characteristic handle.
cccd_handle	integer	CCCD characteristic handle. This value is zero if there is no CCCD.
properties	byte_array	Property value (a bit field): Broadcast: 0x01 - If set, it allows broadcasts of the Characteristic Value using Characteristic Configuration Descriptor. Read: 0x02 - If set, it allows reads of the Characteristic Value. Write Without Response: 0x04 - If set, it allows writing of the Characteristic Value without response. Write: 0x08 - If set, it allows writing of the Characteristic Value with response. Notify: 0x10 - If set, it allows notifications of a characteristic value. Indicate: 0x20 - If set, it allows indication of a characteristic value with acknowledgement. Authenticated Signed Writes: 0x40 - If set, it allows signed writes to the characteristic value. Reserved Bit: 0x80 - Do not use. Reserved for future use. Valid length: 1 only
security_read	enumerator	Valid values: 1: No encryption required. 2: Unauthenticated encryption required. 3: Authenticated encryption required.
security_write	enumerator	Valid values: 1: No encryption required. 2: Unauthenticated encryption required. 3: Authenticated encryption required.

7.1.3 AT+UBTGHCC - GATT Host Controlled Characteristic

Create a new host controlled characteristic in the GATT table for a GATT server. The CCCD for the characteristic, if applicable, is created here. Extended properties such as CPFD, CUDD, and SCCD are not supported.

Syntax
 

AT Command	Description
AT+UBTGHCC=<uuid>,<properties>,<security_read>,<security_write>	Define a characteristic.

Response	Description
+UBTGHCC:<value_handle>,<cccd_handle>	Successful write response.

Defined values
 

Parameter	Type	Description
uuid	byte_array	UUID of characteristic. This can be either 16 bit or 128 bit.
value_handle	integer	Value handle of the added characteristic.
cccd_handle	integer	Client Characteristic Configuration Descriptor (CCCD) handle of the added characteristic. This value is zero if there is no CCCD.
properties	byte_array	Property value (a bit field): Broadcast: 0x01 - If set, it allows broadcasts of the Characteristic Value using Characteristic Configuration Descriptor. Read: 0x02 - If set, it allows reads of the Characteristic Value. Write Without Response: 0x04 - If set, it allows writing of the Characteristic Value without response. Write: 0x08 - If set, it allows writing of the Characteristic Value with response. Notify: 0x10 - If set, it allows notifications of a characteristic value. Indicate: 0x20 - If set, it allows indication of a characteristic value with acknowledgement. Authenticated Signed Writes: 0x40 - If set, it allows signed writes to the characteristic value. Reserved Bit: 0x80 - Do not use. Reserved for future use. Valid length: 1 only
security_read	enumerator	Valid values: 1: No encryption required. 2: Unauthenticated encryption required. 3: Authenticated encryption required.
security_write	enumerator	Valid values: 1: No encryption required. 2: Unauthenticated encryption required. 3: Authenticated encryption required.

7.1.4 AT+UBTGD - GATT Descriptor define

Define a vendor defined descriptor. Standard Bluetooth low energy descriptors such as CCCD are created while creating the characteristic in AT+UBTGC command.

Syntax
 

AT Command	Description
AT+UBTGD=<uuid>,<security_read>,<security_write>,<value>[,<max_length>]	Define descriptor.

Response	Description
+UBTGD:<desc_handle>	Successful write response.

Defined values
 

Parameter	Type	Description
uuid	byte_array	UUID of characteristic. This can be either 16 bit or 128 bit.
value	byte_array	Descriptor value. This can be 23 bytes long.
max_length	integer	Maximum length of the descriptor in bytes. The maximum value is 23 bytes. Valid values: 1..23
desc_handle	integer	Handle of the created descriptor.
security_read	enumerator	Valid values: 1: No encryption required. 2: Unauthenticated encryption required. 3: Authenticated encryption required.
security_write	enumerator	Valid values: 1: No encryption required. 2: Unauthenticated encryption required. 3: Authenticated encryption required.

7.1.5 AT+UBTGSA - GATT Service Activate

Activate the service defined with the AT+UBTGS command. After this command is issued, it is not possible to add more characteristics or descriptors to the service.

Syntax
 

AT Command	Description
AT+UBTGSA	Activate current defined service.

7.1.6 AT+UBTGRRR - GATT Read Request Respond

Respond to an unsolicited request to read (see +UEBTGRR) from a remote GATT client.

Syntax
 

AT Command	Description
AT+UBTGRRR=<conn_handle>,<value>	Responds to read request.

Defined values
 

Parameter	Type	Description
conn_handle	integer	GAP handle of the connected device.
value	byte_array	Characteristic value. This can be 244 bytes long.

7.1.7 AT+UBTGNS - GATT Notification Send

Send notifications to a remote client. This also updates the value of the characteristic.

Syntax
 

AT Command	Description
AT+UBTGNS=<conn_handle>,<char_handle>,<value>	Send notification

Defined values
 

Parameter	Type	Description
conn_handle	integer	GAP handle of the connected device.
char_handle	integer	Characteristic value handle.
value	byte_array	Characteristic value. The maximum length is the current MTU size - 3.

7.1.8 AT+UBTGIS - GATT Indication Send

Send indication to a remote client. This also updates the value of the characteristic.

Syntax
 

AT Command	Description
AT+UBTGIS=<conn_handle>,<char_handle>,<value>	Send notification

Defined values
 

Parameter	Type	Description
conn_handle	integer	GAP handle of the connected device.
char_handle	integer	Characteristic value handle.
value	byte_array	Characteristic value. The maximum length is the current MTU size - 3.

7.1.9 AT+UBTGAV - GATT Attribute Value

Update the value of an attribute. In case of characteristics which allow indications and notifications, this command will update the value without sending any indications or notifications to the remote side.

Syntax
 

AT Command	Description
AT+UBTGAV=<attr_handle>,<value>	Set attribute value.

Defined values
 

Parameter	Type	Description
attr_handle	integer	Attribute handle.
value	byte_array	Characteristic value. This can be 244 bytes long.

7.1.10 AT+UBTGRRRE - GATT Read Request Respond with error code

Respond to read request with application error code.

Syntax
 

AT Command	Description
AT+UBTGRRRE=<conn_handle>,<error_code>	Respond with error code.

Defined values
 

Parameter	Type	Description
conn_handle	integer	GAP handle of connected device.
error_code	byte_array	Application error code. Allowed value range: 0x80-0x9F Valid length: 1 only

7.1.11 AT+UBTGWRE - GATT Write Respond with Error code

Respond to write operation with application error code.

Syntax
 

AT Command	Description
AT+UBTGWRE=<conn_handle>,<error_code>	Respond with error code.

Defined values
 

Parameter	Type	Description
conn_handle	integer	GAP handle of connected device.
error_code	byte_array	Application error code. Allowed value range: 0x80-0x9F Valid length: 1 only

7.1.12 AT+UBTGWRR - GATT Write Request Respond

Accept write request from GATT client.

Syntax
 

AT Command	Description
AT+UBTGWRR=<conn_handle>	Respond to write request.

Defined values
 

Parameter	Type	Description
conn_handle	integer	GAP handle of connected device.

7.2 Unsolicited Response Codes

Unsolicited Response Code	Description
+UEBTGCW	Event GATT Server Write
+UEBTGRR	Event GATT Server Read Response
+UEBTGIC	Event GATT Server Indication Confirmation

7.2.1 +UEBTGCW - Event GATT Server Write

Unsolicited response code for GATT Server. This event occurs when a remote client writes to an attribute.

Syntax

+UEBTGCW:<conn_handle>,<value_handle>,<value>,<options>

Defined values
 

Parameter	Type	Description
conn_handle	integer	GAP connection handle.
value_handle	integer	Characteristic value handle.
value	byte_array	The data as hex string. For example, 070809AABBCC
options	enumerator	Valid values: 0: Write without Response performed 1: Write with Response performed 2: Write long performed

7.2.2 +UEBTGRR - Event GATT Server Read Response

Unsolicited response code for GATT Server. This event occurs when a remote client reads an attribute over the air. The event should be responded with AT+UBTGRRR.

Syntax

+UEBTGRR:<conn_handle>,<value_handle>

Defined values
 

Parameter	Type	Description
conn_handle	integer	Handle of the connected device.
value_handle	integer	Handle of the characteristic value.

7.2.3 +UEBTGIC - Event GATT Server Indication Confirmation

Unsolicited response code for GATT Server. This event occurs when a remote GATT client acknowledges the receipt of an indication message sent using AT+UBTGIS.

Syntax

+UEBTGIC:<conn_handle>,<char_handle>

Defined values
 

Parameter	Type	Description
conn_handle	integer	Connected device handle.
char_handle	integer	Characteristic value handle.

8 SPS

SPS - Serial Port Service

8.1 AT Commands

AT Command	Description
AT+USPSC	SPS Connect
AT+USPS	SPS - Enable/Disable Service
AT+USPSWS	SPS Write String
AT+USPSWB	SPS Write Binary
AT+USPSRM	SPS Receive Mode
AT+USPSRS	SPS Read String
AT+USPSRB	SPS Read Binary

8.1.1 AT+USPSC - SPS Connect

SPS connect on connected Bluetooth device

Syntax
 

AT Command	Description
AT+USPSC=<conn_handle>[,<flow_control>]	SPS connect on connected Bluetooth device

Defined values
 

Parameter	Type	Description
conn_handle	integer	Connection handle of remote peer
flow_control	integer	Flow control: 0 - no flow control, 1 - flow control

8.1.2 AT+USPS - SPS - Enable/Disable Service

Enable or disable the SPS service

Syntax
 

AT Command	Description
AT+USPS=<sps_service_option>	Enables or disable the SPS Service. Notes: Can be stored using AT&W.
AT+USPS?	Read if the SPS service is enabled or disabled.

Response	Description
+USPS:<sps_service_option>	Successful read response.

Defined values
 

Parameter	Type	Description
sps_service_option	enumerator	Valid values: 0: This option disables the SPS service after saving the configuration and restarting the device. (Default) 1: This option enables the SPS service directly. If this option is set, and the configuration is saved, SPS will be enabled after reboot.

8.1.3 AT+USPSWS - SPS Write String

Write to a peer through SPS

Syntax
 

AT Command	Description
AT+USPSWS=<conn_handle>,<string_data>	Write SPS data

Response	Description
+USPSWS:<conn_handle>,<written_length>	Successful write response

Defined values
 

Parameter	Type	Description
conn_handle	integer	Connection handle of remote peer which has SPS enabled
string_data	string	Data encoded as ascii chars. Valid length: 1..1000
written_length	integer	Data length that was written.

8.1.4 AT+USPSWB - SPS Write Binary

Syntax
 

AT Command	Description
AT+USPSWB=<conn_handle>{binary_data}	Writes the specified amount of data to the specified SPS connection in binary mode. Max 1000 bytes.

Response	Description
+USPSWB:<conn_handle>,<written_length>	Successful write response

Defined values
 

Parameter	Type	Description
conn_handle	integer	Connection handle of remote peer which has SPS enabled
binary_data	binary	The data to write.
written_length	integer	Data length that was written.

8.1.5 AT+USPSRM - SPS Receive Mode

Syntax
 

AT Command	Description
AT+USPSRM=<read_mode>	Set the mode in which to receive SPS data in AT mode. Notes: Can be stored using AT&W.
AT+USPSRM?	Read mode set.

Response	Description
+USPSRM:<read_mode>	Successful read response.

Defined values
 

Parameter	Type	Description
read_mode	enumerator	Modes to read data in AT Valid values: 0: Buffered mode 1: Direct String mode 2: Direct Binary Mode

8.1.6 AT+USPSRS - SPS Read String

Syntax
 

AT Command	Description
AT+USPSRS=<conn_handle>,<length>	Reads the specified amount of data from given connection handle. Note that the data should include no null terminator characters.

Response	Description
+USPSRS:<conn_handle>,<length>,<string_data>	Successful read response.

Defined values
 

Parameter	Type	Description
length	integer	Data bytes to read. Valid values: 0..1000
conn_handle	integer	Connection handle of remote peer
string_data	string	SPS data in string format

8.1.7 AT+USPSRB - SPS Read Binary

Syntax
 

AT Command	Description
AT+USPSRB=<conn_handle>,<length>	Reads the specified amount of data from the specified connection handle in binary mode.

Response	Description
+USPSRB:<conn_handle>{binary_data}	Successful read response.

Defined values
 

Parameter	Type	Description
length	integer	Data bytes to read. Valid values: 0..1000
binary_data	binary	The available data. Please note that the number of bytes may be less than requested.
conn_handle	integer	Connection handle of remote peer

8.2 Unsolicited Response Codes

Unsolicited Response Code	Description
+UESPSC	Event SPS Connection
+UESPSDC	Event SPS Disconnection
+UESPSDS	Event SPS Data String
+UESPSDB	Event SPS Data Binary
+UESPSDA	Event SPS Data Available

8.2.1 +UESPSC - Event SPS Connection

Event response for SPS Connect. Upon a successful SPS connection, conn_handle will contain the connection handle of the remote peer.

Syntax

+UESPSC:<conn_handle>

Defined values
 

Parameter	Type	Description
conn_handle	integer	Connection handle of remote peer

8.2.2 +UESPSDC - Event SPS Disconnection

Event response for SPS Connect. Upon a SPS disconnection, conn_handle will contain the connection handle of the remote peer.

Syntax

+UESPSDC:<conn_handle>

Defined values
 

Parameter	Type	Description
conn_handle	integer	Connection handle of remote peer

8.2.3 +UESPSDS - Event SPS Data String

Unsolicited event containing SPS data as a string received from remote peer.

Syntax

+UESPSDS:<conn_handle>,<string_data>

Defined values
 

Parameter	Type	Description
conn_handle	integer	Connection handle of remote peer
string_data	string	SPS data in string format

8.2.4 +UESPSDB - Event SPS Data Binary

Unsolicited event containing SPS data in binary format.

Syntax

+UESPSDB:<conn_handle>{binary_data}

Defined values
 

Parameter	Type	Description
binary_data	binary	The received data.
conn_handle	integer	Connection handle of remote peer

8.2.5 +UESPSDA - Event SPS Data Available

Unsolicited event containing the number of received bytes to read.

Syntax

+UESPSDA:<conn_handle>,<number_bytes>

Defined values
 

Parameter	Type	Description
number_bytes	integer	Number of bytes available to read.
conn_handle	integer	Connection handle of remote peer

9 Power

Power Commands

9.1 AT Commands

AT Command	Description
AT+UPMDS	Power Management Deep Sleep

9.1.1 AT+UPMDS - Power Management Deep Sleep

Syntax
 

AT Command	Description
AT+UPMDS	Enter Deep Sleep Mode with GPIO wakeup.
AT+UPMDS=<wakeup_mode>	Enter Deep Sleep Mode with specified wakeup mode.

Defined values
 

Parameter	Type	Description
wakeup_mode	enumerator	Selects how to wake up from deep sleep. Valid values: 0: Wakeup by pulling the module wakeup pin low. 1: Wakeup by module reset pin. Default value: 0

10 Transparent

Transparent Mode AT commands. In transparent mode all data that is sent from the host to the UART is
forwarded to the socket or SPS link that is configured for transparent mode, and the all data that arrives
on this link is sent to the UART.
Transparent mode is limited to one link at a time.

10.1 AT Commands

AT Command	Description
AT+UTM	Transparent Mode
AT+UTMP	Transparent Mode Persistent
AT+UTMPC	Transparent Mode Persistent Clear

10.1.1 AT+UTM - Transparent Mode

Use this command to directly switch to transparent mode for a specific SPS link or a socket.

Syntax
 

AT Command	Description
AT+UTM=<link_type>,<handle>	Enter Transparent Mode

Defined values
 

Parameter	Type	Description
handle	integer	For SPS links, set this to the connection handle For sockets, set this to the socket handle
link_type	enumerator	Valid values: 0: BLE SPS Link 1: Socket

10.1.2 AT+UTMP - Transparent Mode Persistent

This command is used for automatically setting up a transparent mode connection on boot.

Syntax
 

AT Command	Description
AT+UTMP=<link_type>,<config_id>	Set persistent transparent mode for link Notes: Requires AT&W and a reboot before taking effect.
AT+UTMP?	Get current persistent transparent mode configuration

Response	Description
+UTMP:<link_type_read>,<config_id>	Successful read response.

Defined values
 

Parameter	Type	Description
config_id	integer	For SPS, set this to the config_id returned by AT+UBTP.
link_type	enumerator	Valid values: 0: BLE SPS Link 1: Socket
link_type_read	enumerator	Valid values: -1: No link type set 0: BLE SPS Link 1: Socket

10.1.3 AT+UTMPC - Transparent Mode Persistent Clear

Clears the persistent link configuration for transparent mode.

Syntax
 

AT Command	Description
AT+UTMPC	Clears persistent transparent mode settings Notes: Can be stored using AT&W.

11 Changelog

All notable changes in the NORA-B26 AT commands manual will be documented here.

[3.0.1] - R01 - 2024-08-13

First release for NORA-B26 with Bluetooth Low Energy support and with new and improved AT commad set, not backwards compatilbe with previous u-connectXpress versions.

12 Related documents

1. NORA-B26 Product Page, https://www.u-blox.com/en/product/nora-b2-series
2. NORA-B26 Data Sheet, https://www.u-blox.com/docs/UBXDOC-465451970-4608
3. NORA-B26 System integration manual, https://www.u-blox.com/docs/UBXDOC-465451970-2534
4. EVK-NORA-B26 User Guide, https://www.u-blox.com/docs/UBXDOC-465451970-4607

13 Contacts

u-blox AG
Address: Zürcherstrasse 68
8800 Thalwil
Switzerland
For further support and contact information, visit us at www.u-blox.com/support.