Anybus Wireless Bolt, Wireless Bridge II User guide

Download

WWiirreelleessss BBoolltt™™// WWiirreelleessss BBrriiddggee IIII

AATT CCoommmmaannddss

REFERENCE GUIDE

SCM-1202-004 1.7 en-US 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 are the property of their respective holders.

is a registered trademark of HMS Industrial Networks AB. All other trademarks mentioned in this document

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

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

3.5 WLAN AP Commands................ .. ..................................... .. ............................................. 33

3.6 WLAN Client (STA) Commands................................ .. ..................................... ................... 36

3.7 Informational Commands ...................................................................... .. ........................ 46

3.8 Miscellaneous Commands ............................................................................ ................... 47

3.9 Bluetooth Low Energy Commands............ ..................................... .. .................................. 57

3.10 Bluetooth Low Energy GATT Client Commands ..................... .. ......................................... .. .. 66

3.11 Unsolicited events.......................... ..................................... .. ......................................... 75

4 S Registers.......................................................................................................................... 77

4.1 ATS S Registers ........................................................ .. ..................................... .. ............. 77

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

This page intentionally left blank

Preface 3 (84)

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

1.0 2016-06-27

1.1 2016-10-01

1.2 2017-03-31

1.3 2017-09-21

1.4 2017-12-21

1.5 2018-02-15

1.6 2018-03-08

1.7 2018-09-03

Date

Description

Beta release

First public release

Updated for Wireless Bridge II

Update for SP2

Update for FW 1.3.9

Updated script examples

Added unsolicited events

Update for FW 1.6.3 Script examples are now available on support web

Wireless Bolt

™

/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

Introduction 4 (84)

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 1.7 en-US

AT Commands 5 (84)

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* Output: AT&F AT* AT AT*ANDHCP? AT*ANDHCP= AT*ANIP? AT*ANIP= AT*ANHN? AT*ANHN= AT*BCP= ...

3.1.3 AT Attention

Attention command determining the presence of a DCE

Syntax:

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 6 (84)

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

dhcp_client

dhcp_server

store

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

0: Off, use static IP address 1: On, acquire an IP address using DHCP

0: Off, Disable DHCP server 1: ON, Enable DHCP server 2: DHCP Relay, Relay DHCP messages to an external DHCP server.

Requires a reboot for the changes to take effect.

AT*ANDHCP?

Read the current DHCP setting

Syntax:

AT*ANDHCP?

Example:

AT*ANDHCP? *ANDHCP:<dhcp_client>,<dhcp_server>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 7 (84)

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

start_address_offset

store

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

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

Requires a reboot for the changes to take effect.

AT*ANDHCPSTA?

Read the DHCP start address offset.

Syntax:

AT*ANDHCPSTA?

Example:

INPUT: AT*ANDHCPSTA? OUTPUT: *ANDHCPSTA:<start_address_offset>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 8 (84)

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> Input: AT*ANDHCPTAB? Output: *ANDHCPTAB:

192.168.0.201,03001D002B01,600 *ANDHCPTAB:

192.168.0.202,030146002D00,600 ...

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

ip_addr NetworkAddress IP address for the device

netmask NetworkAddress Netmask for the device

gateway

store

Requires a reboot for the changes to take effect.

Type Description

NetworkAddress The IP address of the gateway

Boolean If store is 1 the new value is stored permanently.

AT*ANIP?

Get the IP settings

Syntax:

AT*ANIP?

Example:

AT*ANIP? *ANIP:<ip_addr>,<netmask>,<gateway>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 9 (84)

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

hostname

store

Requires a reboot for the changes to take effect.

AT*ANHN?

Get hostname

Type Description

String

Boolean If store is 1 the new value is stored permanently.

The hostname to set. Maximum of 128 characters.

Syntax:

AT*ANHN?

Example:

AT*ANHN? *ANHN:<hostname>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 10 (84)

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

bd_addr MACAddress If specified the MAC address of the remote Bluetooth device must

name

role

Type Description

match this value.

String

Integer

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.

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

handle

Example:

Input: AT*BCC=0 gives OK when the connection with handle 0 is closed.

Type Description

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.

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 11 (84)

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

bd_addr MACAddress MAC address of the Bluetooth device to get the name of.

Type Description

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 1.7 en-US

AT Commands 12 (84)

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.

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

server_profile

Requires a reboot for the changes to take effect.

Type Description

Integer

The role of the device: 100: PAN User role, PAN Profile 101: Network Access Point role, PAN Profile.

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 1.7 en-US

AT Commands 13 (84)

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

pin String

store

AT*BFP?

Get the fixed pin/passkey used for BT authentication.

Syntax:

AT*BFP?

Type Description

The pin/passkey to set. A numerical value 0..999999.

Boolean If store is 1 the new value is stored permanently.

3.3.9 AT*BPM Pairing Mode

AT*BPM=

Set the pairing mode for BT

Syntax:

AT*BPM=<pair_mode>,<store>

Input Parameters:

Name

pair_mode

store

AT*BPM?

Get the pairing mode for BT. Pairing off = 1, Pairing on = 2.

Syntax:

AT*BPM?

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

The mode to set. Pairing off = 1, Pairing on = 2. Note: This also applies to Bluetooth LE.

Example:

Input: AT*BPM?

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 14 (84)

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

security_mode

store

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

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.

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 1.7 en-US

AT Commands 15 (84)

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

mode

store

AT*BBM?

Get the bridge mode used for BT. See AT*BBM= for values.

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

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

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

bd_addr

is_le_device Boolean 0: BT Classic Device

Type Description

String

Bluetooth address of the bonded device.

1: BT LE Device

Example:

AT*BBD? *BBD:<bd_addr1>,<is_le_device1> *BBD:<bd_addr2>,<is_ le_device2> ... OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 16 (84)

3.3.13 AT*BUB Unbond

AT*BUB=

Un-bonds a previously bonded device.

Syntax:

AT*BUB=<bd_addr>

Input Parameters:

Name

bd_addr MACAddress MAC address of the Bluetooth device to un-bond. If address

Example:

Input: AT*BUB=8C8B83EE2ACB

Type Description

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.

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

mode

store

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

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

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 1.7 en-US

AT Commands 17 (84)

3.3.15 AT*BDM GAP Discoverability Mode

AT*BDM=

Set current GAP discoverability mode. For default value see AT*AMDEFAULT.

Syntax:

AT*BDM=<gap_mode>,<store>

Input Parameters:

Name

gap_mode

store

AT*BDM?

Get the current GAP discoverability mode. See AT*BDM= for values.

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

The GAP discoverability mode to set: 1: GAP non-discoverable mode 2: GAP limited discoverable mode 3: GAP general discoverable mode

Syntax:

AT*BDM?

Example:

AT*BDM? *BDM:<gap_mode>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 18 (84)

3.3.16 AT*BCM GAP Connectability Mode

AT*BCM=

Set current GAP connectability mode. For default value see AT*AMDEFAULT.

Syntax:

AT*BCM=<gap_mode>,<store>

Input Parameters:

Name

gap_mode

store

AT*BCM?

Get the current GAP connectability mode. See AT*BCM= for values.

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

The GAP connectability mode to set: 1: GAP non-connectable mode 2: GAP connectable mode

Syntax:

AT*BCM?

Example:

AT*BCM? *BCM:<gap_mode>

3.3.17 AT*BCA Connection Accept

Used when external connection control is enabled (see ATS2012)

AT*BCA=

Accept or reject a connection attempt. This must be sent to answer the *BCI Connect Indication.

Syntax:

AT*BCA=<handle>,<accept>

Input Parameters:

Name

handle

Type Description

Integer

Boolean Set to 1 to accept the connection, 0 to reject it.

The handle of the connection, received in the *BCI Connect Indication.

Wireless Bolt

™

/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 19 (84)

3.3.18 AT*BLN Local Name

AT*BLN=

Set the unit's Bluetooth name. A reboot is needed for the setting to take effect.

Syntax:

AT*BLN=<name>

Input Parameters:

Name

name

AT*BLN?

Get the unit's Bluetooth name.

Syntax:

AT*BLN?

Type Description

String

The Bluetooth name to use. The maximum length is 31 characters.

Example:

AT*BLN? *BLN:<name>

3.3.19 AT*BRSS Read RSSI

AT*BRSS=

Get the RSSI for a connection.

Syntax:

AT*BRSS=<handle>

Input Parameters:

Name

handle

Example:

AT*BRSS=<handle> *BRSS:<rssi>

Type Description

Integer

The handle of the connection to get the RSSI for.

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 20 (84)

3.3.20 AT*BLQ Read Link Quality

AT*BLQ=

Get the link quality for a connection. Link Quality is a value between 0 and 255 and it only applies to Bluetooth connections.

Syntax:

AT*BLQ=<handle>

Input Parameters:

Name

handle

Type Description

Integer

The handle of the connection to get the link quality for.

Example:

AT*BLQ=<handle> *BLQ:<link_quality>

3.3.21 AT*BLP Limited Pairing

AT*BLP=

Enables or disables limited pairing, only valid for current power cycle. If the device should be pairable after power cycle, see S register 2007. Note: This also applies to Bluetooth LE.

Syntax:

AT*BLP=<enable>,<time_limit>

Input Parameters:

Name

enable Boolean 0: Disable pairing

time_limit

Type Description

1: Enable. Pairing will be limited.

Integer

The time (in seconds) the unit will be pairable. Valid time is 0 to 300 seconds. Values less than 0 will be treated as 0.

Wireless Bolt

™

/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 21 (84)

3.3.22 AT*BCHM Channel Map

AT*BCHM=

Write the Bluetooth channel map. Note that at least 20 channels must be enabled. For default value see AT*AMDEFAULT.

Syntax:

AT*BCHM= <ch0to15>,<ch16to31>,<ch32to47>,<ch48to63>,<ch64to78>,<store>

Input Parameters:

Name

ch0to15

ch16to31

ch32to47

ch48to63

ch64to78

store

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

Bit mask used to enable or disable channels 0 to 15 (Bit 0 = Channel 0).

Bit mask used to enable or disable channels 16 to 31. (Bit 0 = Channel

16)

Bit mask used to enable or disable channels 32 to 47 (Bit 0 - Channel

32).

Bit mask used to enable or disable channels 48 to 63 (Bit 0 = Channel

48).

Bit mask used to enable or disable channels 64 to 78 (Bit 0 = Channel

64).

AT*BCHM?

Read the Bluetooth channel map.

Syntax:

AT*BCHM?

Example:

AT*BCHM? *BCHM: <ch0to15>,<ch16to31>,<ch32to47>,<ch48to63>,<ch64to78>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 22 (84)

3.3.23 AT*BPP Packet policy

AT*BPP=

Set the Bluetooth packet policy. This policy is used for subsequent connections. Any ongoing connections are not affected. For default value see AT*AMDEFAULT.

Syntax:

AT*BPP=<policy>,<store>

Input Parameters:

Name

policy

store

AT*BPP?

Get the Bluetooth packet policy.

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

0: Long Range (only DM1 packets). 1: Short Latency, basic rates (all DM packets). 2: High Throughput, basic rates (DM + DH packets). 3: As 2 but with 2-EDR enabled. 4:As 3 but with 3-EDR enabled

Syntax:

AT*BPP?

Example:

AT*BPP? *BPP:<policy>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 23 (84)

3.3.24 AT*BMSP Master Slave policy

AT*BMSP=

Set the Bluetooth Master Slave Role Policy. For default value see AT*AMDEFAULT.

Syntax:

AT*BMSP=<policy>,<store>

Input Parameters:

Name

policy

store

AT*BMSP?

Get the Bluetooth Master Slave Role Policy.

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

0: Always attempt to become master on incoming connections. Should be used for a unit configured as NAP.

1: Always let the connecting device select master/slave role on incoming connections.

Syntax:

AT*BMSP?

Example:

AT*BMSP? *BMSP:<policy>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 24 (84)

3.3.25 AT*BLCOD Local class of device.

AT*BLCOD=

Set the Bluetooth Local Class Of Device code. For default value see AT*AMDEFAULT.

Syntax:

AT*BLCOD=<cod>,<store>

Input Parameters:

Name

cod

store

AT*BLCOD?

Get the Bluetooth Local Class Of Device code.

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

Valid values for this parameter are specified in the Bluetooth Assigned Numbers Document, www.bluetooth.com. The parameter has been divided into three segments, a service class segment, a major device class segment and a minor device class segment (bits 2-7).

Syntax:

AT*BLCOD?

Example:

AT*BLCOD? *BLCOD:<cod>

3.3.26 AT*BRCD Read Connected Devices.

AT*BRCD?

Retrieves the MAC address and handle of every connected Bluetooth device.

Syntax:

AT*BRCD?

Example:

AT*BRCD? returns *BRCD:<bd_addr>,<handle> for each connected device followed by OK or ERROR.

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 25 (84)

3.3.27 AT*BCLC Clear the Connection list

AT*BCLC=

Clears all the entries in the Connection list.

Syntax:

AT*BCLC=<store>

Input Parameters:

Name

store

Type Description

Boolean If store is 1 the new value is stored permanently.

Example:

AT*BCLC=1

3.3.28 AT*BCLR Read the Connection list

AT*BCLR=

Reads an entry in the Connection list.

Syntax:

AT*BCLR=<index>

Input Parameters:

Name

index

Type Description

Integer

The index of the entry to read.

Example:

AT*BCLR=2 *BCLR:<2>,<bd_addr>,<name>,<role>

AT*BCLR?

Reads the list of Connections that the unit can use.

Syntax:

AT*BCLR?

Example:

AT*BCLR? returns *BCLR:<index>,<bd_addr>,<name>,<role> for each entry in the list followed by OK.

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 26 (84)

3.3.29 AT*BCLW Write an entry in the Connection list

AT*BCLW=

Writes an entry in the Connection list. NOTE: If store is set to 1 all entries in the connection list will be stored.

Syntax:

AT*BCLW=<index>,<bd_addr>,<name>,<role>,<store>

Input Parameters:

Name

index

bd_addr MACAddress If specified the MAC address of the remote Bluetooth device must

name

role

store

Type Description

Integer

String

Integer

Boolean If store is 1 the new value is stored permanently.

The index of the entry to write.

match this value.

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:

AT*BCLW=0,00026F668FA8,dut1,101,1 OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 27 (84)

3.3.30 AT*BPPCM Set PANU PANU Connection Mode.

AT*BPPCM=

Set the PANU PANU Connection Mode used in easy config. For default value see AT*AMDEFAULT.

Syntax:

AT*BPPCM=<connection_mode>,<store>

Input Parameters:

Name

connection_mode

store

AT*BPPCM?

Reads the PANU PANU Connection Mode.

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

The connection mode of PANU-PANU: 1: MAC only 2: NAME only 3: Both MAC and NAME

Syntax:

AT*BPPCM?

Example:

AT*BPPCM? *BPCCM:<mode>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 28 (84)

3.4 WLAN Commands

3.4.1 AT*WMODE WLAN Mode

AT*WMODE=

Set WLAN mode, Station or AP.

Syntax:

AT*WMODE=<mode>

Input Parameters:

Name

mode

Requires a reboot for the changes to take effect.

Example:

Input: AT*WMODE=1 sets WLAN mode to AP.

Type Description

Integer

The mode to set, Station (0) or AP (1).

AT*WMODE?

Get WLAN mode, Station (0) or AP (1)

Syntax:

AT*WMODE?

Example:

AT*WMODE? *WMODE:<mode>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 29 (84)

3.4.2 AT*WKEY Encryption/Authentication Key

AT*WKEY=

Write encryption/authentication key at index 1. This command is a shortcut for AT*WKEYI=1,

Syntax:

AT*WKEY=<key>,<store>

Input Parameters:

Name

key

store

Example:

Input: AT*WKEY=Sesame,1

AT*WKEY?

Read encryption/authentication key

Type Description

String

Boolean If store is 1 the new value is stored permanently.

The key to use. Max 63 characters.

Syntax:

AT*WKEY?

Example:

Input: AT*WKEY? returns the encryption/authentication key at index 1.

3.4.3 AT*WKEYI Write Encryption/Authentication Key (with Index)

AT*WKEYI=

Write encryption/authentication key at any index.

Syntax:

AT*WKEYI=<index>,<pKey>,<store>

Input Parameters:

Name

index

pKey String

store

Type Description

Integer 1...4

The key to use. Max 63 characters.

Boolean If store is 1 the new value is stored permanently.

Example:

Input: AT*WKEYI=2,Sesame,1.

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 30 (84)

3.4.4 AT*WACTKEY Active Encryption/Authentication Key

AT*WACTKEY=

Set the index of the active Encryption/Authentication Key

Syntax:

AT*WACTKEY=<index>,<store>

Input Parameters:

Name

index

store

AT*WACTKEY?

Get the index of the active Encryption/Authentication Key, 1..4.

Syntax:

AT*WACTKEY?

Type Description

Integer 1..4

Boolean If store is 1 the new value is stored permanently.

Example:

Input: AT*WACTKEY?

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 31 (84)

3.4.5 AT*WMIMO WLAN MIMO

AT*WMIMO=

Configures which antennas should be enabled 1: Enable only primary antenna 2: Enable both antennas NOTE: This value is ignored on devices with only one antenna.

Syntax:

AT*WMIMO=<mode>

Input Parameters:

Name

mode

Requires a reboot for the changes to take effect.

Example:

Input: AT*WMIMO=2 enable WLAN MIMO.

Type Description

Integer

Configures which antennas should be enabled.

AT*WMIMO?

Get WLAN MIMO, MIMO off (1) or MIMO on (2)

Syntax:

AT*WMIMO?

Example:

AT*WMIMO? *WMIMO:<mode>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 32 (84)

3.4.6 AT*WWM WLAN World Mode

When WLAN World Mode is enabled only frequencies accepted all over the world is used. When disabled local frequencies can be used but then the device must search for location during startup which will increase the startup time. New channels must be added manually with AT*WSCHL.

AT*WWM=

Configures WLAN World Mode 0: Disable WLAN World Mode 1: Enable WLAN World Mode NOTE: When WLAN World Mode is disabled the startup time will increase.

Syntax:

AT*WWM=<wlan_world_mode>

Input Parameters:

Name

wlan_world_mode

Requires a reboot for the changes to take effect.

Type Description

Integer

Enable/disable WLAN World Mode.

Example:

Input: AT*WWM=0 disable WLAN World Mode.

AT*WWM?

Get WLAN World Mode, World Mode off (0) or World Mode on (1)

Syntax:

AT*WWM?

Example:

AT*WWM? *WWM:<mode>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 33 (84)

3.5 WLAN AP Commands

3.5.1 AT*WASSID Access Point SSID

AT*WASSID=

Sets the SSID for AP mode.

Syntax:

AT*WASSID=<ssid>

Input Parameters:

Name

ssid

Requires a reboot for the changes to take effect.

AT*WASSID?

Gets the SSID for AP mode.

Type Description

String

The SSID to set. Max 32 characters.

Syntax:

AT*WASSID?

Example:

AT*WASSID? *WASSID:<ssid>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 34 (84)

3.5.2 AT*WACH Access Point Channel

AT*WACH=

Sets the channel for AP mode.

Syntax:

AT*WACH=<channel>

Input Parameters:

Name

channel

Requires a reboot for the changes to take effect.

AT*WACH?

Gets the channel for AP mode.

Type Description

Integer

The channel to use. Valid channels are 1-11 for 2.4 GHz and 36, 40, 44, 48 for 5 GHz.

Syntax:

AT*WACH?

Example:

AT*WACH? *WACH:<channel>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 35 (84)

3.5.3 AT*WAAM Authentication Mode for AP

AT*WAAM=

Set the AP Authentication Mode. For default value see AT*AMDEFAULT.

Syntax:

AT*WAAM=<mode>

Input Parameters:

Name

mode

Requires a reboot for the changes to take effect.

AT*WAAM?

Get the AP Authentication Mode.

Type Description

Integer

Authentication Mode: 0 = Open, 2 = WPA/WPA2 PSK

Syntax:

AT*WAAM?

Example:

Input: AT*WAAM?

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 36 (84)

3.6 WLAN Client (STA) Commands

3.6.1 AT*WSMAC WLAN MAC address

Can be used to clone a MAC address from an Ethernet device. This will allow layer 2 data to be bridged by one device. Can be combined with IP forwarding.

AT*WSMAC=

Set the WLAN MAC address. If set to all 0 or all FF the unit's default address will be used.

Syntax:

AT*WSMAC=<mac>

Input Parameters:

Name

mac

Requires a reboot for the changes to take effect.

Type Description

MACAddress The MAC address to set.

AT*WSMAC?

Get the MAC address.

Syntax:

AT*WSMAC?

Example:

AT*WSMAC? *WSMAC:<mac>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 37 (84)

3.6.2 AT*WSBM WLAN Bridge Mode

AT*WSBM=

Set the WLAN Bridge Mode. In layer 2 tunnel mode all layer 2 data will be bridged over WLAN. Please note that this option uses a custom protocol and can only be used when the AP and the remote device are of the same type Layer 2 cloned MAC only mode is used in combination with AT*WSMAC. In this mode only data from the cloned MAC will be bridged over WLAN. When using MAC clone two devices will use the same MAC - hence there is no way for a DHCP server to distinguish them from one another and both devices will receive the same IP address. In layer 3 IP forward mode IP data from all data will be bridged over WLAN. Please note that this mode can be combined with AT*WSMAC to enable layer 2 data for one device. For default value see AT*AMDEFAULT.

Syntax:

AT*WSBM=<mode>

Input Parameters:

Name

mode

Type Description

Integer

The Bridge Mode to set. 0: Layer 2 tunnel 1: Layer 2 cloned MAC only 2: Layer 3 IP forward

Requires a reboot for the changes to take effect.

AT*WSBM?

Get the Bridge Mode.

Syntax:

AT*WSBM?

Example:

AT*WSBM? *WSBM:<mode>

3.6.3 AT*WSC Connect

AT*WSC

Connect to Access Points as specified in the Connection List.

Syntax:

AT*WSC

Example:

Input: AT*WSC returns OK if the connection succeeds, ERROR otherwise.

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 38 (84)

3.6.4 AT*WSCC Close Connection

AT*WSCC

Close WLAN connection in Station mode. If there is no connection but a connect as specified by the Connection List is in progress this is terminated.

Syntax:

AT*WSCC

Example:

Input: AT*WSCC, returns OK when the connection is closed.

3.6.5 AT*WSCP Connect Peer

AT*WSCP=

Connect to a WLAN AP.

Syntax:

AT*WSCP=<bssid>,<ssid>,<channel>

Input Parameters:

Name

bssid MACAddress If specified the AP BSSID must match this value, if left blank the BSSID

ssid

channel

Type Description

is ignored.

String

Integer

The SSID of the AP to connect to. If not specified the AP BSSID must be specified for a connection to be possible.

The channel to use. 0 for any channel in the channel map.

Example:

Input: AT*WSCP=8C8B83EE2ACB,dut,0 will return OK if the connection succeeds, ERROR otherwise.

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 39 (84)

3.6.6 AT*WSSCAN Scan

AT*WSSCAN=

Scan the surroundings for access points with a specific Network Name (SSID) on a specified channel.

Syntax:

AT*WSSCAN=<pssid>,<channel>

Input Parameters:

Name

pssid

channel

Example:

Input: AT*WSSCAN=dutAP,1 will return 0...48 access points in the immediate surroundings, then return OK.

Type Description

String

Integer

The SSID to scan for. Max 32 characters.

The channel to scan for

AT*WSSCAN?

Scan the surroundings for access points. Will return 0...48 access points in the immediate surroundings, then return OK.

Syntax:

AT*WSSCAN?

Example:

Input: AT*WSSCAN? *WSSCAN: [bssid],[ssid],[channel],[rssi],[authentication_suit],[unicast_ ciphers],[group_cipher]

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 40 (84)

3.6.7 AT*WSAM Authentication Mode for Station

AT*WSAM=

Set the Station Authentication Mode. For default value see AT*AMDEFAULT.

Syntax:

AT*WSAM=<mode>,<store>

Input Parameters:

Name

mode

store

AT*WSAM?

Get the Station Authentication Mode.

Syntax:

AT*WSAM?

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

Authentication Mode: 0 = Open, 1 = WEP64/128 (shared secret), 2 = WPA/WPA2 PSK, 3 = LEAP, 4 = PEAP

Example:

Input: AT*WSAM?

3.6.8 AT*WSRSS Read RSSI

AT*WSRSS?

Read RSSI value of the connection.

Syntax:

AT*WSRSS?

Example:

Input: AT*WSRSS? returns ERROR if there currently is no Station mode connection.

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 41 (84)

3.6.9 AT*WSLNK Read Link Status

AT*WSLNK?

Read current WLAN link status.

Syntax:

AT*WSLNK?

Example:

AT*WSLNK? *WSLNK:<link_status>,<bssid>

3.6.10 AT*WSUSER User name for WLAN LEAP/PEAP authentication.

AT*WSUSER=

Set the user name.

Syntax:

AT*WSUSER=<user_name>,<store>

Input Parameters:

Name

user_name

store

Type Description

String

Boolean If store is 1 the new value is stored permanently.

The user name to set (max 63 characters)

Example:

Input: AT*WSUSER=Joe,1

AT*WSUSER?

Get the user name.

Syntax:

AT*WSUSER?

Example:

Input: AT*WSUSER?

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 42 (84)

3.6.11 AT*WSDOMAIN Domain for WLAN LEAP/PEAP authentication.

AT*WSDOMAIN=

Set the domain.

Syntax:

AT*WSDOMAIN=<domain>,<store>

Input Parameters:

Name

domain

store

Example:

Input: AT*WSDOMAIN=Cool,1

AT*WSDOMAIN?

Get the domain.

Type Description

String

Boolean If store is 1 the new value is stored permanently.

The domain to set. Max 63 characters.

Syntax:

AT*WSDOMAIN?

Example:

Input: AT*WSDOMAIN?

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 43 (84)

3.6.12 AT*WSPASS Pass phrase for WLAN LEAP/PEAP authentication.

AT*WSPASS=

Set the pass phrase.

Syntax:

AT*WSPASS=<pass_phrase>,<store>

Input Parameters:

Name

pass_phrase

store

Example:

Input: AT*WSPASS=Secret,1

AT*WSPASS?

Get the pass phrase.

Type Description

String

Boolean If store is 1 the new value is stored permanently.

The pass phrase to set. Max 63 characters.

Syntax:

AT*WSPASS?

Example:

Input: AT*WSPASS?

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 44 (84)

3.6.13 AT*WSCHL Channel list

AT*WSCHL=

Sets the Channel list for Station mode.

Syntax:

AT*WSCHL=<channel_list_str>,<store>

Input Parameters:

Name

channel_list_str

store

Example:

AT*WSCHL=<channel0>,<channel1>,<channel2>...,1

Type Description

String

Boolean If store is 1 the new value is stored permanently.

A comma separated string of channels to use. Valid channels are 1-11 for 2.4 GHz and 36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 132, 136, 140 for 5 GHz. If world mode is disabled and configured as WLAN client also channels 12, 13, 120, 124, 128 are possible.

AT*WSCHL?

Gets the Channel list for Station mode.

Syntax:

AT*WSCHL?

Example:

AT*WSCHL? *WSCHL:<channel0>,<channel1>,<channel2>...

3.6.14 AT*WSCLC Clear the Connection list

AT*WSCLC=

Clears all the entries in the Connection list.

Syntax:

AT*WSCLC=<store>

Input Parameters:

Name

store

Type Description

Boolean If store is 1 the new value is stored permanently.

Example:

AT*WSCLC=1

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 45 (84)

3.6.15 AT*WSCLR Read the Connection list

AT*WSCLR=

Reads an entry in the Connection list.

Syntax:

AT*WSCLR=<index>

Input Parameters:

Name

index

Example:

AT*WSCLR=2 *WSCLR:<2>,<bssid>,<ssid><channel>

AT*WSCLR?

Reads the list of Connections (Access Points) that the unit can use.

Type Description

Integer

The index (0..49) of the entry to read.

Syntax:

AT*WSCLR?

Example:

AT*WSCLR? returns *WSCLR:<index>,<bssid>,<ssid>,<channel> for each entry in the list followed by OK.

3.6.16 AT*WSCLW Write an entry (AP) in the Connection list

AT*WSCLW=

Writes an entry in the Connection list. NOTE: If store is set to 1 all entries in the connection list will be stored.

Syntax:

AT*WSCLW=<index>,<bssid>,<ssid>,<channel>,<store>

Input Parameters:

Name

index

bssid MACAddress The BSSID of the AP.

ssid

channel

store

Type Description

Integer

String

Integer

Boolean If store is 1 the new value is stored permanently.

The index (0..49) of the AP to write.

The SSID of the AP. Max 32 characters.

The channel of the AP.

Example:

AT*WSCLW=0,00026F668FA8,dutAP1,11,1 AT*WSCLW= 1,00026F668FA8,dutAP2,6,1

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 46 (84)

3.7 Informational Commands

3.7.1 AT*AILVI Local Version Info

AT*AILVI?

Reads the local version info for the product

Syntax:

AT*AILVI?

Example:

AT*AILVI? *AILVI:<vendor>,<fw_version>

3.7.2 AT*AILVIE Local Version Info Extended

AT*AILVIE?

Reads the extended local version info for the product

Syntax:

AT*AILVIE?

Example:

AT*AILVIE? *AILVIE: Network Type: 0x4544 *AILVIE: Module Type: 0x0056 *AILVIE: Pre-Boot Version: "2.0.10" *AILVIE: Bootloader Version: "2.0.10" *AILVIE: Software Version: "1.2.2FS2.0.0" *AILVIE: Software Description: "Name of product 1.2.2-RCFS2.0.0"

3.7.3 AT*AIMAC Read MAC

AT*AIMAC=

Reads the the MAC for the specified interface

Syntax:

AT*AIMAC=<interface>

Input Parameters:

Name

interface

Type Description

Integer

The MAC to get. 0: Ethernet 1: WLAN 2: Bluetooth

Example:

AT*AIMAC=<interface> *AIMAC:<mac>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 47 (84)

3.8 Miscellaneous Commands

3.8.1 AT*AMLI Login

AT*AMLI=

Syntax:

AT*AMLI=<password>

Input Parameters:

Name

password

Example:

AT*AMLI=<password>

AT*AMLI?

Returns 1 if logged in

Type Description

String

The password set using AT*AMPW

Syntax:

AT*AMLI?

Example:

AT*AMLI?

3.8.2 AT*AMLO Logout

AT*AMLO

Log out from the AT command interface

Syntax:

AT*AMLO

Example:

AT*AMLO

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 48 (84)

3.8.3 AT*AMPW Password

AT*AMPW=

Set password to the AT command interface

Syntax:

AT*AMPW=<password>,<store>

Input Parameters:

Name

password

store

Type Description

String

Boolean If store is 1 the new value is stored permanently.

Max length is 16 characters

3.8.4 AT*AMSTAT System status

Get the system status.

AT*AMSTAT=

Get the system status.

Syntax:

AT*AMSTAT=<verbose>

Input Parameters:

Name

verbose Boolean 0: Terse, 1: Verbose.

Type Description

Example:

AT*AMSTAT=0 *AMSTAT: Uptime:25 *AMSTAT: WLAN Mode:Station, MAC:02:01:2E:00:24:00, state:3 *AMSTAT: Connected to AP:02:01:2E:00:28:00, channel:1, rssi:-35 *AMSTAT: Bluetooth: MAC:8C:8B:83:EE:2A:E6, State:1 *AMSTAT: Local name: dut *AMSTAT: Ethernet: MAC:02:00:2E:00:24:00, State:1, Type:1 *AMSTAT: IP_ADDR:192.168.0.99 OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 49 (84)

3.8.5 AT*AMESS Event and Status Subscriber

AT*AMESS=

Set event and status subscriber configuration

Syntax:

AT*AMESS=<mac_addr>,<eth_type>,<ip_addr>,<udp_ port>,<protocol>,<store>

Input Parameters:

Name

mac_addr

eth_type

ip_addr

udp_port

protocol

store

Type Description

String

Integer

String

Integer

Boolean If store is 1 the new value is stored permanently.

MAC address of event subscriber. Only used when protocol bit 1 is set

The 16 bit Ethernet type to use. Only used when protocol bit 1 is set

IP address of event subscriber. Only used when protocol bit 2 is set

The UDP port to use. Only used when protocol bit 2 is set

The protocol to use for sending events. Bit 0: Send events over TCP AT connections Bit 1: Send events over Layer-2 (mac_address must be specified) Bit 2: Send events over Syslog

AT*AMESS?

Read current event subscriber settings

Syntax:

AT*AMESS?

Example:

AT*AMESS? *AMESS:

3.8.6 AT*AMEECM Execute Easy Configuration Mode

Executes the specified Easy Configuration Mode

AT*AMEECM=

Executes the supplied Easy Configuration Mode.

Syntax:

AT*AMEECM=<mode>

Input Parameters:

Name

mode

Type Description

Integer

The mode number to execute.

Example:

AT*AMEECM=3 OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 50 (84)

3.8.7 AT*AMECFL Read/Write Easy Configuration Modes Function List

Reads/Writes the list of supported Easy Configuration Modes

AT*AMECFL=

Sets the list of supported Easy Configuration Modes. For default value see AT*AMDEFAULT.

Syntax:

AT*AMECFL=<easy_config_modes>,<store>

Input Parameters:

Name

easy_config_modes

store

Example:

AT*AMECFL=1,2,3,4,5,6,1 OK

Type Description

String

Boolean If store is 1 the new value is stored permanently.

Comma-separated string of up to 15 modes and their order to be supported. Valid modes are 1 to 15. Using mode=0 (INVALID MODE) will terminate the list at the given position.

AT*AMECFL?

Get the list of supported Easy Configuration Modes.

Syntax:

AT*AMECFL?

Example:

Input: AT*AMECFL?

3.8.8 AT*AMTFTP TFTP Upgrade

AT*AMTFTP=

Trigger a firmware update via TFTP. Device will automatically be rebooted into bootloader mode.

Syntax:

AT*AMTFTP=<device_ip>,<server_ip>,<filename>

Input Parameters:

Name

device_ip NetworkAddress The IP that the device shall use during the upgrade procedure

server_ip

filename

Type Description

NetworkAddress TFTP server IP address

String

Firmware filename (.fwz)

Wireless Bolt

™

/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 51 (84)

3.8.9 AT*AMPID Product ID

AT*AMPID?

Get product ID

Syntax:

AT*AMPID?

Example:

AT*AMPID? *AMPID:<vendor_id>-<platform_id>-<variant_id>

3.8.10 AT*AMSI Supported Interfaces

AT*AMSI?

Get the supported interfaces

Syntax:

AT*AMSI?

Example:

AT*AMSI? *AMSI:Ethernet *AMSI:WLAN (2.4 GHz) *AMSI:WLAN (5.0 GHz) *AMSI:WLAN (MIMO)

3.8.11 AT*AMSBC Supported Bluetooth Configuration

AT*AMSBC?

Get the supported Bluetooth configuration

Syntax:

AT*AMSBC?

Example:

AT*AMSBC? *AMSBC:<nap>,<panu>,<max_connections_classic>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 52 (84)

3.8.12 AT*AMGD General Data

General data storage for custom data

AT*AMGD=

Write general data.

Syntax:

AT*AMGD=<general_data>,<store>

Input Parameters:

Name

general_data

store

Example:

Input: AT*AMGD=1,1,1,1 gives OK when...

AT*AMGD?

Read previously written data.

Type Description

String

Boolean If store is 1 the new value is stored permanently.

A custom string to store. Max length is 32 characters.

Syntax:

AT*AMGD?

Example:

AT*AMGD? *AMGD:<data>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 53 (84)

3.8.13 AT*AMTL TCP Listener

Configures the AT over TCP server

AT*AMTL=

Set TCP listener settings

Syntax:

AT*AMTL=<port>,<enable>,<store>

Input Parameters:

Name

port

enable Boolean 0: Disables TCP Listener

store

Requires a reboot for the changes to take effect.

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

TCP port to listen for incoming connections

1: Enables TCP Listener

AT*AMTL?

Get TCP listener settings

Syntax:

AT*AMTL?

Example:

AT*AMTL? *AMTL:<port>,<enabled>

3.8.14 AT*AMBD Bridging Disable

AT*AMBD=

Set bridging enable/disable

Syntax:

AT*AMBD=<disable>,<store>

Input Parameters:

Name

disable Boolean 0: Bridging Enabled

store

Type Description

Boolean If store is 1 the new value is stored permanently.

1: Bridging Disabled

Wireless Bolt

™

/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 54 (84)

3.8.15 AT*AMLCR Layer 2 Configuration Receiver

Configure AT over layer 2 (Ethernet)

AT*AMLCR=

Set AT over layer 2 configuration

Syntax:

AT*AMLCR=<eth_type>,<enable>,<store>

Input Parameters:

Name

eth_type

enable Boolean 0: Disable AT over Ethernet

store

Requires a reboot for the changes to take effect.

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

16 bit Ethernet type that should be used for AT commands

1: Enable AT over Ethernet

AT*AMLCR?

Get AT over layer 2 configuration

Syntax:

AT*AMLCR?

Example:

AT*AMLCR? *AMLCR:<eth_type>,<enabled>

3.8.16 AT*AMREBOOT Reboot

AT*AMREBOOT

Reboot device

Syntax:

AT*AMREBOOT

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 55 (84)

3.8.17 AT*AMPSM PROFIsafe Mode

Enable PROFIsafe Mode, in PROFIsafe mode it's only possible to read configuration. To write configuration again, it's necessary to reset to factory defaults with the physical button.

AT*AMPSM=

Enable/Disable PROFIsafe mode.

Syntax:

AT*AMPSM=<profisafe_mode>,<apply_now>,<store>

Input Parameters:

Name

profisafe_mode

apply_now Boolean 0: Apply changes after reboot.

store

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

Set state of PROFIsafe mode. 0: Disable. 1: Enable.

1: Apply changes immediately.

Example:

Input: AT*AMPSM=1,1,1 Output: *AMPSM:OK

AT*AMPSM?

Read state of PROFIsafe mode.

Syntax:

AT*AMPSM?

Example:

Input: AT*AMPSM? Output: *AMPSM:<profisafe_mode>

3.8.18 AT*AMIC Interface configuration

AT*AMIC?

Command to read back interface configuration bit mask

Syntax:

AT*AMIC?

Example:

AT*AMIC? *AMIC:<iface_config>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 56 (84)

3.8.19 AT*AMSERIAL Serial Number

AT*AMSERIAL?

Command to read back serial number

Syntax:

AT*AMSERIAL?

Example:

AT*AMSERIAL? *AMSERIAL:<serial>

3.8.20 AT*AMDEFAULT Read DEFAULT

AT*AMDEFAULT?

Get the DEFAULT VALUES.

Syntax:

AT*AMDEFAULT?

Example:

Input: AT*AMDEFAULT?

3.8.21 AT*AMLOG Read event log

AT*AMLOG=

Command to clear current event log.

Syntax:

AT*AMLOG=<clear>

Input Parameters:

Name

clear Boolean Set this to 1 to clear the event log.

AT*AMLOG?

Read the event log.

Type Description

Syntax:

AT*AMLOG?

Example:

Input: AT*AMLOG?

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 57 (84)

3.9 Bluetooth Low Energy Commands

3.9.1 AT*BLEAD Get/Set the advertise data

AT*BLEAD=

Set the data to be advertised by this device.

Syntax:

AT*BLEAD=<data>,<store>

Input Parameters:

Name

data

store

Example:

AT*BLEAD=0102000305FF,1 OK

Type Description

String

Boolean If store is 1 the new value is stored permanently.

The new data to be advertised as a HEX string with max 28 bytes.

AT*BLEAD?

Get the data currently being advertised by this device.

Syntax:

AT*BLEAD?

Example:

AT*BLEAD? *BLEAD:<data>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 58 (84)

3.9.2 AT*BLESRD Get/Set the scan response data

AT*BLESRD=

Set the data to be responded by this device.

Syntax:

AT*BLESRD=<data>,<store>

Input Parameters:

Name

data

store

Example:

AT*BLESRD=0102000305FF,1 OK

AT*BLESRD?

Get the data currently being responded by this device.

Type Description

String

Boolean If store is 1 the new value is stored permanently.

The new data to be responded as a HEX string with max 31 bytes.

Syntax:

AT*BLESRD?

Example:

AT*BLESRD? *BLESRD:<data> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 59 (84)

3.9.3 AT*BLEOM Get/Set the BLE operating mode

AT*BLEOM=

Set the BLE operating mode.

Syntax:

AT*BLEOM=<mode>,<store>

Input Parameters:

Name

mode

store

Requires a reboot for the changes to take effect.

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

The BLE operating mode: 0: BLE off. 1: Central operating mode.

Example:

AT*BLEOM=1,1 OK

AT*BLEOM?

Get the current BLE operating mode.

Syntax:

AT*BLEOM?

Example:

AT*BLEOM? *BLEOM:<mode> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 60 (84)

3.9.4 AT*BLEND BLE name discovery

AT*BLEND=

Discover the name of a Bluetooth device.

Syntax:

AT*BLEND=<bd_addr>

Input Parameters:

Name

bd_addr

Output Parameters:

Name

devicename

Type Description

String

Type Description

String

Bluetooth address of the device, on the format "XX-XX-XX-XX-XX-XXy" where "y" is "p" or "r" depending on if the address is private or random.

Devicename of found BLE device. The value is limited to a maximum of 19 bytes.

Example:

AT*BLEND=<bd_addr> *BLEND:<devicename> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 61 (84)

3.9.5 AT*BLERM Enter/Exit RAW BLE mode

AT*BLERM=

Enter/Exit RAW BLE mode. Note that this only affects the current AT session. When the AT session is in RAW BLE mode, it will receive unsolicited BLE events. The following AT sessions are available: * RAW Ethernet * JSON/Web interface * Each TCP connection is its own session. Note: The RAW BLE mode may not be entered from the JSON/Web interface.

Syntax:

AT*BLERM=<mode>

Input Parameters:

Name

mode Boolean

Example:

AT*BLERM=<mode> OK

Type Description

Enter/Exit RAW BLE mode. 0: Exit RAW BLE mode. 1: Enter RAW BLE mode.

AT*BLERM?

Get the current RAW BLE mode.

Syntax:

AT*BLERM?

Example:

AT*BLERM? *BLERM:<mode> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 62 (84)

3.9.6 AT*BLEDM BLE discoverability mode

AT*BLEDM=

Set the BLE discoverability mode.

Syntax:

AT*BLEDM=<mode>,<store>

Input Parameters:

Name

mode

store

Example:

AT*BLEDM=<mode>,<store> OK

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

The BLE discoverability mode to set: 1: BLE non-discoverable mode 2: BLE limited discoverable mode 3: BLE general discoverable mode

AT*BLEDM?

Get the current BLE discoverability mode.

Syntax:

AT*BLEDM?

Example:

AT*BLEDM? *BLEDM:<mode> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 63 (84)

3.9.7 AT*BLECM BLE connectability mode

AT*BLECM=

Set the BLE connectability mode.

Syntax:

AT*BLECM=<mode>,<store>

Input Parameters:

Name

mode

store

Example:

AT*BLECM=<mode>,<store> OK

Type Description

Integer

Boolean If store is 1 the new value is stored permanently.

The BLE connectability mode to set: 1: BLE non-connectable mode 2: BLE connectable mode

AT*BLECM?

Get the current BLE connectability mode.

Syntax:

AT*BLECM?

Example:

AT*BLECM? *BLECM:<mode> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 64 (84)

3.9.8 AT*BLEDD BLE device discovery

Note: Only available when the device is in central operating mode.

AT*BLEDD=

Discover BLE devices. If a passive discovery is performed the devices advertisement data will be included. If an active scan is performed the devices scan response data will be included.

Syntax:

AT*BLEDD=<type>,<length>,<scan>

Input Parameters:

Name

type

length

scan

Type Description

Integer

Type of discovery. 0:.Discover all devices, but only display each device once. 1: Discover devices in general or limited discoverability mode. 2: Discover devices in limited discoverability mode. 3: Discover all devices, each device may be displayed multiple times.

Length of discovery in milliseconds. Max 65535 ms.

Type of scan. 0: Active scan. 1: Passive scan.

Output Parameters:

Name

bd_addr

rssi Integer RSSI.

name

data

Type Description

String

Bluetooth address of the BLE device.

Complete local name of BLE device, if included in data.

Advertise/Scan response data as a HEX string.

Example:

AT*BLEDD=<type>,<length>,<scan> *BLEDD:<bd_ addr>,<rssi>,<name>,<data> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 65 (84)

3.9.9 AT*BLEC Connect to BLE device

Note: Only available when the device is in central operating mode.

AT*BLEC=

Initiate an attempt to connect to a BLE device. The result will come in an unsolicited *BLEC event.

Syntax:

AT*BLEC=<bd_addr>

Input Parameters:

Name

bd_addr

Output Parameters:

Name

con_handle

bd_addr

Type Description

String

Type Description

Integer

String

Address of device to connect to, on the format "XX-XX-XX-XX-XX-XXy" where "y" is "p" or "r" depending on if the address is private or random.

Hexadecimal formatted connection handle. ffff if the connection fails.

Bluetooth address of the device connecting to.

Example:

AT*BLEC=<bd_addr> OK *BLEC:<con_handle>,<bd_addr>

3.9.10 AT*BLED Disconnect from BLE device

Note: Only available when the device is in central operating mode.

AT*BLED=

Initiate an attempt to disconnect from a BLE device. The result will come in an unsolicited *BLED event.

Syntax:

AT*BLED=<con_handle>

Input Parameters:

Name

con_handle

Output Parameters:

Name

con_handle

Type Description

Integer

Type Description

Integer

Connection handle.

Hexadecimal formatted connection handle.

Example:

AT*BLED=<con_handle> OK *BLED:<con_handle>

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 66 (84)

3.10 Bluetooth Low Energy GATT Client Commands

3.10.1 AT*BGCPSD Discover All Primary Services

Note: Only available when the device is in central operating mode.

AT*BGCPSD=

Discover all primary services of a GATT server.

Syntax:

AT*BGCPSD=<con_handle>

Input Parameters:

Name

con_handle

Output Parameters:

Name

attr_handle

start_group_handle

end_group_handle

uuid

Type Description

Integer

Type Description

Integer

Connection handle.

Decimal formatted attribute handle.

Decimal formatted start group handle.

Decimal formatted end group handle.

128-bit UUID on the format 00112233-4455-6677-8899-aabbccddeeff, 00112233445566778899aabbccddeeff or 16-bit UUID on hexadecimal format 0011.

Example:

AT*BGCPSD=<con_handle> *BGCPSD:<attr_handle>,<start_group_ handle>,<end_group_handle>,<uuid> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 67 (84)

3.10.2 AT*BGCPSDU Discover All Primary Services By Service UUID

Note: Only available when the device is in central operating mode.

AT*BGCPSDU=

Discover primary services by UUID. This will filter out the results based on UUID.

Syntax:

AT*BGCPSDU=<con_handle>,<uuid>

Input Parameters:

Name

con_handle

uuid

Output Parameters:

Name

attr_handle

start_group_handle

end_group_handle

Type Description

Integer

String

Type Description

Integer

Connection handle.

UUID to search for.

Decimal formatted attribute handle.

Decimal formatted start group handle.

Decimal formatted end group handle.

Example:

AT*BGCPSDU=<con_handle>,<uuid> *BGCPSDU:<attr_handle>,<start_ group_handle>,<end_group_handle> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 68 (84)

3.10.3 AT*BGCFIS Find Included Services

Note: Only available when the device is in central operating mode.

AT*BGCFIS=

Find included services of a given service.

Syntax:

AT*BGCFIS=<con_handle>,<start_handle>,<end_handle>

Input Parameters:

Name

con_handle

start_handle

end_handle

Output Parameters:

Name

attr_handle

start_group_handle

end_group_handle

uuid

Type Description

Integer

Type Description

Integer

Connection handle.

Start handle of the service.

End handle of the service.

Decimal formatted attribute handle.

Decimal formatted start group handle.

Decimal formatted end group handle.

128-bit UUID on the format 00112233-4455-6677-8899-aabbccddeeff, 00112233445566778899aabbccddeeff or 16-bit UUID on hexadecimal format 0011.

Example:

AT*BGCFIS=<con_handle>,<start_handle>,<end_handle> *BGCFIS: <attr_handle>,<start_group_handle>,<end_group_handle>,<uuid> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 69 (84)

3.10.4 AT*BGCDCS Discover All Characteristic of a Service

Note: Only available when the device is in central operating mode.

AT*BGCDCS=

Discover all characteristics of a service.

Syntax:

AT*BGCDCS=<con_handle>,<start_handle>,<end_handle>

Input Parameters:

Name

con_handle

start_handle

end_handle

Output Parameters:

Name

attr_handle

properties Integer

value_handle

uuid

Type Description

Integer

Type Description

Integer

String

Connection handle.

Start handle of the service.

End handle of the service.

Decimal formatted attribute handle.

Hexadecimal formatted properties. The individual bits indicate a specific property:

* Bit 0: Broadcast * Bit 1: Readable * Bit 2: Writable with no response * Bit 3: Writable * Bit 4: Notify * Bit 5: Indicate * Bit 6: Authenticated signed write * Bit 7: Extended property available

Decimal formatted value handle.

128-bit UUID on the format 00112233-4455-6677-8899-aabbccddeeff, 00112233445566778899aabbccddeeff or 16-bit UUID on hexadecimal format 0011.

Example:

AT*BGCDCS=<con_handle>,<start_handle>,<end_handle> *BGCDCS: <attr_handle>,<properties>,<value_handle>,<uuid> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 70 (84)

3.10.5 AT*BGCDCD Discover All Characteristic Descriptors

Note: Only available when the device is in central operating mode.

AT*BGCDCD=

Discover all descriptors of a characteristic.

Syntax:

AT*BGCDCD=<con_handle>,<value_handle>,<service_end_handle>

Input Parameters:

Name

con_handle

value_handle

service_end_handle

Output Parameters:

Name

char_attr_handle

attr_handle

uuid

Type Description

Integer

Type Description

Integer

String

Connection handle.

Handle of the characteristic value.

End handle of the service which the characteristic belongs to.

Decimal formatted handle to the characteristic.

Decimal formatted attribute handle.

128-bit UUID on the format 00112233-4455-6677-8899-aabbccddeeff, 00112233445566778899aabbccddeeff or 16-bit UUID on hexadecimal format 0011.

Example:

AT*BGCDCD=<con_handle>,<value_handle>,<end_handle> *BGCDCD: <char_attr_handle>,<attr_handle>,<uuid> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 71 (84)

3.10.6 AT*BGCRC Read Characteristic Value, Read Characteristic Descriptors

Note: Only available when the device is in central operating mode.

AT*BGCRC=

Read the value of a characteristic or descriptor.

Syntax:

AT*BGCRC=<con_handle>,<attr_handle>,<offset>

Input Parameters:

Name

con_handle

attr_handle

offset

Output Parameters:

Name

data

Type Description

Integer

Type Description

String

Connection handle.

Handle to the characteristic or descriptor value.

Offset where to start read from.

Data formatted as a hexadecimal string.

Example:

AT*BGCRC=<con_handle>,<attr_handle>,<offset> *BGCRC: <data> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 72 (84)

3.10.7 AT*BGCRCU Read Using Characteristic UUID

Note: Only available when the device is in central operating mode.

AT*BGCRCU=

Read the value of a characteristic by UUID. ERROR will be returned if no characteristic with the specified UUID could be found in the handle range.

Syntax:

AT*BGCRCU=<con_handle>,<start_handle>,<end_handle>,<uuid>

Input Parameters:

Name

con_handle

start_handle

end_handle

uuid

Output Parameters:

Name

attr_handle

data

Type Description

Integer

String

Type Description

Integer

String

Connection handle.

Handle, where to start looking for the UUID.

Handle, where to stop looking for the UUID.

UUID to look for.

Handle to the attribute read.

Data formatted as a hexadecimal string.

Example:

AT*BGCRCU=<con_handle>,<start_handle>,<end_ handle>,<uuid> *BGCRCU:<attr_handle>,<data> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 73 (84)

3.10.8 AT*BGCRCM Read Multiple Characteristic Values

Note: Only available when the device is in central operating mode.

AT*BGCRCM=

Read multiple characteristics in a single read. The application must know the length of each data element in the returned list. Therefore only the last data element may have a variable length.

Syntax:

AT*BGCRCM=<con_handle>,<attr_handle_list>

Input Parameters:

Name

con_handle

attr_handle_list

Output Parameters:

Name

data

Type Description

Integer

String

Type Description

String

Connection handle.

List of characteristic handles for which values to read, as a string where each handle is four hexadecimal digits.

Ex: "00010003000A" would read characteristics with handles 0x0001, 0x0003 and 0x000A.

Data formatted as a hexadecimal string.

Example:

AT*BGCRCM=<con_handle>,<attr_handle_list> *BGCRCM:<data> OK

3.10.9 AT*BGCWC Write Characteristic Value, Write Characteristic Descriptors

Note: Only available when the device is in central operating mode.

AT*BGCWC=

Write a value to a characteristic or descriptor.

Syntax:

AT*BGCWC=<con_handle>,<attr_handle>,<data>

Input Parameters:

Name

con_handle

attr_handle

data

Example:

AT*BGCWC=<con_handle>,<attr_handle>,<data> OK

Type Description

Integer

String

Connection handle.

Handle to the characteristic or descriptor value.

Data to write as a HEX string with max 20 bytes.

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 74 (84)

3.10.10 AT*BGCWCN Write Without Response

Note: Only available when the device is in central operating mode.

AT*BGCWCN=

Write a value to a characteristic without any response from the remote side.

Syntax:

AT*BGCWCN=<con_handle>,<attr_handle>,<data>

Input Parameters:

Name

con_handle

attr_handle

data

Example:

AT*BGCWCN=<con_handle>,<attr_handle>,<data> OK

Type Description

Integer

String

Connection handle.

Handle to the characteristic value.

Data to write as a HEX string with max 20 bytes.

3.10.11 AT*BGCWCL Write Long Characteristic Values, Write Long Characteristic Descriptors

Note: Only available when the device is in central operating mode.

AT*BGCWCL=

Write long characteristic or descriptor value.

Syntax:

AT*BGCWCL=<con_handle>,<attr_ handle>,<data>,<reliable>,<flag>,<offset>

Input Parameters:

Name

con_handle

attr_handle

data

reliable Boolean Whether or not to verify the data written.

flag

offset

Type Description

Integer

String

Integer

Connection handle.

Handle to the characteristic or descriptor value.

Data to write as a HEX string with max 18 bytes.

0: Do not verify. 1: Verify.

All but the last writes to a long value should have the flag set to 1. The last write should have the flag set to 0. Set the flag to 2 to abort the write.

Offset of the data to write.

Example:

AT*BGCWCL=<con_handle>,<attr_ handle>,<data>,<reliable>,<flag>,<offset> OK

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 75 (84)

3.11 Unsolicited events

In order to receive unsolicited events the AT session needs to be put into a RAW BLE mode. This is done with the AT*BLERM command.

3.11.1 AT*BLEC Device connected

Event Device connected, for Central or Peripheral Bluetooth LE mode.

Output Parameters:

Name

con_handle

bd_addr

Example:

Event: *BLEC:<con_handle>,<bd_addr>

3.11.2 AT*BLED Device disconnected

Event Device disconnected, for Central or Peripheral Bluetooth LE mode.

Type Description

Integer

String

Hexadecimal formatted connection handle. ffff if the connection fails.

Bluetooth address of the device connecting to.

Output Parameters:

Name

con_handle

Type Description

Integer

Example:

Event: *BLED:<con_handle>

3.11.3 AT*BLENR Notification received

Event Notification received, for Central Bluetooth LE mode.

Output Parameters:

Name

con_handle

attr_handle

value

Example:

Event: *BLENR:<con_handle>,<attr_handle>,<value>

Type Description

Integer

String

Hexadecimal formatted connection handle.

Handle to the attribute.

Value as a HEX string.

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

AT Commands 76 (84)

3.11.4 AT*BLEIR Indication received

Event Indication received, for Central Bluetooth LE mode.

Output Parameters:

Name

con_handle

attr_handle

value

Example:

Event: *BLEIR:<con_handle>,<attr_handle>,<value>

Type Description

Integer

String

Hexadecimal formatted connection handle.

Handle to the attribute.

Value as a HEX string.

Wireless Bolt™/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

S Registers

4 S Registers

4.1 ATS S Registers

Changes made to S registers requires reboot

Standard Registers

4 Response

Name

Command Line Termination Character

Formatting Character

Backspace Character

Value Range

1..127 13

1..127 10

0..255 8

Default Value

77 (84)

Description

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 in place of the CR.

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.

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.

Miscellaneous Registers

1000

1001

1002 Ignore

1003 Event

1004 Event

1005 Event

1006

1007

Name

Reserved

Broadcast Layer 2 AT

Subscriber Protocol

Subscriber Ethernet Type

Subscriber Syslog Port

Bridge Cache Timeout

Easy Config LED Mode

Value Range

0..1 0

0..255 0

0..65535 0

0..255 2

0..3 3

Default Value

Description

Setting this register to 1 will ignore Layer2 AT broadcast packets

Bit mask deciding how events should be sent. Bit 0: Send events over TCP AT connections Bit 1: Send events over Layer-2 (mac_address must

be specified, using AT*AMESS) Bit 2: Send events over Syslog

The 16 bit Ethernet type to use when sending events over layer 2

The 16 bit UDP port to use when sending events using Syslog

Time in seconds before mac address cache table in the bridge throws away an entry.

Bit mask representing Easy Config LED Mode when smart mode is finished

Value 0: Link quality LEDs are off Value 1: WLAN RSSI Value 2: BT Link Quality Value 3: Auto (default) show WLAN if active otherwise show BT if active

Wireless Bolt

™

/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

S Registers

Miscellaneous Registers (continued)

1008

1009

1010

1011

1012

1013

Name

Reserved

Diagnose Mode

Value Range

Default Value

0..4294967296 0x00010001

78 (84)

Description

Set diagnose mode bitmask. The following events will be sent when the bit is set: Bit 0: *WSCO - Connection to AP up

*WSCC - Connection to AP down *WASA - Station has connected *WASR - Station has disconnected *WSDST - Digital signal transition (only applicable if S4001 is 1) *WSRSSC - RSSI value falls below or rises above the value in S4003 (only applicable if S4004 is 0) Bit 1: *WSRSS - RSSI periodically sent while connected, with interval set by S3007 *WSCH - Used WLAN channel, sent upon connection setup Bit 2: *WSSCAN - Background scan result (only applicable if S4004 is 0) Note: Will not work while a connection is in progress, use AT*WSCC to cancel Bit 3: *WSSCAN - Background scan result for possible handover candidates (only applicable if S4004 is 0) *WSRHC - Roaming handover candidate (only applicable if S4004 is 0) *WSRH - Roaming handover (only applicable if

S4004 is 0) *WSFRG - Roaming reassociating (only applicable if

S4004 is 1) *WSFRD - Roaming reassociated (only applicable if

S4004 is 1) Bit 16: *BCI - Connection indication (incoming connection) *BCO - Connection opened *BCC - Connection closed *BDST - Digital signal transition (only applicable if S2702 is 1) *BLQC - Link Quality value falls below or rises above the value in S2700 Bit 17: *BLQ - Link Quality periodically sent while connected, with interval 5000ms Bit 18: *BI - Background scan result, regardless of the current roaming operation. Bit 19: *BI - When background scan is active results for the currently connected device and possible handover candidates are sent. *BRSS - When background scan is active an

approximated RSSI value for the current connection is sent periodically. *BRHC - Roaming handover candidate

*BRH - Roaming handover

1014

Wireless Bolt

Easy Config

0..4294967296 5000

Mode Timeout

™

/ Wireless Bridge II™Reference Guide

Maximum time to wait for first push on SMART button in milliseconds

SCM-1202-004 1.7 en-US

S Registers

Miscellaneous Registers (continued)

1015

1016

Name

Radio Mode

Log level

Bluetooth Registers

2000

2001

2002

2003

2004

2005

2006

Name

Reserved

Inquiry Class of Device Filter

2007

2008

2009

2010

Reserved

Max Number of Connections

2011

2012

Reserved

External Connection Control

2013

2014

2015

Reserved

2016 Connect to

Name Scheme

Value Range

Default Value

0..3 3

0..3 1

Value Range

Default Value

0..4294967296 0x00020300

0..7 1

0..1 0

0..2 1

79 (84)

Description

Configures which radios should be enabled 0: All radio off 1: Enable only Bluetooth 2: Enable only WLAN 3: Enable Bluetooth and WLAN

Configures what kind of events that should be presenred in the event log 0: Off, No events should be logged. 1: Error, Error events should be logged.

2: Warning, Warning and Error events should be logged.

3: Verbose, All events should be logged.

Description

A found device must match this bitmask to be reported to the higher layers, e.g. to find all networking devices, bit 17 should be set (0x00020300 or 131840). Bit 0-1 and 24-31 are reserved and will be ignored

The default value is set at production time and might differ for different product models. It is readable using the AT*AMSBC? command.

0: Disable. 1: Enable.

0: Connect to first name (first found). This will make a limited inquiry searching for 1 unit,

get the name of the found unit and, if the name matches, connect to it.

1: Connect to best name (highest RSSI value). This will make an inquiry, sort the devices regarding to the RSSI value. Then it will start from the device with best RSSI value, get the name and connect if it matches the desired name. If it fails, it will go to the next device and so on. (default) 2: Connect to name. This will make an inquiry and then get the name of the found devices. When a matching name is found, a connection attempt will be done. If the connection fails, it will try with the next found and so on.

Wireless Bolt

™

/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

S Registers

Bluetooth Registers (continued)

Name

2017 Connect to

Name Exact Match

2018

Background Scanning Interval

Roaming BT Registers

Name

2700 Trigger Scan

Link Quality

2701

Roaming list trigger Link Quality

2702

Roaming list trigger input

2703 Minimum

acceptable RSSI

2704 Roaming RSSI

diff threshold

Value Range

Default Value

0..1 1

0..4294967296 5000

Value Range

Default Value

0..255 200

0..1 0

0..1 1

-128..127 -70

0..127 10

80 (84)

Description

0: Connect to BT devices that contain a sub part of the connection name, ex. 'DUT' will try to connect to 'xDUTx'. Where x is a sign for wild card. 1: Connect to an exact match of the BT local name in the connection list.

Time between background scans in milliseconds

Description

When the current connection's Link Quality is below this level a background scan is initiated to find a better connection.

0: Do not trig on Link Quality 1: Trig on Link Quality (default)

0: Do not trig on digital input 1: Trig on digital input (default)

Defines at what RSSI level a connection is considered acceptable.

When the current connection's RSSI is below MIN_ ACCEPTABLE_RSSI and the difference between the connected device RSSI and the RSSI from the best device from background scan exceeds this threshold a roaming handover is done.

WLAN Registers

3000

3001

3002

Name

Reserved

3003 Power Save

Mode

3004

3005

Reserved

Background Scanning Interval

3006 Reconnect

Interval

3007

RSSI poll interval

3008

3009

3010

Reserved

Roaming WLAN Registers

4000

Name

Roaming list trigger RSSI

4001

Roaming list trigger input

4002 Roaming RSSI

diff threshold

Value Range

0..2 0

Default Value

Description

0: Off 1: Sleep 2: Deep Sleep

0..4294967296 5000

0..65535 1000

Value Range

Default Value

Time between background scans in milliseconds

The interval in milliseconds

RSSI poll interval in milliseconds

Description

0..1 1 0: Do not trig on RSSI 1: Trig on RSSI (default)

0..1 1

0: Do not trig on digital input 1: Trig on digital input (default)

0..127 10

When the difference between the connected AP RSSI and the RSSI from the best AP from background scan exceeds this threshold a roaming handover is done.

Wireless Bolt

™

/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

S Registers

Roaming WLAN Registers (continued)

Name

4003 Trigger Scan

Value Range

-128..127 -70

RSSI

4004 Fast Roaming 0..1 1

Network Registers

5000

Name

TCP Keep-Alive

Value Range

0..1 0

Enable

5001

TCP Keep-Alive

0..4294967296 7200000

Idle Time

5002

TCP Keep-Alive

0..4294967296 75000

Interval

5003

TCP Keep-Alive

0..255 9

Lost Count

5004

LLDP Send

0..65535 60

Interval.

5005

5006

Reserved

LLDP Hold

2..10 4

Multiplier

Default Value

81 (84)

Description

Defines at what RSSI level a background scan should be initiated to find a better connection.

0: Disable fast roaming. 1: Enable fast roaming according to IEEE 802.11r, this causes the device to roam quicker between APs with the same SSID, but the BSSID and Channel

parameters in the connection list is ignored (default). Note that this is in Client mode only and the the AP's also need to support IEEE 802.11r.

Description

Turn on/off TCP keep-alive packets. It is important to understand that sending frequent keep-alive packets usually isn't a good solution to detect dropped connections. Detecting dead links should be done on a higher level, i.e. in the user application protocol. There is a lot of information available on the subject on the web. 0: TCP keep-alive packets turned off 1 = TCP keealive packets turned on

Time in milliseconds for a TCP connection to be idle before a keep-alive packet is sent.

Time in milliseconds between keep-alive packets.

Number of lost keep-alive packets to wait before a TCP connection is reset.

The module will per default send information in LLDP frames with its current setup. This can also be used to stay alive on access points that do not properly wake the module before a disassociation. Value in seconds. 0 = Off, do not send or process incoming LLDP frames

This value multiplied with LLDP interval makes the total time an LLDP update is valid.

PROFINET Registers

5100

5101

Name

Reserved

Profinet Prioritization

5102

Prioritized Ethernet Type

5103

5104

Reserved

PTCP Filter

Bluetooth Low Energy Registers

6000

Name

Advertising Interval Minimum

6001

Advertising Interval Maximum

Wireless Bolt

™

/ Wireless Bridge II™Reference Guide

Value Range

Default Value

0..1 0

0..65535 0x8892

0..1 1

Value Range

Default Value

32..16384 1600

32..16384 2000

Description

Set prioritization for PROFINET. 0: Disable 1: Enable

The 16-bit Ethernet type to prioritize

Set ProfiNET PTCP filter. When enabled, all incoming PTCP packets will be dropped. 0: Disable 1: Enable

Description

Advertising interval minimum (must be <= Advertising Interval Maximum). Unit in multiples of

0.625 ms.

Advertising interval maximum (must be >= Advertising Interval Minimum). Unit in multiples of

0.625 ms.

SCM-1202-004 1.7 en-US

S Registers

Bluetooth Low Energy Registers (continued)

6002

Name

Advertising

Value Range

0..7 7

Channel Map

6003 Connect

6..3200 24

Connection Interval Minimum

6004 Connect

6..3200 40

Connection Interval Maximum

6005 Connect Latency 0..500 0

6006 Connect

100..32000 2000

Linkloss Timeout

6007 Connect Create

0..65535 5000 Connect create connection timeout. Unit in

Connection Timeout

6008 Connect

16..16384 48

Connection Scan Interval

6009 Connect Scan

16..16384 48

Window

6010

Bond

6..3200 24

Connection Interval Minimum

6011

Bond

6..3200 40

Connection Interval Maximum

6012

Bond

0..500 0

Connection Latency

6013

Bond Linkloss

100..32000 2000

Timeout

6014

Bond Create

0..65535 5000

Connection Timeout

6015

Bond Scan

16..16384 48

Interval

6016

Bond Scan

16..16384 48

Window

6017 Remote Name

6..3200 24

Connection Interval Minimum

6018 Remote Name

6..3200 40

Connection Interval Maximum

6019 Remote Name

0..500 0

Connection Latency

6020 Remote Name

100..32000 2000

Linkloss Timeout

6021 Remote Name

0..65535 5000 Remote name request create connection timeout.

Create Connection Timeout

Default Value

82 (84)

Description

Bit mask for advertising channel map. Bit 0: Channel 37 Bit 1: Channel 38 Bit 2: Channel 39

Connect connection interval minimum (must be <= Connect Connection Interval Maximum). Unit in multiples of 1.25 ms.

Connect connection interval maximum (must be >= Connect Connection Interval Minimum). Unit in multiples of 1.25 ms.

Connect latency for number of connection events. Unit in multiples of 1.0 ms.

Connect linkloss timeout. Unit in multiples of 1.0 ms.

multiples of 1.0 ms.

Connect connection scan interval (must be >= Connect Scan Window). Unit in multiples of 0.625 ms.

Connect scan window (must be <= Connection Scan Interval). Unit in multiples of 0.625 ms.

Bond connection interval minimum (must be <= Bond Connection Interval Maximum). Unit in multiples of 1.25 ms.

Bond connection interval maximum (must be >= Bond Connection Interval Minimum). Unit in multiples of 1.25 ms.

Bond latency for number of connection events. Unit in multiples of 1.0 ms.

Bond linkloss timeout. Unit in multiples of 1.0 ms.

Bond create connection timeout. Unit in multiples of 1.0 ms.

Bond scan interval (must be >= Bond Scan Window). Unit in multiples of 0.625 ms.

Bond scan window (must be <= Bond Scan Interval). Unit in multiples of 0.625 ms.

Remote name request connection interval minimum (must be <= Remote Name Request Connection Interval Maximum). Unit in multiples of

1.25 ms.

Remote name request connection interval maximum (must be >= Remote Name Request Connection Interval Minimum). Unit in multiples of

1.25 ms.

Remote name request latency for number of connection events. Unit in multiples of 1.0 ms.

Remote name request linkloss timeout. Unit in multiples of 1.0 ms.

Unit in multiples of 1.0 ms.

Wireless Bolt

™

/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

S Registers

Bluetooth Low Energy Registers (continued)

Name

6022 Remote Name

Value Range

16..16384 48

Request Scan Interval

6023 Remote Name

16..16384 48

Request Scan Window

Default Value

83 (84)

Description

Remote name request connection scan interval (must be >= Remote Name Request Scan Window). Unit in multiples of 0.625 ms.

Remote name request scan window (must be <= Remote Name Request Scan Interval). Unit in multiples of 0.625 ms.

Wireless Bolt

™

/ Wireless Bridge II™Reference Guide

SCM-1202-004 1.7 en-US

last page

Box 4126 300 04 Halmstad, Sweden

info@hms.se SCM-1202-004 1.7 en-US / 2018-09-03 / 9427

Anybus Wireless Bolt, Wireless Bridge II User guide

Specifications and Main Features

Frequently Asked Questions

User Manual

1 Preface

1.1 About This Document

1.2 Document history

2 Introduction

2.1 Data Types

3 AT Commands

3.1 Standard Commands

3.1.1 AT&F Restore to Factory Settings

3.1.2 AT* List Available Commands

3.1.3 AT Attention

3.2 Network Commands

3.2.1 AT*ANDHCP DHCP Mode

3.2.2 AT*ANDHCPSTA DHCP Start Address Offset

3.2.3 AT*ANDHCPTAB DHCP Table

3.2.4 AT*ANIP IP Settings

3.2.5 AT*ANHN Hostname

3.3 Bluetooth Classic Commands

3.3.1 AT*BCP Connect Peer

3.3.2 AT*BCC Close Connection

3.3.3 AT*BC Connect

3.3.4 AT*BND Name Discovery

3.3.5 AT*BDD Device Discovery

3.3.6 AT*BI Inquiry

3.3.7 AT*BSP Server Profile

3.3.8 AT*BFP Fixed PIN

3.3.9 AT*BPM Pairing Mode

3.3.10 AT*BSM Security Mode

3.3.11 AT*BBM BT Bridge Mode

3.3.12 AT*BBD Bonded Devices

3.3.13 AT*BUB Unbond

3.3.14 AT*BLEM Low Emission Mode

3.3.15 AT*BDM GAP Discoverability Mode

3.3.16 AT*BCM GAP Connectability Mode

3.3.17 AT*BCA Connection Accept

3.3.18 AT*BLN Local Name

3.3.19 AT*BRSS Read RSSI

3.3.20 AT*BLQ Read Link Quality

3.3.21 AT*BLP Limited Pairing

3.3.22 AT*BCHM Channel Map

3.3.23 AT*BPP Packet policy

3.3.24 AT*BMSP Master Slave policy

3.3.25 AT*BLCOD Local class of device.

3.3.26 AT*BRCD Read Connected Devices.

3.3.27 AT*BCLC Clear the Connection list

3.3.28 AT*BCLR Read the Connection list

3.3.29 AT*BCLW Write an entry in the Connection list

3.3.30 AT*BPPCM Set PANU PANU Connection Mode.

3.4 WLAN Commands

3.4.1 AT*WMODE WLAN Mode

3.4.2 AT*WKEY Encryption/Authentication Key

3.4.3 AT*WKEYI Write Encryption/Authentication Key (with Index)

3.4.4 AT*WACTKEY Active Encryption/Authentication Key

3.4.5 AT*WMIMO WLAN MIMO

3.4.6 AT*WWM WLAN World Mode

3.5 WLAN AP Commands

3.5.1 AT*WASSID Access Point SSID

3.5.2 AT*WACH Access Point Channel

3.5.3 AT*WAAM Authentication Mode for AP

3.6 WLAN Client (STA) Commands

3.6.1 AT*WSMAC WLAN MAC address

3.6.2 AT*WSBM WLAN Bridge Mode

3.6.3 AT*WSC Connect

3.6.4 AT*WSCC Close Connection

3.6.5 AT*WSCP Connect Peer

3.6.6 AT*WSSCAN Scan

3.6.7 AT*WSAM Authentication Mode for Station

3.6.8 AT*WSRSS Read RSSI

3.6.9 AT*WSLNK Read Link Status

3.6.10 AT*WSUSER User name for WLAN LEAP/PEAP authentication.

3.6.11 AT*WSDOMAIN Domain for WLAN LEAP/PEAP authentication.

3.6.12 AT*WSPASS Pass phrase for WLAN LEAP/PEAP authentication.

3.6.13 AT*WSCHL Channel list

3.6.14 AT*WSCLC Clear the Connection list

3.6.15 AT*WSCLR Read the Connection list

3.6.16 AT*WSCLW Write an entry (AP) in the Connection list

3.7 Informational Commands