Lyngdorf TDAI-2170 User manual

Serial Control Manual
TDAI-2170

Serial Settings
The serial port settings are always 8 data bits, no parity and one stop bit with a baud rate of 115200.
Commands and Requests
All commands and requests start with the ‘!’ character.
Commands end with a combination of the Carriage Return character (ascii 0x0D, referred to as
<CR> in this document) and Line Feed (ascii 0x0A, <LF>). Often, a single <CR> is used, but
because different systems handle these characters differently, it is also allowed to end with <LF>,
<CR><LF> or even <LF><CR>. In this document, it is expected to be <CR><LF>, but all of these
combinations are allowed instead.
Requests end with the character ‘?’ and <CR><LF> (or any <CR><LF> combination as above).
Both commands and requests can have parameters, these are enclosed in parenthesis.
Replies to a request are formatted as the request with the reply values as parameters. Replies always
use the <CR><LF> combination of line-end characters.
Commands and requests are not case sensitive.
In addition, it is possible to subscribe to status changes from the device. In this situation, whenever
a status has changed (new source, new voicing etc.) the device will send a status. This status is
formed exactly like a reply to a request, except it is followed by the character '!' before the
<CR><LF> to indicate, that this is an asynchronous message, not a reply.
!COMMAND<CR><LF>
Command
!COMMAND(param)<CR><LF>
Command with parameter
!REQUEST?<CR><LF>
Request
!REQUEST(param)?<CR><LF>
Request with parameter
!REQUEST(reply)<CR><LF>
Reply to a request
!REQUEST(status)!<CR><LF>
A status, which has changed
Commands and requests which are malformed or has invalid parameters will just be ignored. If a
command or request is correct but followed by garbage before the line end chracter(s), the
command or request will be executed and the garbage ignored.

Requests
The following requests are available on the TDAI-2170:
Request name
Action
Reply
!VER?<CR><LF>
Requests the SW version
!VER(1.23a)<CR><LF>
If the version is 1.23a
!DEVICE?<CR><LF
>
Requests the type of device
A TDAI-2170 will reply with:
!DEVICE(TDAI-2170)<CR><LF>
!PWR?<CR><LF>
Requests the current power
state.
!PWR(OFF)<CR><LF>
or
!PWR(ON)<CR><LF>
!VOL?<CR><LF>
Requests the current volume.
!VOL(v)<CR><LF>
Where the value of v is the volume
ranging from -999 to 120 in steps of 0.1
dB.
!MUTE?<CR><LF>
Requests the mute status.
!MUTE(ON)<CR><LF>
or
!MUTE(OFF)<CR><LF>
!SRC?<CR><LF>
Requests the currently selected
input source.
!SRC(n)<CR><LF>
Where n is the currently selected source.
For possible values see “Appendix A:
Input Source Numbering.”
!SRCNAME(n)?<CR
><LF>
Requests the name of input
source number n. For legal
values of n see the table in
“Appendix A: Input Source
Numbering.”
!SRCNAME(n,Name)<CR><LF>
Where n is the number of the input
source and “Name” is a string with the
name of the requested input source.
!SRCENABLED?<C
R><LF>
Requests the list of input
sources which are enabled by
the user.
!SRCENABLED(b)<CR><LF>
Where b is a bitmask indicating which
source inputs are enabled by the user.
Bit0 (LSB, rightmost bit in the string)
indicates the status for source input 0 etc.
!VOI?<CR><LF>
Requests the currently selected
voicing.
!VOI(n)<CR><LF>
Where n is the selected voicing. For
possible values see “Appendix B:
Voicing Numbering”

!VOINAME(n)?<CR
><LF>
Requests the name of voicing
number n. For legal values of n
see “Appendix B: Voicing
Numbering”
!VOINAME(n,Name)<CR><LF>
Where n is the number of the voicing and
“Name” is a string with the name of the
requested voicing.
!VOIENABLED?<C
R><LF>
Requests the list of which
voicings are enabled in the
device.
!VOIENABLED(b)<CR><LF>
Where b is a bitmask (16 bits) indicating
which voicings are enabled by the user.
Bit0 (LSB, the rightmost bit in the string)
indicates the status for Voicing 0
(Neutral), Bit1 for Voicing 1 etc. Voicing
0 (Neutral) is always enabled.
!RP?<CR><LF>
Requests the currently selected
RoomPerfect position.
!RP(n)<CR><LF>
Where n is the currently selected
position.
0 = Bypass
1-8 = Focus positions 1-8
9 = Global
!RPSTATUS?<CR><
LF>
Requests the status of filters in
the RoomPerfect module.
!RPSTATUS(b)<CR><LF>
Where b is a bitmask (8 bits) indicating
which focus positions are present. Bit0
(LSB, the rightmost bit in the string)
indicates whether Focus1 is present, Bit1
indicates Focus2 etc. If any Focus
positions are present, the Global filter
will also be available.
Example:
!RPSTATUS(00000101)
In this example Focus 1 and Focus 3 are
present, and since there are focus
positions, the global position will also be
present.

Commands
The following commands are available on the TDAI-2170.
Command name
Action
!OFF<CR><LF>
Turns the amplifier off.
!ON<CR><LF>
Turns the amplifier on.
!PWR<CR><LF>
Toggles power on the amplifier. Same functionality as the
standby button on the front.
!VOLDN<CR><LF>
Decreases the volume 1 step (0.5 dB).
!VOLUP<CR><LF>
Increases the volume 1 step (0.5 dB).
!VOLCH(d)<CR><LF>
Changes the volume by the deltavalue d. An example to turn
down the volume by 3.2 dB:
!VOLCH(-32)<CR><LF>
Note: This function will handle volume in steps of 0.1 dB!
!VOL(n)<CR><LF>
Sets the volume to the value n, where n is between -999 and
120. If n is higher than the maximum volume, volume will be
set to the maximum volume.
Note: This function will handle volume in steps of 0.1 dB!
!MUTEON<CR><LF>
Mutes the amplifier.
!MUTEOFF<CR><LF>
Demutes the amplifier.
!MUTE<CR><LF>
Toggles mute.
!SRCDN<CR><LF>
Selects the previous enabled input source. Same functionality
as rotating the input selector on the front counterclockwise.
!SRCUP<CR><LF>
Selects the next enabled input source. Same functionality as
rotating the input selector on the front clockwise.
!SRC(n)<CR><LF>
Selects the source n if it is enabled. For valid values of n refer
to “Appendix A: Input Source Numbering.”
!SRCALL(n)<CR><LF>
Selects the source n even if it is not enabled. For valid values
of n refer to “Appendix A: Input Source Numbering.”
!RPDN<CR><LF>
Selects the previous RoomPerfect position.
!RPUP<CR><LF>
Selects the next RoomPerfect position.
!RPBP<CR><LF>
Selects the RoomPerfect Bypass position, if it is enabled.

!RPFOC(n)<CR><LF>
Selects RoomPerfect focus position n, where n is between 1
and 8.
!RPGLOB<CR><LF>
Selects the RoomPerfect Global position.
!VOIDN<CR><LF>
Selects the previous voicing.
!VOIUP<CR><LF>
Selects the next voicing
!VOI(n)<CR><LF>
Selects voicing number n. For possible values see “Appendix
B: Voicing Numbering”
!SUBSCRIBE<CR><LF>
Activates subscription mode. After sending this command,
status changes in the device will cause a status information to
be sent. The following status changes will cause a status
information:
Input changed
RoomPerfect position changed
Voicing changed
Device has powered on or off
Device has been muted or demuted
Subscription mode is active until power has been removed
from the device or unsubscribe command has been received.
!UNSUBSCRIBE<CR><LF>
Deactivates subscription mode. No more status information
will be received.
!SUBSCRIBEVOL<CR><LF>
Activates subscription mode for volume information. After
receiving this command, the device will send information
whenever the volume has been changed on the device.
Volume subscription mode is active until power has been
removed from the device or unsubscribevol command has
been received.
!UNSUBSCRIBEVOL<CR><LF>
Deactivates volume subscription mode.

Appendix A: Input Source Numbering
The following table shows which numbers corresponds to which inputs.
Number
Source Input
0
Coax Digital 1
1
Coax Digital 2
2
Optical Digital 3
3
Optical Digital 4
4
Optical Digital 5
5
Optical Digital 6
6
USB Input
7
HDMI Input 1
8
HDMI Input 2
9
HDMI Input 3
10
HDMI Input 4
11
HDMI Audio Return Channel (ARC)
12
Analog 1 (RCA on main board)
13
Analog 2 (RCA on main board)
14
Analog 3 (RCA on extension board)
15
Analog 4 (RCA on extension board)
16
Analog 5 (RCA on extension board)
17
Analog 6 (XLR on extension board)

Appendix B: Voicing Numbering
This table shows which numbers corresponds to which voicings.
Number
Voicing
0
Neutral
1
Music 1
2
Music 2
3
Relaxed
4
Open
5
Open Air
6
Soft
7
Action 1
8
Action 2
9
Movie
10
Action Movie
11
News
12
Bass 1
13
Bass 2