Welcome to Arylic's TCP API developer documentation.

The Query and Control Interface is supported by standard TCP/IP Sockets. So unique socket identification on the LAN/WLAN is the pair of the Arylic Device IP Address and the Communication Port. The creation and management of TCP/IP Sockets is no covered in the Scope of this document as this can found in many places on the Internet and in books.

It is a strong recommendation to familise yourself with the Arylic "Web Management Interface". This will enable you to configure the IP address of your Arylic Device and also configure the communications Port for the TCP/IP Socket if required.

Arylic provide a simple development Tool for Windows. You can evaluate these commands without any coding.

The API is working in bi-directional, which means device would send message to TCP client when its status changed. For example, user adjust volume on APP or with remote. The TCP client would receive the volume change message.


The client could connect to device via TCP method on port 8899, and the connection could be remained for sending or receiving data in the future.

Data format

The connecton are bi-directional, so client can send data to device and also will receive data from device. The actual payload are packed into a structured packet in the following format. And normally we define the payload send to device as command and payload received from device as message. The command all will begin with MCU and the message normally begin with AXX (except the PAS function), and then follow with function and param. The function and param are normally a 3 characters text, and add together with + mark, so the payload normally has 11 bytes length. And if the playload is longer than 11 bytes, you need to add an extra & mark in the end. The command and message will have same function name, you need to remember the difference.

For example, when you send MCU+VOL+050 to device, that means set current system volume to 50%, and when you received AXX+VOL+050 and that means current device have volume 50%.

sample packet with payload MCU+VOL+050

0x18 0x96 0x18 0x20
0x0b 0x00 0x00 0x00
0xc1 0x02 0x00 0x00
0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x4d 0x43 0x55 0x2b 0x56 0x4f 0x4c 0x2b 0x30 0x35 0x30 

Packet structure

Name Length Description
header 4 0x18 0x96 0x18 0x20
length 4 Length of the payload, little endian INT. eg: 0x0b 0x00 0x00 0x00 means 11 bytes payload.
checksum 4 Sum of all payload bytes, little endian INT.
reserved 8 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
payload N Command to device or message from device


set system volume to 50


response message for system volume


The commands sent to device would start with MCU+, and then following 3 bytes major type, and then a mark + with a param or minor type or action, anyway. It would be - in some commands.

The message received from device would start with AXX+, and then following 3 bytes major type, and then mark +, and then param or response.

Normally the length of payload would be fixed 11 bytes. For some commands/messages which is longer than 11 bytes, it supposed to be ended with mark &.

Device Information

Basic Information

get device information


response message AXX+DEV+INFSoundSysten_D1C2;release;SoundSysten_D1C2;52414B4F49545F52445F322E34;-36;0;0&

The response of device information are seperated with ;, and the description of each field:

Field in Sample Description
SoundSysten_D1C2 device name
release firmware build type
SoundSysten_D1C2 device SSID which would be seen in hotspot or when setting up network
52414B4F49545F52445F322E34 SSID of connected AP hexed string
-36 RSSI of current AP
0 unkown
0 unkown

More Information

get device information


response message

AXX+INF+INF{ "uuid": "FF31F09E8AFCEBECAF8BF24F", "DeviceName": "SoundSysten_D1C2", "GroupName": "SoundSysten_D1C2", "ssid": "SoundSysten_D1C2", "language": "en_us", "firmware": "4.6.415147", "hardware": "A31", "build": "release", "project": "Rakoso_SA100_V3", "priv_prj": "Rakoso_SA100_V3", "project_build_name": "a31rakoit", "Release": "20220427", "temp_uuid": "B4DE02F28DDB12B0", "hideSSID": "1", "SSIDStrategy": "2", "branch": "A31_stable_4.6", "group": "0", "wmrm_version": "4.2", "internet": "1", "MAC": "00:22:6C:1D:D1:C2", "STA_MAC": "00:22:6C:1D:D1:C4", "CountryCode": "CN", "CountryRegion": "1", "netstat": "2", "essid": "52414B4F49545F52445F322E34", "apcli0": "", "eth2": "", "ra0": "", "eth_dhcp": "1", "VersionUpdate": "0", "NewVer": "0", "set_dns_enable": "1", "mcu_ver": "42", "mcu_ver_new": "0", "dsp_ver": "0", "dsp_ver_new": "0", "date": "2023:12:25", "time": "09:03:12", "tz": "8.0000", "dst_enable": "1", "region": "unknown", "prompt_status": "1", "iot_ver": "1.0.0", "upnp_version": "1005", "cap1": "0x305200", "capability": "0x28e90b80", "languages": "0x6", "streams_all": "0xbef022e", "streams": "0xb88002e", "external": "0x0", "plm_support": "0x8016", "preset_key": "10", "spotify_active": "0", "lbc_support": "0", "privacy_mode": "0", "WifiChannel": "9", "RSSI": "-32", "BSSID": "6C:B1:58:35:94:A8", "battery": "0", "battery_percent": "0", "securemode": "1", "auth": "WPAPSKWPA2PSK", "encry": "AES", "upnp_uuid": "uuid:FF31F09E-8AFC-EBEC-AF8B-F24FFF31F09E", "uart_pass_port": "8899", "communication_port": "8819", "web_firmware_update_hide": "0", "ignore_talkstart": "0", "web_login_result": "-1", "silenceOTATime": "", "ignore_silenceOTATime": "1", "new_tunein_preset_and_alarm": "1", "iheartradio_new": "1", "new_iheart_podcast": "1", "tidal_version": "2.0", "service_version": "1.0", "ETH_MAC": "00:00:00:00:00:00", "security": "https\/2.0", "security_version": "2.0" }&

The response will contain most of the device information, and is same with the HTTPAPI getStatusEx.

Network State

get current internet state


response message


To query current internet state of device. And when no internet connction, it would return 000, otherwise 001.

Device will send actively when status changed.

USB Disk

get status of usb device


response message


When no usb disk detected, it will return 000, and when have detected usb disk plugin, will return with 001.

Device will send actively when status changed.

Device control


get current volume


response message


The param of MUT is an integer range from 0 to 100, for example, 030 is for volume 50.

You could send MCU+VOL+GET to get current system volume.




response message


The param of MUT is either 000 or 001, which is unmute or mute.

You could send MCU+MUT+GET to check current state.

Device Name

set device name to apple


response message


When device name changed, you should see this changes on APP or else. And also when you change name on APP, the connected TCP client should also receive this change.

Device Reboot



This command is used to reboot the WIFI module only. And the client connection would be lost.

Reset Factory Settings

reset factory settings


This will reset device to factory. And the client connection would be lost.

Playback Control

Playback Control

pause current playback


response message


Please note that the mark between type and param are -. And considering the different mark would affect the command, have added it with the param in the following table.

The responsed messages would just stand for the playback status, and might have no connection with the command sent.

Param Description
-PUS pause current playback
+PUS toggle play and pause
-PLA resume play, available only when paused
-STP stop current playback
+NXT next track, available only when play list
+PRV previous track, available only when play list
+PUQ start to play last playlist, available only when ever started playback on APP

Playback Mode

set repeat one


response message


The playback mode is defined as following:

Param Description
000 repeat all
001 repeat one
002 repeat all and shuffle
003 shuffle
004 sequence

You could send MCU+PLP+GET to query current mode.


play preset #1


The device support 10 groups of presets, stands for the relative group shown on APP.

Param Description
nnn a number from 1 to 10, to play the preset playlist
NXT play next preset playlist
PRE play previous preset playlist

set current playlist to preset #2


response message


This command will have effect only if the current source support preset. Some known working playlist: Spotify Connect, Internet Radio, TIDAL, QOBUZ.

Playback Information

Current Input Mode

message from device when switch to LINE-IN


The param of PLM is the current playback source, and you could send MCU+PLM+GET to query current input. And response MEA+RDY means the media info is ready.

Param Description
000 Idle
001 AirPlay
002 DLNA
010 online playlist
011 USB playlist
031 Spotify Connect
032 TIDAL Connect (A97 only)
041 Bluetooth
045 Coaxial
047 LINE-IN 2
049 HDMI
053 External Bluetooth
054 Phono
056 Optical 2
057 Coaxial 2
058 ARC
099 Slave mode

Media Information

For media information, the base board will keep query the state. So the TCP client could just monitor the relative messages. And the MCU will only query in period, so client could try to send the query command to update immediately for the current status, and then monitor messages to update.

Another point need to be noted, the information might be not accurate, you need to test with the real condition to determine which one is more suitable.


check current info


response message


This message is short, so normally used to query current progress.

Field Description
curpos milliseconds of elapsed
totlen milliseconds of duration
status current playback status, might be play, stop, pause
loop loop/shuffle mode, please refer to the above Playback Mode

Media Information

get media information


response message

AXX+MEA+DAT{ "title": "4865616C2054686520576F726C642E6D7033", "artist": "4D69636861656C204A61636B736F6E", "album": "4B696E67204F6620506F70", "vendor": "55506E50536572766572", "skiplimit": 0 }&

This message will contain more information of current playback. The field title/artist/album should be comprehensive, and will list some known vendor below, the skiplimit is unkown. All messages are with format hexed string.

Vendor Description
QPlay QPlay
Spotify Spotify Connect
Airplay AirPlay
UPnPServer playlist in UPnP Share
Rhapsody Napster
iheart iHeart Radio
USBDiskQueue USB Disk
vTuner Internet Radio
_RemoteLocal playlist on phone
CustomStream Open Network Stream
RadioParadise Radio Paradise
Prime Amazon Music (A97)
CalmRadio Calm Radio (A97)
SoundCloud Sound Cloud (A97)
SoundMachine Sound Machine (A97)

More Information

get media information


response message


This should be the most completed information for now playing status.

Field Description
type unkown
ch unkown
mode input source, refer to above PLM mode
loop loop/shuffle mode, please refer to the above Playback Mode
eq unkown
status current playback status, might be play, stop, pause
curpos milliseconds of elapsed
offset_pts unkown
totlen milliseconds of duration
Title song title (hexed)
Artist song artist (hexed)
Album song album (hexed)
alarmflag unkown
plicount count of songs in playlist
plicurr current index in playlist
vol current volume
mute mute status

Spotify Status

message from device when spotify started


The SPY message will have param 000 when spotify stopped, and 001 when spotify started.

Passthrough Function

The device is composed with 2 parts, the WiFi module and the base board. The basic functions described above will work with the WiFi module, so all devices have the same WiFi module (for example A31) will have same API.

And the passthrough function which is used for the client to communicate with the MCU on base board directly, and which have an extended function set which will work with the base board and might be different for various models.

Extended EQ function

sample command


response message

Function Description
EQGet query current EQ, no param
EQSet:{type}:{value} set EQ
EQ:{type}:{value} current EQ
Param Description
{type} will be treble or bass
{value} a number 0 ~ 10 which stands for -5 ~ 5 on APP (actually gain -10dB ~ +10 dB).

AP8064 platform

sample command


response message


Models including the PRO v1/2, AMP v1/v2 and some A50/S50 are based on an old platform AP8064. Commands will be sent as param of PAS with an identifier: Rakoit:.

Command Ver Description
GetBoard 0 get current board ID
GetCommit 0 get git commit
GetPrompt 0 get current voice prompt settings
SetPrompt:{pmt} 0 enable/disable voice prompt, {pmt} should be 0 or 1
GetAPIVer 1 get API version
SendKey:{key} 1 send key
MaxVolume:Get 2 get max volume
MaxVolume:{mxv} 2 set max volume
VB:INT:{vb_int} 2 set intensity of virtual bass
VB:ENH:{vb_enh} 2 set enhance of virtual bass
VB:SWI 2 toggle virtual bass
VB:Get 2 get on/off state of virtual bass
VB:{en} 2 turn on/off virtual bass
LED:{en} 2 turn on/off LED

BP10XX platform

sample command


response message


Models including MINI V3, PRO v3, AMP v3 and newer are based on platform BP10XX. Command will be sent as param of PAS with an identifier: RAKOIT:. eg: to query system volume, you can send payload MCU+PAS+RAKOIT:VOL&, and will receive message with payload MCU+PAS+RAKOIT:VOL:50&. The extended passthrough function will have some abundant functions with the basic WiFi function, as it shares with the same command set with the UART interface.

For more command details, please refer to UART API.