2. Computers & electronics
  3. Audio & home theatre
  4. TV set-top boxes
  5. LOEWE
  6. Control Interface

LOEWE Control Interface User manual

  • Hello! I am an AI chatbot trained to assist you with the LOEWE Control Interface User manual. I’ve already reviewed the document and can help you find the information you need or explain it in simple terms. Just ask your questions, and providing more details will help me assist you more effectively!
Loewe
Control Interface Specification
1
Control Interface Specification
for Chassis SL3xx/SL4xx
V4.1.1
n
Loewe
Control Interface Specification
2
n
1 Revision History
Version Date Name Department Description
0.1 2005-08-05 HG SW TV Initial draft (tentative, not reviewed)
0.2 2006-09-21 AB SW TV Results of review on July 26
th
2006 added
- baud rate setting via service menu
- query values by ‘?’
- add new commands
2006-09-26 HG SW TV Formal changes
0.3 2007-03-16 AB SW TV - all supported port settings added
- bass/treble changed to bass0,bass1/treble0,treble1
- software version added since a command is available
- status values modied
- command “frontkeys” exchanged by “keys”
- Appendix 1 for IR codes added
0.4 2007-03-22 AB SW TV status parameter corrected
0.5 2007-04-26 AB SW TV - command “keys” replaced by command “cong”
- command “data” extended by dierent audio and video parameter
- command “proglist” added
- command “help”: returns only list of available commands, no additional
info for each command
- IR codes for local keys added to IR table (Appendix)
0.6 2007-05-02 AB SW TV - commands “time” and “timer” added
0.7 2007-05-25 AB SW TV - AV channels for prog command: HDR and Photoviewer added
- status command: substatus “uninit” added
- power command: powermode “init” added
- proglist command: parameter avtv and avradio added for reading
additional inputs of tv and radio mode
- increment and decrement for command data added (via +/-)
- notication for command data added.
0.8 2007-05-20 AB SW TV some corrections
1.0 2007-06-06 AB SW TV - proglist command extended for favourite lists
- data command: maxvolume added
2007-06-11 AB SW TV - ir command: value of status bits for single command corrected; ir
sequence for complete key press added
2007-06-19 AB SW TV - data command: favourite added to get/set active favourites
1.1 2007-06-25 AB SW TV notify command: extended to set the format for notications
1.1.1 2007-07-09 AB SW TV - Software version for command “notify format” corrected
Impressum
Loewe Technologies GmbH
Industriestraße 11
D-96317 Kronach
www.loewe.tv
Releasedatum 2018-04-27, V4.1.1
Redaktionsdatum 12/18-1.0 PS
© Loewe Technologies GmbH, Kronach
Die Informationen in diesem Dokument können sich ohne vorherige Ankündigung ändern und stellen keinerlei Verpflichtung seitens der Loewe
Technologies GmbH dar.
Alle Rechte, auch die der Übersetzung, technische Änderungen sowie Irrtümer vorbehalten.
Loewe
Control Interface Specification
3
n
2.0.0 2008-02-14 AB SW TV dynamic menus added
2008-02-22 AB SW TV parameter pip and pipProg added for dynamic menu ‘message’
2008-03-30 AB SW TV command proglist extended by paging and radio favourites
2008-04-01 AB SW TV command timer extended to program a timer for an arbitrary point of time
2008-08-04 AB SW TV some IR codes added to appendix 1
2.0.1 2009-09-03 AB SW TV - ir command: Status bits corrected for simulating a complete key event
- prog command: HDMI3 and MusicBox added to AV channels
3.0.0 2010-06-14 AB SW TV Modications for chassis SL1xx added.
3.0.1 2010-10-21 AB SW TV - Description of RJ12 socket added.
- Settings for Microsoft Windows HyperTerminal added for testing the
interface
- prog command: Browser channel added
3.0.2 2011-06-22 OK LOH - Added new browser command
3.1.0 2011-09-20 AB SW TV epg command added
4.0.0 2013-08-19 AB MW Document updated for SL2xx
4.0.1 2014-01-13 AB MW Error messages for timer command updated.
2014-01-27 AB MW Hint for ir command added.
2014-02-11 AB MW Version info updated
SL3xx
4.0.1
2015-04-30 AB MW SL3xx version created (based on V4.0.1 of SL2xx)
IR codes updated (Appendix 1)
4.0.2 2015-06-17 AB MW power command extended to switch-on the TV set with certain AV input
or station number
4.0.3 2015-08-17 AB MW - dynamic menus added
- ir command supported without status parameter for simulate as short
key press
4.1.0 2015-09-17 AB MW status command: sub-mode “busy” added
4.1.1 2018-04-13 AB Software
Engineering
prog command: SPDIF-in not available for SL3xx/SL4xx
2018-04-13 AB Software
Engineering
Appendix IR code: Code 72 (TV mode on) removed. Code 22 has to be
used.
2018-04-13 AB Software
Engineering
- Pin1 of RJ12 socket corrected (=Modulated RSIG-Signal)
- data command: maxvolume added
2018-04-13 AB Software
Engineering
Terminal for testing: Description for PuTTY added (Hyper Terminal
removed).
2018-04-27 AB Software
Engineering
Pronto hex codes added for RC5 code in Appendix 1
2 Open Items
Loewe
Control Interface Specification
4
n
3 Table of Contents
1 Revision History ............................................................................................................................................................................ 2
2 Open Items .................................................................................................................................................................................... 3
3 Table of Contents .......................................................................................................................................................................... 4
4 Revision History ............................................................................................................................................................................ 6
5 General .......................................................................................................................................................................................... 6
5.1 Differences to chassis SL1xx ...........................................................................................................................................................................6
5.2 Differences to chassis SL2xx........................................................................................................................................................................... 7
6 Requirements.................................................................................................................................................................................7
6.1 Hardware interface ........................................................................................................................................................................................... 7
6.2 Test via terminal program ................................................................................................................................................................................ 8
7 Protocol Format ............................................................................................................................................................................ 8
7.1 Physical Layer ....................................................................................................................................................................................................8
7.2 Data Link Layer ..................................................................................................................................................................................................9
7.3 Application Layer ..............................................................................................................................................................................................9
7.3.1 Common Message Structure .........................................................................................................................................................................9
7.3.2 Command ..........................................................................................................................................................................................................9
7.3.3 Response ......................................................................................................................................................................................................... 10
7.3.4 Notification .......................................................................................................................................................................................................10
8 Message Lists...............................................................................................................................................................................10
8.1 Commands ......................................................................................................................................................................................................10
8.2 Responses ....................................................................................................................................................................................................... 12
8.3 Notifications ..................................................................................................................................................................................................... 13
8.4 Message Details .............................................................................................................................................................................................. 14
8.4.1 data ................................................................................................................................................................................................................... 14
8.4.2 ident .................................................................................................................................................................................................................. 15
8.4.3 ir ......................................................................................................................................................................................................................... 15
8.4.4 notify ..................................................................................................................................................................................................................17
8.4.5 power .................................................................................................................................................................................................................17
8.4.6 prog ................................................................................................................................................................................................................... 18
8.4.7 progdata ........................................................................................................................................................................................................... 19
8.4.8 proglist .............................................................................................................................................................................................................. 19
8.4.8.1 Get the available favourites ............................................................................................................................................................................ 19
8.4.8.2 Get the stations of a favourite or the AV list .................................................................................................................................................20
8.4.8.3 Get program list page by page ......................................................................................................................................................................20
8.4.8.4 proglist notification ......................................................................................................................................................................................... 21
8.4.9 range ................................................................................................................................................................................................................. 21
8.4.10 status ................................................................................................................................................................................................................ 21
8.4.11 time ...................................................................................................................................................................................................................23
8.4.12 timer ..................................................................................................................................................................................................................23
8.4.13 config ................................................................................................................................................................................................................24
Loewe
Control Interface Specification
5
n
8.4.14 help ....................................................................................................................................................................................................................24
8.4.15 version ..............................................................................................................................................................................................................25
8.4.16 msg ...................................................................................................................................................................................................................25
8.4.17 dmenu ..............................................................................................................................................................................................................25
8.4.17.1 Menu type “list” ................................................................................................................................................................................................25
8.4.17.2 Menu type “message” ....................................................................................................................................................................................25
8.4.17.3 Entry points ...................................................................................................................................................................................................... 25
8.4.17.4 Command format ........................................................................................................................................................................................... 26
8.4.17.4.1 Subcommand define ..................................................................................................................................................................................26
8.4.17.4.2 Subcommand content ...............................................................................................................................................................................27
8.4.17.4.3 Subcommand status ..................................................................................................................................................................................28
8.4.17.4.4 Subcommand event ....................................................................................................................................................................................29
8.4.17.4.5 Subcommand entry ....................................................................................................................................................................................29
8.4.17.4.6 Subcommand undefine ������������������������������������������������������������������������������������������������������������������������������������������������������������������������� 30
8.4.17.5 Handling of Dynamic menus ........................................................................................................................................................................ 30
8.4.17.6 Examples ......................................................................................................................................................................................................... 30
8.4.17.6.1 Entry Points ..................................................................................................................................................................................................... 30
8.4.17.6.2 Message ........................................................................................................................................................................................................... 31
8.4.17.6.3 List ..................................................................................................................................................................................................................... 31
8.4.18 browser ............................................................................................................................................................................................................. 32
8.4.19 epg ....................................................................................................................................................................................................................32
9 Configuration Data and Limit Values ......................................................................................................................................... 33
10 AMX ............................................................................................................................................................................................. 34
Appendix 1: IR codes .................................................................................................................................................................................................. 34
Loewe
Control Interface Specification
6
4 Revision History
Document Description
ControlInterfaceSpecication_SL1xx_V3.1.0_20110930.pdf Loewe Control Interface specication for chassis SL1xx.
5 General
This document denes a simple ASCII-based (but 8 bit) control interface via RS-232C.
The protocol has the following properties:
• Simple enough for to be emulated by any terminal program
• Readable command names
• Numbers transferred as ASCII strings, not as binary data
• Asymmetric at the application layer (commands vs. response / notication)
• Asymmetric at the data link layer (one-sided ow control only)
• No error protection
Possible applications are:
• Remote control of TV sets in a hotel installation
• Remote control in a home AV installation
• Remote control of public monitors
• Service (with limitations)
5.1 Differences to chassis SL1xx
• proglist command: The handling of the station list has been completely changed with chassis
SL2xx/SL3xx. There are no more blocks for each front-end in one list. The station list of each
front-end is stored in a separate favourite list. Additionally personal lists can be created which can
contain stations with dierent front-ends in an arbitrary order. So the proglist command still exists,
but it is used in a dierent way. The command is not compatible with SL1xx. See chapter 8.4.8.
• prog command: Due to the new concept of the station/favourite lists also the prog command has
been extended by an optional parameter, the list-name. It is necessary to change to a station of
another favourite.
Please see also the note for AV inputs with negative station numbers in chapter 8.4.6.
• timer command: Due to the new concept of the station/favourite lists also the timer command has
been extended by an optional parameter, the list-name.
Recording to av1 is not possible.
• time command: the local time oset is dened in minutes now, in SL1xx it is dened in hours.
• “data favourite” does no longer exists. To activate a station of another favourite list you have to use
the prog command now: prog [program number] [<”list name”>]
• cong command: ir and frontkeys can be deactivated now also in consumer mode, not only when
hotel mode is active. The ir notication has to be requested explicitly with “notify 1 ir”.
• ir command: With sl1xx most ir keys could be simulated with sending a single ir command with
status value = 3 (rst key press + auto repeat). In SL3xx/SL4xx it is recommended to send
always two ir commands, rst with status value = 3 and the second one with status value = 8 (key
released). See section “Simulate a complete key event” in chapter 8.4.3.
• Dynamic menus
The colour keys are no longer supported due to the new GUI concept of SL2xx/SL3xx/ SL4xx. But
for this the function keys F1, F2, F3 and F4 have been introduced.
n
Loewe
Control Interface Specification
7
5.2 Differences to chassis SL2xx
• Baudrates
SL3xx/SL4xx does not support baudrates with 76800 and 115200 bps. The maximum baudrate is
57600 bps.
6 Requirements
The RS232 interface is supported by SL3xx chassis since version V1.1.14.
6.1 Hardware interface
The RS232 interface is available via an RJ12 socket:
Female connector on the side of TV set,
viewed towards connector pins.
Pin Signal Signal requirements
1 IR-Link Modulated RSIG-Signal
2 GND Ground
3 TxD RS232 Data from TV, Standard RS232 specication
4 NC Not connected
5 RxD RS232 Data to TV, Standard RS232 specication
6 IR from TV VoL < 1.5V
VoH > 3.5V
5V signal, internal 4K7 pull-up resistor in connected device requested.
By default the signal is modulated (veried for remote control with 36 kHz carrier). If any hotel
mode is active the signal is demodulated, but can be congured to demodulated (Hotel menu,
menu item IR Link).
For connecting the TV set to a D-Sub 9 socket an adapter cable is available, Art.No. 70499 001.
The pin mapping of a RJ12-to-D-Sub-9 adapter has to be as follows:
RJ12 Pin D-Sub 9 pin Signal
2 5 GND
3 2 Data from TV
5 3 Data to TV
n
Loewe
Control Interface Specification
8
6.2 Test via terminal program
The interface can be easily tested by using a terminal program. Here are the settings for the open source
program PuTTY at 9600 baud for port COM5:
7 Protocol Format
7.1 Physical Layer
• Bidirectional communication by RS-232C lines TxD and RxD (no control lines used)
• Port settings:
o modes:
- 8 bit async
- 9 bit
- 8 bit parity
o Parity: Even, Odd
o Stopbits: 1 stopbit, 2 stopbit
o Baud rates: 2400, 4800, 9600, 19200, 28800, 38400, 57600 bps
o Default settings are: 9600 baud, 8 bit async, no parity, 1 stopbit
n
Loewe
Control Interface Specification
9
The port settings can be adjusted in the service menu of the TV set, menu item “RS232”, “port
settings”.
This menu can also be opened by pressing the function key on the front panel (M or ) and
simultaneously pressing key ‘7’ of the remote control.
7.2 Data Link Layer
The data link layer uses is an asymmetric, connectionless and line-oriented protocol:
The TV set will read in an entire data line of max. RCI_LINE_LENGTH_LIMIT 8 bit characters, and
interprets it as soon as a line termination character has been received. Both carriage return (CR, 0x0D)
and line feed (LF, 0x0A) character will be accepted as line termination characters, a line feed character
following a carriage return character will be ignored.
The TV set will not mirror received characters, and the counterpart must not mirror any received
characters.
The TV sends either lines terminated by a CR/LF combination, or the prompt character RCI_PROMPT_
CHAR as the rst character of a new line (following a LF character). The counterpart should not send (i.e.
terminate by CR and/or LF) a new line before the RCI_PROMPT_CHAR has been received, but type-
ahead is guaranteed for at least up to another RCI_LINE_LENGTH_LIMIT bytes.
7.3 Application Layer
The application layer transfers messages. The message types “command”, “response” and “notication”
exist. This classication has no eect on the notation of the messages. It describes only the functionality of
the messages sent to or received from the TV set.
7.3.1 Common Message Structure
A message consists of a message id followed by a space character, and optionally followed by a list of
parameters.
The message id is a text string conforming to the pattern [A-Za-z][A-Za-z0-9_]*.
Parameters are decimal or hexadecimal numbers or text strings separated by a space. Numbers are
decimal by default, hexadecimal numbers are preceded by a single ASCII quote.
Strings must be enclosed in double quotes if they contain spaces. The following control characters are
supported using the backslash:
“\n”: line feed
“\r”: carriage return
“\t”: tab
“\\”: backslash
“\””: double quote
The meaning of a parameter depends on its position in the list.
In the following required parameter are described in squared brackets ([...]). Optional parameters are
enclosed by curly brackets ( {...}) additionally.
7.3.2 Command
A command is sent to the TV set. It consists of one single line.
n
Loewe
Control Interface Specification
10
7.3.3 Response
A response is sent by the TV set immediately after receipt of a command. It may consist of one or more
lines, the last line followed by the prompt character RCI_PROMPT_CHAR.
The content of the response to a valid command will be specic for that command, and has to be specied
for each command. If an immediate response is not possible, only a RCI_PROMPT_CHAR will be sent for
to allow subsequent commands, but the proper reply will be sent as a single notication later on. This is to
be specied in each case.
On receipt of an invalid command, the ASCII “?” will be displayed (followed by CR/LF and RCI_PROMPT_
CHAR as specied above).
7.3.4 Notification
Notications will be sent by the TV set depending on specic events, provided the specic notication has
been enabled by a preceding command. Notications are terminated with CR/LF and the prompt character
RCI_PROMPT_CHAR.
Since the RS232 version V1.1 the leading and/or trailing string for notications can be dened arbitrarily.
See the denition of the notify command.
8 Message Lists
Notes:
• All numbers in messages are ASCII, there are no binary data.
• Message texts are case-signicant.
• The space character is generally used as a word separator. Strings in parameters have to be
quoted if they contain spaces.
• Variable 8-bit text strings in message parameters are UTF-8 encoded unless specied otherwise.
Any xed texts are plain 7 bit ASCII.
8.1 Commands
For a detailed description of parameter values, see the additional tables/chapters under 8.4 Message
Details. Parameters in curly braces are optional. The column “SL1xx Version” contains the software version
of SL1xx chassis since the command is available.
Note: A command is always backward compatible when new features have been implemented with new TV
software! This is valid at least for a chassis generation.
Standby and Wakeup Commands:
Due to the standby concept not all commands are supported in standby. There are two dierent types of
commands which are supported in standby:
• Standby commands: Commands which are handled by the standby controller completely. There will be
no signicant delay for the response of the TV set.
• Wakeup commands: Commands which are accepted by the standby controller but which have to be
handled by the main controller (e.g. for reading the program list via command proglist).
For this the main controller is waked up (without picture and sound). After it has been booted the
n
Loewe
Control Interface Specification
11
n
command is handled. The boot up time is dierent for the dierent SL1xx chassis. Example: Chassis
SL121 has a boot up time of about 7 seconds!
If there are no further commands for 5 seconds the main controller is switched o again. The dierent
standby power states can be evaluated by the status command (see chapter 8.4.10).
The standby command type is described in the following table in the column “standby type”:
standby = Standby command
wakeup = Wakeup command
none = Command is not supported in standby at all.
Id Parameters Example RS232
version
SL3xx
version
standby
type
browser [command] [param] browser 0 http://www.
loewera.de
V 3.1 PV1.1.14 none
cong [ir 0/1/?] [localkeys 0/1/?] cong keys ir 0
localkeys 0
V1.0 PV1.1.14 standby
data [name] [values] ... [name] [values] data volume 17 V1.0 PV1.1.14 none
dmenu [dene/content/status/entry/undened] …
see chapter 8.4.17
V2.0 PV1.1.14 none
epg s [station number} epg s 1 V3.1 PV1.1.14 none
help help V1.0 PV1.1.14 standby
ident ident V1.0 PV1.1.14 standby
ir [system] [subsystem] [command] [status]
Since HL1 version V2.1.X the command is supported
without status parameter to simulate a single (short)
key press, but only when the TV is active, not in deep
standby:
[system] [subsystem] [command]
ir 0 0 1 3
ir 0 0 1
V1.0
V4.1
PV1.1.14
PV2.1.22
standby
msg [message text] msg “Hello world!” V1.0 PV1.1.14 none
notify [0/1] [id] ... [id] ... [0/1] [id] ... [id] notify 1 status prog 0 ir V1.0 PV1.1.14 wakeup
format [0/1/2/3] {[string]} {[string]} notify format 1 “\r\n!>” V1.1 PV1.1.14
power [o/tv/audio/radio/photo] power tv V1.0 PV1.1.14 wakeup
Optional parameter for “power tv”
tv {[program number]}
power tv -6 V4.0.1 PV2.0.17
prog [program number] prog 1001 V1.0 PV1.1.14 none
prog number -22 = MusicBox V2.0 PV1.1.14
prog number -13 = HDMI3 V2.0 PV1.1.14
Loewe
Control Interface Specification
12
Id Parameters Example RS232
version
SL3xx
version
standby
type
proglist To get the available favourite lists:
[tvlist/radiolist]
To get the station list of a favourite:
[tv/radio] [<“favourite name”>]
[av]
proglist tvlist
proglist tv “DVB-C”
proglist radio “My Fav1”
V1.0
PV1.1.14 wakeup
- paging [tv/radio/av] [<“favourite name”>] [page size]
- page [rst/last/next/+/prev/-]
- page [page number]
- page prog [program number]
- proglist paging tv
“DVB-C” 10
- proglist page +
- proglist page 10
V2.0 PV1.1.14 none
range [name] range volume V1.0 PV1.1.14 none
status status V1.0 PV1.1.14 standby
time [?]
[yyyy-mm-dd] [hh:mm:ss] {[local time oset]}
time 2007-05-31
10:30:00 60
V1.0 PV1.1.14 none
timer [add] [hdr] [station number] [duration] {<”list-name”>} timer add hdr 1 90 V1.0 PV1.1.14 wakeup
add [hdr] [station number] [date] [start time] [stop time]
{<”list-name”>}
timer add hdr 2 2008-
03-28 20:15 22:00
version version V1.0 PV1.1.14 standby
To request a parameter value a question mark has to be inserted instead of the value. The question mark is
not necessary (but valid) if the command has no parameter.
Examples:
data volume ? bass0 ? treble0 ?
data volume ?
status ?
status
Invalid:
data volume bass0 treble0
8.2 Responses
Id Parameters Example
data [name] [value] {[name] [value] ....} data volume 17
help [list of all supported commands] help cong
data
...
version
ident [type] [version] ident SL320 V4.1.0
ir [system] [subsystem] [command] [status] ir 0 0 1 ‚02
keys ir [0/1] local [0/1] keys ir 0 local 0
prog [program number] prog 1001
n
Loewe
Control Interface Specification
13
n
Id Parameters Example
proglist List of available favourites:
[tvlist/radiolist/avlist] [number of lists] [<”list name #1”>]
[<”list name #2”>] ... CR/LF
List of stations of a favourite:
[tv/radio] [<”list name”>] [number of programs] [program number] [program
name] CR/LF
[program number] [program name] CR/LF
...
[program number] [program name]
[av] [“<AVlist>”] [number of AV inputs] [input number] [input name] CR LF
...
[input number] [input name]
proglist tvlist 3 “DVB-C” “Analog”
“My Fav1”
Hint: The station name is encoded
in UTF-8 format.
proglist [tv/radio/av] [<”list name”>] paging count [number of programs] pages
[number of pages]
proglist [tv/radio] [<”list name”>] [number of programs] page [page number]
[program number [program name] CR/LF
program number] [program name] CR/LF
...
[program number] [program name]
proglist tv “DVB-C” paging count 67
pages 7
proglist tv 10 page 1 1 “Das Erste
HD”
2 “ZDF HD”
3 “RTL”
4 “SAT.1”
5 “ProSieben” ...
range [name] [lower limit] [upper limit] range bass -12 12
status [main] [sub] [pip] [record]
the sub mode “busy” is supported since SL3xx version V2.1.22.0, RS232
version V4.1.0
status tv ttx pipo reco
time [yyyy-mm-dd] [hh:mm:ss] [local time oset] time 2007-05-31 10:30:00 -1
version [protocol version] version 1.2.0
8.3 Notifications
Id Parameters Example
ir [system] [subsystem] [command] [status] ir 0 0 1 3
prog [program number] prog 123
status [main] [sub] [pip] [record]. status tv ttx pipo reco
data [parameter name] [parameter value] data volume 20
proglist changed [tv/radio] proglist changed tv
epg [content: p/f] [station number] [start time] [stop time] „[title]“ „[shortinfo]“ epg p 3 20:15 22:00 „CSI: Miami“
„Episode 75“
Loewe
Control Interface Specification
14
8.4 Message Details
8.4.1 data
This message may be used to query or to set a selection of internal data, mainly user settings. A parameter
value can be modied by a certain value or by incrementing or decrementing.
Format:
data [parameter name] [?/+/-/[value]] {[parameter name] [?/+/-/[value]]...}
Examples:
Query a value: data volume ?
Set a value: data volume 25
Increment a value: data volume +
Decrement a value: data volume –
Parameter name Contents Value Range
volume volume value 0..99 (maximum)
Hint: The user setting “maximum volume” is
considered!
maxvolume user dened upper limit for volume 10 .. 99
hpvolume headphone volume
Attention: available since SL3xx V2.2.18.0 and
SL3xx/SL4xx V3.1.2.0 (and higher).
0 ..99
mute mute on/o
Increment/decrement with +/- is not supported.
0/1
bass0 bass value for custom music sound -12 .. +12
bass1 bass value for custom movie sound -12 .. +12
treble0 treble value for custom music sound -12 .. +12
treble1 treble value for custom movie sound -12 .. +12
brightness brightness value for current video mode 0 .. 20
contrast contrast value for current video mode 0 .. 20
color color value for current video mode 0 ...20
sharpness sharpness value for current video mode 1 .. 5
3Dmode Switching on/o 3D and selecting the mode o / auto / sbs / tb
auto: automatic
sbs: side by side
tb: top/bottom
The permitted range of values may be queried by the corresponding range message.
Data values can also be activated for notication. Whenever a value of any parameter is modied a data
notication for the modied parameter is sent.
n
Loewe
Control Interface Specification
15
8.4.2 ident
The parameter list is a sequence of readable text strings. The rst string identies the TV type, the second
one the software version.
8.4.3 ir
This command allows to emulate infrared remote control commands when used as a command, or to
check the infrared receiver and decoder by monitoring notications of received infrared commands.
Via the status byte the ir receiver can be disabled. That means all commands received from the remote
control are ignored for TV control, but are forwarded as ir notication (if enabled). Only the ir commands
received from the control interface are handled by the TV set. So the external control device connected to
the control interface decides which ir commands are relevant.
Additionally the local keys are disabled. The events are not forwarded as ir notications!
Hint: After power o/on via main switch the keys are enabled again. To disable key permanently use the
command cong.
parameter: [system] [subsystem] [command] {[status]}
Since the SL3xx version V2.1.x the command is also supported without the status parameter to
simulate a short key press, but only when the TV is active, not in deep-standby.
For the relevant system, subsystem and command codes see Appendix 1.
status:
bit 0: rst command in sequence
bit 1: auto-repeat command
bit 2: delayed command; it denes once that a key has been pressed for more than 600 ms.
bit 3: key released
bit 4: IR receiver disabled
bit 4 – 7: don’t care (have to be zero)
To simulate a single IR command bit 0 and bit 1 has to set.
Example:
“TV on”
ir 0 0 22 3
To disable/enable the IR receiver an ir command has to be sent with bit4 = 1/0. To avoid any action by the
ir command use the following ones:
disable the ir receiver: ir 0 0 0 16
enable the ir receiver: ir 0 0 0 0
Simulating a complete key event
Some OSD elements or device controller evaluates the ir status in detail for dierent function. Examples:
• When the play key is pressed only short the HDR playback is started, if it pressed longer a
bookmark is set.
• OK key: Short press opens the small station list, long press opens the extended station list
n
Loewe
Control Interface Specification
16
For this the internal ir status is updated every 110 ms as long as IR signals are received from the remote
control. As the processing of the RS232 command can’t be guaranteed in the same way as the remote
control the update of the status has to be handled by the external application.
The status sequence dependent from the time the key is pressed is described below:
Time Status bits Status value
rst auto-repeat delayed key released
0 ms 1 1 3
110 ms 0
220 ms 0
330 ms 0
440 ms 0
550 ms 1 2
660 ms 1 1 6
770 ms 1 2
...
n * 110 ms 1 2
key is released 1 8
A complete key press exists at least of two ir commands, because the release of the key also has to be
sent. All other status settings only have to be sent, when the key has been pressed for the stated time.
ATTENTION: With SL3xx/SL4xx for several keys at least two ir command (rst with status value = 3,
second with status value = 8) has be sent to be sure that it will be handled by the TV set (e.g. for the
digit keys 0 – 9).
Example for digit key 1:
ir 0 0 1 3
ir 0 0 1 8
It is recommended always to send two commands to simulate a complete key event.
Since the SL3xx version PV2.1.x a short key press can be simulated with a single ir command without the
status parameter. So you can avoid sending two commands with status = 3 and status = 8.
Example for digit key 1:
ir 0 0 1
Hint: If the ir receiver is disabled (“ir 0 0 0 16”) and the notication for the ir command is activated
(“notify 1 ir”), the exact sequence is sent via RS232 when a key of the remote control is pressed.
The ir notication can’t be enabled by activating all notication (“notiy 1”), it has to be activated
explicitly with “notify 1 ir”.
n
Loewe
Control Interface Specification
17
8.4.4 notify
Notications are not sent automatically, but only on request. This message allows to enable or disable
specic notications. Only those messages listed in chapter 8.3 can be enabled.
Notications will be sent once after enabling a notication, and whenever the information has changed.
Format:
notify [0/1] {[id] ... [0/1] [id]...}
To activate/deactivate all notications notify 1 / notify 0 can be used.
Hint: The epg notication for present/following and the ir notication can’t be activated with notify 1 due
to the amount of data (e.g. for epg sent with every channel change). It has to be activated explicitly with
notify 1 epg / notify 1 ir. , but it is deactivated with notify 0.
Since the RS232 version V1.1 the leading and/or trailing strings for notications can be dened arbitrarily.
This might be necessary to distinguish notications from responses when using command sequences.
notify format [format: 0/1/2/3] {[string1] [string2]}
format:
0: Standard format. Notications are terminated by CR/LF and the prompt character.
1: Notications are sent with a trailing string dened by string1.
2: Notications are sent with a leading string dened by string1.
3: Notications are sent with a leading string dened by string1 and a trailing string dened
by string2.
The strings are limited by a maximum of 5 characters. The format parameter can’t be used in combination
with the parameter to enable/disable notications.
Examples:
notify format 0
notify format 1 “\r\n!>”
notify format 2 “!”
notify format 3 “@” “\r\n@>”
8.4.5 power
This command is used to switch the tv set to certain operation states:
parameter description
init If the TV is in standby after rst power on (via main switch) the program list is not initialized (amongst
others), so it is not available with the command proglist. In this case the command “power init” can
be used to start the TV without picture and sound. When the initialization is done the TV returns to
standby automatically. This can be evaluated with the command status.
If the TV is already initialized the command “power init” has no eect. The current state of the TV set
is not changed in this case.
o Switch tv to standby. If a record is active the TV will change to “active” mode only.
n
Loewe
Control Interface Specification
18
parameter description
tv {[program number]} Switch tv on with the last active tv channel.
Available since HL1-Version V2.0.17.0 (or higher):
[program number] is an optional parameter and can be used to switch-on the TV set with a certain AV
input or program number (of the last active station list).
Example:
Switch-on the TV set with HDMI 1:
power tv -6
audio Switch tv to radio mode with inactive screen (= audio mode) reproducing sound of last radio channel.
radio Switch tv to radio mode with active screen (=radio mode) reproducing sound of last radio channel.
For evaluating the current power mode use command “status”.
8.4.6 prog
This message may be used to query the current program number (if used without parameters), or to
request a switchover to a specic program number of a certain favourite. The message will be conrmed
immediately by a single RCI_PROMPT_CHAR, and a single prog notication containing the current
program number will be sent when the program change has either been completed or rejected. For to nd
out whether the request has been accepted, the returned program number has to be compared with the
requested program number.
Format:
prog [program number] {<”list-name”>}
If no list-name is added the TV changes to program number of the current active favourite.
Negative program numbers are reserved for AV channels. In this case no list-name has to be added.
NOTE: With an AV input also the favourite “AV list” is active. When it is active the command prog without
a list name will execute a change to another input of the AV list (e.g. “prog 2” will change to HDMI2). That
means: When an AV input is active you have to add the list-name always to change to a TV channel.
number AV channel additional information
-1 AV1
-2 AV2 Not available in SL3xx/SL4xx
-3 AV3 Not available in SL3xx/SL4xx
-4 AVS
-5 VGA (=PC-In)
-6 HDMI1
-7 HDMI2
-8 COMP-IN-1 Not available in SL3xx/SL4xx.
-9 COMP-IN-2 Not available in SL3xx/SL4xx.
-10 Audio-In-1
-11 Audio-In-2 Not available in SL3xx/SL4xx.
n
Loewe
Control Interface Specification
19
number AV channel additional information
-12 Audio-Digital-In (SPDIF In) Not available in SL3xx/SL4xx.
-13 HDMI3
-14 HDMI4
-15 to -19 reserved
-20 HDR playback This number is readable only. It can’t be used to start a HDR playback by sending
“prog -20”!!!
-21 Photoviewer This number is readable only. It can’t be used to start the Photoviewer.
-22 Musicplayer This number is readable only. It can’t be used to start the Musicplayer.
-23 Videoplayer This number is readable only. It can’t be used to start the VideoPlayer.
-24 Mediaplayer This number is readable only. It can’t be used to start the Mediaplayer mode.
-25 Internet Brower This number is readable only. It can’t be used to start the Internet Browser.
8.4.7 progdata
not implemented.
8.4.8 proglist
This message is used to get the available favourites and the containing program/stations or the list of the
AV inputs.
The program name is UTF-8 encoded. DVB channels also can contain some special character ([0xC2
0x86] / [0xC2 0x87]) to encode a short name.
[0xC2 0x86]: Begin of part of short name
[0xC2 0x86]: End of part of short name
Example:
[0xC2 0x86]S[0xC2 0x87]uper[0xC2 0x86] RTL[0xC2 0x87]
Long name: “Super RTL”
Short name: “S RTL”
To get the long name removed these special characters.
8.4.8.1 Get the available favourites
First you have to know the names of the available favourites.
Format for command:
proglist [tvlist/radiolist]
Format for response:
Proglist [tvlist/radiolist] [number of lists] [<”list name #1”>]
[<”list name #2”>] ... CR/LF
n
Loewe
Control Interface Specification
20
8.4.8.2 Get the stations of a favourite or the AV list
Via the name of the favourite you can request the list of staprogtions or the name of the AV inputs.
The program number and the program name are replied. The rst parameter of the response always
contains the program type information (tv/radio/av).
Format for command:
proglist [tv/radio] [<”list-name”>]
proglist [av]
Format for response:
proglist [tv/radio] [<”list-name”>] [number of programs] [[program number] “[program
name]” CR/LF]]...
Response for the AV list:
av “<AVlist>” [number of AV inputs] [[input number] “[input name]” CR LF]]...
The string “<AVlist>” is sent because the displayed name in the GUI depends on the selected menu
language, which is not known by the middleware.
8.4.8.3 Get program list page by page
The format of the chapter before is used to get the complete station list.
But it is also possible to request single pages of a favourite. The page size can be dened arbitrarily (2 –
255 items per page). E.g. this could be necessary for external devices without enough memory to store up
to 5000 channels.
For paging the page size has to be dened rst:
proglist paging [tv/radio] [<”list name”>] [items per page]
The TV will response by sending the total number of programs and the total number of pages:
proglist [tv/radio] [<”list name”>] paging count [number of channels] pages [number of
pages]
After this it is possible to navigate within the program list:
proglist page [rst/last/prev(+)/next(-)/<number of page>/
prog <program number>]
Get rst page: proglist page rst
Get last page: proglist page last
Get next page: proglist page next or proglist page +
Get previous page: proglist page prev or proglist page –
Get certain page by number: proglist page [page number]
The page number starts with 1 (rst page) and ends with number of pages (last page).
Get page containing a certain program number:
proglist page prog
<program number>
The program number needs not to be the rst item of the page. It depends on the absolute position of
the program number within the complete list.
n
/