← Back to Support Hub
proStream

Support For Individuals

What we can help with

Get assistance focussed on streaming switchers, UVC, IP and NDI streaming and more. Ask our AI Agent anything to start support session

  • Mini-series devices
  • TAO encoders
  • ASK wireless video

Start a support chat

Tell us your device model and what you need help with, or try a suggested question.

Support Knowledge

Select an article from the menu to view full content here.

API / streamZ/MSP 325N / Data Format Description

Protocol Data Format Description

Applies to

streamZ, MSP 325N

1. The general data format for sending/receiving is as follows

SymbolSize (Byte)DefinitionExample
ADDR1Address (default 0x00)0x00
SN1Command sequence number (for transmission flow control, 0x00-0xFF)0x02
CMD1Command type0x68
DAT11Parameter type 10x01
DAT21Parameter type 20x00
DAT31Parameter type 30x00
DAT41Parameter type 40x00
CHKSUM1ADDR...DAT4 checksum0x6B

CHKSUM = ADDR + SN + CMD + DAT1 + DAT2 + DAT3 + DAT4

Command assembly format for sending (19 characters): '<' + 'T' + 2-digit ADDR + 2-digit SN + 2-digit CMD + 2-digit DAT1 + 2-digit DAT2 + 2-digit DAT3 + 2-digit DAT4 + 2-digit CHKSUM + '>'

Command assembly format for receiving (19 characters): '<' + 'F' + 2-digit ADDR + 2-digit SN + 2-digit CMD + 2-digit DAT1 + 2-digit DAT2 + 2-digit DAT3 + 2-digit DAT4 + 2-digit CHKSUM + '>'

📢  Important

The following Device Connection statement is critical.

Device Connection

Wi-Fi Connection

The device uses UDP broadcast to send commands to IP address 255.255.255.255 on port 2000.

When searching for TAO 1MINI, the device sends a single response to the sender.

📢  Important

All API commands documented in this category MUST be sent to the IP address from which TAO 1MINI sent its initial response.

Bluetooth Connection

  • Connection roles: TAO 1MINI acts as the Bluetooth server, and the connecting device acts as the client.

  • UUID: The UUID agreed upon for TAO 1MINI is fa87c0d0-afac-11ff-8a39-0800200c9a66`.

  • Command transmission: Bluetooth uses the same command format as Wi-Fi.

Format description of send/receive commands with a data block (CMD = 0xE0 or 0xE1)

SymbolSize (Byte)DefinitionExample
ADDR1Address (default 0x00)0x00
SN1Command sequence number (for transmission flow control, 0x00-0xFF)0x02
CMD10xE0 (set parameters) / 0xE1 (read parameters)0xE1
DAT110~255 Parameter type 10x01
DAT210~255 Parameter type 20x00
DAT31Data block length (LSB)0x..
DAT41Data block length (MSB)0x..
CHKSUM1ADDR...DAT4 checksum0x..

The last byte of the data block is the checksum, calculated as the sum of all bytes in the data block. The data block length (DAT3 and DAT4) includes the checksum.

All data blocks are represented in JSON format. The specific fields are described with each command.

📢 Notes: To specify the language, include the {"language":1} field:

  • 1: Chinese
  • 0: English

Currently, only Chinese and English are supported.

Example of a command: JSON data block + CHKSUM {"statusType":1,"statusValue":10,"language":1}b

2. Description of the general data block of received commands

ParameterRequiredTypeDescription
Code*int0 : Success
msg*stringPrompt message from the server, which can be displayed in a Toast
deviceUuid*stringBound device; the uuid issued by the server to the device
data*any

Response data block example

{"code":0,"msg":"success","deviceUuid":"x12345521xxxx","data":{}}

3. The following data is returned when an unsupported command is received or an error occurs

SymbolSize (Byte)DefinitionRemarks
CMD1CMD---
DAT110×FF---
DAT210×FF---
DAT310×FF---
DAT410×FF---