ARCANA RS232 COMMAND LIST [Arcana FW 0.77 and up]

ARCANA RS232 jack expects the following plug signals: 
TIP  = TX [sends data out from ARCANA]
RING = RX [receives data to ARCANA]
SLEEVE = GND

Parameters: 19200, n, 1, no handshake

Each command must start with #arcana header and must end with a carriage return \r or a newline \n

Each response will have both carriage return \r and a newline \n added in the format <cr><lf>

Use only lowercase characters

A generic RS232 command to write a value:
#arcana set x y
where #arcana is the header and all commands start with this header
set - indicates value will be written to arcana
x - target to be written
y - value or values

A generic RS232 command to read a value:
#arcana get x 
where #arcana is the header and all commands start with this header
get - indicates value will be read from arcana
x - target to be read

The get-command generally first returns the command name and then the value.

Command list [current set-values can be read with the get-command]:

#arcana set hotplug
Hotplugs the source device

#arcana set reboot
Restarts Arcana

#arcana set scalemode x
where x is one of the following:
auto
none
4k60_444_8_dv_hdr10p
4k60_444_8_lldv_hdr10p
4k60_444_8_dv
4k60_444_8_lldv
4k60_444_8_hdr10p
4k60_444_8_hdr
4k60_444_8_sdr
4k60_420_10_lldv
4k60_420_10_hdr
4k60_420_10_sdr
4k60_420_8_lldv
4k60_420_8_hdr
4k60_420_8_sdr
4k30_422_12_lldv
4k30_422_12_hdr
4k30_422_12_sdr
1080p60_12_hdr
1080p60_12_sdr
1080p60_8_sdr
Sets the scaling style for the HDMI video output signal
In auto mode, optimizes according to the best sink capabilities
Ex. #arcana set scalemode auto

#arcana set hdrmode x
where x is one of the following:
auto
off
force4000
force2000
force1000
boost
custom
lldvsync
Controls how the HDR metadata is sent. 
Auto setting uses incoming if available and OFF setting turns off any HDR metadata at the output
Ex. #arcana set hdrmode force4000

#arcana set audiomode x
where x is one of the following:
auto
display
earc
both
Controls audio transmit:
auto -outputs audio depending what is connected 
display -outputs only to the display and mutes eARC TX
earc -outputs via eARC only
both -outputs always from both
Ex. #arcana set audiomode auto

#arcana set unmutedelay x
where x is [on / off]
Adds delay between audio mode change and unmute to remove switching noise/pops
Ex. #arcana set unmutedelay on

#arcana set tvarcdisabled x
where x is [on / off]
Enable or disable routing of the TV ARC audio. When set, all audio will always come from HDMI input only.
Ex. #arcana set tvarcdisabled on

#arcana set tvstandbymute x
where x is [on / off]
Enable or disable eARC TX mute when TV enters a standby mode.
If set, when TV enters standby the eARC TX will mute all audio.
Ex. #arcana set tvstandbymute on

#arcana set hdrcustomvalue x
where x is 0-10000 nits
Modifies the incoming HDR MAXCLL value
This setting is used to replace the incoming metadata or to create the metadata using this value.
Ex. #arcana set hdrcustomvalue 1000

#arcana set hdrboostvalue x
where x is -5000 - +5000 nits
Modifies the incoming HDR MAXCLL value by adding/subtracting this value
This setting is used to replace the incoming metadata or to create the metadata using this value.
Ex. #arcana set hdrcustomvalue 1000

#arcana set lldvtohdrmode x
where x is [on / off]
Adds LLDV data block to the input EDID and modifies video stream to allow HDR conversion
Ex. #arcana set lldvtohdrmode on

#arcana set lldvtohdrprimmode x
where x is [bt2020 / dcip3]
Modifies LLDV data block accordingly
Ex. #arcana set lldvtohdrprimmode bt2020

#arcana set lldvtohdrminlumvalue x
where x is between 0-10000 expressed in 1/1000 nits
Modifies LLDV data block accordingly
Ex. #arcana set lldvtohdrminlumvalue 10
This sets minlumvalue as 10/1000nits = 0.01 nits

#arcana set lldvtohdrmaxlumvalue x
where x is between 0-10000 nits
Modifies LLDV data block accordingly
Ex. #arcana set lldvtohdrmaxlumvalue 4000

#arcana set earcdelaymode x
where x is [on / off]
Activates or deactivates eARC protocol based delay information issues to the sink
Ex. #arcana set earcdelaymode on

#arcana set earcdelayvalue x
where x is 0-255 msecs
When earcdelaymode is ON, this value is sent to the sink
Ex. #arcana set earcdelayvalue 66

#arcana set oledmode x
where x is [on / off]
Sets the OLED display visibility
Ex. #arcana set oledmode on

#arcana set oledfade x
where x is [0-255]
Sets the OLED display fade timer in seconds. After this time OLED goes blank
0 = no fade
Ex. #arcana set oledfade 60

#arcana set osdmode x
where x is [on / off]
Enables / disables osd
Ex. #arcana set osdmode on

#arcana set osdfade x
where x is [0-255]
Sets the OSD display fade timer in seconds. After this time OSD fades out
0 = no fade
Ex. #arcana set osdfade 30

#arcana set osdcolorvalue x
where x is [1 - 31]
Sets the OSD foreground color
Ex. #arcana set osdcolorvalue 20


#arcana set factoryreset 3
ERASE and overwrite default on all settings
Ex. #arcana set factoryreset 3 



-----------------------
The status of the above set commands can be fetched using "#arcana get ..". In addition these commands can be used

#arcana get serial
Returns the Arcana unit serial number

#arcana get ver
Returns the Arcana unit current version number

#arcana get status x
where x is [rx, tx, txcaps, aud, earc, spd]
rx indicate the input video stream received from the HDMI input
tx indicate the outgoing video stream from the HDMI output port
txsink indicate EDID capabilities of the connected sink on the HDMI output
aud indicate the audio stream type going to the sink connected to the HDMI output port
spd indicate the source name coming from the HDMI input
Ex. #arcana get status rx
Gets the current incoming video format

#arcana get audiochtx
Returns the audio channel count for the output. Applies only in LPCM mode

#arcana get audiopcm
Returns the audio mode LPCM / bitstream from the selected input

#arcana get cdsstr
Returns the current connected eARC device CDS string

#arcana get edidtable x
where x is [rx, tx] 
Returns the current 256-byte EDID table of the corresponding port