Communication

Communication test software: sscom32 Mobile Bluetooth connection software: any Bluetooth debug app

Bluetooth: Android requires SPP communication; iOS uses BLE communication Listed Bluetooth devices must include a specific substring in the Bluetooth name: OPBT, TES, EDMI, LAND, TP, SPP, BLE, TOOL OPBT series icon TP series icon

OP Series Command Protocol

Supports communication with the device via serial port or Bluetooth. After modifying commands, you must send a save-configuration command for changes to persist after reboot.

Command Format

**Commands use a JSON-like format; multiple parameters can be set at once. Total command length must not exceed 150 characters. For example:

• {“AtCommandMode”:true}
• {“UartSelectedIndex”:1,“UserConfigSave”:true}

Command Overview

1. Enter command mode: {"AtCommandMode":true} — after a successful entry, the device remains in command mode
2. Set or query parameters
3. To save parameters: {"UserConfigSave":true}
4. Exit command mode: {"AtCommandMode":false}

**The device defaults to transparent transmission mode; to configure parameters, you must enter command mode first

Command List

1. Command Mode Control

Enter command mode

• Command: {"AtCommandMode":true}
• Response: {"OK":true} indicates successful entry into command mode
• Description: After entry, the device stays in command mode; exit command mode to return to transparent transmission mode
• Default: false

Exit command mode

• Command: {"AtCommandMode":false}
• Response: {"OK":false} indicates successful exit from command mode
• Description: After exit, the device returns to transparent transmission mode
• Default: false

2. System Parameter Operations

Restore user factory defaults

• Command: {"UserDefault":true}
• Response: {"OK":""} indicates successful setting
• Description: Restores system parameters to user factory defaults; send a save-configuration command and reboot for changes to take effect

Save current configuration to user storage

• Command: {"UserConfigSave":true}
• Response: {"OK":""} indicates successful save
• Description: Saves current parameters as user defaults

4. Bluetooth Configuration

SPP name query and set

• Command: {"BtSppName":"?"}

• Response example: {"BT Name SPP":"ZENOVATE SPP"}

• Description: Query current SPP Bluetooth name

• Default: “ZENOVATE SPP”

• Command: {"BtSppName":"XXXXX"}

• Response: {"OK":"XXXXX"}

• Description: Set SPP Bluetooth name; maximum 20 bytes; takes effect after reboot

• Default: “ZENOVATE SPP”

BLE name configuration

• Command: {"BtBleName":"?"}

• Response: {"BT Name BLE":"ZENOVATE BLE"}

• Description: Query current BLE Bluetooth name

• Default: “ZENOVATE BLE”

• Command: {"BtBleName":"XXXXX"}

• Response: {"OK":"XXXXX"}

• Description: Set BLE Bluetooth name; maximum 15 bytes

• Default: “ZENOVATE BLE”

PIN code configuration

• Command: {"BtPin":"?"}

• Response: {"BT PIN":"1234"}

• Description: Query current PIN; default is 1234

• Default: “1234”

• Command: {"BtPin":"XXXX"}

• Response: {"OK":"XXXX"}

• Description: Set new PIN; must be a 4-digit decimal number

• Default: “1234”

5. System Parameter Configuration

Temporary baud rate configuration

• Command: {"OP BaudRate":"?"}

• Response: {"OP BaudRate":"9600,N,8,1"}

• Description: Query current temporary baud rate settings; return value is a string

• Default: 9600,N,8,1

• Command: {"OP BaudRate":"9600,N,8,1"}

• Response: {"OK":"9600,N,8,1"}

• Description: Set current temporary baud rate; takes effect immediately; see format below

• Default: 9600,N,8,1

Preset baud rate table query or set

• Command: {"UartSelectedIndex":"?"}

• Response: {"UartSelectedIndex":0}

• Description: Query current preset baud rate index

• Default: 0

• Command: {"UartSelectedIndex":N}

• Response: {"OK":N}

• Description: Set preset baud rate index; N range 0–9

• Default: 0

• Command: {"OP Preset BaudRate":"?"}

• Response example:

{
    "OP Preset BaudRate": [
        "9600,N,8,1",    // Baud 9600, no parity, 8 data bits, 1 stop bit
        "19200,N,8,1",   // Baud 19200, no parity, 8 data bits, 1 stop bit
        "300,E,7,1",     // Baud 300, even parity, 7 data bits, 1 stop bit
        "38400,N,8,1",   // Baud 38400, no parity, 8 data bits, 1 stop bit
        "4800,N,8,1",    // Baud 4800, no parity, 8 data bits, 1 stop bit
        "9600,E,7,1",    // Baud 9600, even parity, 7 data bits, 1 stop bit
        "2400,E,7,1",    // Baud 2400, even parity, 7 data bits, 1 stop bit
        "300,E,7,1",     // Baud 300, even parity, 7 data bits, 1 stop bit
        "9600,N,8,1",    // Baud 9600, no parity, 8 data bits, 1 stop bit
        "19200,N,8,1"    // Baud 19200, no parity, 8 data bits, 1 stop bit
    ]
}

• Description: Query the preset baud rate configuration list

• Command: {"OP Preset BaudRate":["9600,N,8,1","115200,N,8,1",.....]} 10 optical probe baud rate presets

• Response example: {"OK|FAIL":""}

• Description: Set the preset baud rate configuration list; OK = success, FAIL = failure

Baud rate parameter format:

• Baud rate: 300–115200 (300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200)
• Parity: N = none, E = even, O = odd
• Data bits: 5–8
• Stop bits: 0/1 = 1 stop bit, 2 = 2 stop bits

7. Hardware-Related System Information Query and Configuration

Script mode query and set

• Command: {"PythonRunMode":N}
• Response: {"OK":N}
• Description: Set script execution mode; see list below for N N=0: no script N=1: terminal mode N=2: file mode N=3: immediate execution mode

Flash size query

• Command: {"FlashSize":"?"}
• Response: {"FlashSize":"2MB"}
• Description: Query product Flash size (string)

Battery voltage query

• Command: {"BatteryVoltage":"?"}
• Response: {"BatteryVoltage":N}
• Description: Query product battery voltage in millivolts

System voltage query

• Command: {"SystemVoltage":"?"}
• Response: {"SystemVoltage":N}
• Description: Query product system voltage in millivolts

System temperature query

• Command: {"SystemTemp":"?"}
• Response: {"SystemTemp":N}
• Description: Query product system temperature in degrees Celsius × 10; e.g. 246 means 24.6 °C

TP Series Command Protocol

Return battery voltage

• Command: GetBatteryVolt\r\n
• Response: V=3912\r\n

Return TP version number

• Command: version?\r\n
• Response (non-EDMI): OK,VER=01.00
• Response (EDMI): edmi-3.06\r\n

Return OP hardware and firmware version

• Command: BTVERSION\r\n
• Response example: V3.08-585_20241208,V4.1-585_20241208

Set baud rate parameters

• Command: <BaudTra><i|n|p|q|m|r>,<baudrate=300-115200>,<parity=N|E|O>,<datalen=5|6|7|8>,<stopbit=0|1|2>[,]\r\n baudrate=300-15200 parity=N|E|O parity none|odd|even datalen=5|6|7|8 data length 5–8 bits stopbit=0|1|2 stop bits 1|1|2 bits

• Response (EDMI): OK

• Response (non-EDMI): OK,VER=01.00

• Command: <BaudInit>,<baudrate=300-115200>,<parity=N|E|O>,<datalen=5|6|7|8>,<stopbit=0|1|2>[,]\r\n

• Response (non-EDMI): OK,VER=01.00

• Command: \x55\xDE\xF2\xD6\xC1\x91\x5C\x9E\xB8\x31\xBD\x68\x11\x9F\x0D\x0A

• Response: OK\r\n

• Description: AT ON

• Command: \x55\xBE\xD6\xC9\x9C\x21\x4C\x9E\xB6\x32\xBD\xC1\x00\x9F\x0D\x0A

• Response: OK\r\n

• Description: AT OFF

©2007-2024, ALL RIGHTS RESERVED.

English | Español | Français | Deutsch | العربية | 中文 | 日本語