Actions

OldFAQ-en

From trivum

Contents

If TuneIn Favourites/Presets Link Is Unavailable

  There was an temporary protocol change at TuneIn, causing the Favourite Link to disappear.
  If you defined TuneIn favourites but you see no "My Favourites" Link in the menu:
  
  - you may update to the latest V8.63 Beta of the trivum server
    to have the favourites again in all web browser visualizations (webtouch, ipad app v2)
    1. Enter the server web configuration by web browser.
    2. System / Basic Setup: make sure "Use alpha/beta" is checked.
    3. Close Setup, select Admin / Software Updates at the top.
    4. Read "Available Software Version" if it says V8.63.
    5. Right next to the field "Should the ..." type "yes".
  
  - you may update trivum Touchpad to the latest V2.03 Beta to have the favourites there again.
    Beta means channel 103. Updating all Touchpads of a server is best done via
    the server web interface:
    -   click "Developer" at the right top, then "Keypads" at the left. 
    -   in each Touchpad row at the right, click "Edit" 
        then enter "103" as Channel number. Then click "Update".
    You may also read here how to update via beta channel:
    http://service.trivum.com:90/mediawiki/index.php/FAQ-en#.5B108.5D_Touchpad_Software_Update

[001.2] Known Compatibility Issues

 webtouch visualization / iPhone App:
 will no longer work on iOS 5 devices from server version 8.61 on

[001.3] Pro Line V7 to V8 upgrade known issues

When upgrading a Pro Line system from software V7 to V8, 
the following things must be considered:
  
1. InputConnect card: IR out is no longer supported.
   OutputConnect card: IR out is no longer supported.
    
   If infrared devices are controlled via an Input/OutputConnect card
   then this must be changed to an Ir/RS232 adapter,
   which also has an infrared diode.
   
   You can identify such configurations by
   - hardware: an Ir cable is connected to IR out of a card
   - software: within a device of type Basic/IR,
     - under overview, at infrared connection, instead of "not used"
       some input or output connect card is selected
     - under commands you find commands of type "infrared"
     
2. KNX "Interface" is not supported, only KNX IP "Router".
   See FAQ article 085 for a detailed description.
   If your KNX gateway does NOT communicate via a multicast
   address like 224.0.23.12 then it must be replaced
   by a real IP router, e.g. Siemens N146.
  
3. KNX objects configured at the trivum server may no longer work
   and may have to be reconfigured, especially
   - scene handling (Addons / KNX / scene save)
   - Climate control (Addons / KNX / Climate)
   - lights that use 4-bit dimming
   - shutter with preset handling
   
4. Macro steps will be emptied and must be reconfigured
   Under V8 the macros with their step names will still be visible
   but all steps will be empty due to a different implementation
   of the macro enginge. So each step must be reconfigured.
   
5. Existing cover art will no longer work, requiring a full
   reset and rescan of the music database.
   This means, after the upgrade, select
     Database & Media / Database / Reset
     Database & Media / Database / Rescan all
   The RESET is also required to avoid low disk space,
   due to old cover art files not being cleaned up.
      
6. Very old FM Tuner Cards with Firmware "2.08" cannot 
   be used (are not detected) and must be replaced by
   a newer card. The newer cards actually show a 
   Firmware version  of "1.x". This is relevant only
   for a few systems.
  
7. The CPU load per StreamSource card is higher with V8,
   using about 12 percent (V7: 8 percent) per card.
   Right now up to 6 StreamSources can be used in one C4,
   beyond that a separate PC must be used.

[002] Configuration Backup and Restore: Actuator, Touchpad, Pro Line

Since MusicCenter V8 Release 8.21, or V7 Release 7.79,
it is possible to save the current overall configuration
of the server as a single text file.

MusicCenter V7 Release 7.79.6337:
   select Controller / Advanced / Backup

MusicCenter V8 Release 8.24.6337:
   select Admin / Backup

With older software versions, you may reach the backup page
manually by typing
   
   /backup
  
in the webbrowser. For example, type
  
   http://192.168.1.200/backup
  
if the server IP is .1.200. Then follow the on-screen instructions.

NOTE: some MusicCenter releases older than listed above may also
      contain a backup function, but this should not be used
      as it contains errors.

NOTE: make sure to type /backup and not /backup/ otherwise
      restore of a configuration may fail. (fixed with 7.82, 8.34).

With Touchpad Release 1.79, it is also possible to backup
and restore the configuration, by the Admin menu at the
right top, or by entering /backup manually.

[003] Network Hardware Compatibility List

Known compatible devices:
- Intellinet Modell 523318      (8 ports)
- POE: Intelinet Modell 524155  (100MBit, 16x POE)
- Dell 2216                     (16 ports)
- Dell 2324                     (24 ports)
- D-Link DES-1008               (8 ports)
  
Also recommended:
- any Cisco 24 port switch
- any HP    24 port switch

Known devices that cause network problems.
- Netgear ProSafe GS108
- D-Link DGS-1100
and similar switches. May cause Streamsource cards
to stop playback until a restart of the switch.

Also check the Sonos list of known incompatible hardware:

https://sonos.custhelp.com/app/answers/detail/a_id/42/~/sonos-and-incompatible-hardware

as switches listed as problematic for Sonos may cause
problems with trivum devices as well.

[004] Old Controller V6: automatic time (NTP) unsupported

Very old trivum systems with a V6 server software version
provide an option "use automatic date/time update",
however this is non functional and should not be used.
 
System V7/V8 contains a completely different implementation
for automatic time handling which will not be reintegrated
into V6 servers.

[007.1] search trivum Server (Controller) in the network

To find out the current IP address of the trivum server,
you may use one of these tools:
 
1. ServerAdmin. Download from
   ftp://service.trivum.com/Installer/
   and run "Install-ServerAdmin.exe" under Windows.
   
   On Apple Mac OS X, download
   http://update.trivum.com/update/ServerAdmin-Mac.bin
   then open a terminal, cd into Downloads and type:
     chmod +x ServerAdmin-Mac.bin
     ./ServerAdmin-Mac.bin
    
OR
 
2. the "tlist" command line tool. Download from
   ftp://service.trivum.com/Installer/servicetools/
   for Windows  :
       download tlist.exe and libgcc_s_dw2-1.dll
   for Macintosh: 
       do NOT use the finder to download anything by FTP,
       as it will destroy the files (it probably uses text mode
       instead of the required binary mode).
       Instead, install an FTP client like FileZilla,
       then download
           Installer/servicetools/tlist-mac
       or open a terminal (shell) window and type
       in the command line:
           ftp service.trivum.com
           user: anonymous
           [no password]
           cd Installer
           cd servicetools
           bin
           get tlist-mac
       to exit FTP type
           bye
       then prepare the tool by
           chmod +x tlist-mac
       and finally run it by
           ./tlist-mac
  
For download by web browser select "Save As" with right mouse button
then select a simple directory with short name, e.g. under windows
C:\TEMP is recommended, to find that folder easily in the next step.
  
Subsequently, 
- open a terminal, or CMD.EXE, i.e. a command line environment
- change into the download folder by "cd", e.g. 
  C:
  cd \temp
- then type
  under Windows: tlist.exe
  under Mac: chmod 777 tlist
             ./tlist

Now you should get a list of trivum components in the network, like

  24.07.2012 10:05:48 trivum ComponentFinder V1.08 (VJul 20 2012/14:31:58)
  24.07.2012 10:05:48
  24.07.2012 10:05:48 Own IP : 192.168.001.077
  24.07.2012 10:05:48
  24.07.2012 10:05:48 Found  : KeypadTouch      SNR=     554318 IP=192.168.001.063 V:0.01  (used=7)
  24.07.2012 10:05:48 Found  : MusicCenter      SNR=      10325 IP=192.168.001.091 V:7.67  (used=8)
  24.07.2012 10:05:48 Found  : KeypadTouch      SNR=     554818 IP=192.168.001.037 V:0.01  (used=9)
  24.07.2012 10:05:48 Found  : Cardhost         SNR=       1103 IP=192.168.100.011 V:1.12  (used=11)

Look for one of these components:
- Controller/Processor with a Serialnumber ending with "06"   (System V6)
- MusicCenter          with a Serialnumber ending with "25"   (System V7/V8)

If you see something like "X3" with an IP of 192.168.104.204, then this entry
can be ignored; it is just a Cardhost with it's default IP.
If you ONLY see such an X3 entry, but no Controller or MusicCenter,
then the actual main system didn't start up at all.

[008] About the old trivum Sync Tool (replaced by NAS since V7)

Since 2013, and MusicCenter V7, the trivum Sync Tool to send music files
to a server is no longer supported. Instead, please

  -  place all your music files on a NAS in your network.

  -  configure the NAS path under Streaming / Library in the format
        smb://nasname/sharename
     for example
        smb://DS212/music

  -  then select Streaming / Shares / rescan all.

See also FAQ article 059, NAS access configuration.
http://service.trivum.com:90/mediawiki/index.php/FAQ-en#.5B059.5D_NAS_access_configuration_with_a_trivum_Server_or_Actuator

With software V8 (Actuator and Pro Line) the Sync Tool cannot be used at all.

Now follows a collection of old FAQ articles about the deprecated Sync Tool.

[008.1] Old Sync Tool: multiple tracks with same name, ignoring redundant

Multiple albums were selected for synchronization containing the same
artist/album/track combinations.

[008.2] Old Sync Tool: does not support syncing files without artistname

For every song that should be synchronized, the trivum System
needs unique, non-empty informations about

   -  Artist
   -  Album title
   -  Track title

otherwise synchronization is not possible.

Tracks without artist name can be corrected the following way:

   -  within iTunes, sort the list of all music by Artist,
      by clicking on the Artist column (once or twice).
      The songs without artist should now be listed at the top.

   -  press SHIFT, and keep SHIFT pressed. now select all tracks
      that have no artist set as a group.

   -  select Informations. confirm the popup asking you if to
      edit informations on multiple tracks.

   -  activate the check box "Artist" and enter some artist
      name like "Unknown".

Now it should be possible to synchronize those tracks as well.

[008.3] Old Sync Tool: Does not support syncing files without albumname

For every song that should be synchronized, the trivum System
needs unique, non-empty informations about

   -  Artist
   -  Album title
   -  Track title

otherwise synchronization is not possible.

Tracks without album name can be corrected the following way:

   -  within iTunes, sort the list of all music by Album,
      by clicking on the Album column (once or twice).
      The songs without album should now be listed at the top.

   -  press SHIFT, and keep SHIFT pressed. now select all tracks
      that have no album set as a group.

   -  select Informations. confirm the popup asking you if to
      edit informations on multiple tracks.

   -  activate the check box "Album" and enter some album
      name like "Unknown".

Now it should be possible to synchronize those tracks as well.

[008.4] Old Sync Tool: Error: could not connect to transfer port 8080 of the MusicServer: Socket operation timed out

Within the trivum Sync Tool, there is a button "Server" where
the network address of the trivum MusicServer is configured.
The message "Host unreachable" or "could not connect" can mean that

   -  the machine on which the MusicServer is running
      is not switched on or not connected with the network

   -  or, in case of a Software MusicServer, the program
      was not started on the machine

   -  or the machine on which the MusicServer is running
      meanwhile has a different network address than the one
      configured within the trivum Sync Tool.

Please check:

   -  is the machine of the MusicServer running?
      is the network cable connected?

   -  if you are using the Software MusicServer
      on your Macintosh or PC, is the program running?

      What is your machine's network address?
      You can find out this way:

      Macintosh: System settings (see gear wheels in the dock),
               therein Internet & Network: click on network,
               select the relevant connection at left side
               (usually Ethernet ...), then the IP address
               should appear to the right side.

      Windows: System settings / Network connections,
               therein click for example on "LAN connection",
               then the IP address should appear
               at the left bottom window corner.

      Compare the IP address shown with the settings
      within the trivum Sync Tool. Maybe you have
      to reconfigure your PC / Mac to use the old IP.

[008.5] Old Sync Tool: cannot write: /Musik/audiofiles/...

Some trivum systems have an external harddisk to store music files
sent through synchronization. If this error occurs, this external
harddisk is not accessible.

Check the cabling (especially red eSATA cable) of the hard disk
that it fits tightly. Then switch the system off, wait halve
a minute, then switch it on and wait a few minutes until
reboot is done. Then try again to synchronize.

[009.2] Wireless Remote Control loses Connection

Error: at first, the remote is working, but after some while
it looses connection either temporarily or permanently.

Check: what is displayed on the remote control?

   -  "Connecting": the remote has no connection to the Wireless Adapter
      -  the wireless transmission might be disturbed
      -  the adapter might be off
      
   -  "No Connection To Controller / Keine Verbindung zu Controller":
      the remote can communicate with the Wireless Adapter,
      but the Adapter cannot communicate with the Controller.
      -> check connection between Adapter and Controller
         -  are all cables connected and functioning?
         -  is the Switch working?
            -> restart Switch
         -  IP address conflict?
            -> change IP address range

[010] Music purchased through iTunes cannot be synchronized to the trivum System,

showing an error "file too short, skipping".

Possible reason:
   -  if you purchaes the music through AppleTV,
      it is possible that it isn't synchronized yet
      to your local apple machine where your music
      library tracks are stored normally.
      
      You then have to synchronize AppleTV manually
      with your apple server (pc, notebook)
      to make those tracks fully available
      for synchronization.
      
General verification of music track completeness:

   -  within iTunes, on your newly imported or puchased
      music tracks, press the right mouse button then select
      "Informations". Check the size field: a real, complete
      music file usually contains multiple MB of data.
      If you see only a very small size (smaller than
      32768 Bytes) then this is no valid music file,
      but either a damaged file, or some kind of reference
      to a track that the trivum Sync tool cannot use.
      In this case, try to play the track in iTunes.
      If playing succeeds, check the size again -
      if it's now several MB, then iTunes did some
      internal on-demand download action.
            
   -  if you checked your new files this way,
      making sure that every track has a reasonable size,
      you may create a new playlist, drag them therein,
      then synchronize and check this playlist
      in the trivum system.
      The trivum Sync tool will create a statistic
      for this playlist listing how many tracks 
      were valid for synchronization.

[015] Playlists: how and where to store

The trivum system may import .M3U playlist files from a NAS
in a folder "Playlist" at the top level of the NAS share.
The folder may also be called "Playlists" or "Playlisten".
The folder name is case insensitive.
 
With System V8, the .M3U files may also reside in any
folder within a given NAS share.
 
For example, music is stored on a NAS "syndisk" under a share
named "music", and the share registered in trivum reads like
  
   smb://syndisk/music/
  
Then create a Playlist folder directly under music like:

   smb://syndisk/music/Playlist
 
Then, for example, within iTunes, right click on a playlist
and select "export as .M3U". Store the file onto the NAS with a path like
  
   smb://syndisk/music/Playlist/mylist01.m3u
  
then rescan the NAS share with trivum.

[016] Playlists: How to store music files for best matches

Make sure to store your music in a folder structure like:
   
  Artist / Album / Trackname
  
For example:
   
  Mike Oldfield/The Very Best Of/Shadow On The Wall.mp3
  Mike Oldfield/The Very Best Of/Five Miles Out.mp3
  Mike Oldfield/The Very Best Of/To France.mp3
  Howard Jones/Humans Lib/Hide And Seek.mp3
  Howard Jones/Humans Lib/New Song.mp3
  
Then, when exporting Playlists as .M3U files,
they will contain path informations like
   
  C:\Musik\Mike Oldfield\The Very Best Of\Shadow On The Wall.mp3
     
The trivum system will ignore C:\Musik and try to match
music files on the NAS by the last three path components, e.g.
   
  Mike Oldfield/The Very Best Of/Shadow On The Wall.mp3
  
So make sure that both on the NAS and on your PC all music
is stored in the same folder structure.
  
If music files cannot be matched by the path name
it is tried to match them by artist and track name,
however this is not reliable as special characters
in those names may cause mismatches.

[017] Unexpected source (music file/webradio) appears after switching sources

The trivum system has a technical limitation:
archive (playlist) playback and web radio playback
are using the same source, a Streaming Card.

Therefore switching like Archive Play -> Local -> Webradio
means to switch like

   StreamSource Card -> InputConnect -> StreamSource Card

and when you're back to the same StreamSource Card,
all it does is to continue in the playback mode
that was active most recently - 
so if Playlist play was active, it will do this, 
but if webradio was active, it will play the same 
web radio again.

The distinction "Play current stream" or "run as internet radio" 
on Keypad Keys / Commands applies only when selecting
the StreamCard source for the first time after system restart.

[018] How to select web radios for direct play by playlists

1. import web radios as described in article 113

2. in iTunes, create an index playlist with web radios stations
   named like "P1 my playlist", "P2 playlist" etc.
   then sync to the MusicServer

3. with System V7, you have to configure how many
   of these playlists should be offered for assignments:
 
   Streaming / Settings / Number of direct access playlists
  
   enter here any number from 1 to 10.   

4. in your Controller Keypad definition,
   instead of "run as internet radio",
   you may now select "play playlist #1"
   to run, for example, playlist "P1 ..."

[019] KNX light switching by 2x16 Keypad Menu doesn't work

If the light is defined as having just a single group address
with a 4 bit value, it won't work. In this case, you also
have to define a 1-bit on/off group address in parallel.

If the light is defined as just a 1-bit on/off group address,
you need Controller >= V6.96 or MusicCenter >= V7.36.

[050] playing Sampler / Compilation CDs from NAS

Music Albums containing tracks of many different artists
are called compilations. When importing these into the
trivum MusicCenter system from a NAS, the following things
must be prepared in advance:

1. make sure all music files of your compilation albums
   are marked as compilations, i.e. have the COMPILATION
   flag set in their meta fields.

   this can be done with free tools like Mp3tag 2.48 or higher,
   not only for .MP3 but also .M4A files.

   How to check if your tracks have COMPILATION flag set:

   -  run Mp3Tag
   -  select a compilation folder of your NAS
   -  click into one of the listed tracks
   -  select View / Extended Tags
   -  search for a field "COMPILATION".
      if none is seen, the flag is not set.

   How to set the COMPILATION flag on many files:

   -  it is recommended that you organize your NAS folders
      in a way that all compilation album folders
      are placed within a big root folder called "Compilations".

   -  then you can run Mp3Tag and simply select
      that root folder

   -  then mark ALL tracks by pressing CONTROL+A

   -  select View / Extended Tags

   -  if COMPILATION is not shown anywhere,
      select "Add field" (star symbol),
      then select the field COMPILATION
      and type 1 as value

   -  save all tracks
 
2. with MusicCenter V 7.46 or higher,
   the server will then recognize
    
   -  MP3 files marked as Compilation
   -  M4A files marked as Compilation
     
   and offers tracks of those albums correctly grouped
   in the Touchpad.
     
   As it is now (23.05.2013) FLAC file compilations
   are NOT recognized.
  
   With FLAC, you will see that, no matter what
   compilation album you select, it always seems 
   to contain just a single track, or just a few
   tracks of the same artist.

[059] NAS access configuration with a trivum Server or Actuator

A NAS (Network Attached Storage) is an external hardware unit
with an integrated hard disk. 

Important is:

  -  the NAS has a symbolic name within the SMB network,
     called machine name in the following.
     
  -  within the NAS there must be another symbolic name
     for a folder, called the share name.
     
  -  both are combined into one long name, the network path.
  
One example for a network path to a music folder:

  smb://MyLivebook/music

This means: on the machine "MyLivebook" there is a folder
identified by the name "music".

1. Find the network path of you NAS music folder.
   For that, enter the trivum server web GUI:
  
    System V8:
      Database & Media / Network shares / add share
      
    System V7:
      select Streaming / Library

   And create a new Share. When trying to change the path,
   you should see a list of found network paths.
   In case that this list is empty, select Admin / restart, 
   and wait for aktor reboot.

   If the path list is still incomplete, identify
   the IP address of the NAS, then try the alternative form like:
   
     smb://192.168.1.250/music
     
   however to make this work permanently you must configure
   a fixed IP in the NAS' administration GUI.
   
2. Entering a NAS path
 
   After entering a NAS path of the form
   
     smb://nasadress/nasshare
     
   you may also extend this path by sub folder names. 
   However in most cases this isn't necessary. Also check if
   you need to enter a Workgroup, Username and Password
   for that share. Details can be found in the administration
   surface of your NAS device.

   Then test access to the NAS by button "Rescan all"
   (V7: select Shares / Rescan all)
   and press the Refresh button repeatedly to see status updates.
   The trivum Refresh button shows 2 or 3 arrows in a circle.

   If you see "no access", check if you NAS path and all other
   data are correct. Also make sure to use "/" slashes, but not "\".
       
   If you see a message "scanning files", then access works.

3. About cover art:
   - with MP3 and M4A files, the coverart can be contained
     directly in the music files.
   - otherwise you may provide a file "folder.jpg" within
     an album folder.
  
Well known issues:
   
   - Synology: make sure that a "Volume" is really defined.
     It may happen that with a new NAS no Volume is defined,
     but the NAS allows to define shares, which are however
     unusable because without a volume there is no storage space.
       
   - always try to store at least one music file on the NAS
     before integrating the NAS with trivum. this checks
     if the NAS is configured to supply storage space at all.

[059.3] NAS access to a Windows PC share requires username

- even if you allowed anonymous network access by "Everyone" to a
  Windows folder, access is blocked if you leave the username blank.
 
  It seems that, for Windows shares, a non empty user name
  must always be supplied. You don't even have to supply
  a valid username. Just type anything, for example "anonymous", 
  and keep the workgroup and password empty.
  
- sometimes not even that is working. maybe you want to share
  a folder with wrong access rights, or for some reason
  anonymous access isn't possible to your Windows shares.
  In this case,
  - create a new user on your Windows machine,
    for example: username=music, password=music
  - create an easy, simple music folder on your hard disk,
    for example: C:\TestMusic
  - edit the Properties of C:\TestMusic and share it
    on the network with read access for user: music
  - then enter at the trivum server:
    smb://yourwindowsip/TestMusic
    user: music
    password: music
  - if you don't know your workgroup then in most cases
    then try to type WORKGROUP, or leave it blank.

[059.4] NAS access to Macintosh OS/X Lion Server

If access is not working to a Mac OS/X NAS server,
it may help to disable and then re-enable the file sharing
service at the server, and then to retry access.

[060] How to use coverart with trivum MusicCenter

1. copy all music files onto a NAS
 
2. create a database within iTunes

3. import all music files from the NAS
   into the new iTunes database

4. let iTunes search for cover art

5. now, cover art might be visible within iTunes,
   however in many cases it will not be contained 
   within the music files themselves. 
   To achieve this, follow these steps:

   under Macintosh:
   
   5.1.  download from
         ftp://service.trivum.com/Installer/iTunesScripts/
         the EmbediTunesArtwork-Mac.zip
         and copy it into
         {username}/Library/iTunes

   5.2.  extract the .zip file. A .dmg is created.
         double click the .dmg.
         A window opens.

   5.3.  within the Finder, create a folder
         {username}/Library/iTunes/Scripts
         and from the new window, drag the icon
         "Embed Artwork" into "Scripts".

         Now there should be a file:
         {username}/Library/iTunes/Scripts/Embed Artwork

   5.4.  restart iTunes.
         Now there should be a new menu entry at the right top
         nearby help (a small black symbol). When opening it
         you see "Embed Artwork"

   5.5.  Now you can
         -  select files that display coverart
         -  then select "Embed Artwork"
         and the cover arts will be integrated
         into the music files.
         
   under Windows:
   
   there is a tool available for download from
   ftp://service.trivum.com/Installer/iTunesScripts/
   within EmbediTunesArtwork-Windows.zip
   which must be ran from the windows command line (cmd.exe).

6. in the MusicCenter web surface, under Streaming / Library,
   enter the path to the NAS.
   It must start with "smb://", e.g.
   
      smb://192.168.1.10/mymusic

7. click on "Shares / Rescan all files". Scanning may take a while.
   In the Status tab, you may see if scanning is still ongoing.
   In the Info tab, you may see some statistics.

Alternative method: the Folder Image

  If you place image files with a name "folder.jpg" into
  every album folder on the NAS, then this will be used
  as cover art, if none is contained in the music files.
  
How to check cover art with further tools:
 
  Under Windows you may use MP3Tag to check if your music files
  contain cover art, or to manually add cover art to (some)
  music files.

[068] Source selection, configure sources for Touchpad or iPhone App

Audio sources of the trivum system can be made available as

1. default sources of a zone
 
   configuration at the server:
     System V7 web GUI:
      Zones / Overview: either directly in the overview
      in columns streaming and tuner, or directly in the
      zone configuration as rows streaming and tuner.
     System V8 Actuator:
      Every zone automatically has a fixed, predefined
      default streaming and FM tuner source.
     System V8 Professional Line:
      Zones / zone name / Basic: here you can select
      the Default Tuner and Streaming source card.
 
   how to call:
   -  from Touchpad 1.49, default sources of a zone are shown
      automatically, together with the other sources
      as configured further below. furthermore,
      default sources can be used in the alarm settings.
   -  from Tochpad 1.60, the default sources will appear
      with their name as configured 
      - in the V7 or V8 Pro Line server under
        Cards / Stream Source / Description
        Cards / Tuner Source / Description
      - in the V8 Actuator under
        System / Basic Setup
      as long as no name is configured, default names
      are used like "Stream n" or "Tuner n".
   -  the iPhone App will offer "Streaming" and/or
      "FM Tuner" whenever such default sources
      are available.

2. Zonesources of a zone
   configuration:
      Zones / select zone / Zonesource #1 ff.
   how to call:
      e.g. on a KNX sensor, or a web keypad key,
      select function "basic commands / use next source".

3. Generic Zone Actions
   configuration:
      Zones / select zone / Actions
      with V8 this requires that expert mode is active
      ( System / Basic Setup / expert mode )
   how to call:
      appears on the TP at the right side.

4. Touchpad specific Zone Actions
   configuration:
      Keypads / select the Touchpad / Actions
   how to call:
      appears on the TP at the right side.

5. further assignments
   e.g.
      Keypads / select touchpad / Basic / clock area action
      Keypads / select web keypad / assign Action (=key)
      Keypads / select web keypad / Commands / Command Menu
      Addons / KNX / Audio / Listen Sourcechange

[072.3] MusicCenter 7.64 + Infrared MAY require RS232 Adapter changes

  In case of a configuration:
  - MusicCenter V7.60 to V7.63 using Device
  - Devices controlled by Infrared
  - with Device Commands starting like "RunSlot ..." (not forwardMultiKey)
  - with RS232 Adapter Firmware version < 1.03
    (see http://serverip/trace then Adapter Status)

  THEN a server side update to 7.64 or higher
  will ALSO require
  -  a correction of all RunSlot commands
  -  or to set option decrementRunSlot in the Advanced tab
     of every device
  -  or an RS232 Adapter update to 1.03 or higher,
     but this requires a re-programming of the RunSlot commands
     on the new adapter, by a PC Tool.

  Workarounds in detail:

  - using the decrementRunSlot option:
    1. before server update, in every device that uses
       RunSlot commands, look into Commands / Will be sent as.
       remember for a single command what actual values
       are sent here.
    2. after server update, again look into "Will be sent as".
       Did the values change? If so,
    3. in the Advanced tab, check "decrementRunSlot",
       then again verify under Commands / Will be sent as
       if the old values appear.

  - OR change all RunSlot commands by reducing all values by 1,
    example:

        BEFORE server update:   RunSlot 2.2
        AFTER  server update:   RunSlot 1.1

    reason:
        MCenter 7.60 to 7.63 reduces values before sending,
        MCenter 7.64 or higher does not reduce.

    special case:
        IF there is a command like RunSlot 1,0
        then change it to 0,0 (no negative values).

  - OR you may change all RunSlot commands to forwardMultiKey,
    or to direct RS232 command sequences

  Technical background:
  - in MCenter 7.60 to 7.63, the server decrements 1-based page/slot
    values to 0-based values before sending to Adapter
  - in Adapter Firmware >= 1.03, the adapter decrements 1-based page/slot
    values to 0-based values after receive from MCenter
  -> because MCenter >= 7.64 no longer does the decrement, it requires
     an up to date Adapter.

[080] EIB/KNX ETS Group Address List import

Requires a plain ASCII text file like:
  
  ""
  ""	"light whatever one"	"1/2/3"
  ""	"light whatever two"	"1/2/4"
  
(remove blanks at line starts in this example,
 whitespace between " " should be Tab characters)
  
which can be exported by ETS by using
  Output format          : CSV
  CSV format             : 3/1 - three columns, Main/Middle/Sub group separated
  Export with header line: yes
  CSV separator          : Tabulator
  
it can be imported at the server
- V7: under KNX / Businterface / choose file
- V8: under System / KNX Setup
   
NOTE: you must use a Firefox or Safari browser for upload.
      Chrome may or may not work. Internet Explorer will never work.
 
Up to 500 group addresses are supported, but it is recommended
to import only up to 250 to avoid a slow down of the server's
web configuration GUI.
     
Since trivum V 8.54 build 7649 the following format 
is also supported which is mainly created by ETS 4:
  
  "Main"  "Middle"        "Sub"   "Address"
  "new main group"                      "5/-/-"
          "new middle group"             "5/1/-"
                  "Ausgang1Toggle"        "5/1/0"
                  "Ausgang1Dimmen"        "5/1/1"
                  "Ausgang1Brightness"    "5/1/2"
  
it does not require a header line. All entries
with an incomplete group address like "5/-/-" are ignored.
  
To reduce a large list of group addresses, you may use
 
- a plain text editor like Notepad for Windows
  
- or import the list into Excel, edit it, then re-export as .CSV data
  
- or use the Windows command line tool sfk from
  ftp://service.trivum.com/Installer/freewaretools/
  and then, to keep only group addresses starting like 1/7/ type:
    
     sfk filter input.csv -+\"1/7/*\" +tofile out.csv

[080.2] KNX Touchpad maximum number of objects

The trivm KNX Touchpad supports up to 8 pages to display KNX objects.
With the smallest possible button size for an object, 
e.g. a light switch of size 1x2, 8 objects can be placed 
on one page, so overall a maximum of 64 KNX objects can be displayed.
 
Internally the KNX Touchpad supports up to 128 KNX objects 
with up to 12 group addresses each. The actual number of configurable 
group addresses is dependent on the KNX object used, for example, 
a binary switch has only 2 group addresses.

[081] Devices at IR/RS232 Adapter do not react

Devices are configured at the trivum server and connected via RS232 adapter. 
 
1. Adapter is not active, not found in network
 
   Check the Adapter power supply and LAN cabling.
   Check the CAT5 LAN connector: if LEDs are blinking
   then both power supply and LAN connection is working.
  
2. Adapters are detected, devices can be activated 
   by Touchpad or web keypad, but they do not physically react, 
   and errors show up like:
   
      does not get any data from device
      does not get valid data from device
      device noanswer

->   enter the device overview page.
     Adapters should appear in one of three colors:

        green: Adapter is active, has sent messages to device
               AND received replies from the device
               
        red  : adapter is not active at all (showing "0/0")
               or has communication problems (e.g. ip range too small,
               or other device like a Touchpad using an IP within 
               the ip range that conflicts with adapter).

        blue : adapter is active, but the device never
               sends a reply. there is an info (n/0) meaning 
               n = number of sent messages
               0 = number of received messages

               -> if the device is bi-directional, meaning
                  it should sent replies to trivum,
                  then the physical connection does not work.
                  in this case, check the cabling.
                   
                  Possible test: to check if the adapter is physically
                  able to receive any data, unplug the RS232 from the
                  target device, then connect (shortcut) RX and TX lines,
                  so the adapter receives it's own RS232 commands.
                  The receive count must then go up.
   
Connection from RS232 adapter to device: within the cable,
TX/RX lines must be crossed. The pin number for TX/RX is different
from device to device.
  
Cable pin layouts on the trivum connector side are documented in
 
  ftp://service.trivum.com/Media_trivum/Documents/MusicCenter-V7-Setup.pdf
 
Now follows an excerpt from page 5:
  
  trivum side RS232 connector pins:
  
                          plain RJ45        SUB-D9 adapter i-rj45
     1     TX (Output)  - orange/white      blue
     2     GND          - orange            orange
     3     RX (Input)   - green/white       black
     [6] [ GND]         - green
  
     Pin 6 of plain RJ45 will no longer be used in future adapter versions.
  
  target device side connector pins:
  
     The kind of connectors vary from device to device, and even when using SUB-D9
     connectors pin assignments can change from device to device. Therefore consult
     the device manual for an exact pin assignment description.
  
  how to connect: 
     The TX/RX lines must be crossed.
     - connect trivum TX to device RX
     - connect trivum RX to device TX
     - connect trivum GND to device GND
   
  When measuring the TX line it should show -5 to -9 volts. 
  adapter cables available from trivum:
  
     part number    type
     i-loewe-c      RJ45 o RJ12 to connect Loewe TV's
     i-rj45         generic RJ45 to SubD9 kit (2 parts) that allows
                    to configure pin assignments individually
  
If you can send commands to the device, e.g. you press
track skip on the touch pad and a DVD player actually skips
to the next track, but you still see the error "no valid data"
on the Touchpad, then since V7.76/8.17 there is also an option
in the advanced device settings to disable device reply warnings.
This, however, should be used only if you are absolutely sure
that the device is connected and reacts to commands.
The message "device has no connection" cannot be disabled.
 
See also article 157: How to trace IR/RS232 communication

[081.2] RS232 Adapter / TV communication incomplete

For example: a Loewe TV can be controlled, but the program
list cannot be received. Under /trace at the TV device
or RS232 data trace, it can be seen that a command like
"proglist" produces a truncated reply.
 
Check the RS232 Adapter version. If it's 1.01, then this
is far too old and it contains known bugs that lead to
truncation of long messages (like a program list reply).

[081.3] shared IR/RS232 Adapter looses messages on send

Although mutliple devices are allowed to use the same IR output
of the same IR/RS232 adapter, these devices should NOT be in the
same chain, otherwise this happens:
 
  -  device 1 switches on, sends IR command via adapter
  -  device 2 also switches on immediately, also sends
     immediately IR command to the same adapter
  => second command is lost.
   
Solution: use two IR/RS232 adapters.

[082] iPhone/iPad App Features

Since Summer 2014 the iPhone App V2 is available.
It requires a trivum server with software V8,
and an Apple device with software iOS 7 or higher.
The app will not work on iOS 6 or lower.
 
The most important features are:
- creates a web browser view to the new webtouch
  interface. this means whenever your trivum server
  is updated, the user interface available through
  this App is updated as well.
 
Since 29-Oct-12 the iPhone App 1.0.8 is available.
It is intended only for trivum systems with
a server software V7, and runs on a wide range
of iOS system versions.

The most important features are:
- TuneIn support. Requires Server 7.65 or higher.
  For full support of Favourite Lists ist should be
  Server 7.72.
- Landscape Orientation Support.
- more stable detection of trivum Server in the Wireless LAN
  using Unicast messaging if a Server 7.72 is present.

Important Bugfixes:
- crash on missing network
- no network access if App was in background
- "playing" button did not change to playing view
- crash on albums with 1 character title

[083] iPhone/iPad App TuneIn Error: invalid parameter @255 out of range

With the App 1.0.8, Playback of TuneIn web radio stations is possible
only if a default streaming source is defined in the current zone.

To define this, enter the trivum Server web konfiguration and go to:

  Zones / zone name / line "streaming". If it shows "No Default" here,
  then TuneIn on the App will produce the above error.
  Therefore select a streamsource card in the line "streaming".
  
Playing back albums, however, does not strictly require a default streaming source,
provided that a stream source was defined as a zone action.

[084] TuneIn activation on the Touchpanel or iPhone App

TouchPanel:
  
   TuneIn is available in the Touchpanel Firmware from version 1.51,
   however for full functionality version 1.61 is recommended.
   Furthermore, a trivum server version 7.72 is required.
   
   Even with the newest Touchpane firmware version, tunein may not
   be active by default on systems installed before October 2012.
   
   If TuneIn does not appear, activate through these steps:
   
   System Menu / Info / Special Settings, then type:
   
        tunein on
 
iPhone App:

   With the App version 1.08 or higher (see Settings / Info),
   TuneIn should always be available. Follow these steps:
 
   - connect the App to the trivum Server via
     Settings / Change MusicCenter [ / Zone selection ]
  
   - "Streaming" should be shown now.
     If not, check the server configuration if 
     default sources are defined for the zone (see article 068).
     Select "Streaming". The system should start
     to play some random track.
     
  -  click on the magnifying glass to enter Search.
     Now you should see: Artists, Albums, Genres ...
     and somewhere TuneIn. There you can select TuneIn stations.
     

[085] KNX Setup and Network Configuration Checklist

- Use a KNX IP Router, e.g. Siemens N146,
  but do NOT use a KNX Interface, e.g. Siemens N148.
  The differences are:

  Interface: has ONLY a normal IP address, e.g. 192.168.1.100,
             to communicate only with ONE client at a time.

  Router:    has also a multicast IP address, by default
             224.0.23.12. can communicate with any number
             of clients in parallel. There is also a "normal"
             IP address, which is however not used in most cases.

  IP Interfaces are cheap (up to 200 Euros) but not useful
  for trivum systems. IP Routers cost at least 280 Euros.
  
- avoid any wireless connections! often WLAN access points
  do NOT pass through multicast messages which are strictly
  required for KNX events. connect all by cable, and connect
  the IP router to trivum as direct as possible, for example:
    
                  [internet]
                      |
                   [router]
                      |
           +----------+-----------+
           |                      |
        [switch]             other LAN devices
          |  |
     KNX-IP  trivum
     Router  server
    
- even KNX Routers often support two operation modes
  to run as an Interface or Router. Therefore make sure
  to configure the router to use routing mode. Check:
  -  the run mode. the device must run as a router.
  -  the IP address. Only if the device is running
     as a router you will see an address like 224.0.23.12
  -  filter settings. by default, routers block many
     messages, and this must be changed.

  Example Settings for Siemens N 146 IP Router:
  Parameters
   General
     Support of unconfigured interfaces: enabled
     Monitoring of bus voltage failure : enabled
   Routing (Bus > IP)
     Group telegrams of main groups 0 to 13 : transmit all (for testing)
     Group telegrams of main group 14 and 15: transmit all
     Individually addressed and broadcast telegrams: filter (normal)
     Telegram confirmation of group oriented telegrams: only if routed
   Routing (IP > Bus)
     Group telegrams of main groups 0 to 13 : transmit all (for testing)
     Group telegrams of main group 14 and 15: transmit all
     Individually addressed and broadcast telegrams: filter (normal)
   IP Config 1
     IP Address Assignment:  by DHCP Server
     IP Routing Multicast Address
        Byte 1 [224 ... 239] : 224
        Byte 2 [0 ... 255]   : 0
        Byte 3 [0 ... 255]   : 23
        Byte 4 [0 ... 255]   : 12
  Commissioning
   Address : 1.1.22

- trivum Controller/MusicCenter Server: if you want to use
  KNX at server side, 
  1. make sure that Addons / KNX / Businterface / Use EibnetIP
     is activated (checked)
  2. configure Addons / KNX / Businterface at server side like:
     Use EibnetIP for EIB access: yes
     Interface device address   : 1.1.199
     Eibnet Routing Mode        : yes
     Communication speed        : Fast
     Trace bus communication    : yes

- Touchpad:
  1. make sure that KNX is enabled.
     System Menu / Info: scroll down at the left side,
     and see what buttons appear. If you see a button
     "Show KNX events", then KNX is active. If not,
     touch the "Special settings" button, then enter:
           knx on
  2. web GUI: here you may configure the KNX device
     address of the Touchpad, default is 1.1.199.
     It shouldn't be a problem if all TP use the same device address,
     however, under no circumstances any other KNX device on
     the KNX bus should use the same device address as any touchpad.

- Touchpad bus test: select System Menu / Info and scroll down.
  Select Show KNX events and check if any messages from the
  KNX router appear.

- if these prerequisites are fulfilled,
  -  create a simple light object in the touchpad (TP),
     with only one group address for on/off
  -  within the ETS software, open the group monitor.
     check if your light can be toggled by commands
     from the ETS
  -  toggle the light in the TP GUI. do KNX messages
     appear in the ETS group monitor?

  If not, check again the router configuration within ETS,
  especially the filter settings. Reprogram the router again,
  because it can be possible that the values are listed in ETS,
  but someone forgot to actually program them into the router.

  If the light can still not be switched, check the KNX network
  for bus couplers and their progamming. The also have some
  filter settings. Check and correct them, and reprogram
  them multiple times by ETS.
  
How to configure multiple KNX IP routers:
If there are two routers in the network they will use different
communication addresses, typically 224.0.23.12 and 224.0.23.13.
To configure the correct router for communication,
go to the following places:
- C4 server with v8: enter the web configuration,
  then system / knx setup: knx/ip communication address.
  after changes to this address, restart the server by:
  admin / quick restart
- AudioBox: in the web visualization, click at the right top
  for system menu, then: setup / system setup / more / 
  open advanced configuration, then proceed like on a C4 server
  by entering system / knx setup.
  after changes to the knx ip address, restart the AudioBox by:
  admin / quick restart
  
While KNX is active, trivum components will send occasional
KNX search requests to the KNX IP router. If you don't want
to use KNX in your project, you may disable it this way:

  MusicCenter: Addons / KNX / BusInterface: uncheck "Use EIBNet"

  Touchpad   : System Menu / Info / Special settings / enter: "knx off"
  

[086] KNX device control configuration guide

If you want to control trivum through KNX devices, or vice versa,
then configurations can be done at these places:

  Touchpad, configuration via web browser:

  -  Apps: create objects to control KNX lights,
     shutters, climate controls or scenes

  -  Visu Page n: then place the created objects
     into pages.

     Then, on the touchpad, touch the date info
     at the top to enter the KNX display area.

  Audio Actuator or Pro Line with MusicCenter V8:

  -  System / KNX Setup:
     Select router, enable bus communication trace.
     To see KNX I/O traces, close the dialog then
     select "Developer" at right top and "KNX Trace".

  -  Zones / zone name / KNX Settings:
     Configure simple actions per KNX message.
     Control zone on/off/mute, volume, skip track,
     and send diverse other commands into a zone from KNX.
     See also: KNX Events for more complex actions.
     
  -  Macros:
     Send 1-bit, 8-bit or 14-character data to KNX
     through self defined command sequences.
     
  -  KNX Displays:
     Send status infos like current artist or album,
     track title, time to a KNX Display.
  
  -  KNX Events:
     Configure actions on incoming KNX messages like:
     select a specific source, play an artist/album,
     control a zone (on/off/mute/volume/next source),
     multikey commands like next/prev. track,
     play/pause or device specific commands.
     
  C4 or X3 with MusicCenter V7:
  
  -  Addons / KNX / Businterface:
     Select router, enable bus communication trace.
     Select "Developer" at right top for trace outputs.

  -  Addons / KNX / Displays:
     Send status infos like current artist or album,
     track title, time to a KNX Display.

  -  Addons / KNX / Audio:
     Addons / KNX / Sensors:
     Control zone sources, mute, volume, skip track,
     and send diverse other commands into a zone from KNX.

  -  Macros:
     Send 1-bit, 8-bit or 14-character data to KNX
     through self defined command sequences.

  Please Note: KNX settings at the Touchpad
  are completely independent from KNX at the server!

  For example, you do not have to enable KNX at the server
  to control KNX lights through the Touchpad.

  It is also possible to use a Touchpad just for KNX control
  without any trivum server or actuator in the network.

[087] KNX supported data points

The list of all possible KNX inputs and outputs with a trivum
Server V8 (Actuator / Pro Line), Server V7, and Touchpad.
  
Please Note:
   ">>" means KNX data is sent FROM KNX bus TO trivum
   "<<" means KNX data is sent FROM trivum TO the KNX bus
 
Server with Software V8 (Actuator, Pro Line):
  Zones / zone name / KNX
     Control zone-status and zone-volume by KNX
        >> set zone on/off   - 1 bit
        >> set zone mute     - 1 bit
        >> set zone volume   - 4 bit
        >> set zone volume   - 1 byte
     Push zone-status and zone-volume to KNX
        << push on/off status to bus  - 1 bit
        << push mute status to bus    - 1 bit
        << push volume to bus         - 1 byte
     Control current source by KNX
        >> skip to next/previous source  - 1bit
        >> send ">" command to source    - 1 bit
        >> send "<" command to source    - 1 bit
        >> send ">>" command to source   - 1 bit
        >> send "<<" command to source   - 1 bit
     Special controls
        >> include/exclude in scene      - 1 bit
        >> run any command               - 2 bytes
  Macros / macro name / Steps / send KNX command
        << send 1 bit, 1 byte, or 14 chars text
  KNX Displays
        << set display page              - 1 byte
        << set display icon number       - 1 byte
        << set display text line 1       - 14 bytes
        << set display text line 2       - 14 bytes
        << set display text line 3       - 14 bytes
        << set display text line 4       - 14 bytes
  KNX Events / event name / edit
        >> on bit/byte, 2 bytes or string from KNX
        >> run one of the Generic Server Actions
           e.g. activate a source, change volume etc.
           For the full list of possible actions
           see FAQ article 088 below.
  KNX Actuators / object name / edit (by double click)
     binary switches
        << send switch on/off         - 1 bit
     dimmers
        << set on/off                 - 1 bit
        >> read status                - 1 bit
        << set brightness             - 1 byte
        >> read brightness            - 1 byte
     shutters
        << send short action          - 1 bit
        << send long action           - 1 bit
        << send position              - 1 byte
        >> read position              - 1 byte
        << set angle                  - 1 byte
        >> read angle                 - 1 byte
  
Server with Software V7 (X3 or C4):
  Addons / KNX / ...
     businterface
        >> scene save/restore         - 1 byte
     lights
        << set on/off                 - 1 bit
        << set brightness             - 1 byte
        << dimm                       - 4 bits
        >> read status                - 1 bit
        >> read brightness            - 1 byte
     climate
        >> read setpoint temperature  - 1 byte
        >> read current temperature   - 1 byte
        << temp. controller on/off    - 1 bit
        << set controller action      - 1 byte
        << activate comfort mode      - 1 bit
        << activate night mode        - 1 bit
        << activate standby mode      - 1 bit
     shutters
        << send long action           - 1 bit
        << send short action          - 1 bit
        << activate preset            - 1 bit
        >> read position              - 1 byte
        >> read angle                 - 1 byte
     displays
        << set display page           - 1 byte
        << set display icon number    - 1 byte
        << set display text line 1    - 14 bytes
        << set display text line 2    - 14 bytes
        << set display text line 3    - 14 bytes
        << set display text line 4    - 14 bytes
     sensors
        >> run action on bit value    - 1 bit
           e.g. activate source, use device, 
           change volume. possible actions
           are different to those in V8.
     audio
      status and volume
        >> set zone on/off            - 1 bit
        << send on/off status         - 1 bit
        >> set zone mute              - 1 bit
        << send mute status           - 1 bit
        >> change zone volume         - 4 bit
        >> set zone volume            - 1 byte
        << send current volume        - 1 byte
      source control
        >> skip to next/previous source  - 1bit
        >> send ">" command to source    - 1 bit
        >> send "<" command to source    - 1 bit
        >> send ">>" command to source   - 1 bit
        >> send "<<" command to source   - 1 bit
      special controls
        >> include/exclude in scene   - 1 bit
        >> run any command            - 2 bytes
 
trivum Touchpad:
  Possible KNX objects that can be defined via
  the web configuration interface of a Touchpad.
  These are completely independent from any
  server side KNX configuration.
     binary switch
        << set on/off                 - 1 bit
        >> read status                - 1 bit
     dimmer
        << set on/off                 - 1 bit
        >> read status                - 1 bit
        << set brightness             - 1 byte
        >> read brightness            - 1 byte
     RGB dimmer
        << set on/off                 - 1 bit
        >> read status                - 1 bit
        << set brightness             - 1 byte
        >> read brightness            - 1 byte
        << set red, green, blue       - 1 byte each
        >> read red, green, blue      - 1 byte each
     shutters
        << send short action          - 1 bit
        << send long action           - 1 bit
        << send position              - 1 byte
        >> read position              - 1 byte
        << set angle                  - 1 byte
        >> read angle                 - 1 byte
     climate
        >> read room temperature      - 2 bytes
        << activate comfort mode      - 1 bit
        << activate night mode        - 1 bit
        << activate antifrost mode    - 1 bit
        << set heating/cooling mode   - 1 bit
        >> read heating/cooling mode  - 1 bit
        << set comfort/standby/...    - 1 byte
        >> read operation mode        - 1 byte
        << set comfort temperature    - 2 bytes
        >> read comfort temperature   - 2 bytes
        << set setpoint temperature   - 2 bytes
        >> read setpoint temperature  - 2 bytes

[088] trivum Server V8 Generic Actions

The list of actions (commands) that can be assigned
 
- to KNX events, e.g. on a 1 bit KNX message
- to Control Unit Keys (Touchpad, Web Keypad etc.)
- partially to Macro steps
 
with server software V 8.30 or higher.
 
For example, to assign one of the following functions
to a Touchpad, select at the server
  Control units / touchpad: Actions
then click on a field in the action column.

Groups marked with (M) can also be used in macros.
  
  Control a zone
     volume +/-
     mute
     power off
     power off all zones
     restart server
     rescan music database
     volume + (2 steps)
     volume + (5 steps)
     volume - (2 steps)
     volume - (5 steps)
     use next zone source
 
  Multikey commands    (M)
     traction
        > < >> <<
        play/pause
        OK, Cancel
        => (next album)
        <= (previous album)
        Fast Forward/Backward
        Slow
        Play, Pause, Stop
        Record
        Forward, Backward
     digit
        numlock, digits
        0, 1, 2, ... 9
     navigation
        up, down, left, right
        OK, Exit
     amplifier/switch
        Mute toggle, on, off
        Device Volume +/-
        Input 1, 2, 3, ... 14
        Input up, down
     PVR/TV/DVD
        Station up, down
        Antenna, Timer, Return
        Info, EPG, Menu, Top Menu
        Setup, Subtitles
        Speaker, Audio, Favorites
        UHF, Archive, Teletext
        Red, Green, Yellow, Blue, White
        Sat, TV/Radio, Mode
        Mode TVReceiver, Mode Radio
        Power on, off
        
  Activate a source    (M)
     RDS Tuner
        play current station
        play station ...
     Streaming source
        play current stream
        play playlist by name
        play direct access playlist
        play TuneIn favourite station
        play genre
        play album
        play artist
     Analog input
     Local source
        
  Activate a device    (M)
     use device ...
        
  Run a macro
     run macro ...
        
  Advanced commands    (M)
     zone forward commands
     call single device command
     call single card command

[094] iPhone/iPad App Error: select Genre / Compilation Album fails

The App crashes when selecting the Genre List, then a Genre
with just one Album but multiple artists. Error occurs only
with albums marked as Compilation, not with normal albums.
 
This is fixed with MusicCenter 7.79.6339 or 8.24.6339.

[095] Streamcard Error 3 (Finding Server)

Communication between a Streamsource card and the MusicCenter
is not possible.
 
A Streamsource card checks every 2 seconds if it's communication
partner (software process) is still running. If it has no infos
so far about that partner, or the partner is not answering, then
this error appears.

If the error appears permantently, possible reasons are
- disrupted network communication
- a bug in the Cardhost communication (MCenter V7 or V8 Pro Line)
  if many (PowerAmp) cards are used. (Fixed from V7.77)
  
In most cases it's a network problem. This can be checked
by the trace.exe tool. Identify the Streamsource IP address,
then type in the commandline

  trace.exe streamSourceIP
  
Then press 'i' for Informations. If the card does not react
or shows "Repeating request" permanently then there is a
communication problem with the MusicCenter, e.g. from
IP conflicts with other devices, or a router problem.
It's also possible that the Streamsource itself is defect.

You may also try

  ping streamSourceIP
  
in the commandline. If there is no reply, check cabling
to the Streamsource card.
 
An update to MusicCenter 7.80 or 8.25 may also help
as the Streamsource card handling was improved.

[100] Direct play of direct access playlists (index playlists) by one touch

To allow direct play of a playlist, follow these steps:
 
1. create an Index Playlist. An Index Playlist is a normal
   playlist with a special name scheme. It must contain
   P1, P2, P3 ... etc somwhere in the name. For example:

        P1 my playlist
        My P1 playlist
        My playlist P3
  
2. import this playlist into the trivum system,
   typically by NAS rescan
   
3. with System V7, change
   Streaming / Settings / Number of direct access playlists
   and enter any number from 1 to 10.
3. then you should be able to select it:

   3.1. on a web keypad: in the mcenter web gui,
        select Keypads / open a web keypad config /
        edit an Action / select:
           global source / streaming / archiv / 
              play playlist # ...
   3.2. for the Touchpad:
        -  with server system V7:
           it requires server software V7.81.
           in the mcenter web gui, select actions
           just as described for web keypad above.
        -  with server system V8:
           it requires server software V8.30.
           in the server web gui, select Control units,
           Touchpad, actions, activate a source.
           then it should be self explaining.

[104] KNX Network Traffic Analysis using Tools

You may check if KNX commands for IP routers are visible in your
LAN network by the following tools:

  -  ETS. You need this program already to configure and program
     a KNX IP router, especially the router filters. So in most cases,
     you should have an ETS at hand already. Open the Group Address Monitor
     in ETS and see therein what KNX events come in from the router.

  -  in the trivum Controller or MusicCenter.
     System 7: enable Addons / KNX / Bus interface / trace bus communication
     System 8: enable System / KNX Settings / trace bus communication
     Then open:
        /print/controller-trace
           -> shows a mixed trace of system events and KNX events
     Or open under System 8:
        Developer / KNX/EIB-Trace
           -> shows only KNX events
     In the KNX events, events sent from outside to trivum will
     appear as "wrte" records (external writes to the KNX bus).
  
  -  in the trivum Touchpad:
  
     1. directly at the Touchpad:
        select System Menu / Info / scroll down at the left,
        then select "Show KNX events".
          
     2. indirectly via Touchpad trace outputs:
        - download the trivum trace tool (see article 157)
        - find out the Touchpad IP address by
          System Menu / Info
        - on a Windows or Mac PC, run the trace tool like
          trace.exe touchpadIpAddress
        - if you see the welcome message "trace attached",
          press 'k' to toggle KNX trace.
          this may require a touchpad V 1.69 or higher.
          with Touchpad V 1.84 or higher, you will see messages like
          KNX: wrte 01/4/121 1bit 000 (0x40,0x00) - SRC:bc.d0 DST:11.14 IPSrc=192.168.0.229
          KNX: wrte 01/4/124 byte 000 (0x40,0x00) - SRC:bc.d0 DST:11.14 IPSrc=192.168.0.229
          KNX: answ 06/6/006 text Room_3________  - SRC:bc.e0 DST:11.c6 IPSrc=192.168.1.64
          where 'byte' may also indicate any multi bit value
          like 4 bit dimming events.
   
  -  Wireshark, with a filter like

     ip.dst == 224.0.23.12

  -  or with the free command line tool SFK from
     ftp://service.trivum.com/Installer/freewaretools/

     sfk udpdump -knx

      example output:

        ----- #011 from 192.168.1.76 at 02.11.2012 13:24:29 (14 bytes) -----
         KNX: search request
         >06100201 000E0801 E000170C 0E57<

        ----- #012 from 192.168.1.67 at 02.11.2012 13:24:32 (17 bytes) -----
         KNX: route 1/4/121 len=1 00
         KNX: nmc=29 addil=0 ctl1=BC ctl2=E0 src1/2=11C7 dest1/2=0C79
         KNX: dsttype=0 routcnt=0 tcpi=0 ncnt=0 acpitype=0 acpidata=0
         >06100530 00112900 BCE011C7 0C790100 00<
      
    This way you see whenever something is sent, and from whom.

      Example with a different multicast address:

        sfk udpdump -knx 3671 224.0.23.13
  
     SFK also allows to send simple KNX events for testing like
      
        sfk udpsend -knx "3 4 250 1 0"
        
     which would send a 1-bit value "0" to address 3/4/250.

[108] Touchpad Software Update

The trivum Touchpad software update can be initiated
 
  -  at the Touchpad: via System Menu / Setup / Online SW Update
  
  -  or via the trivum Server:
      System V7: enter http://serverip/trace in the web browser
      System V8: click on "Developer" at the right top
                 to enter the trace page
     and therein, click "Keypads" and click on all Touchpads
     that need an update on "Update".
     
There are 2 relevant update channels:
 
  3     : production
  103   : beta / pre-release
  
To check which channel is configured see
 
  System Menu / Info / SW Channel
  
Channel can be changed 
 
  -  at the Touchpad:
     System Menu / Info / scroll down, select special settings,
     then enter
     
        channel prod   (or "ch prod", or "ch 3")
   
     to select the production channel.
     Or enter
     
        channel beta   (or "ch beta", or "ch 103")
        
     to select the Beta version channel.
  
  -  at the Server: V7 provides a colum "channel" that can
     be edited directly. From System 8.24.6347 select
     "Edit" per Touchpad to change the channel.
     You have to enter codes 3 or 103 there.

[110] trivum KNX touchpad first steps

If you want to use the trivum Touchpad primarily for KNX control,
the following documentation is available:

 trivum TouchPad as KNX Room Controller
  http://www.youtube.com/watch?v=bqSWFKn0ztA&feature=plcp

 KNX Steuerung über das trivum TouchPad als Raumcontroller
 (not in English, but possibly useful)
  http://www.youtube.com/watch?v=86vZKRnL7Lc&feature=plcp
  
In general, you have to follow these steps:
1. connect the Touchpad to the POE switch
2. after startup, press the cirle at the right top
   to enter System Menu.
   select Info.
   read the IP address.
3. run a web browser and connect to the IP address,
   e.g. by typing http://192.168.1.200/
4. there you will find the KNX configuration surface.
   - If you have no trivum audio actor or MusicCenter,
     you should select: operation mode = mainly used to control KNX.
   - under Apps you can define all kinds of KNX devices
     to control with their group addresses.
     after definition, enter a page, then select "Show" at the left top
     to show the device in that page.
     
Right now there is only a German manual
ftp://service.trivum.com/Media_trivum/Documents/Touchpad/Touchpad_Bedienungsanleitung_RZ3.pdf
however large parts of the GUI should be self explaining.
 

[111] How to select Local Source in Zonesources or by KNX

This article applies to Professional Line (not Actuator).
 
Example: an Output Connect or Poweramp Connect card exists in Zone "MyRoom".
This means a Local Source is also available within Zone "MyRoom".

If you want to activate this source through a KNX event,
then enter a Group Address (GA) like 3/3/1 under

  System 7: Addons / KNX / Audio / Zone MyRoom: Listen Sourcechange
  System 8: Zones / MyRoom / KNX: GA to send ">"
  
This means if a 1-bit event 3/3/1 is received, it will toggle between
the Zonesources. Now you have to configure these sources.

  System 7: Zones / MyRoom / Zonesource# ...
  System 8: Zones / MyRoom / Sources ...
  
However, you will find that in System 7, it is not possible to select
Local Source here at all, and in System 8, it is possible but still
inflexible, as you cannot change the displayed name and icon of that
source as it will appear on a touchpad or other display.

Therefore use a virtual device that selects the source, like this:

  System 7: Addons / Devices / New: Basic/IR / Every function
  System 8: Devices / Add Device / Basic/IR / Every function
  
then change device name "Every function", e.g. to "Local Input".
Enter the device definition. Edit "AudioOut Connection",
and select "Local input of current zone".

Then go back to the Zone Source definitions as discussed above.
Now you can select a Zonesource: Device use / Local Input.

And then, a KNX event 3/3/1 should activate that source.

[112] how to use skip album through KNX

Album skip by KNX requires the following steps:
 
1. activate streaming in the zone.
 
2. select search: artists.
   within the artist list, click at the top to play ALL artists.
   (the web visualization will always select random playback,
   selecting up to 500 tracks in total.)
   
   to do this via XML call from an external visualization
   and without random playback, use:
 
   to do this via XML call from an external visualization, use:
   http://serverip/xml/music/search.xml?action=play&artist=%2A&zone=@0
 
   explanation:
     serverip    = type your server ip e.g. 192.168.1.175
     artist=%2A  means "artist=*" to select all artists.
     zone=@0     selects zone with index 0, you may have to change this
  
3. then use the KNX events for next/previous album.
 
4. random play option:
   to play albums in random order, you may add "&random=1"
   but then only a maximum of 500 tracks is selected in total.
 

[113] How to import web radios via NAS playlists

Self-defined lists of web radios are imported
into trivum through playlists.

1. create a playlist with web radios.
   there are multiple options to do so:

   1.1. within iTunes: create a playlist, 
        add web radios to that playlist,
        then export as .M3U file

   1.2. or create a plain text .M3U file,
        e.g. with the Windows Notepad editor,
        with a format like:

#EXTM3U

#EXTINF:-1,Deutschlandfunk - MP3
http://www.dradio.de/streaming/dlf.m3u
#EXTINF:-1,KlassikRadio
http://players.creacast.com/creacast/klassik/playlist.m3u
#EXTINF:-1,KlassikRadio
http://str31.creacast.com:80/klassik1.m3u
#EXTINF:-1,MDR Sputnik Livestream
http://www.sputnik.de/m3u/live.hi.m3u

   You can also find examples under
   ftp://service.trivum.com/WebRadios/

2. copy the created .M3U file into a folder

   Playlist
   
   at the top level of your NAS share folder.
   
3. rescan that NAS share with trivum.

[114] KNX events received twice at trivum server

One case reported that pressing a KNX button always produced
two incoming events at the trivum server. The reason was
that Eibnet Routing Mode was not active under
Addons / KNX / Businterface.

[115] What Audio Actuator Documentation is available

- Datasheet:
  ftp://service.trivum.com/Media%20trivum/Documents/English/trivum%20Datasheet%20V8/Datasheet_AudioActuator.pdf

- Screenshots: (just an overview, without comments)
  ftp://service.trivum.com/Media%20trivum/Documents/AudioActuatorScreenshots/index.html

- Quick installation manual:
  ftp://service.trivum.com/Media%20trivum/Documents/AudioActuatorQuickInstallationManual.pdf

- Context sensitive online help:
  Within the actuator configuration web GUI,
  most fields contain a small context help text for explanation.
  Just enter the actuator web GUI and read through it.
  
- Automation integration API with external servers:
  ftp://service.trivum.com/Media%20trivum/Developers/mcenter-v7-interfaces.txt

- FAQ pages:
  http://service.trivum.com:90/mediawiki/index.php/FAQ-en

[116] Touchpad special commands

For System Menu / Info / Special settings

  touchpanel (oder tp)
     -  activate touchpanel test mode

  tunein on  (or off)
     -  (de)activate tunein support
 
  ntp on
  ntp off
     -  (de)activate NTP time support

  update off
     -  do not show update button

  knx on
  knx off
     -  enable or disable KNX completely

  w1 500
     -  set network warning time (blue rectangle)
        to 500 msec

  seconds off
     -  disable clock's second hand

  panel
     -  show panel type

  channel n   (oder ch n)
     -  change update channel
     

[117] KNX Touchpad cannot be opened by web browser

Check the Touchpad IP by: System Menu / Info at the left side.
Compare this IP to the IP of your Computer from which you want
to access the Touchpad. The first three parts of the IP
should be identical.

Example:

     Computer has   192.168.1.30
     Touchpad has   192.168.5.50
     -> connection is probably not possible,
        as TP is in a different subnet (.5) than computer (.1)

     Computer has   192.168.1.30
     Touchpad has   192.168.1.50
     -> connection should be possible.
     
Special case:
     If the Touchpad has an IP "169.254.231.13", then it probably
     failed to get a DNS address from a DNS server.
     -  check if any DNS server at all exists in the LAN
     -  check if Touchpad has connection to that server
     OR
     -  configure Touchpad to use a static IP address.
        In such a case, high addresses like .190 are recommended
        to avoid later conflicts with future DNS servers
        that typically use low area IP's.

[118] Audio Actuator: distorted, cracking or interrupted sounds

-  if you hear sound disturbance in the form of cracking sounds,
   it could be clippings caused by a wrong DSP setting.
   In the Actuator web GUI, see
   
     Zones / Zone name / DSP/Sound
   
   If any of the "Amount" parameters is > 0, e.g. +5 dB,
   then "Volume adjust" at the top must be 0 minus that value,
   or better -1 minus that value, e.g. -6 dB.
    
   Furthermore, if "Bass enhance level" is active, "Volume adjust"
   may even require further reduction.
    
   In general, it is a better idea NOT to boost frequencies
   by Amounts > 0, but to reduce those frequencies that you
   do NOT want to hear by negative amounts.
    
   If any warnings are shown in red, strictly follow the instructions.
   For example, EQ with +db AND BassEnhance/virtualSurround
   are NOT allowed in combination, as the latter one already
   lifts the sound volume.
   
   If you still hear distortion and clipping and don't know
   what the cause is, always select
    
     Preset / Load / load preset 1 (Flat / default)
    
   at the top, and then try again. 
   
-  if the sound is interrupted every few seconds,
   it could be system overloads by excessive tracing.
   In the Actuator web GUI, see Basic Setup / Advanced options.
   If the field contains "traceplayer=9" then this will internally
   produce massive trace output, leading to interrupted sound.
   Simply clear the field. Since V8.30, the field is also cleared
   automatically on every restart.

[119] Actuator: No Internet or Nameserver - cannot Update

The Actuator needs configuration data from a DHCP server.
A DHCP server gives the Actuator an IP address, and it
tells about which Name Server to use. A Name Server
is required to connect to the internet to allow

- web radio playback
- software updates
- NTP automatic time setting.

Therefore make sure that your Router/Switch/Modem
that connects your local network to the internet
provides a DHCP service which also gives correct
Name server informations.

Follow these steps:

- open your Router's web configuration GUI in a web browser.

- search for settings like: DHCP and Name Server.

- make sure that DHCP is active.

- make sure that Name Server informations are
  sent into your network. If you see some Nameserver
  address like n.n.n.n then verify that this server
  actually exists, on the command line with a command
  like "ping n.n.n.n"
  Example:
           ping 8.8.8.8
  checks the Google Nameserver.
  And if you have no idea what Name Server IP address 
  to use for configuration, try 8.8.8.8
  
- after changes to the network configuration,
  first check with a PC or Notebook if Internet access
  is still working, by opening some internet website.
  Then restart the Actuator.

[120] simulateKeyPress must be called twice

In a Homeserver visualization, the command
/xml/keypad/simulateKeyPress.xml?id=n ...
must be called twice to activate a source.

Solution: append parameter "&once", otherwise
the system waits for a press and then release event
and/or key repeats.

[121] playlist from NAS is incomplete or empty

1. Invalid music files referenced
  
   Make sure that all music files in your playlist
   have non-empty Artist, Album and Track name fields.
   If one of these fields is empty,
   -  the music file is not added to the trivum database
   -  and therefore it will not show up in your playlist
     
   Use, for example, iTunes and select "Informations"
   for a track to check if Artist, Album and Track Name
   are all set.
   
2. Special Characters in Meta data and/or file paths
 
   Check if the artist, album, trackname, and/or
   the path and filename of music tracks contained
   in the playlist contains any special characters
   like Umlauts, Accents, or event Chinese characters.
   
   This can make it impossible for the trivum MusicCenter
   to match those playlist entries to tracks which
   are already in the database. Technical background:
   iTunes for Macintosh saves special characters in an
   untypical non-standard format. The trivum MCenter
   tries to compensate by fuzzy matching, but this
   doesn't always work, especially not with Asian characters.
   
   Therefore try to change or remove special characters
   from tracks listed in Playlists like:
   - change "ä" to "a"
   - change "ó" to "o"
   - remove Chinese characters
   
   Also check the directory and file name on the NAS,
   and change characters there as well. Then reimport
   the tracks into iTunes, re-export the playlists
   to the NAS, and reimport into trivum.
   
3. Complicated and unresolvable music file paths
 
   Check carefully how you import the NAS content to your
   PC or Notebook. Make sure to use short and simple path names
   for all your network shares.
   Look into the exported .M3U playlist files and check
   if the music files have a simple, straightforward path.
 
   Bad example:
     #EXTM3U
     #EXTINF:513,Planet of Women - ZZ Top
     Y:\imported CD\Music\Music\ZZ Top\Afterburner\01 Planet of Women.m4a
     #EXTINF:489,Lovely Day - Billie Holiday
     Y:\imported CD\Music\Music\Billie Holiday\Greatest Hits\Lovely Day.m4a
     
   -> the playlist file references music files with very complicated paths
      stored under "Y:\imported CD\Music\Music". the trivum server knows nothing
      about "Y:\imported CD\Music\Music" because it has no access to details
      of the PC or Notebook, and how NAS shares are mapped therein.
      Therefore it cannot map the file path, and has to use artist and track name
      to resolve entries, which is highly unreliable.
  
   Good example:
     #EXTM3U
     #EXTINF:513,Planet of Women - ZZ Top
     Y:\Music\ZZ Top\Afterburner\01 Planet of Women.m4a
     #EXTINF:489,Lovely Day - Billie Holiday
     Y:\Music\Billie Holiday\Greatest Hits\Lovely Day.m4a
 
   -> the playlist file references music files with very simple paths
      stored under "Y:\Music". the trivum server is able to ignore
      a short (single component) part like Y:\Music, and to match 
      music files by the rest of path, e.g. "ZZ Top\Afterburner\..."
      especially if the network share name from NAS is also just "music".
  
   General recommendation:
   - on your NAS, provide all music through a folder and network share
     called "music". Below "music", the artist folders should be listed.
   - map this network share on your PC through a short mapping like
        net use Y: \\192.168.1.250\music
     or on your Mac through a short "Volume" reference.
  
4. Absolute file paths for optimum match
  
   If you create playlist files containing full absolute SMB path names,
   using UNIX Forward Slashes "/" (not Windows Back Slashes "\") like in
 
     #EXTINF:232,La Grange - ZZ TOP
     smb://RackStation/T-Drive/Musik/trivumDemo/ZZ Top/Greatest Hits/La Grange.mp3
     #EXTINF:239,Gimme All Your Lovin' - ZZ TOP
     smb://RackStation/T-Drive/Musik/trivumDemo/ZZ Top/Greatest Hits/Gimme All Your Lovin'.mp3
     #EXTINF:254,Sharp Dressed Man - ZZ TOP
     smb://RackStation/T-Drive/Musik/trivumDemo/ZZ Top/Greatest Hits/Sharp Dressed Man.mp3
     #EXTINF:123,The ue=ü track - trivum
     smb://RackStation/T-Drive/Musik/trivumDemo/UmlautPfade/the ae=ä and oe=ö album/The ue=ü track.mp3
  
   then chances for a full match are best. Special characters should then
   be encoded as UTF-8 as seen in the last track above.
   
You may also check what the server does in detail
during playlist import, by opening the URL
 
  /print/scanner-trace
  
at the server Web GUI. Look for lines like:
  m3u.noacc:  -  file not found under that filename
  m3u.fuzz :  -  playlist entry matches by fuzzy name comparison
  m3u.remap:  -  playlist entry matches by remapped path name
  m3u.miss :  -  entry cannnot be matched to tracks in the database

5. special cases

   trivum MusicCenter 7.79 with iTunes under Macintosh:
   there was a bug in the path matching, is fixed with 7.80.

[123] TuneIn playback no sound with empty track database

While the trivum track database is empty (no albums),
TuneIn radio station play is not possible. Although
you may select stations on the Touchpad and everything
seems OK, there will be no sound.

Fix: should be fixed from Version 7.77 or 8.19 of MusicCenter.
 
Workaround: configure a NAS and synchronize at least one music file,
then try again the TuneIn radio play.

[124] How to reset the music database and all coverart

With System V8, select
  
  Database & Media / Database / Reset
  
or call the following command by browser:
  /xml/system/control.xml?action=clearDatabase
 
This can be helpful in some rare cases, e.g. if cover art
does not appear in the player screen after a software upgrade
although a normal rescan was selected. 
 
After a database reset, select on Rescan all.
The whole NAS content will be re-read in complete,
which will of course take much longer than a normal rescan.
   
With System V7 you may select:

- Streaming / Coverart / Delete coverart cache

and then run a normal rescan to make sure cover arts are rebuilt.

[125] Pioneer SC-LX76 Receiver HDMI selection not working

Switching HDMI sources with a Pioneer Receiver shows no reaction.

Use instead sources by these names: BD, DVD, DVR, SAT, Video1.
(as they are written at the back of the physical device).
For example, instead of HDMI Input 1, use "Source DVD". 
SAT (not TV/SAT) selection requires MCenter 7.78 or 8.20,
or you have to configure it manually as source SAT with "RS232 06FN".

[126] Coverart does not show in Audioplayer screen

After a System V8 (e.g. Audio actuator) software upgrade, it can happen
that music is listed with cover art in the artist/album search, but when
playing one of these tracks, the player screen does not show cover art.
 
In this case, you have to clear the whole music DB (with all cover art),
as described in article 124 above, and then rescan everything.

[130] Touchpad: how to set the time

The trivum Touchpad receives it's date and time:

1. from the trivum MusicCenter Server, if it is connected to one.
   To change the timezone, enter the server's configuration web GUI.

   System V8: Enter System / Basic Setup. There you should be able to select the time zone.
              V8 Installer Line always uses NTP.
              Note: before Software Version 8.19, the time zone selector fields
              "Etc/GMT+/-" did the opposite of what is expected,
              e.g. Etc/GMT+1 did actually decrement the time by one hour.

   System V7: Enter Controller / Settings. Here you can select if to use NTP (automatic
              time update) or manual time configuration.
              Note: before Software Version 7.77, the time zone selector fields
              "Etc/GMT+/-" did the opposite of what is expected,
              e.g. Etc/GMT+1 did actually decrement the time by one hour.
              
   OR:

2. via NTP (Network Time Protocol). this is used if the Touchpad
   runs as a pure KNX touchpad without MusicCenter connection.
   However, it may happen sometimes that NTP is not active internally.
   If a standalone touchpad shows the wrong time, select:

     System Menu / Info / scroll down at the left, then Special Settings.
     Then type "ntp on".

To use NTP, it is furthermore required that the trivum components have
internet connection, and that the DHCP server provides valid Name Server data.
   

[131] List of available Control units (Keypads)

Web based keypad: 
  A simple 2x16 character display virtual keypad
  intended for Firefox, Chrome and Safari web browsers.
  Often a web keypad is also used for easy automation tasks,
  by defining commands on it's 16 keys, and then calling
  these commands by directly by HTTP requests.
  See also: Homeserver visu below.
  
Web based iPhone/iPad support:
  A web based keypad optimized for display in Safari
  running on iPhone or iPad. On these devices, however,
  the trivum iPhone app is used primarily.
  
Gira HomeServer visu:
  A virtual keypad used just and only as an automation interface
  with applications running on a Gira HomeServer.
  Receives HTTP commands (virtual key presses), and sends back
  status updates by UDP text to the configured home server.
  For more about the HTTP/UDP automation interface, read
  ftp://service.trivum.com/Media%20trivum/Developers/mcenter-v7-interfaces.txt

trivum WebApp visu:
  A web browser based GUI allowing to define KNX objects,
  called the Apps, for KNX control through a web browser.
 
trivum WebTouch visu:
  A simulated Touchpad for use in a web browser, primarily
  used for integration in Homeserver applications which
  are able of displaying web browser controls.   
  

[132] How to select Web Radios via KNX

System V8 only:
-  select a TuneIn radio station via Web Visu or Touchpad.
-  add it to favourites.
-  then create a KNX event:
   KNX Events / Add action / change action,
   Activate a source / Streaming Source / play a TuneIn favourite station
  
System V7/V8:
-  create Index Playlists. These are playlists with a special
   name format like "P1 my playlist", "P2 playlist" etc.
   and place one web radio into each playlist.
-  import those playlists to the trivum server.
-  with System V7, you have to configure how many
   of these playlists should be offered for assignments:
     Streaming / Settings / Number of direct access playlists
   enter here any number from 1 to 10.
-  these playlists can now be selected in diverse commands,
   e.g. on a web keypad key, or for KNX actions.
   For KNX,
   - define a KNX sensor
   - under "action 1 telegram", it should now be possible
     to select playback of index playlist #1, #2 etc.
     through
        global source / streaming / archiv /
           play playlist # ...

[133] V8 NAS and iTunes database scanning

the trivum server can use music files stored on 
a NAS (network attached storage) in formats
.mp3, .flac and .m4a.
 
when scanning a NAS, a list of invalid music files
may be produced.
  
  this means the music files
  -  cannot be accessed, or
  -  has empty or incomplete meta data,
     especially
     -  empty artist name
     -  empty album  name
     -  empty track  name
     which can be checked by tools like 
     -  iTunes: right click on any track, select "Information"
        and see if artist, album and track name data are non empty.
     -  MP3Tag: run that tool, load any album folder on your NAS,
        and see if artist, album and track name data are filled in.
 
  when importing CD's to a NAS, make sure to use software or a service
  that automatically writes artist, album and trackname informations
  into the music files, and ideally also cover art data.
   
  when purchasing music files from the web, make sure they 
  contain artist, album and trackname meta data.
  
  a maximum of 100 entries is listed,
  also in the following categories.

iTunes track mismatches:

  trivum gets a list of tracks from the iTunes database 
  and tries to find those tracks in it's own database. 
  this match is done by Artist name, Album name and
  Track name, or by the Music file path. Possible 
  reasons why matching fails can be:

  -  the iTunes database contains references to files 
     on a different NAS, or a different path in the NAS, 
     or even local files on some PC or Mac not related
     to the NAS

  -  Artist, album or track name or the music file path 
     contain special characters. trivum tries to convert 
     those characters, but this will not always work
     
  -  the same track is listed twice in the iTunes database, 
     referencing two different music files. the first 
     listing will be used by trivum, further listings 
     are skipped
     
  -  tracks with a format not readable by trivum,
     especially .wav files, should not be added
     to the iTunes database

  If an iTunes playlist misses tracks within trivum, 
  the reason are always mismatched tracks in the iTunes database.

Unsupported playlist file type:
 
 Only playlist files with .m3u extension are supported,
 but not .m3u8 or .pls files.
  
M3U playlist mismatches:

 trivum reads .M3U files found in the NAS and tries
 to match the entries within those files
 by Artist name, track name, and music file path.
 Possible reasons why matching fails can be:

  -  Artist, album or track name, or the music file path
     contain special characters. trivum tries to convert
     those characters, but this will not always work.
     
  -  music files are stored in a complicated
     non-standard directory structure with too many
     directories. the recommended structure
     on a NAS looks like:
     
        /music/artist name/album name/track name
        
     with "music" being the share name exported
     by the NAS. if there are additional folders
     between "music" and the artist name,
     trivum tries to match the path although,
     but this will not always work.
 
 If an .M3U playlist file produces many errors,
 best open it with a text editor and check
 entries for plausibility. For example, if all
 entries refer to music files stored on a completely
 different NAS machine or path, it cannot work.

Files without cover art:

 usually, all files of an artist+album combination
 contain cover art. if one or more files do not,
 then the first file per album is listed here.

 this does not necessarily mean there is no cover art
 displayed for the album; if at least one file
 within the album contains cover art, you can ignore
 further error listings for this album.
 
Files with unreadable cover art:

 please check the listed files with a tool
 like mp3tag if they contain unusually large
 cover art files, or files with an image type
 not being jpeg or PNG.
 
Reasons for slow scanning:
 
 Check carefully if your NAS contains redundant tracks,
 i.e. them same Artist/Album/Trackname unit stored
 in multiple music file, maybe in different folders,
 maybe with different formats (like .mp3 and .flac).
 This may also cause Playlist mismatches.
  
Recommended NAS folder structure example:
 
 If there is a NAS machine called "mynas",
 it is recommended
  
  -  to provide a share name "music"
     that exports a folder "music".
  -  to create a folder "playlist" within "music".
  -  to have folders of all artist names
     within "music". within these folders,
     there should be album folders,
     and therein the actual music files.
  -  to create an iTunes database within "music".
      
 when entering the NAS share at trivum, it will look like
   
  smb://mynas/music
    
 and all further paths will look like
  
  smb://mynas/music/playlist       - may contain .m3u files
  
  smb://mynas/music/Abba           - first artist folder
  smb://mynas/music/Abba/The Album - first album folder
  smb://mynas/music/Abba/The Album/Eagle.mp3   - music file
    

[133.2] Windows PC Music Share With iTunes Database

Step By Step creation of a Windows PC
- iTunes Database
- with music files
- with automatic playlist scan

1. Create a Music folder C:\Music

2. Create a new iTunes Database within this folder
   2.1. make sure iTunes is not running
   2.2. hold SHIFT and (double) click on the iTunes Icon.
        You should see a popup:
           Select iTunes Database
        Select:
           Create new database.
        As target folder, select C:\Music
        -> the iTunes Database will be created within C:\Music

3. Copy music files into C:\Music.
   Find a folder with .MP3, .M4A or .FLAC audio files
   and copy all contents into C:\Music with a folder structure like
        Artist\Album\Trackname1.mp3
        Artist\Album\Trackname2.mp3
        Artist\Album\Trackname3.mp3
        ...

4. Import the music files from C:\Music into the iTunes database
   Select: File / Add folder to database.
           Select folder: C:\Music
           -> all music files from within C:\Music
              are now referenced by the iTunes database.

5. Make C:\Music accessible in your network:
   In Windows explorer, right click on C:\Music
   and make it available in the network under Share a name "Music".

6. Enter network path in trivum:
   Select Database & Media / add network share.
   If your PC has a name MYMACHINE then enter as URL

     smb://MYMACHINE/Music

   About username and password: Windows requires that you connect
   with some username and password, even if the network share
   does not need it. So at least enter these data:

     Workgroup: (leave empty)
     User: user
     Password: pass

   The text "user" and "pass" are dummies but required
   to allow a successful Windows share connection.
   Of course, if your share is protected by another user/pw
   then enter that instead.

7. Enable automatic iTunes Database scanning
   Select: iTunes database file / Settings, and check
      "Use iTunes DB playlists"

8. Start scanning.
   Select Database / Rescan all.
   Then click repeatedly on the circular arrow button at the top,
   left to "add network share", to refresh the page.
   - right near the network share path, it should show "Was readable".
   - there should be status updates at the bottom.
   - after the scan has completed, right near "iTunes database file"
     there should be an info "found".

If something is missing, check the structure and content
of your C:\Music folder. It should look similar to:

  EXAMPLE FOLDER STRUCTURE FOR NETWORK SHARES

     Music\iTunes 1\iTunes Library Extras.itdb
     Music\iTunes 1\iTunes Library Genius.itdb
     Music\iTunes 1\iTunes Library.itl
     Music\iTunes 1\iTunes Library.xml
     Music\u2\POP\Discotheque.mp3
     Music\u2\POP\Do you feel loved.mp3
     Music\u2\POP\Gone.mp3
     Music\sade\The Best Of Sade\Cherish The Day.mp3
     Music\sade\The Best Of Sade\Hang On To Your Love.mp3
     Music\sade\The Best Of Sade\Is It A Crime.mp3

This means:
  -  there should be artist folders (e.g. u2 and sade)
  -  within those folders, there should be album folders
  -  within those, there should be music files
  -  there must be an iTunes database home folder:
        iTunes 1
  -  there must be an iTunes database .xml file
        iTunes 1\iTunes Library.xml
     this file contains playlist informations
     and is scanned by trivum for changes.

[133.3] NAS with iTunes Database and Playlists best practice

How to create an iTunes database directly on a NAS that
trivum can read to synchronize playlists.
  
For example, the nas is called "mynas" and all music is
available from smb://mynas/music
 
1. on a PC or Mac, install iTunes.
   Under Windows: keep SHIFT pressed and double click 
                  on the iTunes icon.
   Under Mac:     keep Alt pressed and click
                  on the iTunes icon.
   iTunes will ask you to select any iTunes database,
   or to create a new one.
 
2. Select "create new database". As the target folder,
   select the NAS music folder.
   iTunes will create a database folder within "music",
   containing some files, the most important being
   "iTunes Library.xml".
    
3. now iTunes presents an empty database.
   Select: File / Add Folder, and select the "music"
   folder from the NAs. iTunes will import all music.
   Import means it keeps references to the music files,
   but it does not copy them.
    
4. create some playlists in iTunes.
 
5. with a web browser, enter the trivum V8 configuration surface.
   Select Database+Media and configure the NAS path
     smb://mynas/music
   then select: iTunes database file / settings
   make sure that "Use iTunes DB playlists" is checked.
   then select: Database / Rescan all.
    
After scanning the whole music folder trivum should also find
the iTunes database and import playlists automatically.
 
Furthermore, trivum will check every 15 seconds if the iTunes
database file was changed, so changes in playlists should
ideally be updated within halve a minute.

[133.4] iTunes database on NAS does not use Mediathek.xml

When creating an iTunes database directly on the NAS as described
in article 133.3 above then iTunes will store all song informations
in a file: iTunes Library.xml
 
If, however, such a file does not exist on a NAS, but instead
you find a file "Mediathek.xml" with contents looking similar 
to an iTunes database, then this is no live database!
 
It is just a manually exported copy, or backup, created
in iTunes by: file / mediathek / mediathek exportieren
  
trivum does not use this file for good reason, as it will
never be updated if the user changes his playlists within iTunes.
 
To fix this issue, create a real iTunes library on the NAS,
as described in article 133.3, then delete the Mediathek.xml file 
to avoid further confusion.

[134] Does trivum support LON Local Operating Network bus?

No. Some vendors may offer LON/KNX bridges, but trivum
has no information how good or bad these devices perform.

[135] How to use Touchpad for KNX only, without Server

A trivum Touchpad with configured KNX objects can be used
standalone even if the music server is not available.
 
To do so,
- find the Touchpad IP address, on the Touchpad,
  under System Menu / Info
- open a web browser on your PC, and connect to 
  this IP address. You should see the
  "trivum touchPad Setup Tool" page.
- under "Operation mode", select "Mainly used to control KNX".
- in the Touchpad, touch the time/date at the top
  to enter KNX mode. it should now stay in this mode
  even if no server is available.

[136] Touchpad alarm icon shows no time

The time is shown only if there will be an alarm within
the next 24 hours.

[137] JUNG Facility Pilot (FAP) Integration

The trivum Actuator or Pro Line with Software V8
allows integration into FAP visualisations
through the WebTouch Visu control.
 
So far there is only German documentation,
please refer to the German FAQ, article 137 under
http://service.trivum.com:90/mediawiki/index.php/FAQ#.5B137.5D_JUNG_Facility_Pilot_.28FAP.29_Integration

[138] Gira Homeserver Quad Client Integration

The trivum Actuator or Pro Line with Software V8
allows integration into Gira Quad Client visualisations.
     
So far there is only German documentation,
please refer to the German FAQ, article 138 under
http://service.trivum.com:90/mediawiki/index.php/FAQ#.5B138.5D_Gira_Homeserver_Quad_Client_Integration
  

[139] Maximale Verlustleistung Poweramp 819, Cardhost C4

Poweramp 819: Maximal 120 Watt Verlustleistung (Abwärme).
Cardhost C4 : Maximal 35  Watt falls keine Speaker Connect Karten verwendet.

[140] Time cannot be set manually with MusicCenter V7

Even after disabling NTP, after a server restart there is always
the time before manual changes. A possible reason can be that
there is a fix configuration that receives time from the trivum
server, to work around NTP problems with earlier software versions.

[141] Touchpad time differs with trivum Server

If you want the Touchpad to receive it's time from the trivum Server,
make sure that NTP is disabled locally at the Touchpad:
 
  System Menu / Info / Special Settings
  "ntp off"
 
If you want the Touchpad to use NTP, but it always
displays GMT time, then the time zone infos have not been
installed yet. Just run a software update using
 
  System Menu / Setup / Online software update
   
and it should be fixed.

[142] Epson Beamer EB-G5750WU/EH-TW9000 Control

If the beamer behaves unexpected or permanent error
messages are shown, upgrade to server 7.80 or 8.26 
and select EB/G5750 device.
 
This mode sends two commands to check power and source
status like "PWR?" and "SOURCE?" without blanks.
(In VP21 mode the commands are "PWR ?" and "SOURCE ?")
 
If, after switching to this mode, the device cannot
be switched off correctly, also select advanced /
alwaysPowerOnOff in the device.

[143] 4 Zone Actuator "Fuse Broken" Message

All power connections must be connected, otherwise
this error appears. Look for the "Power - +" marks
on the actuator and connect both sides to the
power supply.

[144] Music Database is deleted unexpectedly

With System V7, check if 
  Streaming / Settings / Daily automatic NAS rescan 
is active, and if under
  Streaming / Library / Network Paths
no path or an invalid path is configured.
If so, disable the automatic NAS rescan.
 
Since System V7 Release 7.80, this behaviour is
changed and the database is no longer deleted
if no paths are configured.

[145] Audio Actuator Initial Setup

Follow the first steps manual as given under
ftp://service.trivum.com/Media%20trivum/Documents/AudioActuatorQuickInstallationManual.pdf
and make sure the Actuator is physically running,
with LEDs lighting up and connected to the LAN. 
  
If you cannot run the supplied software CD,
download the ServerAdmin tool from
ftp://service.trivum.com/Installer/Install-ServerAdmin.exe
as it is important to find the Actuator in the network.
 
Alternatively, you may also use the tool "tlist" to find
the component via Windows or Mac command line.
To use tlist, download for Windows:
  ftp://service.trivum.com/Installer/servicetools/tlist.exe
  ftp://service.trivum.com/Installer/servicetools/libgcc_s_dw2-1.dll
and for Mac:
  ftp://service.trivum.com/Installer/servicetools/tlist-mac
  (do not use the Finder to download under Mac, but a real
   FTP client. see article 007.1 for more.)
then type "tlist".
 
The Actuator uses DHCP to automatically receive an IP
from your LAN DHCP server. If you can identify the
Actuator IP from the above steps, type it into your
web browser (Firefox is preferred) to enter the
configuration pages.
 
For all further steps, read the context help in these
pages, and the FAQ area under:
http://service.trivum.com:90/mediawiki/index.php/FAQ-en
  
see also: #165 Actuator LED light blink codes
 

[146] trivum automation interfaces for HTTP, XML, UDP, KNX

How to control the trivum system by HTTP, XML, UDP: see
ftp://service.trivum.com/Media_trivum/Developers/mcenter-v7-interfaces.txt
 
How to control the trivum system by KNX events: see
http://service.trivum.com:90/mediawiki/index.php/FAQ-en#.5B085.5D_KNX_Setup_and_Network_Configuration_Checklist
http://service.trivum.com:90/mediawiki/index.php/FAQ-en#.5B132.5D_How_to_select_Web_Radios_via_KNX
http://service.trivum.com:90/mediawiki/index.php/FAQ-en#.5B086.5D_KNX_device_control_configuration_guide
http://service.trivum.com:90/mediawiki/index.php/FAQ-en#.5B104.5D_KNX_Network_Traffic_Analysis_using_Tools
and all other articles with "KNX" in their title under
http://service.trivum.com:90/mediawiki/index.php/FAQ-en

[147] Software update by ServerAdmin tool does not work

The ServerAdmin tool supports direct software update only for
Audio Actuators and Touchpads. For other components like Pro Line
servers, use Admin / Check for softwar updates in the web surface. 
 
Touchpad: if the Touchpad shows "Connecting" and has as software < 1.70
          then Update commands from the tool will be ignored.
          Instead enter the System Menu in the Touchpad,
          then select Setup / Online software update.
  

[148] Static IP cannot be configured with Audio Actuator

Full support for static IP is available only from SW Version 8.29.
If you update to 8.29 you may have to run the update twice.
  
To find the static IP settings, follow these steps (V 8.49 or higher):
- System / Basic Setup: enable "use expert mode"
  then you should find new settings
- System / Basic Setup: Expertmode settings: Use static IP

[149] Actuator: Cannot control hardware error

- if both the red, green and yellow LED are blinking
  for a while, with silent pauses for 5 to 10 seconds inbetween,
  it can be caused by a sticky reset key that is pressed down
  permanently by the Actuator casing.

[150] How to identify trivum Components by Serialnumber

C4 Professional System: 
- find the serial number on the C4 Processor card. 
  This card typically contains an "Eth" LAN connector, 
  a "Fan" connector, and at the right top a small 
  serial number.
- with software V7, you will not find a valid 
  serial number in the web configuration (there are
  only dummy values 520 or 12326).
- with software V8, you may also find the Serialnumber
  in the web configuration GUI at the top near SNR.
 
Audio Actuator: find the serial number printed on the
Actuator itself, and in the web configuration GUI
at the top after "SNR".

[151] Touchpad and Webcam / Network camera configuration

How to configure a webcam at the Touchpad
  
   - Make sure you have Touchpad SW Version 1.69
     or higher (System Menu / Info).
     If not, select System Menu / Setup / update.
  
   - use only Webcams that deliver Motion JPEG streams,
     i.e. a sequence of plain JPEG images.
     Do NOT webcams that require any kind of browser
     plugin (Quicktime or Flash) as the trivum touchpad
     does not support such kind of video streams.
   
   - configure the webcam:
     - to use JPEG or MotionJPEG (but NOT MPEG-4 etc.)
     - to use a low resolution of 320x240,
       with 10 fps (these settings might be hidden
       somewhere under "Advanced settings").
       You may try higher resolutions 
       and frame rates later, but they may cause 
       bad performance and even an empty picture.
   
   - find the Touchpad IP address under
     System Menu / Info

   - open a web browser and type that IP address
     to enter the KNX configuration pages.

   - select "KNX Objects"

   - select "Add KNX object or App", then Apps / Webcam
     (some SW versions may require Google Chrome browser here)

   - in the camera configuration dialog, select "Example 1".
     Now you see how a webcam URL should be typed:
     - without leading http://
     - it must be the URL of a real .jpg or .mjpeg object,
       not an .html page.
     - default port is 80.

   - now find out the web address (URL) of your camera
     image or image stream. to do so,
     - open the camera web page of your camera where
       an image is shown
     - press right button on that image,
       select "Copy Image Location"
     - then reenter the trivum touchpad configuration
       surface and paste that address into the 
       camera configuration.
       - remove the leading "http://"
         if it wasn't done automatically
       - if the URL contains a port number,
         e.g. ":8080" then remove it from the URL
         and type it into the port field.
     Normally, the new image should appear instantly
     in the webcam on the touchpad.
  
What to check if no webcam image appears
  
     If you open the webcam App in the Touchpad's
     KNX pages, but see no image:
 
     -  make sure the Touchpad SW version is 1.69 or higher
        as older versions send fixed authentication data
        (user="admin", password="1234")
        that can be misunderstood by webcams.
 
     -  check if the camera allows anonymous access.
        If not, enter webcam username and password
        in the trivum webcam configuration.
        (The password field appears as soon as
         the user name is set.)
 
     -  check if the camera allows parallel access
        by multiple clients. maybe it allows only
        single client access and, because the image
        is already shown in a web browser, the
        touchpad access is blocked.
     
     -  create an empty tab in your web browser
        and open the camera image URL therein,
        to make sure it actually delivers
        JPEG images.
         
     -  maybe restart the Touchpad. However in most
        cases this shouldn't be necessary if the
        configuration data is correct.
  
Other errors
  
   An image appears, then the touchpad freezes
   for several seconds, then the next image appears:
   -> this happens if the webcam image resolution
      is far too high, e.g. 1280x480. reconfigure
      your webcam to use a lower resolution.
 
Tested Webcams
  
   The following wem cams have been tested:
   - Axis 205
   - Edimax 7010pt

   The Axis 205 supports up to 20 clients in parallel.
   If it is important for you to view the same web cams
   on multiple touchpads in parallel, make sure to use
   a webcam that supports multiple streams. For example,
   the Axis m7001 does NOT support multiple streams.

   The Edimax may also support multiple client streams,
   but this was not tested so far. Please check the
   product specification at the vendor's website.
  
How to configure up/down/left/right with a webcam
  
   In the webcam object, fill in the field "command
   address" with the base URL on which your webcam
   receives commands, for example
     192.168.1.229/com/ptz.cgi?move=
     
   Once done, new fields appear like:
   - command UP
   - command DOWN
   - command LEFT
   - command RIGHT
   
   fill these in as well, for example
   - command UP: type "up" etc.
     
   depending on the commands your camera supports.
   For example, touching "up" should then send a command
     192.168.1.229/com/ptz.cgi?move=up
   to the camera.

[152] WLAN Errors while streaming Audio with Actuators

Trivum uses Multicast messages to send audio from a
master actuator synchronized to it's slaves.
 
Depending on the switch used in your network,
it may or may not be able to filter Multicast traffic.
 
Make sure to use a switch that supports an option:
 
  Enable IGMP Snooping
  
Which is, for example, the case with D-Link DGS 1100-16,
in it's configuration GUI under "L2 Features".
 
With this option, the Multicast messages are sent ONLY
to devices that subscribed to this kind of traffic,
but NOT to the whole network, like the WLAN.
 

[153] RS232 Adapter can be listed but not connected/programmed

Check your network switch if "IGMP Snooping" is active.
The trivum IrTool Software uses Multicast messages
to send commands to the adapter, but so far it does not
use the IGMP protocol. Disable IGMP Snooping at your switch
(e.g. within D-Link DGS 1100-16 under "L2 Features")
and it should work.

NOTE, however, that if you are ALSO using trivum Actuators 
with synchronized audio play back AND a WLAN, then IGMP 
Snooping must be active, so the above deactivation should be 
temporary for programming only. (See article 152)

[154] IR/RS232 Adapter power supply connection

Possible options for power supply:
 
  1. A POE switch that delivers 48 V via CAT 5 cable
     
     OR
     
  2. A CAT 5 Power Injector, which itself is 
     connected to a 48 Volts power supply.
  
     NOTE: never connect this 48 Volts power supply
           directly to the adapter!
  
     OR
     
  3. A 15 (!) Volt Power supply connected directly
     to the IR/RS232 adapter.

[155] Control volume by KNX with system V8

Volume of a zone can be controlled by knx via:
  
- Zones / zone / KNX Settings: GA to control zone volume.
  
  You have to find out if your KNX sensor
  sends 4-bit events of the kind "start volume increase, 
  stop volume increase",
  or if it sens 8-bit absolute values (0-255).
  
  Then fill in either the 4 Bit field, or the 1 Byte field.
  
- KNX Events / Add action / control a zone / volume + or -
   
  This can be used as an alternative to the above,
  for example if your KNX sensor sends only 1-bit messages
  for "increase volume" or "decrease volume".
  
If a KNX Event mapped to Volume Up or Down does nothing:
 
Make sure you are selecting the correct volume event.
  
When playing a streaming source (MP3 playback),
select for Volume Up/Down:
 
     Control a zone / volume + or -
  
On a Pro Line system, if a device like DVD player is active,
you may select for Volume Up/Down:
  
     Multikey commands / amplifier,switch / Device Volume + or -
      
But do not mix these up, e.g. when using "Device Volume +"
while a streaming source is active, nothing will happen.

[156] Touchpad Add KNX Object or App cannot be used

This happens with some SW Versions of Touchpad and the Firefox browser
if you are trying "KNX Objects / Add ..." in the Touchpad
web configuration surface. It is fixed with SW Version 1.79.
 
As a workaround,
  -  select KNX Display / Configure / add KNX object,
     which uses a different way of displaying the selection menu
  -  or use the Google Chrome browser

[157] How to trace IR/RS232 Adapter communication

If a device connected by IR/RS232 adapter does not react,
follow these steps to trace the communication:
  
1. activate device I/O tracing at server side
 
   System V7: select Addons / Devices / open device,
              then advanced / verboseMode
  
   Then send test commands: Addons / Devices / open device,
   select Commands, select Send at the left side.
 
   Then open in the web browser:
     http://{serverip}/print/controller-trace
  
   If you see messages like:
     << send: "MYCOMMAND {0D}{0A}"
   this means a command was SENT to the Adapter,
   and the Adapter tried to forward to the device.
     
   If you see messages like:
     >> recv: 
   this means a response was received from the device.
   
   If reponses are listed, however, also depend
   on the kind of device driver chosen.
   Unidirectional drivers may never list a response.
   In such a case, the following may help:
   
2. trace communication directly at the Adapter
   
   To do so, find out
        -  the IR/RS232 Adapter IP address
        -  the IR/RS232 Adapter Serial Number
        -  the IR/RS232 Adapter Firmware Version
  
   System V7: IP and SNr are listed under Addons / Devices 
              in the Status column.
              Firmware Version is listed under Adapters.
               
   Then download the trivum trace tool from
   ftp://service.trivum.com/Installer/servicetools/
 
   Windows: download trace.exe AND libgcc_s_dw2-1.dll
   Mac    : download trace-mac
     
   Then open a Shell or Command Line Window
   (e.g. Windows: select Run then type CMD.exe)
   and go into the folder of the downloaded tools.
   
   RS232 Adapter Version 1.12 and lower:
   
      Windows: type: trace adapterip
        
      Mac    : type: chmod 777 trace-mac
               then: ./trace-mac adapterip
                
      Now you should see something like
     
        Tracing: 192.168.1.133
        trivum TraceMonitor V1.08 (Port=1222 Target=192.168.1.133, VMar 14 2013/11:11:41)
        
      and you may press
        'i' for information
        't' to toggle event tracing outputs
         
   IR+RS232 Adapter Version 1.13 and higher:
      
      Make sure you are using trace tool 1.09 or higher,
      otherwise you cannot trace the adapter.
   
      Windows: type: trace ir adapterSerialNumber
  
      Mac    : type: chmod 777 trace-mac
               then: ./trace-mac ir adapterSerialNumber
                 
      no interactive options are available.
     
 3. control the device manually
   
   Instead of sending commands via trivum to the device,
   also try to control the device directly, e.g. by
   switching on a DVD player by it's power key, then
   loading a DVD and skipping tracks manually,
   to produce possible RS232 replies that may
   show up in traces as described above.
  
 Typical RS232 Adapter replies:
 ------------------------------
 depending on the adapter firmware, more or less
 informations are shown.
  
 RS232 Adapter V 1.03 examples:
      
     Got cmd #64  
        -> means adapter got an RS232 command
           from the trivum server which will be
           forwarded to the actual RS232 device.
             
     Sent message to device
        -> typically after cmd #64, the command
           was sent to the actual RS232 device.
   
     Got cmd #67
        -> means adapter got an AdapterInfo request
          
     Sent device reply to controller {IP}
        -> means adapter got data from the actual
           RS232 device and sends it to the server
             
     This firmware allows interactive 'i' command
     to check some cable pin status.

[158] Error: Resource sharing conflict

This appears if
 
- an Actuator B was a Slave of another Actuator A.
  
- then B's mode was changed to "Installer Master"
  without unregistering B at A.
  
To fix this issue, go into the web configuration
of the primary Actuator A, look into Zones,
and delete B from the list of active Actuators.

[159] Error: Zone is undefined

This appears, for example, if
 
- a Touchpad is using an Actuator in Installer Master mode.
  
- then the Actuator's mode is changed to Slave.
  
-> a direct control of a Slave Actuator by Touchpad
   is not possible, the Touchpad looses the connection.
   Therefore zones referenced on that Actuator
   become invalid or undefined.
    
To fix this issue, enter at the Touchpad:
  System Menu / Setup / Touchpad Settings /
     MusicCenter Link
     
and select another Actuator which is in Master mode.

[160] KNX Touchpad: RGB dimmer color wheel is not shown

Touch the dimmer object in the KNX page,
and keep it touched for 2-3 seconds.
The color wheel popup should be shown then.

[161] 4Zones Actuator: Voltage too low Alert

Possible reasons:
- no power connected to the lower part of a 4zones
  actuator. (if the upper part has no power, the
  system cannot run at all)
- OR: fuse broken for the lower part.
- OR: there is power connected, but really too low
  voltage (it must be 24 V)
  
Note: due to technical reasons, in the 4zone actuator
"Voltage too low" will appear on all 4 zones even
if the voltage is only too low in 2 zones.
   

[163] Short Sounds may not play correctly

If you try to play short music files with less than 15 seconds,
it may happen that only a few seconds or even less is played
and then the track is repeated or skipped.
  
This also depends on the sample rate used (22 kHz versus 44 kHz).
 
To achieve correct playback, you may
- create a longer music file that contains the same sound
  many times
- or extend your music file by up to 15 seconds of silence
 
with an audio file editor like Audacity.

[164] Error: No Zone Player with grouped Actuators

If you combine a master Actuator with one or more Slave
Actuators, then try to play music via Touchpad or some
other visualization, and an error appears:
  
  RC ... No Zone Player
  
then this might be caused by wrong configuration files
produced by earlier versions of the software.
You should then select
  
  Admin / Advanced / Reset Zone Configuration List
   
but be aware that this will delete all settings
of your zone, including Actions and KNX addresses.
 
After this step, regroup the master and slaves
and try music playback again.

[165] Actuator LED light blink codes or patterns

LED Blink Codes:
- as long as the device is starting, yellow and red
  flash synchroneously once per second
- as soon as the software is fully operational,
  yellow and green should be flashing,
  with red being off.

Please Note:
- if an actuator is blinking Red, and you press Reset,
  the red blinking may continue for a while
  until the device has fully restarted.
  Please allow one minute after pressing Reset
  until the blinking stops.

[166] Actuator red LED light is permanently active on first use

The red LED is on during start phase. If it stays on permanently,
please check the following:
   
By default, the device requires a network with a DHCP server
to get it's IP address. If no DHCP server can be reached,
-  green and red LED will stay on permanently
-  with the red LED blinking shortly inbetween
  
In such a case,
-  ask your network administrator to provide a DHCP server
-  make sure the trivum device is fully connected to the LAN network
   so that it can physically reach the DHCP server
-  then press reset at the device, or disconnect it from power
   temporarily for a restart.
     
If DHCP is available at least once then the device can be
reconfigured to use static IP in the future. To do so,
download and run the trivum Administration Tool from
ftp://service.trivum.com/Installer/Install-ServerAdmin.exe

[166.2] Actuator red LED light is permanently active after Software Update

When updating with a huge version jump, e.g. from 8.16 to 8.47,
it may happen that flashing of internal components does not fully suceed
in the first step, and this may cause the red LED to be active permanently
although the configuration GUI does not show an error.
 
In this case, repeat the software update (up to 3 times) until the LED
goes off after full reboot.
 
Another reason can be a jammed reset button.
Check if the reset button is somehow locked by the casing,
try to press reset once and see if the system reacts normally.

[167] AirPlay Installation and Activation

With trivum server software V 8.49 or higher it is possible
to use AirPlay. If this feature is not active with your system
right now, follow these steps.
  
In the server web configuration:
- select Admin / Install AirPlay support
If you cannot find this menu item, manually type in your browser:
  http://serverip/xml/system/update-airplay.xml
- Wait. This will download and install operating system
  components required for AirPlay.
  Do NOT restart the system for at least 5 minutes!
  You may check installation progress by typing
     http://yourserverip/print/messages
  in your browser. Press Reload (F5) for updates.
  -  as soon as "Checking NSS Setup" appears
     the installation should be complete.
  -  if "libavahi is already the newests version"
     appears then AirPlay install was done before.
- If you checked the above /print/messages page
  that installation is complete,
  or otherwise after waiting for 10 minutes,
  you may select Admin / Quick restart (not Restart master).
  
Then, on Actuators:
  -  check if error messages appear. if so,
     read further below article 167.2.
     if no errors appear then AirPlay should be active.
     You may check per Zone the Basic settings:
     "Control Zone by AirPlay" should be checked by default.
     This means as soon as AirPlay input is coming
     the zone is switched on automatically.
 
On C4 Systems:
  -  enter Zones / first zone / Basic Settings.
     make sure that "Default Streaming Source"
     points to a Stream Source card x.
  -  then enter Controllers / Stream x / Basic Settings,
     i.e. the settings of the Default Stream Source
     of the above zone.
     -  select AirPlay input: Enabled
     -  select AirPlay Control Zone: above zone
  -  then, as soon as AirPlay input is sent,
     that zone will be activated.

[167.2] AirPlay Startup Errors

AirPlay Error: Network (old switch?) uses a unicast .local domain.
 
  This means there is a network configuration that uses a name 
  ".local" to identify the local DNS domain, which is incompatible 
  to the Bonjour protocol required to use AirPlay. In general 
  this is caused by old router/switch hardware, or wrong 
  configuration within such a switch. 
 
  Ask your network administrator
 
  -  to reconfigure the local network NOT to use
     ".local" as the local unicast DNS domain name
       
  -  and/or to replace the router or switch
     by a newer or different one
       
  See also articles:
  http://avahi.org/wiki/AvahiAndUnicastDotLocal
  http://en.wikipedia.org/wiki/Multicast_DNS
   
Alternatively, enter the following at the trivum server:
  
  http://serverip/xml/system/fix-airplay.xml
    
  it will correct some system internal files
  trying to work around the problem.
    
[The following are internal notes for trivum service:]
     /etc/nsswitch.conf
        mdns4_minimal [NOTFOUND=return]
           if present, these keywords must be removed
     /etc/default/avahi-daemon
        AVAHI_DAEMON_DETECT_LOCAL=1
           if present, must be set to 0
     changes can be applied by
        /xml/system/fix-airplay.xml
     however slaves are not fixed by this.
     avahi packages as such
        might be old, requiring avahi reinstall

[167.3] AirPlay Inputs cannot be found in the network

If you try to select trivum AirPlay inputs on an iPhone,
but they are not listed, check the following:
  
- maybe WLAN as such is the problem. Try to use AirPlay
  via normal LAN cable. To do so, install iTunes on a PC or Mac machine, 
  then click on the blue speaker selection symbol, 
  at the top, right to the volume bar. 
  If trivum AirPlay inputs are shown there then it is a problem
  of your WLAN switch, router, or access point.
  For example,
  -  the WLAN router may be configured not to send
     multicast messages into the WLAN. Check your router configuration.
  -  the WLAN router may need a firmware update.
     We have seen routers blocking multicast before the update,
     and passing through multicast after an update.
  -  maybe the WLAN router needs to be replaced by a different
     WLAN access point. see below about AirPort Express.
    
- also compare with other (non trivum) devices that support AirPlay.
  For example, try to stream music to some Apple AirPlay speakers.
  If their inputs do not show up, or are lost after some time,
  then there is a network problem.
   
- while your client application (e.g. an iPhone App) is running,
  select Admin / Quick Restart at the trivum server.
  The server does not permanently announce it's AirPlay inputs
  but only from time to time. By restart you enforce an immediate
  sending of these announcements
  
- if you have no alternative devices to test AirPlay in your network,
  
  1. buy an Apple Airport Express Base. this is a WLAN access point
     that also provides an AirPlay input, with analogue output.
       
  2. connect the AirPort to the same switch where the trivum server
     is connected to. do not connect it to a different switch.
     Configure your AirPort to provide an AirPlay input,
     via the AirPort Utility software.
         
  3. select the AirPort access point in your iPhone as your
     WLAN access point.
     
  4. play some music on your iPhone. select AirPlay outputs.
     check if the AirPort appears for selection.
     if it does NOT appear then your iPhone may need to be 
     reconfigured to make it appear, or the AirPort itself
     requires a reconfiguration.
     if it appears, however, like in a small Window showing
   
           +-----------------------+
           |        AirPlay        |
           |-----------------------+
           |))) iPhone             |
           |[O] AirPort            |
           +-----------------------+
   
     then touch into the area with "AirPort", keep it touched,
     and try to scroll it up by moving the finger in the
     direction of "AirPlay". trivum inputs must show up then, like:
  
           +-----------------------+
           |        AirPlay        |
           |-----------------------+
           |[O] trivum: #175 Room 1|
           |[O] trivum: #175 Room 2|
           +-----------------------+
   
Some technical infos: the AirPlay inputs are announced in the network
via UDP multicast messages. Actually the Bonjour protocol is used,
which sends messages to a multicast group 224.0.0.251 on port 5353.
   
- besides using iTunes to see if trivum actually sends
  AirPlay Input announcement messages, you may use
  a command line tool sfk for further analysis:
    
  -  download sfk.exe from
     ftp://service.trivum.com/Installer/freewaretools/
     and store it in a folder like C:\trivum
       
  -  under Windows, open a command line (CMD.EXE)
    
  -  in the command line, type:
     C:
     cd \trivum
     sfk udpdump -bonjour
      
  Then you should see messages like:
     
     [#001 received 295 bytes from 192.168.1.119]
      >00008400 ... 6976756D< ............ 94ACCA02B026@trivum 00000000
      >3A202331 ... 616C0000< : #119 Room 4._raop._tcp.local.. 00000020
      >21800100 ... 4F001C80< !.....x.........twister-8.8.O... 00000040
      >01000000 ... 01000000< ....x................. .O....... 00000060
      >780004C0 ... 20233131< x.....w 94ACCA02B023@trivum: #11 00000080
      >3920526F ... 1F393441< 9 Room 2.-.!.....x.........O.94A 000000A0
      >43434130 ... C02D0021< CCA02B021@trivum: #119 Kuche.-.! 000000C0
      >80010000 ... 30407472< .....x.........O"94ACCA02B020@tr 000000E0
      >6976756D ... 78000800< ivum: #119 Schlafen.-.!.....x... 00000100
   
  which contain a binary data dump, also shown as text.
  If you see messages containing "@trivum" then these are
  AirPlay input announcements by a trivum server.
   
  If you see no messages at all, but there must be (also non trivum)
  AirPlay devices in the network, open CMD.EXE as administrator
  and check your Windows Firewall settings.
   
  If you see far too many AirPlay messages, you may filter like
    
    sfk udpdump -bonjour -from=192.168.1.119
    
  which will show only messages from IP address 192.168.1.119, or
     
    sfk udpdump -bonjour -data "@trivum"
    
  which will show only messages containing the text "@trivum".
    
  Again, if the trivum server seems to send nothing, select Admin / Quick Restart 
  in the server config, as it must send those announcements on restart.

[167.4] AirPlay is not supported by operating system

You may try to fix this yourself by:

- open a web browser, open the web config of the machine
  with this issue

- then read on in article 167: AirPlay Installation and Activation

[168] AirPlay cannot be used from a Desktop Mac or PC

Check if AirPlay is working with any AirPlay device,
for example AppleTV.
   
If this is not the case, check if XBMC is installed 
on your system, and if it has AirPlay support active. 
This may cause incompatibilites. Uninstall XBMC then 
and retry.
  
There may be similar incompatibilities with other
Desktop software that installs AirPlay services.

[169] KNX Touchpad: Shutter Object configuration

The Touchpad KNX Shutter Object allows to configure
the following group addresses:
  
  GA for short action     (to change angle)
  GA for long  action     (to move shutter up/down)
  GA to write  position
  GA to read   position
  GA to set    angle
  GA to read   angle
  
The visualization object looks like:
  
  Small
     +---------------------+
     |   ===============   |
     |     ShutterName     |
     |  __                 |
     |  \/           /\    | - position arrows
     +----------------------
  
  Large (with Set Angle GA)
     +---------------------+
     |  #  ShutterName     |
     |     #  #  #  #      | - preset buttons
     |      __             |
     |  Pos \/ ----- /\    | - position arrrows
     |      __             |
     |  Ang \/ ----- /\    | - angle arrows
     +----------------------
  
Possible Actions:
  
1. Configure "GA for long action",
 
   press Position Down arrow \/
   -> Touchpad sends "1" to "GA for long action".
      The shutter should then start to move down
      and continue to move down until bottom is reached.
      A move down can be interrupted by pressing Up,
      or by pressing an Angle Arrow as below.
      
   press Position Up   arrow /\
   -> Touchpad sends "0" to "GA for long action".
      The shutter should then start to move up
      and continue to move up until top is reached.
      A move up can be interrupted by pressing Down,
      or by pressing an Angle Arrow as below.
   
2. Configure "GA to set angle".
   The angle arrows appear.
    
   press Angle Down Arrow \/
   -> Touchpad sends "1" to "GA for short action".
      Shutter blades should change their angel
      for one step and then stop.
  
   press Angle Up Arrow   /\
   -> Touchpad sends "0" to "GA for short action".
      Shutter blades should change their angel
      for one step and then stop.
    
3. Configure "GA to write/read position".
 
   Press long on a preset button.
   -> position is read from "GA to read position"
      and stored in the Touchpad on that button.
        
   Press short on a preset button.
   -> position is sent to "GA to write position".
 

[170] KNX Touchpad and Chinese characters

To use Chinese characters with the trivum Touchpad,
 
- open a web browser (Firefox or Chrome) and connect
  to the Touchpad's IP address (as shown under
  System Menu / Info / IP Address)
   
- under Touchpad Settings, make sure you have V1.92 or higher.
  Search for: Basic settings / App text encoding.
  Select UTF-8.
  The Touchpad will restart.
  Wait a moment, then reconnect with the web browser.
  Now the configuration surface should use UTF-8 encoding
  and it should be possible to enter Chinese descriptions
  for KNX objects.

[171] AirPlay Installation issues

Since Version 8.49 there is a function available
  Admin / (Re)install AirPlay support
  
However this function is dependent on a fully
functional name server in your network.
After running the function, open
 
  /print/messages
    
and check the status messages.
  
If errors appear:
  -5 - No address associated with hostname
then the Nameserver in your network
is partially unable to resolve hostnames,
causing the AirPlay installation to fail.
In this case,
  -  check your Switch/Router's DHCP data
     which is sent by DHCP to devices
     in your network, esp. Nameserver settings
  -  select a different Nameserver,
     like 8.8.8.8 which should always work.
  -  Quick restart the Actuator
  -  then retry AirPlay installation
  

[172] Web Visu and TouchPanel PC Configuration and Errors

TouchPanel PC with Windows: you must configure the correct
Pointer Device "Click Mode", otherwise things like the
Off button at the right bottom, or Alarm Time changes
will not work correctly. On a Windows XP/Vista/7 System, select

   System Settings / Pointer Device Settings / Click Mode:
       Click and Move

by default, there is a wrong mode "interactive touch" selected,
which
-  produces a popup menu if you press for a longer time
   on the Windows desktop.
-  makes it impossible to switch a zone off by the off button
   at the right bottom of a web visu
-  makes it difficult to change alarm time, as long presses
   on +/- of alarm do not work.

On Windows 8, look for similar settings, and always make sure
that a long press does not produce a Windows Popup.

[173] Internet Explorer: Security Warning with Web Visu

If you modified IE settings to allow Flash installations,
afterwards running the Web Visu (and many other web pages)
may show a line:
  
  Security settings are a risk for this computer
  
  (Die Sicherheitseinstellungsstufe ist ein Risiko für den Computer)
   
This can be disabled by the registry editor.
run regedit, look into
  HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Security
and create a string entry
  Safety Warning Level
with value
  Deactivated

[174] How to skip between different TuneIn favourites

After selecting a TuneIn favourite station, it is not possible
to skip directly to the next/previous in list by < or > events.
However indirectly it can be configured this way:
 
1. define multiple zone sources with different favourites
   - Zones / zone name / Sources / change source
     Activate a Source / Streaming / TuneIn favourite
   - assign multiple favourites this way to multiple
     zone sources.
   Note: if an empty favourite list is shown, but the Touchpad
         or Web Visu does list favourites, it may help to
         restart the server by Admin / Quick Restart.
  
2. then, for example, to toggle between these stations by KNX
   define a KNX group address under:
   Zone / KNX Settings / GA to skip to next/previous source

[175] Play Album plays only one track of the album

This happened with Compilation albums before SW 8.50.
While selecting: Activate a source / Streaming / play
a specific album a specific artist name was selected,
and therefore selected only tracks of that artist
within the sampler album. Update to V8.50 and reassign
the Play Album actions.

[176] Touchpad does not accept any touch presses

If the trivum Touchpad does not react to any touch press,
but everything else (music status display etc.) seems normal
and a cold restart (by power disconnect) doesn't help
as well, then possibly a display connector inside got loose.
Dealers may try to remove the cover (8 screws) and check
the display connector (Folienleiter, Folienstecker),
e.g. by opening the retainer, then remove the connector,
plug it in again, close the retainer.

[177] Touchpad display is upside down after software update

Touchpads with newer display hardware strictly need software
V1.95 or higher. In case you downgraded to V1.93 repeat the
update as V1.95 is online since 11-dec-13.

[178] Touchpad disable default sources display

By default the Touchpad offers the default sources
of the current zone as actions at the right side.
This can be changed in the Touchpad Web Configuration
surface by:
  Admin / Enable Expert Mode
  touchpad Settings / Basic settings:
     don't show default sources as actions
  
then you can enter the server web config,
select Control Units / the touchpad / actions
and configure only the sources you want to see.

[179] AirPlay sound dropouts

These are primarily caused by WLAN reception problems.
Compare AirPlay via WLAN to cable bound AirPlay this way:
  
- on a PC or Mac, install iTunes
- play an .mp3 music file
- make sure the PC/Mac is connected to network
  only by LAN cable, but not (also) by WLAN
- at the top of iTunes, right near the volume slider,
  select trivum as AirPlay output
    
Then, if music plays well from iTunes via LAN cable,
but not from an AirPlay device via WLAN, the problems
are caused by bad WLAN reception.
 
Furthermore, check direct play of music files at trivum.
If sound is interrupted with direct music file play,
then the problem is not AirPlay related.

[180] KNX Scene Configuration example

Example: a trivum actuator should be controlled by KNX scenes.
By selecting two different scenes through GA 1/5/99
the first zone should either be off, or it should play 
a station of the FM tuner.
  
1. System / KNX Setup:
   - enable Use EibNetIP for EIB access
   - GA scene save/restore: enter
     1 5 99
  
2. Zones / first zone / KNX settings:
   - GA to include/exclude in scene: enter
     1 5 90
       
3. Scene programming:
  
   3.1. scene 1: off state 
     
   - make sure the zone is off.
  
   - tell first zone it is part of a scene:
     send through KNX
        1 Bit, Value 1, to 1/5/90
   
     -> to verify if this KNX command was accepted, look
        under Developer/Traces/KNX Trace where it should say:
           "Zone 'first zone' will handle scene part '1' telegram"
  
   - store the current (off) state as scene number one:
     calculate the scene index
        index   = scene number - 1
     calculate the command code
        Store   = 128 plus scene index
        Restore =   0 plus scene index
     send through KNX:
        1 Byte, Value 128, to 1/5/99
    
     -> verify if the KNX trace says:
           "will save scene 1. scene 1 save included 1 zones."
  
  3.2. scene 2: FM tuner station
     
  -  activate FM tuner in the zone, select station 3.
    
   - store the current (on) state as scene number two:
     send through KNX:
        1 Byte, Value 129, to 1/5/99
     
     -> verify if the KNX trace says:
           "will save scene 2. scene 2 save included 1 zones."
         
4. Use the scenes:
   
  4.1. use the "off" scene:
  
     send through KNX:
        1 Byte, Value 0, to 1/5/99
     -> the zone should switch off.
     
     -> verify if the KNX trace says:
           "will restore scene 1. included 1 zones."
     
  4.2. use the FM tuner scene:
    
     send through KNX:
        1 Byte, Value 1, to 1/5/99
     -> the zone should play FM tuner station 3.
     
     -> verify if the KNX trace says:
           "will restore scene 2. included 2 zones."
  
Note that it is not required to have "trace bus communication" active
to see the KNX trace messages shown above. The important action messages
for scene handling are always traced.

[181] No rows/system/data found error on Touchpad

If the Touchpad is connected to a wrong server,
e.g. it was connected to a machine 192.168.1.119
but the next day the machines changed their IP
and now .119 is a different (non trivum) system,
then these errors may appear.
  
Select the trivum server again under
System Menu/Setup/touchpad Settings/MusicCenter link

[182] Network issue: Cardhost is down although cabling correct

Restart not only the local switch, but also the main router
in the network (which makes the internet connection).
This may block multicast messages required to communicate
with the cardhost.

[183] Invalid NAS reply while scanning music files

The NAS uses an old Firmware which is not suitable to scan music files.
It returns a wrong reply to "seek" commands used to jump forward and
backward within a file, which is required to scan informations
from music files.
  
This means that most or all of the music on a NAS cannot be read.
Scanning may still work with .mp3 files using simple ID3v1 tags,
but .m4a and other files will not work.
  
The only solution is to replace the NAS, or to update it's firmware, 
if an update is available.

[184] IR Adapter programming by the Infrared Tool

To program the trivum IR Adapter with commands of an IR remote control
follow these steps:
  
- download the trivum IR Tool (Install-IrTool-*.exe) from
  ftp://service.trivum.com/Installer/
 
- install and run the tool.
  
- if the IR adapter is connected to the network,
  it should appear automatically at the left under "Serial".
   
- select the adapter by it's serial number. 
  click on the flash symbol to connect to the adapter.
  wait until it shows "Connected".
   
- hold your IR remote control in front of the adapter,
  in a distance no longer than 40 cm.
   
- then, for each command to program:
  
  -  look for the "IR command" button. it shows a rectangle curve,
     and on startup, there should be a zero right to it,
     meaning zero commands have been received yet.
   
  -  press a button on your IR remote control.
    
  -  if the adapter receives the command,
     the IR command button should increment it's counter.
     
  -  now drag+drop the IR command button to a slot above it.
     you will see a popup.
     enter a command name and optionally select a multikey.
     For example, if you pressed Power Off, select M: Power off.
     
  repeat this step for all further commands.
  
- finally in the Page column select "Use" for page 1.
  
- close the connection.
 
Store commands into a database file:
  
   After all commands have been programmed, also look at the "File" area
   at the left bottom. Click on the "new file" button and enter
   a filename to store the current database. Make sure to select
   a writeable folder (NOT within "Program Files").
    
   Then drag+drop the commands to store from the top area into the file area.
   On every drag+drop the database file is written automatically.
    
   You may also drag+drop whole Pages from the top Page area to the bottom,
   taking over all commands of a page in one step.
  
Load commands from a database:
  
   In the File area at the left bottom, click on "S" and select
   a folder containing database files.

[185] NAS hardware compatibility list

Tested and working:
- Synology
- WD My Book
- D-Link DNS-320L

Known incompatible NAS systems:
- Freecom Network Drive XS
  (of 2011, does not reply to SMB seek command)
  

[186] create Windows Desktop Shortcut to Web Visualization

If you defined a web visu under control units,
you may create a Windows Desktop Shortcut like:
 
Google Chrome Browser:
  
- select "Show" to open a new Browser Window with a web visu.
  At the top, you see the address like
     http://192.168.1.119/visu/iapp?id=20
 
- create a new Tab. enter the same address into that Tab, e.g.
     http://192.168.1.119/visu/iapp?id=20
  
- look at the right top side for the striped button.
  Select: Tools / create application shortcuts.
  Check only "Desktop", then click on create.
 
Now you have a shortcut on your windows desktop
that opens without an address bar.

[187] RTI configuration

Get the trivum RTI driver:
     
  Whole GUI configuration with driver:
    ftp://service.trivum.com/Installer/RTI/trivum.rti
     
  If you already have a customized GUI configuration
  and only want driver updates, download:
   
    ftp://service.trivum.com/Installer/RTI/trivum.rtidriver
     
  then enter your remote control configuration and select
  loaded drivers / driver / update.
  
How to upload the trivum driver to the RTI remote:
     
  Make sure you have the latest Integration Designer installed.
  Within the Integration Designer,
  
  - open: trivum.rti
  
  - in your remote control configuration select:
    drivers / trivum: and adapt the IP address
    (enter the IP of the trivum server)
  
  - select communications / send to device.
    if send to Mac address doesn't work then find out the remote's IP,
    click on the Target MAC and select "use specific IP".
     
How to configure RTI at the trivum server:
  
  - within system / basic setup / expert mode settings / advanced options
    enter: rti 
    
  - then reload the config web gui
  
  - you will see a new main menu point "rti" at the left bottom
  
  - the server should auto detect RTI if it's in the network
  
  - the RTI should show zone lists and actions automatically.
  
About Zone Configurations within Integration Designer:
  
  Please note that the first zone of a trivum server
  does not always have a Zone ID of "0".
  It can be any random number.
  To find out the actual valid zone ID's,
  look into the server web configuration GUI under
  "RTI Interface". There zones with their ID's are listed.
  Alternatively, you may open a web browser and send the trivum server
  one of these requests:
     /xml/zone/getSelection.xml?grouped
     or
     /xml/zone/getAll.xml

[188] Zone Actions cannot be edited

Enable System / Basic Setup / expert mode

[189] /xml/zone/runCommand.xml for TuneIn Favorites does not work

Since V8.53 there is a page "print example commands" listing command ID's
for external visualisation. Unfortunately, until V8.56 this page documented
four internal commands
   
   /xml/zone/runCommand.xml?zone=@0&command=56
   /xml/zone/runCommand.xml?zone=@0&command=57
   /xml/zone/runCommand.xml?zone=@0&command=58
   /xml/zone/runCommand.xml?zone=@0&command=59
    
as "select TuneIn favorites 1 to 4". From V8.57 on these commands
no longer select TuneIn favorites, but line inputs.
  
IF you use one of these commands, replace them by:
   
   /xml/zone/set.xml?zone=@0&source=@i1
   /xml/zone/set.xml?zone=@0&source=@i2
   /xml/zone/set.xml?zone=@0&source=@i3
   /xml/zone/set.xml?zone=@0&source=@i4
  
which does the same. The "@i" syntax however allows to select 
more than 4 favourites directly.

[190] Group Play with external volume control does not work

If the volume of a zone is NOT controlled by the zone itself,
for example in case of an AudioBox with independent LineOut
with RTI controlled amplifier, then this zone can NOT participate
in group play, i.e. nothing will be audible as volume control
for group play mode is not available.

[191] How to enable special characters in zone names and actions

To enable special characters e.g. for Vietnamese you have to use
trivum Server V8.61.8279 or higher and Touchpad V2.02.8277.
  
At the server, look into
  System / Basic Setup / Basic settings
and enable:
  Use UTF8 encoding everywhere
  
This will switch the encoding of characters used for internal
storage, e.g. of zone names and actions.
  
Note: if you entered special characters before
      they may display wrong after switching, 
      requiring a re-entry of zone names or actions.
     
With this setting active, the server will send names
of zones and actions as unmodified UTF-8 to Touchpads
and other external visualizations. Touchpads need
to have the Software Version listed above otherwise
they cannot display extended characters
e.g. of the Latin Extended range.

[192] How to control multiple Actuators or AudioBoxes via one Web Visualization

To allow this they must be combined as master/slave devices.
- one device stays master (default mode)
- on all other devices: select admin / set mode to installer slave
- on the master, go to the zone list, then wait and reload
  (via circle button) until all other devices show up in green.
  then select on the other devices: use this actuator
This way the slaves are added to the master as new zones.
Then use only the web visualization of the master.
There, enter the new zones and play music.
Note: with the 4 zone actuator restrictions in group play apply,
for example, starting a group play from a slave zone and then
adding zones from the master may not work.

[193] How to disable LineIn action with Actuator, AudioBox

- 4 Zone Actuator: Zones / zone / Basic settings /
  default Line Input: no default
    
- AudioBox: same as 4 Zone Actuator
  
If two actions like "LineIn 1" appear unexpectedly
within a zone, then
  
- select Zones / zone / Actions
  and see if there is an action "LineIn" defined.
  If so, remove it, because LineIn will already
  be offered by
     Zones / zone / Basic settings / default Line Input

[194] trivum App for Android Smartphone/Tablet

This is not yet available, but you may control a trivum server
with software version 8 or higher this way:
  
- find out the IP address of your trivum server.
  For example, on a trivum Touchpad, select 
  System Menu / Info and read "MusicCenter".
  Or download the ServerAdmin Tool from
  ftp://service.trivum.com/Installer/Install-ServerAdmin.exe
 
- open a web browser on your Android device.
  
- type the following address into the browser:
     ipaddress/webtouch
  for example
     192.168.1.100/webtouch
     
- then you should see the trivum webtouch interface.
  then create a bookmark, 
  or a shortcut on your Android desktop.

[195] create or delete zone groups by knx

Since V8.61 zone groups can be defined which can be
activated or deactivated instantly by a knx event.
   
- in the web configuration GUI, enter Zonegroups.
 
- create groups and define which zone members
  they contain.
  
- enter KNX addresses to start this group.
  to "start" here means to join the member zones
  into a group (but not to start playback).

- enter KNX addresses to stop this group.
  to "stop" here means all member zones become
  independent, isolated zones again.

[196] TuneIn uses wrong city or country location

TuneIn tries to auto detect your country by your IP address.
If this fails you may enter the latitude/longitude
of your city in the trivum server configuration under:
  
  Database&Media / Database / Settings / webradio latitude/longitude
  
for example, for Munich in Germany, enter: 
   
  48.1,11.5
  

[197] Windows based Touchpanel compatibility

Current test results with server V8.62 and Touchpanel
devices running the Windows operating system:
  
The trivum web visualization (webtouch) runs fully with
- Google Chrome
- Firefox   
- Internet Explorer 8
- Internet Explorer 10
  
With IE 9, tests showed it runs basically but rather slow.
  
With IE 7, in local tests the webtouch did not run at all.

[198] C4 with 3 Cardhosts: No sound from some Streamsource cards

When using 3 cardhosts with many Streamsources (STS) and
PowerAmp connect cards (PAC) be aware of the following restrictions:

- STS (or any source card like FM Tuner) must be placed
  within slots 1-8 of a cardhost only

- PAC can be placed in any slot, but normally they are placed
  in the higher slots, as the lower ones are used by sources.

- sound produced by STS in slots 1-8 of the first cardhost
  can be played on any PAC in any cardhost

- sound produced by STS in slots 1-8 of the second cardhost
  can only be played on local PAC within the second cardhost.
  Same applies for third or even further cardhosts: sound
  can only be linked locally within the cardhost.

This means, for example, that sound from STS in slot 1 of 2nd cardhost
can NOT be played on a PAC in the first cardhost.

On a C4 system with 2 cardhosts, these restrictions do not exist,
so sound from a STS in the 2nd cardhost can be played on a PAC in the first.

[199] Simfy does not play although music selection works

If you can still select music from the Simfy catalogue
but from one day to another suddenly all music fails
to play with "invalid file" errors then this might be
a server time issue. If the server time differs more than
10 seconds from the real time this may cause such an error.

Go into the server web configuration: Basic Setup.
Make sure that "use automatic date/time update" is active,
or try to reconfigure time manually to an exact minute boundary.

[200] StreamSource card hangs until restart with no audio

Some StreamSource cards delivered in 2014 show the following behaviour:
  
First, everything seems OK, it plays audio.
After a random time, sometimes seconds, sometimes hours
- the card stops to play audio
- but not error message is shown anywhere
- but the green "C" LED at the card goes off.
Furthermore
- in the cardlist the card may show a red message "Slave inactive".
- when trying to use the card an error "CardHost inaktiv" may appear.
After a full restart of the trivum system, it should work again,
until the next error.
  
The reason for this is a change in specifications of a chip on the card,
causing incompatibility with V1.30 firmware. You may identify those cards
by looking on the biq square chip "LPC2365". In the lowest line,
if you see "NSD1317D", with a "D" at the end, then the error may occur. 
(with the older "NSD1317B" revision it should not occur.)
 
If you received a card update toolkit, you can fix this yourself
by flashing the card with the latest V1.31 Firmware.
Please read the documentation:
  Read Me - trivum toolkit DE.txt
  Read Me - trivum toolkit EN.txt
as well as the screenshot
  flashmagic_screenshot.png
within the toolkit and follow all instructions.
Do NOT use the contained StreamSource-1.30.hex file,
but only the latest firmware file:
  StreamSource-1.31.hex
from ftp folder:
  ftp://service.trivum.com/firmware/Karten/
 
Or you may send us the card back for repair. 

[201] Crestron fails to send commands to trivum after a while

If you program Crestron to send HTTP commands to trivum
it is important that, after each command, the connection
must be closed. If you configure Crestron to keep the connection open 
then it seems to work for a few commands, but suddenly
the connection is closed (a forced close by trivum server after some time)
and no further communication seems possible,
although sending commands by a web browser still works.

[202] Tests to find network errors with Installer Line Products

If trivum reacts slow or the web config or web visulization
shows errors in a complex network then try to reduce the network 
to something like:
   
                 internet
                    |
                  router
                    |
        +-------- switch ---+---+
        |                   |   |
        |                   |   +--- trivum server
  other devices             |
  or switches               +------- your notebook
    
 then open a web visulization of the trivum server
 on your notebook using Firefox or Chrome browser
 and do a full reload of the page.
   
 if that does not help, configure both the trivum
 server and your notebook on a static IP and then
 build a fully isolated network:
     
                  switch ---+---+
                            |   |
                            |   +--- trivum server
                            |
                            +------- your notebook
     
 meaning the switch is no longer connected to any other
 device, other switch or the router.
 then load the web configuration. under "database&media"
 edit the first network share change it to
 /Musik/audiofiles/
 which will use demo music stored on the device.
 Now open a web visualization and try stream playback.
   
 If the isolation test is successful (no web page errors
 and streaming works) then add further network components
 step by step.

[203] KNX Touchpad Dimmer does not send "1" on 1-bit GA

On a trivum Touchpad, the dimmer object can use the following
group addresses (GA):
  
  1) GA to set on/off            1 Bit
  2) GA to read status           1 Bit
  3) GA to control brightness    4 Bit
  4) GA to set brightness value  1 Byte
  5) GA to read brightness       1 Byte
   
- note that you should NOT combine 3) and 4) 
  as this is unlogic. If 3) is set then 4) will not
  send any brightness values.
   
- if 4) is defined then:
  -  whenever the dimmer is switched OFF
     it will send 1-bit "0" on address 1),
     but nothing on address 4).
  -  if the dimmer is switched ON
     and the recent brightness was >= 2
     then it will send the recent 8-bit brightness to 4)
     but nothing to 1), i.e. no 1-bit "1" is sent
     in parallel, to avoid confusion by redundant data
     at the target dimmer actuator.
  -  if the dimmer is switched ON
     and the recent brightness was < 2
     then it will just send 1-bit "1" to 1)
     but nothing to 4) to avoid confusion by redundant data
     at the target dimmer actuator.
     
 With a Touchpad < V2.03 build 9190 there was a bug:
 after deleting address 4) the touchpad never again
 sent 1-bit value "1" to 1) when switching the dimmer on.
 The workaround then is to restart the touchpad,
 or to update to V2.03 build 9190.

[204] Touchpad FM Tuner shows no frequency scale

This happens with a trivum server V8.63.9208 or higher.
Update the Touchpad by Beta channel to V2.03.9322 or higher.
See article [108] on how to update by Beta channel.

[205] Service tools download on the Linux/Mac command line

Linux:
  wget http://update.trivum.com/update/tlist-linux
  wget http://update.trivum.com/update/trace-linux
  
Mac:
  curl -o tlist http://update.trivum.com/update/tlist-mac
  curl -o trace http://update.trivum.com/update/trace-mac
  
Windows:
  first download sfk.exe from 
     ftp://service.trivum.com/Installer/freewaretools/
  then type
     sfk wget http://update.trivum.com/update/tlist.exe
     sfk wget http://update.trivum.com/update/trace.exe

[206] AudioBox supported IR Codes

The protocol used is RC5.
The AudioBox listens on device address 7.
The following command codes are supported:
  
  12    ZONECMD_POWER_OFF
  38    Switch on, use ZONECMD_PRESET_1 (same as first hardware key)
  18    ZONECMD_VOLUME_DEC
  20    ZONECMD_VOLUME_INC
  17    MULTIKEY_BASIC_BACKWARD
  16    MULTIKEY_BASIC_FORWARD

[207] How to switch off multiple KNX and audio actuator

For example, by a single KNX message you want to
- switch off lights
- drive down the shutters
- switch off audio
then this cannot be done directly by the KNX touchpad
and/or actuator. Instead,
- program your KNX devices (by ETS) to listen on 
  multiple group addresses, one of them  being an "all off" 
  address that is listened to by many knx devices. 
- at the trivum actuator, create a knx event that also
  listens on this address, just to switch off audio.
 

[208] Web Visulization, iPhone App unexpected volume increase to maximum

- Update the trivum server to Version 8.66 build 9512 or higher.
  Clear your web browser cache.
     on iPhone: enter system settings / safari / clear history and website data
- In the trivum app, select settings at the right top,
  then "i" for information on the web visualization. It must show
     Version V1.01 June/2015
  or higher.

[209] 4 Zone Actuator: Amplifier channel overload

Please check the device temperature under
  
  Zones / left near device select: Show details
    
If the Temperature line shows more than 65 Degrees
this could cause device malfunction.
  
- make sure that the device gets enough air for cooling.
  
- look carefully at the device enclosure,
  near the speaker and power connectors,
  if there are enclosure caps without holes (gaps)
  that prevent air circulation.
  if so you may remove some or all of these caps.
  

[210] Maximum possible Streams (StreamSources) per device

A single C4 system may play
  
- up to 6 streams in parallel with sample rates up to 96 khz
  using file formats mp3, aac, alac, flac
  
- up to 5 streams in parallel with Flac 192 khz files
  (requires Software V 8.66 build 9527)
  
- up to 3 streams in parallel with ALAC 192 khz files
  (requires Software V 8.66 build 9527)
  
Trivum does not support .dsf files or any files with sample rates beyond 192 khz.

[211] Installer Line Group Play: no sound at receiving devices

1. Update your trivum Installer Line devices to software V 8.66 build 9772 or higher.
   After that, make sure that this does NOT appear in the system status:
   Group play notice: If group play does not work between devices disable IGMP at the network switch

2. Use an IGMP capable network switch.
   At the switch, make sure that IGMP snooping is really used
   (via the switches configuration surface).

The group audio play produces a high network traffic.
The IGMP protocol makes sure that this traffic reaches only
those devices interested in that traffic.
But for this the switch needs to understand IGMP,
and the trivum device requires the software version listed above.

Switches supporting IGMP are, for example
- HP 1920G          (24 ports)
- HP-E2620-24-PoEP  (26 ports)
- Cisco 300 series, like Cisco SG300-28

We recommend the HP 1920G switch as it is both easy to configure
and transparent in it's settings.

At the HP 1920G, enable: IGMP, version 3, with Querier.
Then select "Save" at the right top to store all settings permanently.
If you think there may be a network loop in your cabling, also enable:
MSTP/Global/Enable STP Globally/Enable

At the HP-E2620-24 there is only an option "IGMP" by default, without details.
 It seems that no extra global save option is required.
 It seems that this switch uses Querier by default. With our tests the
 IGMP filtering worked immediately. You may also configure details,
 but for that you need to connect by RS232 cable to that switch.
 When restarting the switch, to get again to the switch config,
 you may have to enter it's IP without any path behind.
 Same as with 1920G, in case there are still network problems
 you may enable: Spanning Tree/Tree Management/STP

At a Cisco SG300-28 select:
  Multicast
     Properties/Bridge Multicast Filter: Enable
     IGMP snooping/Status: Enable
     IGMP Table: Edit
        IGMP Snooping Status: Enable
        IGMP Querier Status: Enable
        IGMp Querier Version: IGMPV3
  After setting these values
  -  wait 2-3 Minutes before filtering becomes active
  -  select the blinking "save" button at the top then
     source/running config, destination/startup
  The Cisco also supports STP in case of network loops.

If you have multiple switches supporting Querier in a row then
it may be sufficient to activate Querier on one switch only.

Furthermore, if the system is controlled by iPads,
an Apple Airport Express WLAN access point is recommended.

[212] How to change between multiple sources by one KNX button

This can be done   
1. by defining Zone Sources under
   Zones / zone (menu) / Sources 
   Here you can define up to 8 sources, or simply actions,
   like activating Tuner, Streaming etc.
2. by toggling between the defined Zone Sources through
   Zones / zone (menu) / KNX Settings / Start music in the current zone:
   GA to skip to next/previous source
For example, if you configure "1 2 3" here and then send a 1-bit message "1" to KNX group address 1/2/3 then the zone will switch from Zonesource #1 to #2 etc.
This scheme can be used for many things, like sources, FM radio stations, TuneIn web radio stations, toggling between Playlists and more.

[212] How to change between multiple sources by one KNX button

This can be done
1. by defining Zone Sources under
  Zones / zone (menu) / Sources
  Here you can define up to 8 sources, or simply actions,
  like activating Tuner, Streaming etc.
2. by toggling between the defined Zone Sources through
  Zones / zone (menu) / KNX Settings / Start music in the current zone:
  GA to skip to next/previous source
For example, if you configure "1 2 3" here and then send a 1-bit message "1" to KNX group address 1/2/3 then the zone will switch from Zonesource #1 to #2 etc.
This scheme can be used for many things, like sources, FM radio stations, TuneIn web radio stations, toggling between Playlists and more.

[213] If TuneIn Favourites/Presets Link Is Unavailable

 There was an temporary protocol change at TuneIn, causing the Favourite Link to disappear.
 If you defined TuneIn favourites but you see no "My Favourites" Link in the menu:
- you may update to the latest V8.63 Beta of the trivum server to have the favourites again in all web browser visualizations (webtouch, ipad app v2) 1. Enter the server web configuration by web browser. 2. System / Basic Setup: make sure "Use alpha/beta" is checked. 3. Close Setup, select Admin / Software Updates at the top. 4. Read "Available Software Version" if it says V8.63. 5. Right next to the field "Should the ..." type "yes". - you may update trivum Touchpad to the latest V2.03 Beta to have the favourites there again. Beta means channel 103. Updating all Touchpads of a server is best done via the server web interface: - click "Developer" at the right top, then "Keypads" at the left. - in each Touchpad row at the right, click "Edit" then enter "103" as Channel number. Then click "Update". You may also read here how to update via beta channel: http://service.trivum.com:90/mediawiki/index.php/FAQ-en#.5B108.5D_Touchpad_Software_Update

[214] C4 with 2 or more Cardhosts: Noise or unexpected sound

Problem:
  Multiple Card Hosts are used within a large C4 system.
  When playing a source, like analogue input, not only the sound
  of that source is audible, but also unexpected sound like FM tuner.
  When disconnecting the analogue in source, only the noise is audible.

Solution:
  1. Make sure you are using Shielded Twisted Pair cables.
     These are marked as STP or SFTP.
     Do not use Unshielded Twisted Pair cables, marked as UTP.

  2. Make sure you are using the correct cabling scheme.
     For example, with one master and two slave card hosts
     then connections must be
        TXA from 1st -> RXA of 2nd device
        TXB from 1st -> RXB of 2nd device
        TXA from 2nd -> RXA of 3rd device
        TXB from 2nd -> RXB of 3rd device

[215] How to test if a card is broken

Problem:
  A C4 card like FM tuner, Streamsource etc. does not work at all.

Solution:
  Analyze if the problem is caused by the card itself, or by the cardhost,
  or a specific slot of the cardhost.

  1. see if there is another free slot in the same cardhost.
     mind that sources need to be placed in slots 1-8.
     if so, put the card in the free slot and restart the system.
     -  if it is working then the slot is defective.
     -  if it is still not working then the card is defective.

  2. if there is no free slot available
     exchange the card with another card of the same type,
     for example another FM tuner in another cardhost.
     -  if the card is working in the other cardhost,
        but the exchanged card no longer works,
        then the slot is defective.
     -  if the card is still not working, even in the other
        cardhost, then the card is defective.

  If the tests clearly show a defective card
  then give us feedback so we can arrange a replacement.