6.2.1 Requirements for online playlists ................................22 6.2.2 Limitations of online playlists ................................24 6.3 Single track playlist ..............................24 6.4 Mixed source playlist ..............................25 6.5 Background: Flow for playing from internet ..............................26 7. Playing from card Lisa Compact...
Page 3
..............................31 7.6.1 Play playlist at Lisa startup ................................31 7.6.2 Play playlist following task or command ................................32 7.7 Background: Streamit custom SD cards ..............................35 8. Fallback to card 8.1 Fallback in case of stream failure ..............................37 8.2 Set up the Lisa for fallback...
Page 4
14.3 Periodic log messages ..............................63 14.4 Event-driven log messages ..............................65 15. Live Communication 15.1 The Streamit Live Communication Gateway ..............................72 15.2 Enable Live Communication on the Lisa ..............................72 16. Volume and sound 16.1 Defined volume levels ..............................
Page 5
19.1.2 Loading the encryption key into the Lisa ................................85 20. Useful tools 20.1 Lisa Configuration Tool ..............................86 20.2 Streamit Card and Scheduler Toolkit ..............................87 21. Background knowledge 21.1 The general flow in Lisa devices ..............................88 21.2 The startup procedure ..............................
Page 6
22.4 Forcing an update when RSU is disabled ..............................98 22.5 Manual device activation ..............................98 22.6 Monitoring logging on the platform ..............................98 22.7 Detailed logging ..............................99 22.8 Error codes ..............................99 23. More information 24. Support Lisa Compact...
Page 7
2. this device must accept any interference received, including interference that may cause undesired operation. The Streamit internet radio device does not contain any user-serviceable parts. Repairs should be made only by an authorized Streamit service center. Unauthorized repairs or modifications could result in permanent damage to the equipment, and void your warranty and your authority to operate the device under Part 15 regulations.
This manual applies to Lisa software version 1.44. 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.
Page 9
To make proper use of the Device portal you need to create an account. You also need to have a Device portal subscription plan to use your Lisa device on the Device portal. For this purpose, Streamit currently offers 2 versions: the Device portal Basic subscription and the Device portal Extended...
Page 10
Please note that you need to sign a support agreement with Streamit when building your own platform. This agreement makes clear what you may expect from Streamit in terms of professional support for such a crucial operation that a custom platform is for you.
Device appearance Front view The front view of the Lisa Compact is depicted below. Lisa Compact features four status LEDs and a Micro-USB service connector. The MicroSD card slot can be found at the centre of the bottom side, covered by a hatch mounted with a single screw.
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. You will hear a click and the adapter will be locked in place. 90° Start position End position Lisa Compact...
Page 13
Lisa and the internet. The small (type B micro) connector of the USB cable is plugged in the device, while the A-connector is intended for connection to your Windows PC. Before making this connection we recommend that the Lisa Configuration Tool is first installed. Lisa Compact...
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.
Page 15
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. Lisa Compact...
Configuration 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.
The recommended configuration interface for the Lisa devices is the Device portal web-interface. By default, all Streamit devices will get their configuration from the Streamit Device portal. Configuration from SD card The Lisa can load a configuration from the SD card. This can be very useful when a large number of devices needs to be configured.
Page 18
This makes it possible to create a single SD card image that contains several configurations for specific devices. The image can be copied and used for many devices, each device will load the configuration file that has its serial number as file name. Lisa Compact...
Condition Power connected, but device is off Power connected, but a fatal error has occurred* Device is on * Please consult Streamit support for more information. LED: Network Condition There is no physical connection to the network DHCP configuration in progress...
Page 20
No card present, but this is required for playing from or content update Card is mounted and ready to use Playing from card Content update is running Cleanup card, Erase card, Erase playlist LED: Audio Condition Not playing (no error situation) Buffering (card or inet) Playing card Lisa Compact...
Page 21
Playing inet Playing card in fallback Not playing (error situation e.g. missing codec license for specific code, no stations, no playlists etc.) Lisa Compact...
Playing a stream or playlist from internet 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.
Page 23
/ m3u8 audio/x-ms-asf · Reference in the playlist to an other playlist (nesting) is not supported Example of an M3U playlist The simplest playlist file (e.g: myPlaylist.m3u) it looks something like the following: http://myServer/audio/myAudioFile3.mp3 http://myServer/audio/myAudioFile1.mp3 http://myServer/audio/myAudioFileN.mp3 Lisa Compact...
This setup allows you to change the program 'on the fly', even while the Lisa is playing the program. Each time the Lisa requests a playlist, the server will base the response (the returned playlist) on the latest version of the program and the Lisa will (therefore) follow the new planning/program. Lisa Compact...
For these error conditions, the following applies: · The Lisa will request a new playlist from the server · The error condition will be included in the header of the request that is sent to the server Lisa Compact...
The server can parse the header and detect the error condition: Header Error condition X-STREAMIT-PLAYER-PLSERR: No card The playlist refers to a track on the card, but there (mounted) is no card present/mounted X-STREAMIT-PLAYER-PLSERR: <x> Missing The playlist referred to one or more tracks that Entries were not found on the card, where <x>...
Streamit will only officially support the use of these custom-supplied Transcend SD cards. Other cards may always be used at own risk. Streamit will not offer free support for other memory cards. Streamit custom SD cards for background information on this matter.
‘1.pls’ and ‘2.pls’ (not 2.pls and 4.pls for example, this would result in no playlists being recognized by the Lisa at all). · Playlists must follow the PLS standard (Wikipedia PLS format description), and specifically Lisa Compact...
Page 29
Gaps in the numbering of the entries (1, 2, 4) are not allowed § There can be no more than 32768 entries per playlist o Tags must come in the order that is indicated in the following tables: Lisa Compact...
Page 30
Volume and sound for more information. Footer section: Required Remarks NumberOfEntries Value must be equal to the total number of entries in the playlist. The key-value pair must end with a newline Version Value must be '2' (without the quotes) Lisa Compact...
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...
When the Lisa is instructed to play a playlist by a task in the task schedule or by a command using e.g., LCT, a series of checks and actions are executed to determine which playlist and playlist entry should be played. This is outlined in the flow diagram below and explained in detail in the accompanying text. Lisa Compact...
Page 33
To review the play playlist task and command, see Schedule tasks and Command overview list, respectively. Lisa Compact...
Page 34
Because it is possible to do content update in background, it is checked whether the playlist has been updated since the last time it was used. If so, it is reloaded so that the updated playlist is used. Lisa Compact...
The SD card is the key component in using Store-and-Forward and Fallback to card on Streamit’s audio devices. Streamit always puts a lot of effort in making sure the hardware and software follows the SD specifications. However, there are numerous manufactures each with their own implementation. These implementations are also continuously updated and Streamit has no influence on that.
Page 36
Streamit will only officially support the use of these custom-supplied Transcend SD cards. Other cards may always be used at own risk. Streamit will not offer free support for other memory cards. Lisa Compact...
It allows you to couple a matching fallback playlist to each station. It works as follows: · Playlist one (1.pls) is the fallback playlist for preset 1. · Playlist two (2.pls) is the fallback playlist for preset 2 and so on. Lisa Compact...
This section describes in detail a minimal setup to make the Lisa fallback and play from the SD card in case of network or streaming failure. It is assumed that the Lisa has a preset 1 configured to play an audio stream. Lisa Compact...
Requirements for playlists on the card. For testing purposes, it is recommended to use the Streamit Card and Scheduler Toolkit to create the playlist. · Copy the playlist and the tracks that it uses onto the SD Card, according to the...
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...
Store-and-Forward for the Lisa: · Set up your own Simple Store-and-Forward Server · Use Streamit ADP, the ADP - User Manual includes a step-by-step 'How to' for Store-and-Forward · Use your own custom-built platform...
This task is repeated daily, to be able to update the contents on the card daily. On Monday Nov 2nd at 09:00 (shop opening time) the Lisa starts playing playlist 1.pls. This playlist will be played every day, as the task is daily repeating. Lisa Compact...
To play commercials, the Lisa needs both the commercial tracks, as well as the planning. How the Lisa receives the tracks and the planning, depends on the configuration platform. Please consult the user manual of the configuration platform for more information. Lisa Compact...
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. Lisa Compact...
The 'Update content' task will only work if the Content update URL (in the configuration of the Lisa) points to a platform that supports this, for example Streamit Audio Distribution Platform (ADP) or a custom-built platform.
The Lisa can be configured to perform the content update in the background. This can be done via a configuration platform that supports this (for example Streamit ADP), or via a command (see Command overview list).
Page 47
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. Lisa Compact...
Finally, the Lisa can also read its schedule from the SD card. The time and date of the clock of the Lisa is set by a special tasks in the schedule file (the Streamit Device portal and Streamit ADP include this task in all schedules).
Page 49
Lisa is powered on. updated, Lisa is powered ally off. Update Task is performed in the Task is performed in the Content update is schedule background background stopped, task is executed, Lisa is powered off Lisa Compact...
Page 50
Start Task is not executed Playback is stopped at Task is not executed commercial the end of the current track, the commercial is played, playback continues with the next track from the playlist Lisa Compact...
Task Command Schedule update Update schedule Content update Update playlists Update playlists only (no tracks) Update commercials and announcement tracks Update commercial plans Rescheduled tasks will be canceled when another schedule task is started or when the Lisa resets. Lisa Compact...
This is done by sending the desired commands to the device. The commands that can be used are described in Command overview list. This feature is available on Streamit Device portal and Streamit Audio Distribution Platform. 13.2 Live Communication With Live Communication, the Lisa makes a persistent connection to the Live Communication URL.
A device reset may be required to apply changes in settings. The “reset” will power the Lisa Compact device back on. The Lisa needs to be powered on after a "reset", using the “pw 1” command .
Page 54
Automatic card cleanup Clean up to execute in the ccinbg 0 = Disable, 1 = Enable background, while playing Configuration URL (example) isp streamit 7 URL (maximum 144 characters) Connect to Monitoring and Control Server Connection test ctest...
Page 55
Description Command Parameters and response ERROR Filename was missing in the command DHCP on/off isp streamit D 1 = DHCP, 0 = Static IP Downmix audio to mono forcemono 0 = Disable, 1 = Enable Encryption key (onboard) kchk integrity check...
Page 56
0 = MSS of 536 (default), 1 = MSS of 1460 TCP fragmentation is not supported) Operation mode mode streamit 1 = Streamit Device Portal, (configuration source) 2 = Custom web resource, 3 = Fixed settings Play announcement Filename of the announcement on the SD card...
Page 57
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...
Page 58
(internet) Treble level treble -8 to 7 Update only commercial plans Update commercials and announcements tracks Update content (full) Update content in the udinbg 0 = Disable, 1 = Enable background Update device configuration ud Lisa Compact...
Read the IP and related settings Command to the Lisa Reply by the Lisa current Network settings: Provider name: Channelservice Local IP (DHCP): 0.0.0.0 Netmask: 0.0.0.0 Gateway: 192.168.10.1 DNS1: 0.0.0.0 DNS2: 0.0.0.0 Web URL: http://staging.devices.streamit.eu:9999/config Remote Update: Enabled Update URL: http://www.streamit.eu/lisaupdate/ > Lisa Compact...
Page 60
2 http://123.4.56.78:8080 Reply by the Lisa Set monitoring interval to 15 minutes Command to the Lisa rcs 2 15 Reply by the Lisa Set configuration URL Command to the Lisa isp streamit 7 http://devices.streamit.eu/config Reply by the Lisa Lisa Compact...
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 ' ' (without the quotes) can be used. telnet When the Lisa receives the command, it returns the current value of the setting. Lisa Compact...
There are two settings that need to be programmed, so that the Lisa knows where to send the logs and how often. This can be done on the Device portal or Streamit ADP, or manually. See the <rcs> command described in...
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.
Page 64
The periodic messages have a miscellaneous information field. This contains information about the stream stability. This information is printed in the Misc column on the Streamit Device portal and the Streamit Audio Distribution Platform. The stream stability is represented by a number of counters.
<scheduled_task> task failed there is no card in the Lisa while the task requires a card, etc. Tasks that can be reported: Activate device Clean up card Comm. & Ann. update Configuration update Lisa Compact...
Page 66
Could not play announcement '<filename>' The announcement is not played, because the required file is not available on the card Could not play commercial '<filename>' The commercial is not played, because the required file is not available on the card Lisa Compact...
Page 67
Lisa has no presets, playing from card The Lisa plays from card, because it has no presets. The Lisa periodically performs a configuration update in the background, to try and get presets Lisa Compact...
Page 68
<INFO> Received activation code: Card usage Part of the activation process Received activation code: Codec Part of the activation process Received activation code: EV Part of the activation process Lisa Compact...
Page 69
Trying configuration via failover resource Failure to connect to or resolve the configuration resource. At least one failover configuration resource has been configured and the Lisa will try configuration from there. Lisa Compact...
Page 70
Only included if CAN update information were already available on the card was found number of commercials/announcements that were ca.dwn Only included if CAN update information downloaded was found Lisa Compact...
Page 71
Only included if CAN update information failed to download because of other reasons than was found not found on the server Lisa Compact...
You can build your own applications for 'live' interaction with Lisa devices anywhere in the world, using the API of the Streamit Live Communication Gateway. To use the fully documented API of the Streamit Live Communication Gateway a subscription is required, please contact sales@streamit.eu...
Max level. The Lisa knows that it plays a commercial or announcement, because it is a task with the command sc or sa, respectively. There is no need to have a volume parameter as part of the task. Lisa Compact...
Lisa can be configured to downmix the audio. The Lisa will mix the audio data of the left and right channel together and send the (down-sampled) result to both RCA output connectors. The Lisa can be configured to downmix by sending a command (see Command overview list). Lisa Compact...
When the device tries to connect, the proxy server will respond with HTTP error 407. The HTTP response also contains a header indicating the type of authentication protocol used. Below, part of a HTTP proxy response, requiring NTLM: HTTP/1.0 407 Proxy Authorization Required Proxy-Authenticate: Negotiate Proxy-Authenticate: NTLM Lisa Compact...
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. Remote monitoring data via proxy server 17.2.4...
That means all internet connections will fail. First check with your network administrator whether a proxy server must be used. If so, make sure the connection with the proxy server can be made and test again. See also Using a proxy server. Lisa Compact...
80 for all services. · Config server shows N (=not applicable): The Lisa is configured to use a fixed configuration and will not apply changes from the configuration server (e.g., Device portal or Streamit's Audio Distribution Platform) 17.4...
Different ports are used by Lisa devices that are registered on Device portal before February 2, 2015 For more information, see the manual that is available online on Device portal. Streamit Audio Distribution Platform (ADP) When the Streamit ADP is used as configuration platform, connections will be made with the following servers: Streamit ADP (adp2.streamit.eu) ·...
Port 80 – for software update, used as default software update resource Streamit Live Communication Gateway For more information on the domain and port used for the Streamit Live Communication Gateway, see the corresponding documentation. Ports used for streaming and Store-and-Forward audio 17.4.2...
Authorization header in the HTTP request. This is completely transparent to the user. The credentials for the authorization will be parsed from the resource URL , e.g. http://username:pass@server:port/path. 17.7 Lisa host name The host name of the Lisa is the hardware version+serial number. For example, Lisa Compact...
Device portal. When this feature has been enabled, your device will automatically update to the latest version on the Streamit update server or to the version on your own update server, depending on how this is configured in the Streamit Device portal.
RSU. If later a software update is required, it can be realized in one of the following ways: · Switch on RSU using the platform where the device retrieves its configuration · Switch on the RSU or load the software directly into the Lisa using the Lisa Configuration Tool. Lisa Compact...
Lisa. An encryption system using Streamit’s encryption technique is depicted in the figure below. The main idea is simple; you use a “key” to encrypt your audio files. This is called the Encryption key and is...
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.
A device reset may be required to apply changes in settings. The “reset” will power the Lisa Compact device back on. The Lisa needs to be powered on after a "reset", using the “pw 1” command .
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.
It is also possible to control the Lisa from a remote server, by sending it commands (like those supported by Lisa Configuration Tool), over a local network or internet. This is covered in the section on Commands. Lisa Compact...
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. Lisa Compact...
Page 90
If the configurations are retrieved from a platform (Streamit Audio Distribution Platform, Device portal, or a custom-built platform) the Lisa will perform a configuration update. However, this will not be done when the Lisa is not programmed to work with Fixed settings.
All entries are played in random All entries are played sequentially* entries order Playlist has more than 2000 All entries are played All entries are played sequentially* entries sequentially* *First entry to be played depends on how the playlist is started: Lisa Compact...
The Lisa devices support the following audio formats: MP3, OGG, AAC+. Please note that depending on the type of Lisa you have, not all formats are supported. All Lisa devices support MP3, see Lisa product range for more details. Lisa Compact...
The table below shows the maximum bitrates allowed for two channels for a specific samplerate as defined by the AAC specification, while the Lisa itself does actually not have a lower limit. Lisa Compact...
Streamit does not know of network scans performed by an Approved Scanning Vendor (ASV) on networks where a Lisa device is installed. Nor has Streamit been able to find tools for testing this. Considering Streamit's large, world-wide customer base and the strict enforcement of PCI regulations, it should be safe to say with a high degree of certainty that the Lisa does not compromise the PCI DSS compliance of a network.
Page 95
By placing the Lisa outside the local network in a well-configured DMZ, the Lisa can be denied access to the local network. In such a setup, the Lisa cannot be used to attack other devices in the local network, even in the theoretical case that the Lisa would be 'infected'. Lisa Compact...
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 ' (without the qoutes) via Lisa Configuration Tool. The self-test should return ' '.
80 for all services. · Config server shows N (=not applicable): The Lisa is configured to use a fixed configuration and will not apply changes from the configuration server (e.g., Device portal or Streamit's Audio Distribution Platform) Lisa Compact...
22.6 Monitoring logging on the platform If available, the remote monitoring logging on the platform (Device portal, Streamit Audio Distribution Platform, or a custom-built platform) is a great source of information on what happens with the Lisa 'in the field'. The section...
Lisa devices. This monitoring has much greater detail than can be derived from the regular platform-based monitoring (see Monitoring). The logging of LCT can be saved for careful review and may be required by Streamit when providing support. Please include the LCT log data in support requests when LCT log data is available.
Page 100
420 Device needs to perform card related functionality (e.g., play content from card), but card is not present 421 Failure to allocate requested memory for card functionality [internal error] 422 Card present in the device, but not useable Lisa Compact...
Page 101
501 Player was not successfully initialised [internal error] 502 Failure to register ethernet device, indicates hardware issue with network interface 509 Failure to allocate requested memory for receiving configuration or online playlist [internal error] 513 Could not start streamer thread [internal error] Lisa Compact...
Page 102
540 Failure to create a socket for the connection [internal error] 541 Failure to set socket option MSS [internal error] 542 Failure to set socket option RCVTIMEO or SNDTIMEO [internal error] 543 Failure to set socket option RXBUF [internal error] Lisa Compact...
Page 103
No schedule file was found on the card 1.6+ v. 1.4Failed to create a connection with the remote server Failure to allocate requested memory for remote monitoring functionality [internal error] 1.6+ 566 Failed to disconnect from the remote server Lisa Compact...
Page 104
Activation instructions are incomplete or incorrect [internal error] 577 Activation instructions are incorrect 578 Could not access PHY. Indicates potential hardware issue. 579 Link not available, make sure the device is physically properly connected to the network infrastructure Lisa Compact...
Page 105
583 No connection can be made because network interface is not yet configured (e.g. when device is in configuration wizard) 584 Playlist entry will be skipped, because this is being downloaded at the specific moment 587 Not enough memory for certificate Lisa Compact...
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.eu · The Lisa Technical Manual site for customers with a support contract for a custom-built platform...
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.
Page 109
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.
Need help?
Do you have a question about the Lisa Compact and is the answer not in the manual?
Questions and answers