Instructions

ManualsBrandsAnybus ManualsAutomationWireless Bolt WLAN, Bluetooth, Ethernet Anybus Wire

WWiirreelleessss BBoolltt

™™

// WWiirreelleessss BBrriiddggee IIII

™™

AATT CCoommmmaannddss

REFERENCE GUIDE

SCM-1202-004 1.7 en-US ENGLISH

Summary of content (86 pages)

PAGE 1
Wireless Bolt™ / Wireless Bridge II™ AT Commands REFERENCE GUIDE SCM-1202-004 1.
PAGE 2
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.
PAGE 3
Table of Contents 1 2 Preface ................................................................................................................................. 3 1.1 About This Document .......................................................................................................3 1.2 Document history ............................................................................................................3 Introduction........................................................................
PAGE 4
This page intentionally left blank
PAGE 5
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 Date Description 1.
PAGE 6
Introduction 2 4 (84) 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.
PAGE 7
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.
PAGE 8
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.
PAGE 9
AT Commands 3.2.2 7 (84) 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=, Input Parameters: Name Type Description start_address_offset Integer Start address of the DHCP IP range.
PAGE 10
AT Commands 3.2.3 8 (84) 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.
PAGE 11
AT Commands 3.2.5 9 (84) AT*ANHN Hostname Set/get the hostname used with dynamic DNS AT*ANHN= Set hostname Syntax: AT*ANHN=, 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.
PAGE 12
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=,, 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.
PAGE 13
AT Commands 3.3.3 11 (84) 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= Input Parameters: Name Type Description bd_addr MACAddress MAC address of the Bluetooth device to get the name of.
PAGE 14
AT Commands 3.3.6 12 (84) AT*BI Inquiry AT*BI Perform a Bluetooth inquiry. Syntax: AT*BI Example: Input: AT*BI returns *BI:,,,, 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.
PAGE 15
AT Commands 3.3.8 13 (84) AT*BFP Fixed PIN AT*BFP= Set the fixed pin/passkey used for BT authentication Syntax: AT*BFP=, 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.
PAGE 16
AT Commands 3.3.10 14 (84) AT*BSM Security Mode AT*BSM= Set the security mode to use for BT. For default value see AT*AMDEFAULT. Syntax: AT*BSM=, 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 thirdparty devices, Use Just works in that case).
PAGE 17
AT Commands 3.3.11 15 (84) AT*BBM BT Bridge Mode AT*BBM= Set the bridge mode for BT. For default value see AT*AMDEFAULT. Syntax: AT*BBM=, 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.
PAGE 18
AT Commands 3.3.13 16 (84) AT*BUB Unbond AT*BUB= Un-bonds a previously bonded device. Syntax: AT*BUB= 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 3.3.
PAGE 19
AT Commands 3.3.15 17 (84) AT*BDM GAP Discoverability Mode AT*BDM= Set current GAP discoverability mode. For default value see AT*AMDEFAULT. Syntax: AT*BDM=, Input Parameters: Name Type Description gap_mode Integer The GAP discoverability mode to set: 1: GAP non-discoverable mode 2: GAP limited discoverable mode 3: GAP general discoverable mode store Boolean If store is 1 the new value is stored permanently. AT*BDM? Get the current GAP discoverability mode.
PAGE 20
AT Commands 3.3.16 18 (84) AT*BCM GAP Connectability Mode AT*BCM= Set current GAP connectability mode. For default value see AT*AMDEFAULT. Syntax: AT*BCM=, Input Parameters: Name Type Description gap_mode Integer The GAP connectability mode to set: 1: GAP non-connectable mode 2: GAP connectable mode store Boolean If store is 1 the new value is stored permanently. AT*BCM? Get the current GAP connectability mode. See AT*BCM= for values.
PAGE 21
AT Commands 3.3.18 19 (84) 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= Input Parameters: Name name Type Description String The Bluetooth name to use. The maximum length is 31 characters. AT*BLN? Get the unit's Bluetooth name. Syntax: AT*BLN? Example: AT*BLN?
*BLN: 3.3.19 AT*BRSS Read RSSI AT*BRSS= Get the RSSI for a connection.
PAGE 22
AT Commands 3.3.20 20 (84) 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= Input Parameters: Name Type Description handle Integer The handle of the connection to get the link quality for. Example: AT*BLQ=
*BLQ: 3.3.21 AT*BLP Limited Pairing AT*BLP= Enables or disables limited pairing, only valid for current power cycle.
PAGE 23
AT Commands 3.3.22 21 (84) 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= ,,,,, Input Parameters: Name Type Description ch0to15 Integer Bit mask used to enable or disable channels 0 to 15 (Bit 0 = Channel 0). ch16to31 Integer Bit mask used to enable or disable channels 16 to 31.
PAGE 24
AT Commands 3.3.23 22 (84) 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=, Input Parameters: Name Type Description policy Integer 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.
PAGE 25
AT Commands 3.3.24 23 (84) AT*BMSP Master Slave policy AT*BMSP= Set the Bluetooth Master Slave Role Policy. For default value see AT*AMDEFAULT. Syntax: AT*BMSP=, Input Parameters: Name Type Description policy Integer 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. store Boolean If store is 1 the new value is stored permanently.
PAGE 26
AT Commands 3.3.25 24 (84) 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=, Input Parameters: Name Type Description cod Integer 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).
PAGE 27
AT Commands 3.3.27 25 (84) AT*BCLC Clear the Connection list AT*BCLC= Clears all the entries in the Connection list. Syntax: AT*BCLC= 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= Input Parameters: Name Type Description index Integer The index of the entry to read.
PAGE 28
AT Commands 3.3.29 26 (84) 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=,,,, Input Parameters: Name Type Description index Integer The index of the entry to write. bd_addr MACAddress If specified the MAC address of the remote Bluetooth device must match this value.
PAGE 29
AT Commands 3.3.30 27 (84) 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=, Input Parameters: Name Type Description connection_mode Integer The connection mode of PANU-PANU: 1: MAC only 2: NAME only 3: Both MAC and NAME store Boolean If store is 1 the new value is stored permanently. AT*BPPCM? Reads the PANU PANU Connection Mode.
PAGE 30
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= Input Parameters: Name Type Description mode Integer The mode to set, Station (0) or AP (1). Requires a reboot for the changes to take effect. Example: Input: AT*WMODE=1 sets WLAN mode to AP. AT*WMODE? Get WLAN mode, Station (0) or AP (1) Syntax: AT*WMODE? Example: AT*WMODE?
*WMODE: Wireless Bolt™ / Wireless Bridge II™ Reference Guide SCM-1202-004 1.
PAGE 31
AT Commands 3.4.2 29 (84) 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=, Input Parameters: Name Type Description key String The key to use. Max 63 characters. store Boolean If store is 1 the new value is stored permanently.
PAGE 32
AT Commands 3.4.4 30 (84) AT*WACTKEY Active Encryption/Authentication Key AT*WACTKEY= Set the index of the active Encryption/Authentication Key Syntax: AT*WACTKEY=, Input Parameters: Name Type Description index Integer 1..4 store Boolean If store is 1 the new value is stored permanently. AT*WACTKEY? Get the index of the active Encryption/Authentication Key, 1..4. Syntax: AT*WACTKEY? Example: Input: AT*WACTKEY? Wireless Bolt™ / Wireless Bridge II™ Reference Guide SCM-1202-004 1.
PAGE 33
AT Commands 3.4.5 31 (84) 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= Input Parameters: Name Type Description mode Integer Configures which antennas should be enabled. Requires a reboot for the changes to take effect. Example: Input: AT*WMIMO=2 enable WLAN MIMO.
PAGE 34
AT Commands 3.4.6 32 (84) 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.
PAGE 35
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= Input Parameters: Name Type Description ssid String The SSID to set. Max 32 characters. Requires a reboot for the changes to take effect. AT*WASSID? Gets the SSID for AP mode. Syntax: AT*WASSID? Example: AT*WASSID?
*WASSID: Wireless Bolt™ / Wireless Bridge II™ Reference Guide SCM-1202-004 1.
PAGE 36
AT Commands 3.5.2 34 (84) AT*WACH Access Point Channel AT*WACH= Sets the channel for AP mode. Syntax: AT*WACH= Input Parameters: Name Type Description channel Integer The channel to use. Valid channels are 1-11 for 2.4 GHz and 36, 40, 44, 48 for 5 GHz. Requires a reboot for the changes to take effect. AT*WACH? Gets the channel for AP mode. Syntax: AT*WACH? Example: AT*WACH?
*WACH: Wireless Bolt™ / Wireless Bridge II™ Reference Guide SCM-1202-004 1.
PAGE 37
AT Commands 3.5.3 35 (84) AT*WAAM Authentication Mode for AP AT*WAAM= Set the AP Authentication Mode. For default value see AT*AMDEFAULT. Syntax: AT*WAAM= Input Parameters: Name Type Description mode Integer Authentication Mode: 0 = Open, 2 = WPA/WPA2 PSK Requires a reboot for the changes to take effect. AT*WAAM? Get the AP Authentication Mode. Syntax: AT*WAAM? Example: Input: AT*WAAM? Wireless Bolt™ / Wireless Bridge II™ Reference Guide SCM-1202-004 1.
PAGE 38
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= Input Parameters: Name mac Type Description MACAddress The MAC address to set. Requires a reboot for the changes to take effect.
PAGE 39
AT Commands 3.6.2 37 (84) 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.
PAGE 40
AT Commands 3.6.4 38 (84) 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.
PAGE 41
AT Commands 3.6.6 39 (84) AT*WSSCAN Scan AT*WSSCAN= Scan the surroundings for access points with a specific Network Name (SSID) on a specified channel. Syntax: AT*WSSCAN=, Input Parameters: Name Type Description pssid String The SSID to scan for. Max 32 characters. channel Integer The channel to scan for Example: Input: AT*WSSCAN=dutAP,1 will return 0...48 access points in the immediate surroundings, then return OK. AT*WSSCAN? Scan the surroundings for access points.
PAGE 42
AT Commands 3.6.7 40 (84) AT*WSAM Authentication Mode for Station AT*WSAM= Set the Station Authentication Mode. For default value see AT*AMDEFAULT. Syntax: AT*WSAM=, Input Parameters: Name Type Description mode Integer Authentication Mode: 0 = Open, 1 = WEP64/128 (shared secret), 2 = WPA/WPA2 PSK, 3 = LEAP, 4 = PEAP store Boolean If store is 1 the new value is stored permanently. AT*WSAM? Get the Station Authentication Mode. Syntax: AT*WSAM? Example: Input: AT*WSAM? 3.6.
PAGE 43
AT Commands 3.6.9 41 (84) AT*WSLNK Read Link Status AT*WSLNK? Read current WLAN link status. Syntax: AT*WSLNK? Example: AT*WSLNK?
*WSLNK:, 3.6.10 AT*WSUSER User name for WLAN LEAP/PEAP authentication. AT*WSUSER= Set the user name. Syntax: AT*WSUSER=, Input Parameters: Name user_name Type Description String The user name to set (max 63 characters) store Boolean If store is 1 the new value is stored permanently.
PAGE 44
AT Commands 3.6.11 42 (84) AT*WSDOMAIN Domain for WLAN LEAP/PEAP authentication. AT*WSDOMAIN= Set the domain. Syntax: AT*WSDOMAIN=, Input Parameters: Name Type Description domain String The domain to set. Max 63 characters. store Boolean If store is 1 the new value is stored permanently. Example: Input: AT*WSDOMAIN=Cool,1 AT*WSDOMAIN? Get the domain. Syntax: AT*WSDOMAIN? Example: Input: AT*WSDOMAIN? Wireless Bolt™ / Wireless Bridge II™ Reference Guide SCM-1202-004 1.
PAGE 45
AT Commands 3.6.12 43 (84) AT*WSPASS Pass phrase for WLAN LEAP/PEAP authentication. AT*WSPASS= Set the pass phrase. Syntax: AT*WSPASS=, Input Parameters: Name Type Description pass_phrase String The pass phrase to set. Max 63 characters. store Boolean If store is 1 the new value is stored permanently. Example: Input: AT*WSPASS=Secret,1 AT*WSPASS? Get the pass phrase.
PAGE 46
AT Commands 3.6.13 44 (84) AT*WSCHL Channel list AT*WSCHL= Sets the Channel list for Station mode. Syntax: AT*WSCHL=, Input Parameters: Name Type Description channel_list_str String 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.
PAGE 47
AT Commands 3.6.15 45 (84) AT*WSCLR Read the Connection list AT*WSCLR= Reads an entry in the Connection list. Syntax: AT*WSCLR= Input Parameters: Name Type Description index Integer The index (0..49) of the entry to read. Example: AT*WSCLR=2
*WSCLR:<2>,, AT*WSCLR? Reads the list of Connections (Access Points) that the unit can use. Syntax: AT*WSCLR? Example: AT*WSCLR?
returns *WSCLR:,,, for each entry in the list followed by OK. 3.6.
PAGE 48
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:, 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.
PAGE 49
AT Commands 47 (84) 3.8 Miscellaneous Commands 3.8.1 AT*AMLI Login AT*AMLI= Log in to the AT command interface Syntax: AT*AMLI= Input Parameters: Name Type Description password String The password set using AT*AMPW Example: AT*AMLI= AT*AMLI? Returns 1 if logged in 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.
PAGE 50
AT Commands 3.8.3 48 (84) AT*AMPW Password AT*AMPW= Set password to the AT command interface Syntax: AT*AMPW=, Input Parameters: 3.8.4 Name Type Description password String Max length is 16 characters store Boolean If store is 1 the new value is stored permanently. AT*AMSTAT System status Get the system status. AT*AMSTAT= Get the system status. Syntax: AT*AMSTAT= Input Parameters: Name Type Description verbose Boolean 0: Terse, 1: Verbose.
PAGE 51
AT Commands 3.8.5 49 (84) AT*AMESS Event and Status Subscriber AT*AMESS= Set event and status subscriber configuration Syntax: AT*AMESS=,,,,, Input Parameters: Name Type Description mac_addr String MAC address of event subscriber. Only used when protocol bit 1 is set eth_type Integer The 16 bit Ethernet type to use. Only used when protocol bit 1 is set ip_addr String IP address of event subscriber.
PAGE 52
AT Commands 3.8.7 50 (84) 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=, Input Parameters: Name Type Description easy_config_modes String Comma-separated string of up to 15 modes and their order to be supported. Valid modes are 1 to 15.
PAGE 53
AT Commands 3.8.9 51 (84) AT*AMPID Product ID AT*AMPID? Get product ID Syntax: AT*AMPID? Example: AT*AMPID?
*AMPID:-- 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.
PAGE 54
AT Commands 3.8.12 52 (84) AT*AMGD General Data General data storage for custom data AT*AMGD= Write general data. Syntax: AT*AMGD=, Input Parameters: Name Type Description general_data String A custom string to store. Max length is 32 characters. store Boolean If store is 1 the new value is stored permanently. Example: Input: AT*AMGD=1,1,1,1 gives OK when... AT*AMGD? Read previously written data.
PAGE 55
AT Commands 3.8.13 53 (84) AT*AMTL TCP Listener Configures the AT over TCP server AT*AMTL= Set TCP listener settings Syntax: AT*AMTL=,, Input Parameters: Name port Type Description Integer TCP port to listen for incoming connections enable Boolean 0: Disables TCP Listener 1: Enables TCP Listener store Boolean If store is 1 the new value is stored permanently. Requires a reboot for the changes to take effect.
PAGE 56
AT Commands 3.8.15 54 (84) AT*AMLCR Layer 2 Configuration Receiver Configure AT over layer 2 (Ethernet) AT*AMLCR= Set AT over layer 2 configuration Syntax: AT*AMLCR=,, Input Parameters: Name Type Description eth_type Integer 16 bit Ethernet type that should be used for AT commands enable Boolean 0: Disable AT over Ethernet 1: Enable AT over Ethernet store Boolean If store is 1 the new value is stored permanently. Requires a reboot for the changes to take effect.
PAGE 57
AT Commands 3.8.17 55 (84) 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=,, Input Parameters: Name Type Description profisafe_mode Integer Set state of PROFIsafe mode. 0: Disable. 1: Enable. apply_now Boolean 0: Apply changes after reboot.
PAGE 58
AT Commands 3.8.19 56 (84) AT*AMSERIAL Serial Number AT*AMSERIAL? Command to read back serial number Syntax: AT*AMSERIAL? Example: AT*AMSERIAL?
*AMSERIAL: 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= Input Parameters: Name Type Description clear Boolean Set this to 1 to clear the event log.
PAGE 59
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=, Input Parameters: Name Type Description data String The new data to be advertised as a HEX string with max 28 bytes. store Boolean If store is 1 the new value is stored permanently. Example: AT*BLEAD=0102000305FF,1
OK AT*BLEAD? Get the data currently being advertised by this device.
PAGE 60
AT Commands 3.9.2 58 (84) AT*BLESRD Get/Set the scan response data AT*BLESRD= Set the data to be responded by this device. Syntax: AT*BLESRD=, Input Parameters: Name Type Description data String The new data to be responded as a HEX string with max 31 bytes. store Boolean If store is 1 the new value is stored permanently. Example: AT*BLESRD=0102000305FF,1
OK AT*BLESRD? Get the data currently being responded by this device.
PAGE 61
AT Commands 3.9.3 59 (84) AT*BLEOM Get/Set the BLE operating mode AT*BLEOM= Set the BLE operating mode. Syntax: AT*BLEOM=, Input Parameters: Name Type Description mode Integer The BLE operating mode: 0: BLE off. 1: Central operating mode. store Boolean If store is 1 the new value is stored permanently. Requires a reboot for the changes to take effect. Example: AT*BLEOM=1,1
OK AT*BLEOM? Get the current BLE operating mode.
PAGE 62
AT Commands 3.9.4 60 (84) AT*BLEND BLE name discovery AT*BLEND= Discover the name of a Bluetooth device. Syntax: AT*BLEND= Input Parameters: Name Type Description bd_addr 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. Name Type Description devicename String Devicename of found BLE device. The value is limited to a maximum of 19 bytes.
PAGE 63
AT Commands 3.9.5 61 (84) 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.
PAGE 64
AT Commands 3.9.6 62 (84) AT*BLEDM BLE discoverability mode AT*BLEDM= Set the BLE discoverability mode. Syntax: AT*BLEDM=, Input Parameters: Name Type Description mode Integer The BLE discoverability mode to set: 1: BLE non-discoverable mode 2: BLE limited discoverable mode 3: BLE general discoverable mode store Boolean If store is 1 the new value is stored permanently. Example: AT*BLEDM=,
OK AT*BLEDM? Get the current BLE discoverability mode.
PAGE 65
AT Commands 3.9.7 63 (84) AT*BLECM BLE connectability mode AT*BLECM= Set the BLE connectability mode. Syntax: AT*BLECM=, Input Parameters: Name Type Description mode Integer The BLE connectability mode to set: 1: BLE non-connectable mode 2: BLE connectable mode store Boolean If store is 1 the new value is stored permanently. Example: AT*BLECM=,
OK AT*BLECM? Get the current BLE connectability mode.
PAGE 66
AT Commands 3.9.8 64 (84) 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=,, Input Parameters: Name type Type Description Integer Type of discovery. 0:.Discover all devices, but only display each device once.
PAGE 67
AT Commands 3.9.9 65 (84) 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= Input Parameters: Name Type Description bd_addr 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.
PAGE 68
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= Input Parameters: Name Type Description con_handle Integer Connection handle. Name Type Description attr_handle Integer Decimal formatted attribute handle. start_group_handle Integer Decimal formatted start group handle.
PAGE 69
AT Commands 3.10.2 67 (84) 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=, Input Parameters: Name Type Description con_handle Integer Connection handle. uuid String UUID to search for. Name Type Description attr_handle Integer Decimal formatted attribute handle.
PAGE 70
AT Commands 3.10.3 68 (84) 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=,, Input Parameters: Name Type Description con_handle Integer Connection handle. start_handle Integer Start handle of the service. end_handle Integer End handle of the service. Name Type Description attr_handle Integer Decimal formatted attribute handle.
PAGE 71
AT Commands 3.10.4 69 (84) 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=,, Input Parameters: Name Type Description con_handle Integer Connection handle. start_handle Integer Start handle of the service. end_handle Integer End handle of the service.
PAGE 72
AT Commands 3.10.5 70 (84) 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=,, Input Parameters: Name Type Description con_handle Integer Connection handle. value_handle Integer Handle of the characteristic value. service_end_handle Integer End handle of the service which the characteristic belongs to.
PAGE 73
AT Commands 3.10.6 71 (84) 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=,, Input Parameters: Name Type Description con_handle Integer Connection handle. attr_handle Integer Handle to the characteristic or descriptor value. offset Integer Offset where to start read from.
PAGE 74
AT Commands 3.10.7 72 (84) 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=,,, Input Parameters: Name Type Description con_handle Integer Connection handle. Handle, where to start looking for the UUID.
PAGE 75
AT Commands 3.10.8 73 (84) 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=, Input Parameters: Name Type Description con_handle Integer Connection handle.
PAGE 76
AT Commands 3.10.10 74 (84) 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=,, Input Parameters: Name Type Description con_handle Integer Connection handle. attr_handle Integer Handle to the characteristic value. data String Data to write as a HEX string with max 20 bytes.
PAGE 77
AT Commands 3.11 75 (84) 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 Type con_handle Integer Description Hexadecimal formatted connection handle. ffff if the connection fails. bd_addr String Bluetooth address of the device connecting to.
PAGE 78
AT Commands 3.11.4 76 (84) AT*BLEIR Indication received Event Indication received, for Central Bluetooth LE mode. Output Parameters: Name Type Description con_handle Integer Hexadecimal formatted connection handle. attr_handle Integer Handle to the attribute. value String Value as a HEX string. Example: Event: *BLEIR:,, Wireless Bolt™ / Wireless Bridge II™ Reference Guide SCM-1202-004 1.
PAGE 79
S Registers 77 (84) 4 S Registers 4.1 ATS S Registers Changes made to S registers requires reboot Standard Registers Register Name Value Range Default Value Description 3 Command Line Termination Character 1..127 13 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.
PAGE 80
S Registers 78 (84) Miscellaneous Registers (continued) Register Name 1008 Reserved Value Range Default Value Description 1009 Reserved 1010 Reserved 1011 Reserved 1012 Reserved 1013 Diagnose Mode 0..4294967296 0x00010001 Set diagnose mode bitmask.
PAGE 81
S Registers 79 (84) Miscellaneous Registers (continued) Register Name Value Range Default Value Description 1015 Radio Mode 0..3 3 Configures which radios should be enabled 0: All radio off 1: Enable only Bluetooth 2: Enable only WLAN 3: Enable Bluetooth and WLAN 1016 Log level 0..3 1 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.
PAGE 82
S Registers 80 (84) Bluetooth Registers (continued) Register Name Value Range Default Value Description 2017 Connect to Name Exact Match 0..1 1 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. 2018 Background Scanning Interval 0..
PAGE 83
S Registers 81 (84) Roaming WLAN Registers (continued) Register Name Value Range Default Value Description 4003 Trigger Scan RSSI -128..127 -70 Defines at what RSSI level a background scan should be initiated to find a better connection. 4004 Fast Roaming 0..1 1 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).
PAGE 84
S Registers 82 (84) Bluetooth Low Energy Registers (continued) Register Name Value Range Default Value Description 6002 Advertising Channel Map 0..7 7 Bit mask for advertising channel map. Bit 0: Channel 37 Bit 1: Channel 38 Bit 2: Channel 39 6003 Connect Connection Interval Minimum 6..3200 24 Connect connection interval minimum (must be <= Connect Connection Interval Maximum). Unit in multiples of 1.25 ms. 6004 Connect Connection Interval Maximum 6..
PAGE 85
S Registers 83 (84) Bluetooth Low Energy Registers (continued) Register Name Value Range Default Value Description 6022 Remote Name Request Scan Interval 16..16384 48 Remote name request connection scan interval (must be >= Remote Name Request Scan Window). Unit in multiples of 0.625 ms. 6023 Remote Name Request Scan Window 16..16384 48 Remote name request scan window (must be <= Remote Name Request Scan Interval). Unit in multiples of 0.625 ms.