Anybus Wireless Bolt User manual

Wireless Bolt
™/ Wireless Bridge II™
AT Commands
REFERENCE GUIDE
SCM-1202-004 EN 1.7 ENGLISH

Important User Information
Liability
Every care has been taken in the preparation of this document. Please inform HMS Industrial Networks AB of any
inaccuracies or omissions. The data and illustrations found in this document are not binding. We, HMS Industrial
Networks AB, reserve the right to modify our products in line with our policy of continuous product development.
The information in this document is subject to change without notice and should not be considered as a
commitment by HMS Industrial Networks AB. HMS Industrial Networks AB assumes no responsibility for any errors
that may appear in this document.
There are many applications of this product. Those responsible for the use of this device must ensure that all the
necessary steps have been taken to verify that the applications meet all performance and safety requirements
including any applicable laws, regulations, codes, and standards.
HMS Industrial Networks AB will under no circumstances assume liability or responsibility for any problems that
may arise as a result from the use of undocumented features, timing, or functional side effects found outside the
documented scope of this product. The effects caused by any direct or indirect use of such aspects of the product
are undefined, and may include e.g. compatibility issues and stability issues.
The examples and illustrations in this document are included solely for illustrative purposes. Because of the many
variables and requirements associated with any particular implementation, HMS Industrial Networks AB cannot
assume responsibility for actual use based on these examples and illustrations.
Intellectual Property Rights
HMS Industrial Networks AB has intellectual property rights relating to technology embodied in the product
described in this document. These intellectual property rights may include patents and pending patent applications
in the USA and other countries.
Anybus®is a registered trademark of HMS Industrial Networks AB. All other trademarks mentioned in this document
are the property of their respective holders.
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7
Table of Contents Page
1 Preface ............................................................................................................................... 3
1.1 About This Document.....................................................................................................3
1.2 Document history...........................................................................................................3
2 Introduction ...................................................................................................................... 4
2.1 Data Types....................................................................................................................4
3 AT Commands.................................................................................................................. 5
3.1 Standard Commands .....................................................................................................5
3.2 Network Commands.......................................................................................................6
3.3 Bluetooth Classic Commands .......................................................................................10
3.4 WLAN Commands .......................................................................................................30
3.5 WLAN AP Commands..................................................................................................35
3.6 WLAN Client (STA) Commands ....................................................................................38
3.7 Informational Commands..............................................................................................49
3.8 Miscellaneous Commands............................................................................................50
3.9 Bluetooth Low Energy Commands ................................................................................60
3.10 Bluetooth Low Energy GATT Client Commands..............................................................69
3.11 Unsolicited events........................................................................................................78
4 S Registers...................................................................................................................... 80
4.1 ATS S Registers ..........................................................................................................80

This page intentionally left blank

Preface 3 (88)
1 Preface
1.1 About This Document
This document describes the available AT commands for Anybus Wireless Bolt/Bridge II.
The reader of this document is expected to be familiar with the product and have a good
knowledge of wireless communication and network technology.
For additional related documentation, file downloads and technical support, please visit the
Anybus support website at www.anybus.com/support.
1.2 Document history
Revision list
Version Date Description
1.0 2016-06-27 Beta release
1.1 2016-10-01 First public release
1.2 2017-03-31 Updated for Wireless Bridge II
1.3 2017-09-21 Update for SP2
1.4 2017-12-21 Update for FW 1.3.9
1.5 2018-02-15 Updated script examples
1.6 2018-03-08 Added unsolicited events
1.7 2018-09-03 Update for FW 1.6.3
Script examples are now available on support web
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

Introduction 4 (88)
2 Introduction
AT commands allow more configuration options than the web interface and can be scripted for
batch configuration of multiple units. A string of AT commands can for example be sent from a
PLC for automatic configuration during initial setup or when replacing units.
Each command line can only contain a single command and must not exceed 300 characters.
Some commands may have additional limitations. This document describes the structure and
syntax of each command and also includes examples for most of them.
Some of the commands require that the unit is rebooted before they become effective. This is
indicated in the description of the command.
UPPER CASE is only used for clarity in this manual, AT commands are not case sensitive.
2.1 Data Types
The description of each command also specifies the data types used for the parameter values.
There are five different data types:
String
Strings can contain all the printable characters from the ISO 8859-1 (8-bit ASCII) character set
except "(double quote) ,(comma) and \(backslash).
The string does not need surrounding quotes.
Integer
Integer values can be entered in decimal form or as a hexadecimal string beginning with 0x; e.g.
15 can also be entered as 0x0000000F.
Boolean
Boolean values can be either 0(false) or 1(true).
NetworkAddress
Used for IP addresses. Must be entered as four integer values in the range 0 to 255 separated
by periods, e.g. 192.168.0.98.
MACAddress
Used for Ethernet and Bluetooth MAC addresses. Addresses must be entered as six groups of
two hexadecimal digits in one of the following formats:
00A0F7101C08
00:A0:F7:10:1C:08
00–A0–F7–10–1C–08
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 5 (88)
3 AT Commands
3.1 Standard Commands
3.1.1 AT&F Restore to Factory Settings
AT&F
This command instructs the unit to set all parameters to their defaults as specified by the
manufacturer.
Syntax:
AT&F
3.1.2 AT* List Available Commands
Returns a list of all available AT commands
AT*
Syntax:
AT*
Example:
Input: AT*<br>Output:<br>AT&F<br>AT*<br>AT<br>AT*ANDHCP?<br>AT*ANDHCP=
<br>AT*ANIP?<br>AT*ANIP=<br>AT*ANHN?<br>AT*ANHN=<br>AT*BCP=<br>...
<br>
3.1.3 AT Attention
AT
Attention command determining the presence of a DCE
Syntax:
AT
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 6 (88)
3.2 Network Commands
3.2.1 AT*ANDHCP DHCP Mode
Set/get the DHCP mode. If activated, this will take precedence over settings made with
AT*ANIP. For default value see AT*AMDEFAULT.
AT*ANDHCP=
Set the DHCP mode
Syntax:
AT*ANDHCP=<dhcp_client>,<dhcp_server>,<store>
Input Parameters:
Name Type Description
dhcp_client Integer 0: Off, use static IP address
1: On, acquire an IP address using DHCP
dhcp_server Integer 0: Off, Disable DHCP server
1: ON, Enable DHCP server
2: DHCP Relay, Relay DHCP messages to an external DHCP server.
store Boolean If store is 1 the new value is stored permanently.
Requires a reboot for the changes to take effect.
AT*ANDHCP?
Read the current DHCP setting
Syntax:
AT*ANDHCP?
Example:
AT*ANDHCP?<br>*ANDHCP:<dhcp_client>,<dhcp_server>
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 7 (88)
3.2.2 AT*ANDHCPSTA DHCP Start Address Offset
Set/get the DHCP start address offset. Used when the internal DHCP server is enabled. For
default value see AT*AMDEFAULT.
AT*ANDHCPSTA=
Set the DHCP start address offset.
Syntax:
AT*ANDHCPSTA=<start_address_offset>,<store>
Input Parameters:
Name Type Description
start_address_
offset
Integer Start address of the DHCP IP range. The internal DHCP server IP
range will then be calculated once the DHCP server is enabled by
taking the static assigned IP-address (AT*ANIP) and modifying the
last octet to the inputted start address offset (start_address_offset).
It is impossible to assign the start address offset to values equal to 0
or above 247.
Example:
If the start address offset is set to 201, it will start at 201 and hand
out 7 addresses. If the devices static IP-address is 192.168.0.99,
then the DHCP IP-addresses shall be calculated as follows.
*192.168.0.201
*192.168.0.202
*192.168.0.203
*192.168.0.204
*192.168.0.205
*192.168.0.206
*192.168.0.207
store Boolean If store is 1 the new value is stored permanently.
Requires a reboot for the changes to take effect.
AT*ANDHCPSTA?
Read the DHCP start address offset.
Syntax:
AT*ANDHCPSTA?
Example:
INPUT: AT*ANDHCPSTA? <br>OUTPUT: *ANDHCPSTA:<start_address_offset>
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 8 (88)
3.2.3 AT*ANDHCPTAB DHCP Table
Get the DHCP Table. If the DHCP server is enabled, this command will read out an array of
assigned IP-addresses, the associated Client-ID and the associated lease times (time until the
lease expires, in seconds) for the IP-address, where the first element is the first assigned
address. If the DHCP server is disabled, this command will return ERROR.
AT*ANDHCPTAB?
Read the DHCP Table
Syntax:
AT*ANDHCPTAB?
Example:
Output format: *ANDHCPTAB: <ip>,<client_id>,<lease><br><br>Input:
AT*ANDHCPTAB?<br>Output:<br>*ANDHCPTAB:
192.168.0.201,03001D002B01,600<br>*ANDHCPTAB:
192.168.0.202,030146002D00,600<br>...
3.2.4 AT*ANIP IP Settings
Set/get IP settings for the device
AT*ANIP=
Write IP address and related information. The information set by this command will not be valid
until after the module is restarted.
Syntax:
AT*ANIP=<ip_addr>,<netmask>,<gateway>,<store>
Input Parameters:
Name Type Description
ip_addr NetworkAddress IP address for the device
netmask NetworkAddress Netmask for the device
gateway NetworkAddress The IP address of the gateway
store Boolean If store is 1 the new value is stored permanently.
Requires a reboot for the changes to take effect.
AT*ANIP?
Get the IP settings
Syntax:
AT*ANIP?
Example:
AT*ANIP?<br>*ANIP:<ip_addr>,<netmask>,<gateway>
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 9 (88)
3.2.5 AT*ANHN Hostname
Set/get the hostname used with dynamic DNS
AT*ANHN=
Set hostname
Syntax:
AT*ANHN=<hostname>,<store>
Input Parameters:
Name Type Description
hostname String The hostname to set. Maximum of 128 characters.
store Boolean If store is 1 the new value is stored permanently.
Requires a reboot for the changes to take effect.
AT*ANHN?
Get hostname
Syntax:
AT*ANHN?
Example:
AT*ANHN?<br>*ANHN:<hostname>
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 10 (88)
3.3 Bluetooth Classic Commands
3.3.1 AT*BCP Connect Peer
AT*BCP=
Bluetooth Connect to Peer. The connection will not be retried if unsuccessful.
Syntax:
AT*BCP=<bd_addr>,<name>,<role>
Input Parameters:
Name Type Description
bd_addr MACAddress If specified the MAC address of the remote Bluetooth device must
match this value.
name String If name is specified and S register 2017 is 1 the remote name must
match this value exactly. If S register 2017 is 0 this is a case
sensitive substring of the remote name to connect to, e.g. if
specified to DUT it will try to connect to DUT, DUTx, xDUT and
xDUTx, but not to dut.
role Integer The role of the remote device:
100: PAN User role, PAN Profile
101: Network Access Point role, PAN Profile,
103: PAN, This will first try to connect to PANU, and if it fails,
connect to NAP
All others:Reserved
Example:
Input: AT*BCP=8C8B83EE2ACB,,101 will return the handle of the connection
and OK if the connection succeeds, ERROR otherwise.
3.3.2 AT*BCC Close Connection
AT*BCC=
Bluetooth Close Connection
Syntax:
AT*BCC=<handle>
Input Parameters:
Name Type Description
handle Integer The handle of the connection to close. If set to 0 and there is no
connection with handle 0 any ongoing connection attempts and
retries will be aborted.
Example:
Input: AT*BCC=0 gives OK when the connection with handle 0 is closed.
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 11 (88)
3.3.3 AT*BC Connect
AT*BC
Bluetooth Connect (according to the Connection List).
Syntax:
AT*BC
Example:
Input: AT*BC will return the handle of the connection and OK if the
connection succeeds, ERROR otherwise.
3.3.4 AT*BND Name Discovery
AT*BND=
Bluetooth Name Discovery
Syntax:
AT*BND=<bd_addr>
Input Parameters:
Name Type Description
bd_addr MACAddress MAC address of the Bluetooth device to get the name of.
Example:
Input: AT*BND=8C8B83EE2ACB gives the name of the device and OK if
successful, ERROR otherwise.
3.3.5 AT*BDD Device Discovery
AT*BDD
Perform a Bluetooth Device Discovery i.e. an Inquiry followed by a named lookup for any
device that does not report a name in the inquiry response.
Syntax:
AT*BDD
Example:
Input: AT*BDD returns *BDD:<bd_addr>,<cod>,<device_name_
valid>,<bluetooth_name>,<rssi> for each found device followed by OK or
ERROR.
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 12 (88)
3.3.6 AT*BI Inquiry
AT*BI
Perform a Bluetooth inquiry.
Syntax:
AT*BI
Example:
Input: AT*BI returns *BI:<bd_addr>,<cod>,<device_name_
valid>,<bluetooth_name>,<rssi> for each found device followed by OK or
ERROR.
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 13 (88)
3.3.7 AT*BSP Server Profile
AT*BSP=
Sets the Bluetooth server profile. A reboot is needed for the setting to take effect. Please note
that following values will be affected depending on what role is selected: NAP: AT*BMSP
Master Slave policy will be set to 0, ATS2010 max number of connections will be set to 7,
AT*BCM Connectability mode will be set to 2. PANU: AT*BMSP Master Slave policy will be set
to 1, ATS2010 max number of connections will be set to 1, AT*BCM Connectability mode will be
set to 1. IMPORTANT: As the device is connectable after NAP has been set an appropriate
Security Mode should be configured.
Syntax:
AT*BSP=<server_profile>
Input Parameters:
Name Type Description
server_profile Integer The role of the device:
100: PAN User role, PAN Profile
101: Network Access Point role, PAN Profile.
Requires a reboot for the changes to take effect.
Example:
Input: AT*BSP=101 sets the device to the Network Access Point role.
AT*BSP?
Gets the Bluetooth server profile.
Syntax:
AT*BSP?
Example:
Input: AT*BSP? returns the server profile. See AT*BSP= for values.
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 14 (88)
3.3.8 AT*BFP Fixed PIN
AT*BFP=
Set the fixed pin/passkey used for BT authentication
Syntax:
AT*BFP=<pin>,<store>
Input Parameters:
Name Type Description
pin String The pin/passkey to set. A numerical value 0..999999.
store Boolean If store is 1 the new value is stored permanently.
AT*BFP?
Get the fixed pin/passkey used for BT authentication.
Syntax:
AT*BFP?
3.3.9 AT*BPM Pairing Mode
AT*BPM=
Set the pairing mode for BT
Syntax:
AT*BPM=<pair_mode>,<store>
Input Parameters:
Name Type Description
pair_mode Integer The mode to set. Pairing off = 1, Pairing on = 2.
Note: This also applies to Bluetooth LE.
store Boolean If store is 1 the new value is stored permanently.
AT*BPM?
Get the pairing mode for BT. Pairing off = 1, Pairing on = 2.
Syntax:
AT*BPM?
Example:
Input: AT*BPM?
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 15 (88)
3.3.10 AT*BSM Security Mode
AT*BSM=
Set the security mode to use for BT. For default value see AT*AMDEFAULT.
Syntax:
AT*BSM=<security_mode>,<store>
Input Parameters:
Name Type Description
security_mode Integer The security mode to set.
1 = Security disabled, No encryption or authentication.
2 = Fixed pin, Encrypted connection with PIN code security. This
mode only works between two units of this type and brand (Not with
third-party devices, Use Just works in that case). PIN codes must
consist of 4 to 6 digits.
3 = Just works, Encrypted connection without PIN code.
Note: For Bluetooth LE only 1 = Security Disabled and 3 = Just
Works is supported.
store Boolean If store is 1 the new value is stored permanently.
AT*BSM?
Get the security mode used for BT. See AT*BSM= for values.
Syntax:
AT*BSM?
Example:
Input: AT*BSM?
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 16 (88)
3.3.11 AT*BBM BT Bridge Mode
AT*BBM=
Set the bridge mode for BT. For default value see AT*AMDEFAULT.
Syntax:
AT*BBM=<mode>,<store>
Input Parameters:
Name Type Description
mode Integer The bridge mode to set.
1 = Bridge mode disabled.
2 = IP forward. (Needed if Bluetooth connection to an android device.
You also need an active DCHP server to be able to connect to an
android device.)
store Boolean If store is 1 the new value is stored permanently.
AT*BBM?
Get the bridge mode used for BT. See AT*BBM= for values.
Syntax:
AT*BBM?
Example:
Input: AT*BBM?
3.3.12 AT*BBD Bonded Devices
AT*BBD?
Get the bonded devices. Note: This also applies to Bluetooth LE.
Syntax:
AT*BBD?
Output Parameters:
Name Type Description
bd_addr String Bluetooth address of the bonded device.
is_le_device Boolean 0: BT Classic Device
1: BT LE Device
Example:
AT*BBD?<br>*BBD:<bd_addr1>,<is_le_device1><br>*BBD:<bd_addr2>,<is_le_
device2><br>...<br>OK
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 17 (88)
3.3.13 AT*BUB Unbond
AT*BUB=
Un-bonds a previously bonded device.
Syntax:
AT*BUB=<bd_addr>
Input Parameters:
Name Type Description
bd_addr MACAddress MAC address of the Bluetooth device to un-bond. If address
FFFFFFFFFFFF is selected, all bonded devices will be removed.
Note: Deleting seperate BLE devices is not supported, to delete BLE
device bonds FFFFFFFFFFFF have to be used.
Example:
Input: AT*BUB=8C8B83EE2ACB
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7

AT Commands 18 (88)
3.3.14 AT*BLEM Low Emission Mode
Note: this command is not related to Bluetooth low energy.
AT*BLEM=
Set current Low Emission Mode. For default value see AT*AMDEFAULT.
Syntax:
AT*BLEM=<mode>,<store>
Input Parameters:
Name Type Description
mode Integer The Low Emission mode to set:
0: Connection period: 10 000 ms Paging timeout: 2000 ms Inquiry
timeout: 5000ms
1: Connection period: 5000ms Paging timeout: 300 ms Inquiry
timeout: 600 ms
2: Connection period: 3000ms Paging timeout: 200 ms Inquiry
timeout: 300 ms
3: Connection period: 3000ms Paging timeout: 80 ms Inquiry
timeout: 80 ms
4 - 63: Reserved 64: User specified times, see the ATS General
Settings S Register Manipulation command
store Boolean If store is 1 the new value is stored permanently.
AT*BLEM?
Get the current Low Emission Mode. See AT*BLEM= for values.
Syntax:
AT*BLEM?
Example:
Input: AT*BLEM?
Wireless Bolt™/ Wireless Bridge II™Reference Guide SCM-1202-004 EN 1.7