Aurora HT Series User manual

HT Series Protocol Guide v1.2.4
HT Series Protocol Guide v 1.2.4

HT Series Protocol Guide v1.2.4
Revision History
Version
Number
Revision
Date
Description of Changes
1.0.0 12 - 8 - 2019 Initial Version.
1.2.0 9 - 9 - 2019 Button Modes
Audio routing Commands
Audio Volume Commands
TCP Commands
Updated Internal Commands
1.2.1 17 - 9 - 2019
Updated RPC command SetExtenderMode.
Updated TCP command set_remote_session.
Added new IR commands (!**VS_* and ?**VS_*).
Response for all serial commands has been modified to
terminate with <cr> (\r or 0x0D).
1.2.2 8-11-2019
Added RPC, Serial and Telnet Commands for all pending
commands
This document is compatible with firmware with command API
version 1.2.4
1.2.3 11-6-2021
Add HDCP capability commands.
This document is compatible with firmware with command API
version 1.2.5.
1.2.4 7-8-2022
Cleaned up RPC and TCP commands, added RPC URL
Improved wording of public commands
Fix in section 1.1

HT Series Protocol Guide v1.2.4
Contents
1 Control Commands 4
1.1 Serial commands 4
1.2 Serial Query Commands 12
1.3 RPC Commands 18
1.4 TCP Commands 31
2 Miscellaneous Error! Bookmark not defined.
2.1 Device firmware update. Error! Bookmark not defined.
2.2 File-System & FTP Server. Error! Bookmark not defined.

HT Series Protocol Guide v1.2.4
1. Control Commands
Min API command version: 1.2.5
1.1 Serial commands
The serial command can be issued by the user via the local serial port of the device. !**
is the command header used to specify the device. If !** is given as !20, then the command is
intended for the TX/HTW devices. If the header !** is given as !30, then the command is
intended for RX devices.
These commands are mainly used to control/configure the device. To query the device status/
configuration, refer Serial Query Commands.
If both TX and RX devices are connected, then the user can send serial commands from TX
to RX by providing the serial header as !30. The TX will ignore the command and send it to
the remote device. The remote RX will process the command and send the response back to
the TX. The TX will output this response to the user. Similar is the case when !20 commands
are issued to RX.
Note:
●By default, the configuration of the local serial port is Baud = 115200, Data bits = 8,
Parity = None, Stop bits = 1.
Serial
Command String Format Information
Reboot !**REBOOT
Reboots the i.mx RT processor. Response:
~**REBOOT
Bootloader
Update !**BOOTUPDATE
Enable the bootloader update. Response:
~**BOOTUPDATE
Firmware
Update. !**WSUPDATE
Enter firmware update mode. Response:
~**WSUPDATE
Set Web
Server IP
Address
!**IPxxx:xxx:xxx:xxx<cr>
xxx = 000 – 255
Example: !**IP192.168.001.150<cr>
Response: ~**IP192.168.001.150<cr>
Set Web
Server
Gateway
!**GWxxx:xxx:xxx:xxx<cr>
xxx = 000 – 255
Example: !**GW192.168.001.001<cr>
Response: ~**GW192.168.001.001<cr>

HT Series Protocol Guide v1.2.4
Set Web
Server
Subnet
Mask
!**SMxxx:xxx:xxx:xxx<cr>
xxx = 000 – 255
Example: !**SM255.255.255.000<cr>
Response: ~**SM255.255.255.000<cr>
Debug Web
Server
Processor
!**DEBUGWSx<cr>
X = 0 or 1
0 = Off
1 = On
Example: !**DEBUGWS1
Response: ~**DEBUGWS1<cr>
Debug Web
Video
Processor
!**DEBUGMPx<cr>
X = 0 or 1
0 = Off
1 = On
Example: !**DEBUGMP1
Response: ~**DEBUGMP1<cr>
Serial Port
Settings for
external
port
!**SP1,b,d,p,s<cr>
b = Baud Rate 1200, 2400, 4800, 9600, 19200,
38400, 57600, 115200
d = Data Size 7 or 8
p = Parity N, E, O (None, Even, Odd)
s = Stop Bits 1 or 2
Example: !**SP1,115200,8,N,1<cr>
Response: ~**SP1,115200,8,N,1<cr>
Front Panel
Lock !**LOCKx<cr>
X = 0 or 1
0 = Lock is disabled.
1 = Lock is enabled(Front buttons do not work).
Example: !**LOCK1<cr>
Response: ~**LOCK1<cr>
IP mode
change. !**DHCPx<cr>
X = 0,1 or 2.
0 - DHCP mode.
1 - Static IP mode.
2 - AutoIP mode.
Example: !**DHCP1<cr>
Response: ~**DHCP1<cr>
IR carrier
removal at
receiver
side.
!**IR_CARRIER_STRIPx<cr>
Removes the carrier from the IR signal from the
HDBT and outputs to external IR Transmitter.
X = 0 or 1
1 - Removes carrier.
0 - Disabled.

HT Series Protocol Guide v1.2.4
Example: !**IR_CARRIER_STRIP1<cr>
Response: ~**IR_CARRIER_STRIP1<cr>
Note: A device can have IR carrier removal
enabled either at transmitter or at the receiver
side. But not both. So, enabling at TX disables at
RX and vice versa.
IR carrier
inversal at
receiver
side.
!**IR_INVERSEx<cr>
Inverts the IR signal from the HDBT and outputs
to external IR Transmitter.
X = 0 or 1
1 - Inverts carrier.
0 - Disabled.
Example: !**IR_INVERSE1<cr>
Response: ~**IR_INVERSE1<cr>
IR carrier
removal at
transmitter
side.
!**VS_CARRIER_STRIPx<cr>
Removes the carrier in the IR signal from the IR
Remote and outputs to HDBT.
X = 0 or 1
1 - Removes carrier.
0 - Disabled.
Example: !**VS_CARRIER_STRIP1<cr>
Response: ~**VS_CARRIER_STRIP1<cr>
Note: A device can have IR carrier removal
enabled either at transmitter or at the receiver
side. But not both. So, enabling at TX disables at
RX and vice versa.
IR carrier
inversal at
transmitter
side.
!**VS_INVERSEx<cr>
Inverts the IR signal from the IR Remote and
outputs to HDBT.
X = 0 or 1
1 - Inverts carrier.
0 - Disabled.
Note: It is enabled by default.
Example: !**VS_INVERSE1<cr>
Response: ~**VS_INVERSE1<cr>
Audio
Routing !**AUD<route_from>,<route_to> These settings will be saved against the
video source that is currently in selection.

HT Series Protocol Guide v1.2.4
Route From
Linein – 1, Dante – 2, Selected HDMI – 3,
RemoteAudio - 4, ARC - 5, None - 0
Route To
Lineout - 1, Dante - 2, Stream Audio - 3, Remote
Audio- 4
Note: Audio insertion will work only in HTE TX
Example usages
Linein to Lineout
!**AUD1,1
Linein to Dante
!**AUD1,2
Linein to Stream Audio(Only in TX)
!**AUD1,3
Linein to Remote Audio
!**AUD1,4
Video
Routing
!20VID_SRCx<c
r>
X = 0 or 1 or 2
0 and 1 - HDMI.
2 - VGA (Only for HTE - wallplate).
Example: !20VID_SRC1<cr>
Response: ~20VID_SRC1<cr>
Note: Only for HTE-TX and HTW board.
Format the
File system !**FILESYS_DFLT<cr>
Defaults the file system. After defaulting, the
device will reboot with /IR and /wwwpub
directories present.
Example: !**FILESYS_DFLT<cr>
Response: ~**FILESYS_DFLT<cr>
Factory
default
HTE/HTW.
!**WPROC_DFLT<cr>
Factory defaults the HTE/HTW to default
configuration.
The default configuration is:
IP mode = Auto-IP
Static ip = 192.168.1.10
Static netmask = 255.255.255.0
Static gw = 192.168.1.1
Serial conf = 115200-8n1
Password = admin
Button Lock = Disabled

HT Series Protocol Guide v1.2.4
IR Carrier removal = Disabled
IR Carrier reversal = Disabled
Port Processing mode = Extender mode
USB mode (TX/HTW) = Host
USB mode (RX) = Device
Example: !**WPROC_DFLT<cr>
Response: ~**WPROC_DFLT<cr>
USB mode
change. !**USBx<cr>
Change USB mode.
X = 0 or 1.
0 - Host.
1 - Device.
Example: !**USB1<cr>
Response: ~**USB1<cr>
Note:
If a video stream is in progress, then it will be
stopped for a moment.
Note:
Whenever the USB mode is changed, there
will be a ‘0x00’ character in the UART.
Line in
volume !**LINEIN_VOL<0-100><cr>
~**LINEIN_VOL<0-100><cr>
Example: !**LINEIN_VOL88<cr>
Line Out
volume !**LINEOUT_VOL<0-100><cr>
~**LINEOUT_VOL<0-100><cr>
Example: !**LINEOUT_VOL88<cr>
Response: ~**LINEOUT_VOL88<cr>
Linein Mute !**LINEIN_MUTE<cr>
Mutes the Linein
Example: !**LINEIN_MUTE<cr>
Response: ~**LINEIN_MUTE<cr>
Lineout
Mute !**LINEOUT_MUTE<cr>
Mutes the Line out
Example: !**LINEOUT_MUTE<cr>
Response: ~**LINEOUT_MUTE<cr>
Button
Push !**BTN_PUSH<button_num><cr>
Simulates a button push
Example: !**BTN_PUSH1<cr>
Response: ~**BTN_PUSH1<cr>

HT Series Protocol Guide v1.2.4
Button
release !**BTN_REL<button_num><cr>
Simulates a button release
Example: !**BTN_REL1<cr>
Response: ~**BTN_REL1<cr>
Set button
led
!**BTN_LED<button_num>,<press_mo
de>,<color><cr>
Button_num: 1,2, 3
press_mode : press, release
color: r,g,b,y,c,m,w, n
corresponding to red ,green, blue, yellow,cyan,
magenta, white, none
Example/Response:
Example: !**BTN_LED1,p,r
Response: ~**BTN_LED1,p,r
Set button
mode
!**SET_BTN_MODE<button_num>,
<press_mode>,<button_mode><cr>
Button_num: 1,2, 3
press_mode : press, release
button_mode: 1,2,3 corresponding to default,
serial, tcp
Example/Response:
!**SET_BTN_MODE1,p,1
~**SET_BTN_MODE1,p,1
Clear
button
mode
!**CLR_BTN_MODE<button_num>,
<press_mode>,<button_mode><cr>
Button_num: 1,2, 3
press_mode : press, release
button_mode: 1,2,3 corresponding to default,
serial, tcp
Example/Response:
!**CLR_BTN_MODE1,p,1
~**CLR_BTN_MODE1,p,1

HT Series Protocol Guide v1.2.4
Set Button
parameters
!**BTN_PARAM<button_num>,<press_
mode>,<command_mode>,<command
_string>,<port/ip_addr>,<telnet_port><
cr>
Button num 1/2/3(wallplate)
PressMode: p(press) or (release)
Command_mode: t(tcp)/s(serial)
Command_string: string to be send on button
press(500 char max)
Port: (1/2) serial port in case of serial mode
Ip: ip address in case of tcp
Telnet port: in case of TCP mode
!20BTN_PARAM1,P,T,abc123,192.168.1.10,600
0
!20BTN_PARAM1,P,S,abc123,1
Set Serial
Port
Processing
method
!**REMOTE_SESSION<session_identi
fier>,<ip/extender_mode>,<port/var><c
r>
Session Identifier- TC, PP, PV, TS, EX, MN
TC- Telnet client
PP- Push to port
PV- push to var
TS- Telnet Server
EX- Extender
MN- Manual Method
Extender mode has 2 options : default or mirror
!**REMOTE_SESSIONPV,192.168.1.10 var1
!**REMOTE_SESSIONEX,default
Send IR !**SEND_IR<filename>,<Command
name><cr>
Filename: name of the ir file
command name: Name of the command inside
the ir file
Example/Response:
!**SEND_IRsony.wir,ON
~**SEND_IR