Lisa Compact User Manual for software version 1.
Contents 8 1. Getting started 1.1 Introduction ................................................................................................................................................. 8 1.2 Lisa ................................................................................................................................................. product range 8 1.3 Applications ...............................................................................................................................
7.1 Supported ................................................................................................................................................. cards 27 7.2 Prepare ................................................................................................................................................. playback from card 28 7.3 Start .................................................................................................................................................
13. Commands 52 13.1 ................................................................................................................................................. Monitoring server 52 13.2 ................................................................................................................................................. Live Communication 52 13.3 ................................................................................................................................................
17.2.4 Remote monitoring .......................................................................................................................................................... data via proxy server 76 17.3 ................................................................................................................................................. Test network connection 76 17.3.1 Performing ..............................................................................................................
21.7 ................................................................................................................................................. Supported audio formats and streams 92 21.7.1 MP3 formats .......................................................................................................................................................... 93 21.7.2 OGG Vorbis ...............................................................................................................................
EU Declaration of Conformity This product carries the CE-Mark in accordance with the related European Directives. CE marking is the responsibility of Streamit B.V. The Netherlands. This is a class A product. In a domestic environment this product may cause radio interference in which case the user may be required to take adequate measures.
Getting started 1 This manual applies to Lisa software version 1.44. 1.1 Introduction Thank you for purchasing the Streamit internet audio player Lisa Compact. The Lisa Compact is a device with many possibilities and we strongly recommend you to read this manual thoroughly before you start installing and using the device for the first time. The Lisa is a fully autonomous working IP-audio receiver, able to tune in to web casts of internet radio stations and audio distributors.
· Streamit Device portal · Streamit Audio Distribution Platform · Your own platform These variants are described in more detail below. Standalone operation You do not have to use the Lisa for playing from the internet. When you have a sufficiently large number of audio files available, you can also make exclusive use of the card functionality. The supported format for the audio files depends on the software edition of the Lisa.
On Device portal you can create user accounts for each of your clients and allow them a certain level of management of their device. You can for example allow them view the monitoring data, while you maintain control of the other aspects of the Lisa configuration. Streamit Audio Distribution Platform If you want to have a complete system for the planning and distribution of content and maintenance of playlists and players, Streamit's Audio Distribution Platform (ADP) is available for you.
Installation 2 This section of the manual will cover the installation of your Lisa internet radio, how to mount and connect your device. 2.1 Unpacking your device Carefully take out of the package the device and the supplied materials.
With an RCA to female jack converter cable the RCA connectors can also be used for headphones. Bottom view 2.3 Connecting the Lisa Connecting the power supply Select the correct power plug adapter for your mains socket and mount this to the Lisa power adapter. Start at the position where the small triangle marking points to the top of the power supply, opposite to the side of the cord. Press down slightly and rotate the plug 90° clockwise as depicted below.
Plug the power adapter to the mains outlet and plug the other side in the Lisa. In the process we ask that you careful attention to the following instructions: Never use wet hands when plugging the power adapter in the mains and never remove the power adapter from the mains with wet hands. Do not cut or damage the cord of the power adapter; do not place heavy objects on the cord. This can cause short-circuit, resulting in electrical shocks or even fire.
First time setup 3 The Lisa Compact comes with default settings. The most important are the network settings. By default DHCP is used. This section describes the first time start up and the device activation. 3.1 Switching on the Lisa for the first time The first time the Lisa Compact is powered on, it will apply default settings for the most important settings, using DHCP for IP settings. When IP configuration via DHCP succeeds, the network status LED will burn green constantly. 1.
All Lisa devices need to be connected at least once to the public internet for activation, before it can be used in a private network.
Configuration 4 The Lisa Compact comes with default settings. The most important are the network settings. By default DHCP is used. The default settings on the Lisa may not be what is needed for your specific application, or they may have to be updated during use. This section describes the available configuration methods. 4.1 Configuration platform Update the configuration during use, when the Lisa is in the field, is best done remotely.
Configuration mode Source of the configuration Update 2 Custom-built platform, or Streamit Audio Distribution Platform When the Lisa retrieves its configuration: · At startup (either power on or restart) · When a task is scheduled with this command (see Task scheduling) · When the update configuration command is sent to the Lisa (see Commands) 3 Fixed on-board settings Using one of the Alternative configuration methods In all operation modes the Lisa can start by reading a configuration file from
After configuration from card is finished (or skipped, when there is no card or there is no configuration file on the card) the device will perform the configuration update using the configuration update URL, just like it normally does. This configuration update is skipped when the device is configured in fixed configuration mode. The configuration file can be created using the Lisa Configuration Tool. The configuration file should be placed in the root folder of the SD card.
5 LED status information The Lisa features 4 LEDs, which are used to communicate the status of the device. The LEDs have the following meaning (from bottom to top): · Power · Network · Card · Audio Each led can be switched OFF, switched ON, or BLINK in one of the three (3) possible colors.
The Lisa is configured via DHCP or with a static IP address IP configuration via DHCP failed (e.g., no DHCP server). The formerly assigned IP configuration (IP address, netmask, default gateway, DNS) has been applied DHCP configuration failed (e.g.
Playing inet Playing card in fallback Not playing (error situation e.g. missing codec license for specific code, no stations, no playlists etc.
Playing a stream or playlist from internet 6 By default the Lisa will connect to the Streamit Device portal. If the Lisa is registered on the Streamit Device portal, the device will get a list of presets. When powered on the first time, the Lisa will start to play the stream or playlist of the first preset. A preset can be the URL of an audio file, a stream or a playlist.
· The size of the playlist file must be smaller then 16000 bytes · All URL’s contained must be absolute, relative paths e.g. “../../myaudioFile1.mp3” are not allowed · URLs can point to streams and tracks on the internet or tracks on the SD card: o Example URL for a track on the internet: o Example URL for a track on the card: http://myserver/audio/track001.mp3 PHAT0:/music.mp3 · The maximum URL length 1024 characters · All 7-bit ASCII characters are supported, except the escaped characters ‘\n’, ‘\r’,
6.2.2 Limitations of online playlists Playing the entries of a playlist in random order is only possible for playlists that are stored on the SD card (see Store-and-Forward). However, online playlists are retrieved from the web server and played immediately. They are not stored on the SD card and therefore random order playback of the entries is not supported. 6.3 Single track playlist If the music and commercial program for a day has been planned, changes may be required during that day.
6.4 Mixed source playlist The concept of single track playlist allows for changes to the music and commercial program 'on the fly'. However, it does not have the bandwidth efficiency of Store-and-Forward. Each time a track is required for playback, that track is downloaded and played (while being downloaded). Store-and-Forward on the other hand is efficient in bandwidth usage, but does not have the flexibility to change the music and commercial program or even add/use new content on the fly.
The server can parse the header and detect the error condition: Header Error condition X-STREAMIT-PLAYER-PLSERR: No card (mounted) The playlist refers to a track on the card, but there is no card present/mounted X-STREAMIT-PLAYER-PLSERR: Missing Entries The playlist referred to one or more tracks that were not found on the card, where will be replaced by the number of tracks that were not found on the card. Sent in combination with the next header.
Playing from card 7 The Lisa can play playlists from the memory card. A playlist is a text file with the “pls” extension, which contains a list of songs (referred to as entries) in a specific format. This can be used for straightforward 'playing music from the card'.
7.2 Prepare playback from card Before you can start playback from the card, you need to place a playlist and the tracks that it uses onto the SD Card, according to the Requirements for playlists on the card and to the Requirements for audio tracks on the card. 7.
o For filenames the ASCII printable characters (see Wikipedia ASCII printable characters) are supported, except the characters that are excluded for FAT32 filenames: " * / : < > ? \\ | o For contents other than filenames, the ASCII printable characters (see Wikipedia ASCII printable characters) are supported, as well as the control characters carriage return (\r), line feed (\n), and horizontal tab (\t) o Lines must only contain known key-value pairs, or be empty o Empty lines may contain spaces and horizon
Header section: Key Required Remarks [playlist] yes StartTime This is not a key-value pair, and should be included exactly as shown Intended start time in the hh:mm format (between 00:00 and 23:59). This value is used to determine where to start playing in the playlist. Value has a maximum length of 16 characters. PlsName The value is shown on the LCD display instead of the playlist filename (e.g., 1.pls).
Playlists can be created manually or by means of some software package/tool. During testing the Streamit Card and Scheduler Toolkit is recommended, this ensures that the playlist is compatible with the Lisa devices. Example of a playlist [playlist] PlsName=Oldies File1=Dream a little dream (Rough mix).mp3 Title1=LivingRoom - Dream a little dream of me Length1=19 File2=Fleetwood Mac - Say you love me.mp3 Title2=Fleetwood Mac - Say you love me Length2=250 File3=Am3.
If the Last Played Entry is known, Last Played Entry + 1 (when available) is used as starting point for playing, avoiding repetition of the Last Played Entry. In the rare case that the Last Played Entry is unknown, the Lisa will start to play the Last Played Playlist from the first entry. When the Last Played Playlist is not known, typically when the card was removed/inserted, the user will be asked to choose from the available playlists.
To review the play playlist task and command, see Schedule tasks and Command overview list, respectively.
Playlist available? The first question is whether the requested playlist is available. The play playlist command has a mandatory parameter that indicates which playlist should be started. Further action depends on whether the requested playlist is available: · If not: The question is, if a task is being executed · If yes: The question is, if the playlist is updated These questions are explained below.
Playing a playlist? In case the Lisa is already playing a playlist, this playback is stopped. This happens even if the Lisa currently already plays the playlist that is requested. This makes it possible to restart playing a playlist, from the same or a different point. Random playback? The playback of playlists can be done sequentially or randomized. If random playback is enabled, the playback of the playlist starts with a random entry of that playlist.
In general, SD cards are consumer devices and the manufacturer is constantly under high price pressure. To cut production costs the manufacturers look at cheaper components. These newer cards are built with cheaper electronics, but get sold under the same product name, making it impossible for the end user to identify. For example, Transcend started using cheaper flash memory (TLC) to reduce costs. This type of flash memory has a lower endurance limit than the previously used MLC memory.
Fallback to card 8 An important card-related feature of the Lisa is the fallback in case of network or streaming failure. When you use the Lisa to play audio from the internet, you rely on a stable internet connection. A problem with the stream provider, the Internet Service Provider (ISP), a problem in the IP network (failure of modem/switch etc.), all of these can cause problems with the audio playback from internet.
This fallback implementation for both playlist presets and fallback to card is depicted in the figure below. Suppose the Lisa was playing preset 2, an internet audio stream (say dance music, not a playlist). When the internet connection is experiencing problems the device will enter the fallback mode. Preset 2 was the last preset that was being played before entering fallback, hence the name Last Played Station (LPS). As a first step, the Lisa will check if the matching fallback playlist (2.
Note that for proper operation of the fallback to card, the preset URL must point directly to an audio stream. If the preset URL actually points to a playlist that contains several audio stream URLs, the Lisa will try the next URL in the playlist in case of problems with the stream. However, if the internet connection itself is failing, this will not help. Take the following steps to set up the Lisa for fallback: · Create a playlist with the name '1.
8.5 Troubleshooting fallback to card For troubleshooting, use the following checklist: · The internet stream is not the URL of a playlist · A Streamit-supplied SD card is used (see Supported cards) · The playlist on the SD card is in the correct format (see Requirements for playlists on the card) · The tracks included in the playlist are on the SD card · The SD card is mounted properly by the Lisa. Use the Lisa Configuration Tool to check if the card was mounted, look for "Info MM: Card mounted".
Store-and-Forward 9 Streaming requires a stable internet connection. This may not be available. Store-and-Forward is a way of working with the Lisa that downloads the playlists and music tracks during the night (or some other convenient moment), so that the playlists can be played at a later moment, even if the internet connection is unstable, limited, or not available at all.
o A task to update the schedule itself 9.2 Example Store-and-Forward task schedule The following task schedule gives an idea of how Store-and-Forward can be implemented with the Task Scheduler. Note that this is a rather basic example. In practice the task schedule probably contains more sophisticated planning of playlists over time. More information on the Task Scheduler can be found in Task scheduling. On Sunday Nov 1st 2015 at 21:00 in the evening, the Lisa updates its schedule.
10 Commercials and Announcements The support for Commercials and Announcements on the Lisa can be summarized as follows: Commercials and announcements can be specified that will be played at indicated times ‘interrupting’ the playlist in the manner that is appropriate for the commercial or announcement: · A commercial is a track that is played between two music tracks at the indicated time or as soon after that time as the currently playing track finishes.
10.3 Update Commercials and Announcements The commercials and announcements are updated as part of the content update proces. This is described in Updating the content on the card.
11 Updating content on the card Typically, the content on the card is automatically updated using the 'Update content' task (see Command overview list).
11.2 Update content (full) Update commercials and announcements tracks Update playlists only (no tracks) Update only commercial plans Command: up uca uo ucp Update playlists yes optional yes optional Download tracks required by playlists yes Update commercial plans yes optional optional yes Download specified commercial tracks yes yes Update keep.
All other files are deleted, regardless of their extension. The advantage of the automatic card cleanup is that old tracks that are no longer used, are removed automatically.
12 Task scheduling Lisa devices are autonomous until a certain degree, they support reconnects, fallback etc. However, some operations require dynamic (inter)action. For instance powering the device on/off, updating the content on the card, etc. This is the role of the Task Scheduler. The Task Scheduler is a process running in the background which is always checking if any ‘tasks’ need to be performed. These time-stamped tasks are downloaded from a remote server, in the form of a schedule file.
· If the Lisa performs a content update in the background, the content update is not interrupted, except when the Lisa is powered off or rebooted (note that some commands do this!) The nature of the interruption by the task on the on-going process depends on the exact combination of the task and the current state or on-going process of the Lisa. The exact effects are detailed in the following table.
Playing a stream Playing from card Executing content update (when content update is not done in the background) Update content up, uo, uca, ucp By default: Playback is stopped, task is executed, Lisa is rebooted and powered off If content update in the background is enabled: Content update is (re) started and executed in the background By default: Playback is stopped, task is executed, Lisa is rebooted and powered off Content update is stopped, task is executed, Lisa is powered off If content update
12.2 Multiple tasks at the same time Tasks should not be planned for execution at the same time. In some cases this is hard to avoid, for example with repeating commercials. Consider the following situation: Start Repeat Executes at Commercial A 10:00 Every 15 minutes 10:00 10:15 10:30 10:45 11:00 11:15 11:30 11:45 12:00 ... Commercial B 11:00 Every hour 11:00 12:00 ... To address this situation, tasks that are planned for execution at the same time, will be executed consecutively.
13 Commands The Lisa can be controlled via commands. In many situations it is not acceptable or even realistically possible to be physically near the Lisa when actions on the Lisa are required. Therefore there are several options to remotely control the Lisa. This section outlines the available options to send commands to the Lisa and includes the full list of commands that are supported.
To program settings and control the operation of the Lisa, the Lisa Configuration Tool sends textual commands to the Lisa. In return the Lisa will send back a textual message to indicate whether the setting was applied. For most settings, the current setting can be read by issuing the command without the parameters. For example, to see which Telnet settings are used, the command 'telnet' (without the quotes) can be used. When the Lisa receives the command, it returns the current value of the setting.
For most settings, the current setting can be read by issuing the command without the parameters. For example, to see which Telnet settings are used, the command 'telnet' (without the quotes) can be used. When the Lisa receives the command, it returns the current value of the setting.
Description Command Parameters and response ERROR DHCP on/off isp streamit D 1 = DHCP, 0 = Static IP Downmix audio to mono forcemono 0 = Disable, 1 = Enable Encryption key (onboard) integrity check kchk Erase SD card ec Erase playlists ep File information finfo Filename was missing in the command Playlist number 1-50 (corresponding to 1.pls...50.
Description Command Parameters and response IP gateway isp streamit A IP Gateway (maximum 15 characters) IP netmask isp streamit 8 IP Netmask (maximum 15 characters) Keylock PIN pin 4 digits between 1 and 5 Live Communication URL livecom 1 URL (maximum 144 characters) Live Communication livecom 2 0 = disable, 1 = enable List of scheduled tasks stask Log level loglev 0 = Debug, 1 = Info, 2 = Error Menu language lang "EN","NL","DE", "FR", "ES" Monitoring server disconnect dc MSS to 1
Description Command Parameters and response Provider name isp streamit 1 Provider name (maximum 16 characters) Proxy on/off (example) proxy 1 0 = disable, 1 = enable Proxy URL (example) proxy 2 Proxy URL (maximum 144 characters) Random playback random 0 = disable, 1 = enable Remote Monitoring and Control interval (example) rcs 2 Monitoring message interval in minutes (maximum 32767) Remote Monitoring and Control URL rcs 1 URL (maximum 144 characters) Remove all presets channel 3 Reset
Description Command Parameters and response Stream name (example) channel 1 Parameter 1: Channel ID (Hexadecimal 0 up to 31, corresponding the first to the last streams) Parameter 2: Stream name (maximum length 16 characters) Stream url (example) channel 2 Parameter 1: Channel ID (Hexadecimal 0 up to 31, corresponding the first to the last streams) Parameter 2: Stream URL (maximum 250 characters) System status (internal) systat Telnet enable/disable telnet 1 0 = Disable, 1 = Enable Telnet conn
13.6 Description Command Parameters and response Update playlists only (no tracks) uo Update software uf Update software unconditionally un Update task schedule us Volume volume 0-31 Volume in steps of 0.5 dB volctrl2 0-124 Volume difference audio / commercials vdiff 0-31 Examples of sending commands The following examples aim to clarify how the commands are used. From these examples the use of the other commands can be derived.
Play playlist from card Play playlist 2, starting with entry 15: Command to the Lisa pp 2 15 Reply by the Lisa OK Set stream name Set the name of preset 4 to 'Lounge Radio' Command to the Lisa channel 1 3 Lounge Radio Reply by the Lisa OK Set stream URL Set the URL of preset 12 to 'http://my.radioserver.com:8853/private' Command to the Lisa Reply by the Lisa channel 2 B http://my.radioserver.
13.7 Reading the current setting For most settings, the current setting can be read by issuing the command without the parameters. For example, to see which Telnet settings are used, the command 'telnet' (without the quotes) can be used. When the Lisa receives the command, it returns the current value of the setting.
14 Monitoring The Lisa is much more extended than a simple internet player. It features automatic software update, playing from card, card content update, task scheduling and more. In this section the options to monitor the Lisa are described. This is a useful feature for a device with so many possibilities. The recommended starting point is to use the remote monitoring that the Lisa sends to the monitoring server.
14.2 Example log message Below, a screen shot of how one single log message is displayed on the Streamit Audio Distribution Platform. Next is a screen shot of a single log message on the Device portal: 14.3 Periodic log messages Player status An important part of the periodic log messages is the player status information.
Player status Comment Buffering (Card) Buffering before playing from card (playback has not yet started) Playing card Playing a playlist from card User abort Lisa is powering down Content update stages Because the content update is important for Store-and-Forward, the status of the content update process is included in the periodic monitoring messages.
A stream timeout counter higher than zero does not necessarily mean that the end user has heard issues with the audio. The Lisa has a buffer that lasts many seconds. Many consecutive read timeouts will eventually result in an empty audio buffer and the end user will hear a silence while the device reconnects (and re-buffers), or resorts fallback.
Message Description Content update Erase card Erase playlists Play announcement Play commercial Play playlist Play stream Playlist only update Power Schedule update Software update Software update - forced Brownout reset. Possible power supply failure. System reset due to power supply voltage drop. In case it occurs repeatedly, it is recommended to exchange the power supply.
Message Description Erase card failed Could not start the erase card, e.g., because there is no card present Erase card finished Erase card procedure has completed Erase playlist finished - playlists remaining represents the number of playlists remaining on the card after the task completed Failed to execute task - card usage not allowed A card-related task cannot be executed on a Lisa Basic edition, or the Lisa is not yet activated Failed to play announcement.
Message Description Lisa powered up Lisa is ready to start the various updates and commence playing from the selected source Not found on update server: The specific file was not found on the update location. Server returned HTTP error 404 when asked for the specific filename.
Message Description Required codec not activated The audio stream or playlist entry has an audio format that is not supported by this edition of the Lisa RTC access error Hardware issue RTC power failure detected. Backup battery empty It is highly recommended to exchange the battery or missing. when the issue persists. Running task was interrupted The running task (e.g. up) is interrupted from another scheduled task. Currently, this only applies to the playlist update.
Schedule update summary information tsk.rcv tsk.pln Number of tasks that was found in the schedule. If the message includes '+st', then one of the tasks was for time synchronization (added automatically in case of DP) Number of tasks that was planned for execution. Will be same as tsk.rcv if all of the tasks were valid and not expired. Content update summary information pls.found number of playlists to update, found in the SAF file pls.
ca.nf ca.
15 Live Communication With Live Communication, the Lisa makes a persistent connection to the Live Communication URL. When this connection is broken, the Lisa will try to reconnect. The connection can be used to · change settings · start actions · retrieve status and diagnostic information* This is done by sending commands to and receiving the responses from the Lisa. *Sending self-test commands is not recommended.
16 Volume and sound The Lisa can play commercials and announcements at a different volume level than music tracks. For this different volume levels are defined and applied to streams, playlists, commercials and announcements. The volume itself, as well as bass and treble can also be set. 16.
16.3 Fading The audio will fade out in all cases where audio playback is interrupted or stopped. This includes switching between playlists and stream presets and the start of announcements, but also when powering the device off and executing tasks which require the device to power off or reboot. Fade in is applied when the device returns from fallback, switching back to the stream and starting to play the stream audio. 16.
17 Network and internet 17.1 Configure the network settings Configuration of the network settings can be done using the Lisa Configuration Tool. To configure the network settings of the Lisa with the Lisa Configuration Tool, use the help presented in the tool. 17.2 Using a proxy server The Lisa supports the use of HTTP proxy servers.
As mentioned above, Streamit devices do not support NTLM, but only basic authentication. Some proxy servers can be configured to fall back to basic authentication. Configuration options for the different proxy servers are beyond the scope of this manual. 17.2.4 Remote monitoring data via proxy server The Lisa will use the HTTP CONNECT method for the remote monitoring when the use of a proxy server is enabled. This requests from the proxy a tunnel between the Lisa and the destination server.
Short description Config server Connection to the configuration update server. Not applicable for fixed configuration mode.
· Only Proxy server shows S (=success): The Lisa is configured to use a proxy server, but there is an issue with the configuration of the proxy server. To resolve this issue, consult your network administrator. · None of the connection tests show an S (=success): The Lisa has no internet connection. Check the IP settings of the Lisa, take special note of the proxy server settings (see instructions above). Verify the network using a different device on the same network connection.
17.4.1 Ports used for device-related activities (configuration, monitoring, etc.) The Lisa performs a number of functions that require information to flow over the network, such as retrieving its configuration, its schedule, playlists, as well sending monitoring data, etc. In all cases the Lisa makes a connection to a remote location, for which the address (the URL) is configured in the device settings.
· Port 87xy - for streaming from the ADP. For the actual port number please have a look at your account details, or as an admin view the 'client' details of the customer in question to find out what port the distribution server is configured to operate. Streamit webserver (streamit.
Secure connection for Start URL with Configuration, Schedule, Content update, Software update https:// Monitoring, Ticker tls:// The Lisa will make the secure connection on the specified port. If no port is specified, port 443 will be used. Device portal supports secure connections for all services, see the online user manual of Device portal for more information. 17.6 HTTP Basic Authentication Out of the box, Lisa devices support basic authentication to connect to the different resources.
18 Remote software update (RSU) The Lisa features Remote Software Update (RSU). When the device starts up and the RSU feature has been enabled, it will first check if a new software version is available. When that is the case, the device will automatically update to the new version (certain conditions may apply, see When will Lisa device(s) update automatically). The Remote Software Update feature can be enabled for all devices.
18.4 Forcing an update when RSU is disabled In case the Remote Software Update feature has been disabled, updates can still be performed using Lisa Configuration Tool. 18.5 Best practice The software of the Lisa can be updated in many ways. You can use the Lisa Configuration Tool, you can enable RSU, or you could schedule a task for it. All this ways would work, but let us look at the big picture. Although the Lisa has a rich feature set, we are still adding functionally to it.
19 Protecting device and content 19.1 Card track encryption When you use the Lisa as a standalone player, the audio files need to be copied on the (micro) SD memory card to be used with the device. When you copy audio files directly onto the card, anyone can copy and later play them on their own system. The problem increases when “Store and Forward” is used. For such an application it is required that files are placed on a web server and downloaded by the device.
19.1.1 Generating an encryption key The Streamit Card and Scheduler Toolkit is used to generate the encryption key(s). The full version of the Streamit Card and Scheduler Toolkit is required to encrypt tracks, the free version does not offer that functionality. Ask your sales contact at Streamit for details of the SCS Toolkit. Some documentation or software may refer to the 'decryption key'. This is exactly the same key as the encryption key.
20 Useful tools 20.1 Lisa Configuration Tool The Lisa Configuration Tool (LCT) is a Windows PC software program that communicates with the Lisa over USB.
20.2 Streamit Card and Scheduler Toolkit The Streamit Card & Scheduler Toolkit (SCS Toolkit) is a collection of useful tools. You can use these tools to convert audio files into encrypted files (Streamit encryption method) and for other Store and Forward and card-related operations. You can further use the SCS Toolkit to create playlists and playlist update files, to format your card and to create schedule files.
21 Background knowledge There is a lot to know when you want to fully understand the Lisa. Some of the more important background information is included in this section for reference. 21.1 The general flow in Lisa devices The Lisa is a compact device that can be used for streaming via internet and for playing from memory card (Store-and-Forward). For a better understanding of the flow in the device, we have depicted the high-level flow of a Lisa device in figure below.
21.2 The startup procedure Every time the Lisa device is powered up, it will perform the startup procedure, consisting of a few initialization steps. These steps are carried out automatically and in most cases no input is required from the user. The status messages on the LCD are updated according to the on-going procedure.
The first step in the startup procedure is the software initialization. As the name indicates, the software of the device is properly initialized. Everything in this step is transparent to the user. The Lisa edition will be activated after the Lisa is connected for the first time to the public internet. This means that the Lisa devices always need to be connected one time to the public internet before they can be used in a private network.
21.3 Playing of playlists The files or streams contained in the playlist are played one after another (as long as random playback is disabled): · When a track has been played until the end, playback continues with next entry in the playlist · When a stream stops (e.g., when the connection fails), the Lisa will try to connect to the next entry in the list Also if an entry is not available, the Lisa will continue with the next entry and so on.
§ Immediately after power on: Start from the last played entry § When executing play-playlist task and when switching between playlists: Start from the first entry in the playlist 21.5 The audio buffer For streaming applications, the Lisa has a buffer of 1.5MB. The streaming algorithm in the Lisa tries to fill the buffer to its maximum. The time it takes to fill the buffer to the maximum level, depends mainly on the streaming server configuration and the quality (data rate and reliability) of the stream.
21.7.1 MP3 formats Supported bitrates for MPEG1.0 Supported bitrates for MPEG2.0 Supported bitrates for MPEG2.5 21.7.2 OGG Vorbis formats Only floor 1 is supported and all one- and two-channel Ogg Vorbis files should be playable. OGG format specifications 21.7.3 AAC formats MPEG2-AAC-LC-2.0.0.0 and MPEG4-AAC-LC-2.0.0.0 streams, i.e. the low complexity profile with maximum of two channels can be decoded.
Please note that bitrates above 384 kbps are not tested. Also: 64000 Hz, 88200 Hz and 96000 Hz AAC files are played, but with wrong speed 21.8 PCI DSS compliance The payment card industry has set out a data security standard. Compliance to this standard is required for all companies that process credit card transactions. This section answers some questions related to PCI DSS and the Lisa.
· Expert knowledge of the Lisa architecture · Very good knowledge of decompiling the Lisa software · Expert knowledge in reproducing the Lisa functionality and adding malicious code to it · Good hacking skills to install the 'infected' application to the device · Expert hacking skills to gather data in the network and communicate that data outside of the network This makes the Lisa an unattractive and highly improbable device to target for 'infection'.
22 Troubleshooting In this section several tools and options for troubleshooting are described. Please consider these options before contacting support, this may save you time. 22.1 Self test To make the Lisa Compact perform a self-test, send the self-test command 'e' (without the qoutes) via the Lisa Configuration Tool. The self-test should return 'Selftest Ok'. Otherwise, please save the logging and contact support. 22.
22.2.
22.3 Find the serial number The serial number of the Lisa is printed on the sticker on the bottom of the device and on the gift box. 22.4 Forcing an update when RSU is disabled In case the Remote Software Update feature has been disabled, updates can still be performed using Lisa Configuration Tool. 22.5 Manual device activation The activation process for a Lisa device can be initiated from any of the available command interfaces, by issuing the respective command.
· Special log messages that are sent when an event happens, e.g., the device has updated its task schedule 22.7 Detailed logging When a connection is available between the Lisa and the Lisa Configuration Tool (LCT), the Lisa constantly sends log messages which are displayed in the monitoring window of LCT. The LCT interface is the same for all Lisa devices. This monitoring has much greater detail than can be derived from the regular platform-based monitoring (see Monitoring).
223 Device tries to start a content update without having terminated the previous instance of the content update [internal error] 226 No URLs are available for streaming. Configuration is not yet completed or device could not connect to configuration resource. 227 Insufficient data is read for stable playback from the card. Re-buffering will follow with audio silence during re-buffering.
423 Encryption key calculation result is out of bounds [internal error] 424 End of the playlist is reached, playlist will start over 425 Device is trying to start a card related task (cc, ec, ep) without having terminated a previous instance [internal error] 426 License is required to use the content on the card, but license file not available on the card 427 License is required to use the content on the card, but license file on the card is not valid 428 License is required to use the content on the card,
514 Failure to allocate requested memory for streamer functionality [internal error] 520 Size of downloaded software does not match the size reported in the update information file 521 Downloaded update software exceeds the maximum size supported for specific device type [internal error] 522 Software was not downloaded completely or incorrect files were available on the software update server 523 Remote software update is disabled (or size of update file on server is too small [internal error]) 524 Failure
544 Maximum number of open files supported by the OS was reached [internal error] 545 Failure to send an HTTP request 546 Device is trying to connect an empty (non-configured) resource URL 549 Could not start player thread [internal error] 551 Failure to get or set the RTC date/time. Indicates potential hardware issue.
567 Lisa (already) connected to the remote server 568 No connection allowed since the interval = 0 secs 569 v. 1.4Failure to allocate requested memory for ticker functionality [internal error] v. No messages can be sent to monitoring server when monitoring is disabled 1.6+ 570 Device (already) connected with ticker server (not likely) 571 v. 1.4Failure to allocate requested memory for activation functionality v. Attempt to send a remote message which is not known [internal error] 1.6+ 572 v. 1.
581 Could not access PHY. Indicates potential hardware issue. 582 Link not available, make sure the device is physically properly connected to the network infrastructure 583 No connection can be made because network interface is not yet configured (e.g.
23 More information In addition to this manual, the following sources are available for your reference: · Streamit support site with knowledge base: http://support.streamit.eu/ · Streamit site with additional manuals: https://www.streamit.
24 Support For technical support regarding the Lisa devices, software tools or technical documentation, please contact your dealer first. In case you are a direct customer of Streamit, please visit the knowledgebase, or the support page (http://support.streamit.eu/) where you will find an option to submit support tickets.
© 2020 Streamit B.V.
FCC Statement This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications.
