Diamond Tech DT50-M, Reference Manual

Page 1: ...D T 5 0 M C O M M A N D R E F E R E N C E G U I D E 1 1 P a g e 1 38 DT50 M AT Command Set Reference Guide V1 1 ...

Page 2: ...tion Diamond Technologies Inc cannot assume responsibility for actual use based on these examples and illustrations Diamond Technologies Inc reserves 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 Diamond Technologies Inc Intellectual Prop...

Page 3: ...D T 5 0 M C O M M A N D R E F E R E N C E G U I D E 1 1 P a g e 3 38 Revision History Version Date Description 1 0 8 5 2020 Original Version 1 1 6 13 2022 Added Sections 7 1 12 7 1 13 7 1 14 ...

Page 4: ...T Commands 10 6 1 1 Attention AT 10 6 1 2 Store current configuration W 10 6 1 3 Set to default configuration Z 10 6 1 4 Set to factory defined configuration UFACTORY 11 6 1 5 Circuit 108 2 DTR behavior D 11 6 1 6 DSR Override S 11 6 1 7 Echo On Off E 12 6 1 8 Escape character S2 12 6 1 9 Command line termination character S3 13 6 1 10 Response formatting character S4 14 6 1 11 Backspace character...

Page 5: ...6 7 1 12 Read data in AT command Mode UDATR 27 7 1 13 Write Data in AT Command Mode UDATW 28 7 1 14 Data Available UUDATA 30 8 Bluetooth 30 8 1 Bluetooth Mode AT Commands 30 8 1 1 Discoverability mode UBTDM 30 8 1 2 Connectability mode UBTCM 31 8 1 3 Pairing mode UBTPM 31 8 1 4 Security mode UBTSM 31 8 1 5 Security type UBTST 33 8 1 6 User confirmation UBTUC 33 8 1 7 Inquiry BR EDR UBTI 34 8 1 8 D...

Page 6: ...D T 5 0 M C O M M A N D R E F E R E N C E G U I D E 1 1 P a g e 6 38 ...

Page 7: ...to reconfigure the DT50 using the following command sequence ATS2 47 AT UMSM 1 AT W AT CPWROFF The following criteria must be met for the DT50 to interpret the sequence as a valid escape sequence Before the escape sequence there must be silence for 1 second After the escape sequence there must be silence for 1 second The entire escape sequence must be sent within 200 ms To move from AT mode to dat...

Page 8: ...sent from the DTE to the DT50 is made up of a prefix body and terminator As prefix for the DT50 AT commands only AT ASCII 065 084 and at ASCII 097 116 can be used There is no distinction between upper and lower case characters The body is a string of characters in the range ASCII 032 255 Control characters other than CR carriage return ASCII 013 and BS back space ASCII 008 in a command line are ig...

Page 9: ... be represented as 5C An empty string is represented by two adjacent delimiters 5 2 2 Integer An integer value consists of a sequence of characters all in the range 0 9 Numeric constants are expressed in decimal format only 5 2 3 Enumerator An enumerator value is actually an integer where all its possible values are specified in each case Only the defined values are accepted for the command in que...

Page 10: ...d in start up database The parameters are written to non volatile memory when CPWROFF is issued Response Description OK Successful response ERROR Error response if profile is invalid Parameter Description Profile 0 Only valid value 6 1 3 Set to default configuration Z AT Command Description ATZ profile Resets the profile to the last stored configuration Any settings committed with AT W will be dis...

Page 11: ...ription OK Successful response ERROR Error response if value is invalid Parameter Description value 0 DTR line is ignored 1 default and factory default value Upon an ASSERTED to DEASSERTED transition of the DTR line in data mode the DCE enters the command mode and issues an OK result code 2 Upon an ASSERTED to DEASSERTED transition of the DTR line in data mode the DCE performs an orderly disconnec...

Page 12: ... connections 6 1 7 Echo On Off E AT Command Description ATE echo_on This command configures whether or not the unit echoes the characters received from the DTE in Command Mode If echo_on is omitted it turns off the echoing ATE Reads current echo setting Response Description echo_on OK Successful read response OK Successful response ERROR Error response if profile is invalid Parameter Description e...

Page 13: ...l 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 th...

Page 14: ...f S4 ATS4 Reads response formatting character Response Description term OK Successful read response OK Successful response ERROR Error response Parameter Description esc_char 0 127 Factory default 10 6 1 11 Backspace character S5 AT Command Description ATS5 backspace Writes backspace character This setting changes the decimal value of the character recognized by the DCE as a request to delete from...

Page 15: ...rror response Parameter Description start_mode 0 factory default Command mode 1 Data mode 2 Extended data mode 3 PPP mode 6 1 14 Local address UMLA AT Command Description AT UMLA interface_id Reads the local address of the interface id AT UMLA interface_id address Sets the local address of the interface id A DCE reboot is required before an address change takes effect Response Description UMLA add...

Page 16: ...nd 1 Saved address MAC address of the interface id If the address is set to 000000000000 the local address will be restored to factory programmed value The least significant bit of the first octet of the address must be 0 that is the address must be a unicast address 6 1 16 RS232 Settings UMRS AT Command Description AT UMRS Reads current RS232 settings from the module AT UMRS baud_rate flow_ contr...

Page 17: ... parity 3 even parity change_after_confirm 0 Do not change it must be stored and reset before applying the new setting 1 default Change after OK The DTE should wait at least 40 ms before sending a new command When operating in the extended data mode the change_after_confirm has no direct effect Settings must be stored to the profile and the module must be rebooted before applying the settings 7 Da...

Page 18: ... of the remote device if the local device is configured as Bluetooth low energy Simultaneous Peripheral or Central o escseq defines allowed escseq if the escseq is 1 the remote device can put the local device in AT command mode see AT UDSF command spp dun domain specifies Bluetooth address Bd_Addr of the remote device and port specifies RFCOMM channel query_string can define bt_name uuid qos and e...

Page 19: ...her IPv4 IPv4_Addr or IPv6 IPv6_Addr address or domain name query_string can define local_port query_string flags 1 enables reception from a unicast address when peer is configured to a multicast address mqtt Establishes a TCP or TLS connection to an MQTT Broker peer_handle The peer handle identifies the connection and is used when closing the connection 7 1 3 Close peer connection UDCPC AT Comman...

Page 20: ...ommand mode That is on errors and remote disconnect the peer will automatically try to reconnect The reconnect timeout interval can optionally be selected by setting the parameter ac to to the query string Example spp 0012f3000001 ac to 10000 2 Bit 2 External connect Trigger connection to peer on external signal connect event The connect event is generated when the signal SWITCH_0 is kept low for ...

Page 21: ...tion id 0 6 the server ID to configure Disable an active server first before changing By default the following servers are enabled on id 0 SPP server A DCE reboot is required before any Bluetooth related server configuration takes effect url URL to the service on the remote peer scheme domain port q uery_string Supported scheme tcp query_string keepAlive is used to configure the tcp keepalive sett...

Page 22: ...and 0 as remote port but this will not cause any new UUDPC when the data is received So it will not be possible to extract the data source This is typically used together with the data mode 1 Auto connect This will spawn a new peer and trigger a UUDPC URC so that the host can respond to the sender Further incoming data from the same source will be received on the newly created peer The originally ...

Page 23: ...Successful read response OK Successful write response Parameter Description id Id as given by AT UDSC flags Bit 0 Allow remote configuration 0 Disabled default 1 Enabled 7 1 8 Watchdog settings UDWS The data watchdog functionality is active only in the data or extended data mode Additionally the power mode must also be set to online or sleep mode AT Command Description AT UDWS type Reads current w...

Page 24: ... and there is no need for additional user activity Recommended value is 30s and it should not be set lower than 20s The default value is 0 which means that the watchdog is disabled 6 Net Up timeout param_val1 is the time in seconds allowed between a UUWLE link connected event and a UUNU net up event If the UUNU is not received within the set time the link is automatically disconnected and connecte...

Page 25: ...rted The default value for the bit mask corresponds to the previous behavior of the S2 AT command Bit 0 Activate DSR if any data peer is connected old behavior Bit 1 Activate DSR if a Bluetooth LE bonded device is connected Bit 2 Activate DSR on any Bluetooth LE GAP connection 4 Always connected reconnect time out 100 60000 milliseconds before trying to reconnect a default remote peer with always ...

Page 26: ...ddr or IPv6_Addr Local IP address associated to the peer TCP connection only local_port Local port associated to the peer remote_address IPv4_Addr or IPv6_Addr Remote IP address associated to the peer remote_port Remote port associated to the peer frame_size GAP data length 7 1 11 Peer disconnected UUDPD Description UUDPD Unsolicited response code for data mode Unsolicited response code URC Descri...

Page 27: ...at actual data UDATR data_length hex_data When data format is 1 hexadecimal OK Successful response ERROR Error Response Parameter Description peer_handle The peer handle identifies the connection max_data_length Maximum amount of data bytes to read Set this to 0 to check available data without reading data_format 0 Reserved 1 Hexadecimal Byte Array 2 Binary data_length Actual amount of data bytes ...

Page 28: ... We get an event that indicates that 4 bytes are still left in buffer to be read UUDATA 1 4 Now we try to read 5 bytes of data in hex format but only receive 4 bytes since buffer is empty after that AT UDATR 1 1 5 UDATR 4 36373839 OK Now we get event that indicate that there are no more bytes to read UUDATA 1 0 7 1 13 Write Data in AT Command Mode UDATW Generic write command that can be used for a...

Page 29: ...er Wait some time and retry There was too long idle period in data reception in binary mode The timeout value can be set with UDCFG command Invalid parameter Peer connection URL does not start with at Parameter Description peer_handle The peer handle identifies the connection data_format 0 String 1 Hexadecimal Byte Array 2 Binary data Data to send String in text case Byte Array in hexadecimal case...

Page 30: ...h UDATR command This URC will only be issued from peer connections creating with url scheme starting with at issues after every UDATR command even when receive buffer is empty data_length 0 There can be more data in the receive pipeline than indicated by this URC held back by flow control mechanisms This data will become available after reading data Example UUDATA 1 123 8 Bluetooth 8 1 Bluetooth M...

Page 31: ...se OK Successful write response ERROR Error response Parameter Description connectability_mode 1 GAP non connectable mode 2 factory default GAP connectable mode 8 1 3 Pairing mode UBTPM AT Command Description AT UBTPM Reads the pairing mode AT UBTPM pairing_mode Writes the pairing mode Response Description UBTPM pairing_mode OK Successful read response OK Successful write response ERROR Error resp...

Page 32: ...r can see a passkey that can be entered on the remote device 4 Security Enabled Display Yes No Service level authentication and encryption enabled User interaction is required for bonding This security mode is used when the device has a display where the user can see a passkey that can be verified and confirmed with the remote device 5 Security Enabled Keyboard Only Service level authentication an...

Page 33: ...ere is no support from the remote side 2 FIPS mode Strictly uses Secure Connections Pairing requests will be rejected if the remote device does not support this mode Enabling P 256 Elliptical curve based encryption is memory intensive Hence when enabled the memory reserved for other functionalities will be affected For the settings to take effect use the commands W and CPWROFF to store the configu...

Page 34: ...Name of the discovered device Names of the discovered devices are returned only by the devices supporting Bluetooth 2 1 or later rssi Received signal strength in dBm 8 1 8 Discovery Low Energy UBTD AT Command Description AT UBTD discovery_type mode discovery_length Performs an inquiry procedure to find any discoverable devices in the vicinity Response Description UBTD bd_addr rssi device_ name dat...

Page 35: ...rength in dBm data_type 1 Scan response data 2 Advertise data data Complete advertisement scan response data received from the remote device 8 1 9 Bond UBTB AT Command Description AT UBTB bd_addr mode Performs a GAP bond procedure with another Bluetooth device For some security modes user interaction is required during the bonding procedure The procedure to use is determined by the security mode F...

Page 36: ...ssful response ERROR Error message Parameter Description mode 0 Bluetooth BR EDR 1 Bluetooth low energy 2 default Bluetooth BR EDR and low energy bd_addr Bluetooth device address of the device from which to retrieve the name device_mode 0 The bonded device is in the BR EDR mode 1 The bonded device is in the low energy mode 8 1 12 Local name UBTLN AT Command Description AT UBTLN Reads the local Blu...

Page 37: ...it 18 Rendering Printing Speaker etc Bit 19 Capturing Scanner Microphone etc Bit 20 Object Transfer v Inbox v Folder etc Bit 21 Audio Speaker Microphone Headset service etc Bit 22 Telephony Cordless telephony Modem Headset service Bit 23 Information WEB server WAP server etc Major device class number bits 12 8 00000 Miscellaneous 00001 Computer desktop notebook PDA etc 00010 Phone cellular cordles...

Page 38: ...y UBTMSP AT Command Description AT UBTMSP Reads the role policy of the device AT UBTMSP role_policy Writes the role policy of the device Response Description UBTMSP role_policy OK Successful read response OK Successful write response ERROR Error message Parameter Description role_policy 0 Always attempt to become master on incoming connections 1 default Always let the connecting device select mast...