Device Bluetooth Commands


Device Bluetooth Commands

1. Environment Setup

  • Communication test software: sscom32
  • Optical probe test fixture

OP Series Bluetooth Module AT Command Protocol

Communication is supported only via serial port (through the optical probe test fixture).

AT Command Format

  • AT commands are text-line commands parsed line by line (terminated by carriage return and line feed \r\n)
  • AT commands should use uppercase characters (some modules support mixed case). Commands are prefixed with AT+ and fall into parameter-setting commands and read commands
  • Set command format: AT+<CMD>=<param> — success returns OK\r\n, failure returns ERR\r\n
  • Read command format: AT+<CMD> — success returns +<CMD>:<param>\r\nOK\r\n, failure returns ERR\r\n
  • Invalid or unsupported commands return ERR\r\n or ERROR\r\n

Command List

Note: All commands end with \r\n. In the serial assistant, enable the “Append CR/LF” option, or enter the full command such as AT+BLENAME\r\n. The AT command set below is continuously being expanded; contact us if you need new features.

Command Function Response Notes
AT AT test; returns ok when communication is normal \r\nok\r\n
AT+RESET Save configuration and restart the chip \r\nok\r\n
AT+VER Query module software version \r\n +VER=**** \r\nOK
AT+BLENAME Query current BLE Bluetooth name \r\n +NAME=**** \r\nOK
AT+SPPNAME Query current SPP Bluetooth name \r\n +NAME=**** \r\n OK Effective only in BLE & SPP dual-mode versions
AT+BLEMAC Query module BLE MAC address \r\n +MAC:********** \r\n OK
AT+SPPMAC Query module SPP MAC address \r\n +MAC:********** \r\n OK Effective only in BLE & SPP dual-mode versions
AT+UUID Query all UUIDs on the chip
AT+PIN Query pairing PIN \r\n +PIN=****** \r\n OK
AT+BLENAME=XXXX Set BLE channel Bluetooth name; takes effect after reset \r\nok\r\n
AT+SPPNAME=XXXX Set SPP channel Bluetooth name; takes effect after reset \r\nok\r\n