A54-00001-60759
LUCIA Serial Dongle - RS-232
Quick Start Guide
General
This section describes general features of the LUCIA RS232
protocol. The LUCIA has the following features:
• Volume control
• Mute control
• DSP Matrix control (and thereby source-selection)
• Status readings
About the hardware
GND, TX and RX
The three connections compounds a regular RS232 interface.
GPO
GPO is directly linked to the Lucia amp’s GPO interface
(explained in the Lucia quick start guide).
Preparations
• In order to use the Serial Dongle the Lucia amp must be
updated to software rev:924 or higher.
• In the Lucia Application Browser the control port must be
setup to function RS232.
RS-232 Connection schematic
A RS-232 connection to a LUCIA unit can be established from a
computer via a USB Serial Adapter and a LAB.GRUPPEN Serial
Dongle as sketched below:
Communication Settings
The LUCIA uses 9600 bit/s, 8 databit, no parity and 1 stopbit.
Flow control (software or hardware) are not employed.
Command/Response
All commands/responses are in clear ASCII text and must be
terminated with a <CR> Carriage Return (0x0D).
Synchronization
A single <CR> can be used to empty the LUCIA command buer
to synchronize further communications.
Unknown/Unsupported Commands
If the LUCIA receives an unknown command string, it will
respond with “ERROR UNKNOWN COMMAND”.
Visibility and persistence of settings
Parameters set through the RS-232 protocol are added on top
of the persistent settings of the LUCIA as set by the Application
Browser. Thus RS-232 inicted settings are read with the
available RS-232 status polling commands and are not visible
through the Application Browser. The parameters set through
RS-232 remain when LUCIA enters and exits standby, but
only volume settings for RS-232 control persist when LUCIA
is powered down. Application Browser set settings persist
throughout the power cycle.
Controls
Step output volume up or
down
Command stepvolume [output channels 1 to 4]
[+/- level in dB]<CR>
Function
description
Adjusts the output volume a number of
steps on the given channels. It is possible
to adjust the volume on multiple output
channels at once by using comma as
separator. The step level range is
-100 to 0 dB. When the volume is at
-100 dB the channel is considered muted.
The resolution of the volume control
is 0.5 dB
Usage
examples
One channel stepvolume 1 -2
Multiple channels stepvolume 1,2 -2
Returns
One channel OK STEP VOLUME
CH1:-2
Multiple channels OK STEP VOLUME
CH1:-4 CH2:-2
Error in parameters ERROR STEP
VOLUME
Note: The returned volume level is the
resulting volume level.
Note: If multiple outputs are adjusted the
volume levels are only reported for
available outputs.
Set output volume to a specic level
Command setvolume [output channels 1 to 4]
[level -100 to 0 dB] <CR>
Function
description
Adjusts the output volume to a specic
level for the given channels. It is possible
to adjust the volume on multiple output
channels at once by using comma as
separator. The level range is -100 to 0 dB.
When the volume is at -100 dB the channel
is considered muted. The resolution of the
volume control is 0.5 dB
Usage
examples
One channel setvolume 1 0
Multiple channels setvolume 1,2 -11.5
Returns
One channel OK SET VOLUME
CH1:0
Multiple channels OK STEP VOLUME
CH1:-11.5 CH2:-11.5
Error in parameters ERROR STEP
VOLUME
Note: If multiple outputs are adjusted the
volume levels are only reported for
available outputs.
Mute/Unmute all outputs
Command setmute [state]<CR>
Function
description Mutes or unmutes all outputs
Usage
examples
Mute all outputs setmute 1
Unmute all outputs setmute 0
Returns
Mute all outputs OK MUTE 1
Unmute all outputs OK MUTE 0
Error in outputs ERROR MUTE
Set a matrix patch point gain
Command setmtx [channel in][channel out]:[gain]...
<CR>
Function
description
Sets gain for one or more matrix patch
points. A patch point is specied by input
and output channels concatenated without
separator. It is possible to set multiple patch
points in one go (see usage examples). The
gain range is -31 to 0 dB. When gain is at
-31 dB the patch point is considered unset.
The resolution of the set gain is 0.5 dB
Usage
examples
Patch in1 to out1 setmtx 11:0
Patch multiple
channels
setmtx 11:0
12:-1 22:-2
Unset one patch
point setmtx 11:-31
Returns
Patch in1 to out1 OK SETMTX 11:0
Patch multiple OK SETMTX 11:0
12:-1 22:-2
Unset one patch point
OK SETMTX 11:-31
Error in parameters ERROR SETMTX
Clear matrix and optionally set patch points gain
Command clrmtx [channel in][channel out]:[gain]...
<CR>
Function
description
Clears the matrix (all patch point gains are
set to -31 dB), then sets the gain for one or
more specied patch points. It is possible to
set multiple patch points in one go
(see usage examples). The gain range is
-31 to 0 dB. When gain is at -31 dB the
patch point is considered unset.
The resolution of the gain is 0.5 dB
Serial Dongle
RS-232
Sub-D 9 female
(Looking at the pins
Pin Signal
5
3
2
5
1
6
9GND
TXD
RXD GPIO Port
GND
TX
RX
GPO
LUCIA
Controlling
Device
V2.0.1 09-25-2017
