TABLE OF CONTENTS PRECAUTIONS ........................5 Important Remark ..........................5 Important Safety Instructions ......................6 Cleaning ..............................6 FEATURES ..........................7 Main Features ............................7 INSTALL & CONNECT ......................8 Location, set up and ventilation ....................8 AC connection and powering on ....................8 Audio output connections .......................
Page 3
7.3.3 Connecting to a WiFi network ..................63 System ..............................65 7.4.1 Name and Time ........................ 65 7.4.2 Security ..........................67 7.4.3 Backup, Restore and Firmware ................... 70 7.4.4 USB/MMC Settings ......................72 7.4.5 Register ..........................75 7.4.6 Reboot ..........................76 SSH server configuration for Store &...
1. PRECAUTIONS 1.1 IMPORTANT REMARK The lightning flash with arrowhead symbol, within an equilateral triangle, is intended to alert the user to the presence of uninsulated “dangerous voltage” within the product’s enclosure that may be of sufficient magnitude to constitute a risk of electric shock to persons. The exclamation point within an equilateral triangle is intended to alert the user to the presence of important operating and maintenance (servicing) instructions in the literature accompanying the appliance.
1.2 IMPORTANT SAFETY INSTRUCTIONS Read these instructions. 12. Unplug the device during lightening sorts or when unused for long periods Keep these instructions. of time. Heed all warnings. Refer servicing qualified Follow all instructions. personnel. Servicing is required when Do not use this device near water. the device has been damaged in any Clean only with dry cloth.
Ecler PLAYER ZERTO comes with a 3-year warranty. 2. FEATURES PLAYER ZERO is a compact stereo audio player able to play music content from local storage devices (USB/MICRO SD), Internet streaming services (online radios, etc.) and digital media exchange (DLNA, AirPlay) with the following main features.
3. INSTALL & CONNECT 3.1 LOCATION, SET UP AND VENTILATION The PLAYER ZERO has been specially designed to be used both as a desktop player and a 19" rackmount unit, occupying third a rack space (with VEO-RACK19, optional mounting kit for standard rack cabinets).
This connection provides access to Internet contents, and to the configuration of the unit using a web browser on the computer, which points to the IP address of the PLAYER ZERO, showing the web application embedded in the unit. Refer to the PLAYER ONE &...
3.6 GPI REMOTE CONTROL PORTS PLAYER ZERO has 2 GPI control inputs on its rear panel. These inputs can be connected to an external physical device (e.g. a contact closure) and associated with an PLAYER ZERO function: • Load and play previously configured audio content •...
Plug the power cord into the back of the device to turn it on. 4.1 RESTORE DEFAULT / FIRMWARE UPDATE PLAYER ZERO has two functionalities that can be be done via the FD/FS button on the rear panel: • Restore Factory Defaults: Restore factory settings. Press and hold the FD/FS button on the rear panel for 10 seconds with a small pin or paper clip while the unit is powered on.
5. PANEL FUNCTIONS 5.1 FRONT PANEL ON LED: power indicator. MICRO SD/MICRO SDHC slot: for local audio content playback. SP LED: signal present indicator. Up to 2TB. FAT16/32 format. LED: network traffic USB 2.0 port: for local audio indicator. content playback. Up to 2TB. LED: Micro SD source FAT16/32 and NTFS format.
6. TECHNICAL DATA 6.1 TECHNICAL SPECIFICATIONS PLAYER ZERO DIGITAL ENGINE Processor MIPS Single Core 64bits 580MHz AUDIO CONVERTERS Sampling rate 48kHz Resolution 16bit Bit rate 32~320kbps Frequency response 5Hz - 24kHz (-3dB) MEDIA PLAYER Local storage (USB & microSD), Internet...
Page 14
REAL-TIME CLOCK Retention time 240 hours aprox. Accuracy ±1 minute / month MONITORING AND CONTROL Display Front panel: NET, SP, SD, Power LED indicators Rear panel: Wifi Rear panel: Factoty Defaults / Fail Safe (pin- Buttons hole) LOCAL STORAGE Front panel micro SD slot Micro SD Supports micro SD SDXC Front panel USB female connector...
Page 15
PHYSICAL Min 0°C, +32°F Operating temperature Max +35°C, +95°F Operating humidity < 85% HR Min -10°C, +14°F Storage temperature Max +50°C, +122°F Storage humidity < 90% HR Installation options Desktop, rack (1/3 of 1UR) AD/DC Power Supply, WiFi antenna, adhesive rubber feet, rack tray screws , GPI Included accessories connector, warranty card and standard user guide...
Ethernet (wired) or WiFi. 7.1 FIRST STEPS In order for the device to access the PLAYER ONE / PLAYER ZERO web application, it must be connected to the network, either via a cable (RJ-45 connector) or wirelessly (WiFi).
Page 19
• WiFi: PLAYER ONE / PLAYER ZERO has a WiFi network interface, which means that mobile devices can stream audio to the device. It can be configured wirelessly. There two modes of operation: o MASTER mode: point-to-point connection. The device's WiFi network interface is set to this mode by default.
Page 20
PLAYER ONE / PLAYER ZERO devices use the mDNS service so that they can be accessed intuitively through a web browser on the same local area network (LAN). To access the web application easily, enter “devicename.local/” into the search bar of your browser. By default this is, "playerone.local/"...
Figure 6: web application welcome page 7.1.1 QUICK GUIDE FOR ETHERNET CONNECTION 1. Connect the PLAYER ONE / PLAYER ZERO to a switch/router via the Ethernet interface (wired). 2. Connect the computer/smart device to the same network. 3. Enter "playerone.local/" for PLAYER ONE, or "playerzero.local/" for PLAYER ZERO, into your browser.
7.2.1 PLAYER This page in the PLAYER ONE / PLAYER ZERO menu displays information about playback, streaming tags and detailed information about the audio content, and in addition, it shows the album art. It also allows basic functions to be controlled remotely, such as PLAY/PAUSE, STOP, PREV and NEXT;...
Page 23
(same signal on left and right channel). 10. Volume: allows the volume to be controlled remotely. Please Note : PLAYER ZERO does not have a volume control on the front panel. 11. Repeat mode: o PLAY ALL: Plays through the entire playlist once.
Page 24
Year of development o Device firmware version o Ecler Gallery platform registration key 16. Screen refresh: allows the screen refresh to be paused (SP, playback time, file information, etc.). It also shows the number of changes made to a configuration before it is saved.
7.2.2 PRESETS PLAYER ONE/ PLAYER ZERO allows up to 20 presets or user configuration memories to be created. If you recall a preset stored in the device at a later date, it will recall all the settings that are stored in that preset.
Page 26
Presets page header, and in the RePlayer application. Please Note: PLAYER ZERO does not have an LCD screen. 3. Enabled Events: enables/disables events triggered by GPIs (General Purpose Input) and the silence detection event in the preset. The GPIs and the silence detection event must be configured on the Events page.
Page 27
o Source path/url: this stores a network or local address in the preset. This address must be a valid address for the correct playback of audio content on the device. You can refer to the application prompts for entering local addresses (USB, SD, AirPlay, etc.).
Page 28
...path... is the folder path where the pls file is located Media pointed by party.m3u Defined by the m3u http://www.ecler.com/music/party_songs/party.m3u playlist, and located in a Internet url playlist file (corporate web, etc.) Media pointed by party.pls playlist, Defined by the pls http://www.ecler.com/music/party_songs/party.pls...
7.2.3 EVENTS 3 events are available: 2 of them are triggered by the GPI ports (by means of external, potential-free contact closures, which are connected to the GPI ports on the rear panel of the unit) and the other is triggered by silence detection. Both types of events can be configured on the Events page.
Page 30
7.2.3.1 GPI EVENTS There are 2 GPI events: GPI1 and GPI2. They can each be configured to trigger in different ways and perform independent actions. Figure 10: GPI configuration, Source • Source: source o Polarity: polarity, direct or inverse; to define the trigger, by contact closure or contact release.
Page 31
• Target tab: an action that the device will perform after GPI activation. There are several options or types of event (Type): o Internal: internal stimulus. This is useful for triggering actions within a Script. o Preset recall: loading a preset. Select the preset you want to load with the GPI activation.
Page 32
7.2.3.2 SILENCE DETECTION EVENT PLAYER ONE/ PLAYER ZERO has a special event, the SILENCE detection event: absence of a real analogue audio signal at the unit's outputs. This allows the player to continue playing the media when the programmed audio that is being played ends, or is interrupted for any reason, which may sometimes happen due to certain problems that may arise (loss of Internet, accidental disconnection of the network cable, bad files, etc.): "The show must...
Figure 13: example of configuring a calendar event PLAYER ONE/ PLAYER ZERO has 24 calendar events available, each of which are fully configurable. The default names are: C01, C02…C24. When you click on the name, it will take you to the configuration for that calendar event.
Page 34
Figure 14: Name and Time configuration 7.2.4.1 GENERAL Figure 15: configuring a calendar, General • Enable: allows you to enable or disable the calendar. If the calendar is enabled (ready for activation by dates/times), it will be enabled in all presets. •...
Page 35
7.2.4.2 SOURCE In the SOURCE tab, the parameters for the triggering time/date and event replay conditions are configured. Figure 16: configuring a calendar, Source 7.2.4.3 DATE AND TIME INTERVAL Defines the date and time when the event starts and the date and time when the event ends, if there is a specific end date and time.
Page 36
7.2.4.3.1 WEEKLY REPETITION Weekly mask, or days of the week on which the calendar event will be repeated, at the time indicated in "Start Time". For example, if you select Monday to Friday (weekdays), the configured event will not be triggered on Saturdays and Sundays (weekends).
Page 37
7.2.4.4 TARGET An action that is executed each time the calendar event is triggered. Figure 20: calendar event example, Target This action may be: 1. Internal: internal stimulus (does not perform an action directly, but allows actions to be triggered via scripts) 2.
Page 38
U S B Figure 21 Please Note : PLAYER ZERO does not have an LCD screen. 7.2.4.6 PRACTICAL EXAMPLE OF CONFIGURATION OF CALENDAR EVENTS An establishment whose business hours are 10:00 a.m. to 8:00 p.m., and which is open from Monday to Friday, requires background music, and will periodically make announcements to its customers.
Page 39
7.2.4.6.1 CALENDARS FOR BACKGROUND MUSIC 2 calendar events will be created: one to load the stream and play it, and another to stop The calendar is enabled, and it is given an identifying name. Figure 22 Since no start date is specified, "Start date" is left as the default value ("dd/mm/yyyy"). This means that the event is active from the day the changes are applied.
Page 40
The action of loading and playing the specified stream is configured. Figure 24 The calendar event that will stop the playback of the background music is configured in the same way as the last one. The only difference is that this time the action in question is to stop the playback;...
Page 42
7.2.4.6.2 CALENDAR FOR CLOSING ANNOUNCEMENTS Every day, the closing time of the establishment will be indicated (pre-recorded message) 15 minutes before closing. It will be recalled again 5 minutes before closing. Figure 28 The message should be played twice a day: 15 minutes before closing (at 7:45 p.m.) and 5 minutes before closing (at 7:55 p.m.).
Page 43
Finally, the message located on the SD card ("mmc://...") will be announced with priority. Figure 30 1.1.1.1 CALENDAR FOR CHRISTMAS CAMPAIGN Figure 31 As this is for a specific calendar interval (15/12/21 to 15/01/22), an end date is set by choosing CUSTOM END DATE and setting the End date and End time parameters correctly.
Page 44
Regarding repetitions, the message has to be played every 30 minutes, and it is known that the establishment closes at 8:00 p.m. As there will be no audio at 8:00 p.m., we will set the number of repetitions in such a way that the last time the event is triggered is 30 min before closing.
(during the day), as it is stored on local media, and does not carry the same risks as receiving real-time streaming. Figure 34: syncing folders with Store and Forward (rsync) PLAYER ONE/PLAYER ZERO enables syncing through Store and Forward (rsync).
7.2.6 STORE AND FORWARD (RSYNC) The Store & Forward module allows you to sync the content of the USB/uSD device with a folder that is hosted on a remote server on a daily basis. It also allows for automatic playback of this content, in combination with the Load preset1 reboot mode. rsync (Remote Sync) This service uses the sync tool.
Page 47
7.2.6.1 GENERAL Figure 45: S&F, General • Enabled: This enables/disables the running of the daily sync. • Time: time at which the daily sync is run.
Page 48
7.2.6.2 REMOTE SOURCE Figure 46: S&F, Remote source • Host: host or IP address of the server. Port: server port, by default, 22 • • Folder: directory within the server where the audio content that is to be synced is stored.
Page 49
7.2.6.3 LOCAL TARGET Figure 47: S&F, Local target • Path: defined by the Playlist Path field for PRESET01. This can be changed in the preset settings. 7.2.6.4 LOG Figure 48: S&F, Log • This displays information and activity in relation to the rsync syncing process. It is useful for debugging possible server or device configuration problems.
Figure 49: Script example scripts PLAYER ONE/ PLAYER ZERO has 20 available, each of which is completely configurable. The default names are: S01, S02…S20. When you click on the name, it will take you to the configuration for that script.
Page 51
▪ ON USB: when a USB device is connected or disconnected, and recognized correctly by the device. ▪ ON PORTAL: when syncing with the Ecler Gallery is successfully completed (with sync result "OK"). ▪ ON ERROR: when the error indicated in "Error code" with a code occurs. A table of error codes can be found in the PLAYER ONE PLAYER/ZERO programming library (programmer's appendix).
Page 52
The following chapters show a number of examples of simple . Keep in mind that this PLAYER ONE/PLAYER ZERO programming and customization tool is very script powerful, as the same can execute several tasks which can be linked together, depending on various circumstances, and thus implement an entire logic and intelligence in the way it works.
Page 53
Write messages on the LCD screen The following is an example of how to write a message on the LCD. This message has been configured so that, when the player starts up, the message "Hello Ecler" is displayed on the screen for 10 seconds.
Page 54
7.2.7.2 EXAMPLE SCRIPT02: Automatically play uSD cards when inserted There are applications in which the local storage medium will change depending on the user. For example, an activity room in a gym where, for each session, different instructors will change the music. In other words, they will connect their USB device or uSD card to play their content.
Page 55
7.2.7.3 EXAMPLE SCRIPT03: Messages can be configured for practical uses. The following script displays a "NO INTERNET" message that flashes when the Internet (WAN) connection is lost. It has also been written in such a way that we can use the "blink" function multiple times within the same script.
Page 56
7.2.7.4 EXAMPLE SCRIPT04: Play an Internet radio station when the Internet connection is restored The following script loads a preset when an available Internet connection (WAN) is detected. It can be good to use this in combination with the silence detection event: The device is playing an Internet radio station, however, due to a network problem, it no longer has access to the radio.
7.3 NETWORK Allows you to configure the Ethernet and WiFi network interfaces. Figure 57: Network, Interfaces • Interfaces: allows parameters to be edited for the wired connection, RJ-45 Ethernet port (LAN/WAN). • Wireless: allows parameters to be set for the wireless connection, WiFi interface. Please Note : for detailed information on all network parameters, click on this link.
7.3.1 CONNECTION VIA RJ-45 CABLE By default, PLAYER ONE/PLAYER ZERO has automatic network addressing (DHCP). To change to manual addressing (editing network parameters), access the web application and go to the Network/Interfaces menu. Figure 58 Network information: checking network parameters and network information •...
Page 59
Figure 60: editing network parameters Select Static address mode and press the SWITCH PROTOCOL button to edit the network addressing manually. Figure 61...
Page 60
Configure the network parameters according to your infrastructure: Figure 62 • IPv4 address: device network address • IPv4 netmask: subnet mask • IPv4: gateway (switch/router with Internet access) DNS1: Domain Name System 1 (optional) • • DNS2: Domain Name System 2 (optional) Save the changes on the Edit page, and apply them on the Network/Interfaces page.
7.3.2 POINT-TO-POINT WIRELESS CONNECTION PLAYER ONE/PLAYER ZERO can establish a point-to-point wireless connection with a WiFi interfaced device (PC, smartphone, tablet, etc.), either for accessing the web application or for streaming via AirPlay/DLNA. Make sure that the wireless connection is enabled and the device is set to MASTER (Access Point) mode.
Page 62
If you have more than one Ecler player in the same system, or you simply want to customize the parameters with which the network is displayed, we recommend changing the SSID and password of the WiFi network of your device(s). To do this, click on the EDIT button and adjust the WiFi network parameters according to your needs.
7.3.3 CONNECTING TO A WIFI NETWORK PLAYER ONE/PLAYER ZERO can connect to the Internet via a home WiFi network to access network addresses, such as Internet radios or remote file syncing services. On the WiFi interface configuration page, click SCAN.
Page 64
Enter the password of the WiFi network you want to connect to and press the SUBMIT button. Figure 69 The WiFi network settings are shown below. Press the SAVE button if you do not need to make any additional changes. Please Note : the operating mode has changed to Client.
A wireless connection to your WiFi network will be established. Figure 71 7.4 SYSTEM In the Settings menu you can make changes as an administrator, such as changing the device name, or the password for accessing the web application, or local media encryption, resetting the device to factory settings, saving backups, updating firmware, etc.
Page 66
Please Note : PLAYER ONE/PLAYER ZERO has an internal clock that means that you won’t lose the time setting if it is not connected to the mains or not synced with an NTP service. However, please note that this clock has an accuracy of ±1 minute/month.
On this page, changes can be made to prevent unauthorized personnel from tampering with the player. 7.4.2.1 WEB PASSWORD Password for accessing the web application. By default, ecler. Please Note : the user is always root. This cannot be changed.
Page 68
7.4.2.2 FRONT PANEL FUNCTIONS Setting the front panel button lock to prevent unauthorised tampering or changing of administrator settings. Only available on PLAYER ONE. Figure 75 • LOCK mode: selection of the lock mode o UNLOCK ALL: unlocks all buttons on the front panel. o UNLOCK USER: locks access to the device configuration menu (administrator functions),...
Page 69
7.4.2.3 REPLAYER 4-digit PIN for accessing the device via the RePLAYER control application. Click on this link to find all the information and documentation related to the control application. Figure 76...
Figure 36: Backup • Backup type: type of backup. o ADMIN SETTINGS: saves all settings (both administrator and user settings). o USER SETTINGS: only saves the user settings. GALLERY SETTINGS: saves the settings that are compatible with the Ecler Gallery platform.
Page 71
ADMIN SETTINGS USER SETTINGS GALLERY SETTINGS Player ✓ ✓ ✓ Presets ✓ ✓ ✓ Calendars ✓ ✓ Events ✓ ✓ ✓ Scripts ✓ ✓ ✓ Store and Forward ✓ ✓ Front panel lock settings ✓ Network settings ✓...
7.4.3.3 FIRMWARE UPDATE Figure 80: Firmware • Keep Settings: keeps the device's current settings. If you want to return to factory settings after updating the firmware, deselect this box. It is selected by default. • Flash Firmware: updates via a firmware file hosted on your computer, tablet, server, etc.
Page 73
It operates as follows: 1. The device encrypts the media, formatting the external drive. This process deletes all content from the memory of the uSD or USB device. 2. This process may take several minutes. "FORMATTING..." is displayed on the LCD screen for the duration of the process (PLAYER ONE only).
Page 74
Figure 82: USB/MMC Settings • Encryption enabled: enables/disables media encryption, USB or uSD. If you save this setting, the device will encrypt the disk the next time the drive is mounted, either when the media is inserted or when the device is rebooted. •...
7.4.5 REGISTER The register allows you to keep a detailed record of the device’s activity. This information can be useful for troubleshooting, monitoring device activity, checking for correct programming, etc. The lines in the register contain information about actions performed by the device, errors and/or announcements, along with time information (when different events occur).
7.4.6 REBOOT Allows you to reboot the device from the web application. Click the PERFORM REBOOT button to force the player to reboot. Figure 84: Reboot...
7.5 SSH SERVER CONFIGURATION FOR STORE & FORWARD (RSYNC) The Cloud Disk Sync module, Store and Forward, on the PLAYER ONE/PLAYER ZERO allows the device to download remote audio content to local storage media (USB/uSD). When active, it daily checks a remote location that hosts audio content, compares this...
7.5.1 CONTENT GROUPS A content group is a group if devices that synchronize the same audio content using the Store and Forward utility. It is necessary to create a different user for each content group. Thus, a device assigned to a content group can access only to the content assigned to that group, and not to other content.
It is recommended to create a user per content group for professional applications in which the same SSH server hosts content for different companies. However, if the final user is generating its own content, a single user would be enough. Figura 87: single user 7.5.2 INSTALLING SSH ON LINUX...
7.5.3 CREATING USERS ON LINUX There will be created as many users as content groups have to be managed. To add a new user, type: sudo adduser <new_user_name> Where <new_user_name> stands for the name you want to give to the content group, for example: sudo adduser hotels Figura 88...
7.5.4 GENERATING SSH KEYS Before generating the SSH keys, it is necessary to go first to the home folder of the new user. To do this: Then use the following command to generate the keys and press enter to each question showed up: ssh-keygen -m PEM Figura 90...
Figura 92 Copy the new directory created It is the folder where audio contents are /home/hotels/hotels. storage in the host and need to be copied into PLAYER ONE/PLAYER ZERO S&F’s configuration page.
7.5.6 CONFIGURIND THE REMOTE SOURCE IN THE PLAYER Finally, it can be configured the remote source (SSH server) in the S&F application. • Host: is the IP of the SSH server. To check it you can type on the Terminal: ifconfig Figura 93 •...
Page 84
THIRD-PARTY CONTROL PROTOCOL PLAYER ONE- JSON Commands USER MANUAL...
8. TP-CONTROL PLAYER JSON Commands PRODUCT OVERVIEW JSON (JavaScript Object Notation) is a lightweight data-interchange format that allows PLAYER ONE to communicate with third-party devices and platforms, such as EclerNet Manager. JSON is a text format that is completely language independent but uses conventions that are familiar to programmers of the C-family of languages.
Page 86
Repeat all {"jsonrpc":"2.0","method":"Player.Repeat","Repeat":2} Repeat one {"jsonrpc":"2.0","method":"Player.Repeat","Repeat":3} GET SHORT PLAYER INFORMATION {"jsonrpc":"2.0","method":"Player.GetStats"} {"title":"Brian Hyland - Sealed With a Kiss","counter":"19:30","txtSource":"NET","status":1} GET FULL PLAYER INFORMATION {"jsonrpc":"2.0","method":"Player.GetStatsEx"} {"title":"Elvis Presley - Judy","counter":"07:02","txtSource":"NET","status":1,"SourceList": ["","MMC","USB UNAVAILABLE","DLNA","AIRPLAY","JVL PLAYLIST","MUSICUP"],"source":6,"preset":1,"volume":100,"txtVolume":"0dB", "stereo":1,"repeat": 2,"playmode":0,"fade":1,"bootpreset1":0,"sp":1,"bitrate":"128","duration": "--:--","freq":"44.1","playlist_index":" 0006 / 0056"} PLAYER ADD NEXT PLAYLIST ITEM With this function user can manage device playlist simply inserting next item before the end of current item.
Page 87
PLAYER NEXT {"jsonrpc":"2.0","method":"Player.Next"} PLAYER PREVIOUS {"jsonrpc":"2.0","method":"Player.Prev"} INCREMENT VOLUME Increment volume just one dB {"jsonrpc":"2.0","method":"Player.Volume","Action":"inc"} DECREMENT VOLUME Decrement volume just one dB {"jsonrpc":"2.0","method":"Player.Volume","Action":"dec"} SET VOLUME Param volume is expressed in %. To set volume to 50% use next command. {"jsonrpc":"2.0","method":"Player.Volume","Volume":50} • OPEN PLAYLIST URL Url param must be any valid device url.
Restore device factory default settings. All your settings will be lost. {"jsonrpc":"2.0","method":"Settings.Reset"} RESTORE DEVICE SETTINGS FROM URL Restore device settings to values in url file. {"jsonrpc":"2.0","method":"Settings.Restore","url":"http://ecler.com/my_pl ayer_config.config"} BACKUP CURRENT DEVICE CONFIGURATION Backup device settings to url. Available configurations: user, admin or gallery.
8.3 PRESET COMMANDS Preset variables for GFG.get and CFG.set. Please check Player LUA manual. Preset variables. RELOAD PRESET Reload indicated preset index. Index should be a valid preset index 1..20. Must be called after modifiying preset variables and call commit command {"jsonrpc":"2.0","method":"Preset.Reload","Index":1} 8.4 EVENT COMMANDS Event variables for GFG.get and CFG.set.
DEVICE COMMANDS DEVICE REBOOT {"jsonrpc":"2.0","method":"Device.Reboot"} GET DEVICE VERSION {"jsonrpc":"2.0","method":"Device.GetVersion"} {"version":"3.04r0"} DEVICE UPDATE FIRMWARE With this function user could update device firmware to an specific version. User must provide firmware url. Device setting will be saved. {"jsonrpc":"2.0","method":"Device.Update","url":"https://www.ecler.com/new_f irmware.bin"}...
9. PLAYER LUA SDK Introduction PLAYER is a Lua extension library that acts as interface between LUA and PLAYER firmware using the well-known PLAYER JSON protocol. Basically is composed by different kind of objects: • PLAYER – access player functions. •...
PLAYER LUA SDK V1.02 9.1.1 CHANGELIST • v1.02 – xxxx/xx/xx ✔ Added DEV_reboot function ✔ Added CFG_backup2 function with type parameter: user, admin and gallery ✔ Bug fix CFG_backup was calling to Device.Backup instead Settings.Backup ✔ Typo, Calendar general_enabled changed to bEnabled ✔...
9.2.1 CONVENTIONS • n indicates number • b indicates Boolean • txt indicates text 9.2.2 PLAYER FUNCTIONS Access player functions like repeat, fade, etc. Functions Function: PLAYER_stereo(bStereo) Description: Set the player output mode to stereo or mono Parameters: bStereo – boolean, set to true for stereo output, otherwise mono output is selected Function: PLAYER_fade(nFade) Description:...
Page 95
ep=PLAYER.new() json_text=ep.PLAYER_getStats() print(json_text) cjson=require "cjson" value=cjson.decode(json_text) print(“SourceList[3]=” .. value.SourceList[3]) output {"title":"The White Stripes - Seven Nation Army","counter":"52:52","txtSource":"NET","status":1,"SourceList": ["","MMC","USB","DLNA","AIRPLAY","rock alternativo"],"source":5,"preset":1,"volume":100,"txtVolume":"0dB","stereo":1,"repeat":2,"playmode":0," fade":1," bootpreset1":0,"sp":1,"bitrate":"192","duration":"--:--","freq":"44.1","playlist_index":" 0001 / 0001","playlist_url":"mmc://radiobob-alternativerock-mp3-hq? sABC=5n6s2sr8%230%23no8617362n29q2o435p17n54928n16s5%23gharva&amsparams=playerid:tune in;skey:15 17236200","priority":""} SourceList[3]=USB Function: PLAYER_queue(urlNextElem) Description: Add next playlist item. Using this function you can compose your own playlist. In order to do a continous play it is necessary to queue next item prior to the end of the current one.
Page 96
Description: Use this function to move back to the previous item. It retains the play state. Function: PLAYER_incvol = function() Description: Use this function to increase the player volume 3dB. Function: PLAYER_decvol = function() Description: Use this function to decrease the player volume 3dB. Function: PLAYER_setvol = function(perc) Description:...
9.2.3 CONFIG. (CFG) FUNCTIONS Set and get PLAYER parameters: PRESET, SAF, CAL, EVENT, SCRIPT and LOG. Please refer to the corresponding section to check how to set/get each parameter. Functions Function: CFG_reset() Description: Restore PLAYER configuration to its initial state (factory defaults). Please note that using this function you will lost all your changes.
Function: CFG_set = function(interface, section, variable, value) Description: Set the value of the selected variable “interface.section.variable” to “value” Arguments: interface – must be a valid interface: preset, saf, calendar(01..24), event (gpi1,gpi2, silence), gdrive, script and log. section – variable's section. Most of the cases is “settings” variable –...
Page 99
9.2.4.1 PRESET VARIABLES presetNN.settings.bname Preset name presetNN.settings.eventList List of enabled events separated by % (GPI1%GPI2%SILENCE) presetNN.settings.bPlaylist 1 to overwrite playlist presetNN.settings.loadPlaylist url of the playlist. Must be enabled using presetNN.settings.bPlaylist presetNN.settings.mediaAlias Alias of the enabled playlist. It appears as source presetNN.settings.bStatus 1 to overwrite status presetNN.settings.status...
9.2.5 EVENT FUNCTIONS Event functions lets PLAYER execute automated functions. There are 3 possibilities GPI1, GPI2 and SILENCE settings. Functions Function: EVENT_reload(txtEvent) Description: Reload event configuration. Call it after modify the preset configuration using CFG_set and CFG_commit Arguments: txtEvent – String indicating the event to reload (GPI1, GPI2 or SILENCE) 9.2.6 EVENT VARIABLES When programmaing GPI1 or GPI2 these variables are available...
9.2.7 CALENDAR (CAL) FUNCTIONS Calendar functions lets PLAYER execute automated functions on a date/time. There are 24 different calendar events available. Functions Function: CAL_reload(nIndex) Description: Reload calendar configuration. Call it after modify the calendar configuration using CFG_set and CFG_commit Arguments: nIndex –...
9.2.8 STORE AND FORWARD (SAF) FUNCTIONS Store and Forward module let PLAYER download remote media content from a rsync/ssh server to local storage devices (same as PRESET1), daily, and recall PRESET1 to automatically play it. Functions Function: SAF_reload() Description: Reload Store and Forward configuration. Call it after modify the Store and Forward configuration using CFG_set and CFG_commit 9.2.8.1 STORE AND FORWARD VARIABLES Set to 1 to enable daily Store and Forware synchronization...
9.2.10 DEVICE (DEV) FUNCTIONS Device functions allows the user to setup firmware and general PLAYER configurations. Functions Function: DEV_reboot() Description: Reboot the PLAYER inmediatly. Function: txtVersion = DEV_version() Description: Get the PLAYER firmware version Return: txtVersion – string containing PLAYER firmware version formatted Function: DEV_update(urlFirmware) Description:...
Description: Get local storage encrypted flag Arguments: devUrl – string must be mmc:// or usb:// Return: bEncrypt – boolean, true, if local storage is encrypted Function: bEncrypt = DEV_isEncrypted(devUrl) Description: Get local storage encrypted flag Arguments: devUrl – string must be mmc:// or usb:// Return: bEncrypt –...
Function: lockMode, password = PANEL_get() Description: Set the panel lock mode and password Return: lockMode – string representing lock mode. Possible values are UNLOCK ALL, UNLOCK USER, LOCK ALL password – string with the LOCK/UNLOCK password 9.2.12 FINDER FUNCTIONS Finder functions allows the user to run finder operation on PLAYER. Functions Function: FINDER_set(bLigth)
Page 106
NEEC AUDIO BARCELONA S.L. reserves the right to make changes or improvements in the design or manufacturing that may affect these product specifications. For technical queries contact your supplier, distributor or complete the contact form on our website, Support / Technical requests. Motors, 166‐168 -08038 Barcelona ‐ Spain‐(+34) 932238403 information@ecler.com www.ecler.com...