hit counter script
Ecler PLAYER ZERO User Manual
Ecler PLAYER ZERO User Manual

Ecler PLAYER ZERO User Manual

Local and streaming audio player
Hide thumbs Also See for PLAYER ZERO:
Table of Contents

Advertisement

Quick Links

PLAYER ZERO
AUDIO PLAYER
Local and Streaming Audio Player
SW
USER MANUAL
50-0419-0104
PLAYER ZERO
EN

Advertisement

Table of Contents
loading

Summary of Contents for Ecler PLAYER ZERO

  • Page 1 PLAYER ZERO AUDIO PLAYER Local and Streaming Audio Player USER MANUAL 50-0419-0104 PLAYER ZERO...
  • Page 2: Table Of Contents

    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 &...
  • Page 4 9.2.9 Register (LOG) Functions ...................102 9.2.10 Device (DEV) Functions ....................103 9.2.11 Panel Functions ......................104 9.2.12 Finder Functions ......................105 9.2.13 LCD Functions ........................105...
  • Page 5: Precautions

    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.
  • Page 6: Important Safety Instructions

    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.
  • Page 7: Features

    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.
  • Page 8: Install & Connect

    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).
  • Page 9: Audio Output Connections

    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 &...
  • Page 10: Gpi Remote Control Ports

    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 •...
  • Page 11: Start-Up And Operation

    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.
  • Page 12: Panel Functions

    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.
  • Page 13: Technical Data

    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...
  • Page 16: Mechanical Diagram

    6.2 MECHANICAL DIAGRAM...
  • Page 17 PLAYER ONE / PLAYER ZERO – Web GUI (v1.00r0) AUDIO PLAYERS Streaming and local media audio player USER MANUAL...
  • Page 18: Web Gui (V1.00R0)

    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/"...
  • Page 21: Quick Guide For Ethernet Connection

    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.
  • Page 22: Device

    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.
  • Page 25: Presets

    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...
  • Page 29: Events

    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...
  • Page 33: Calendar

    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 41 Figure 26 Figure 27...
  • 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.
  • Page 45: Cloud Disk Sync

    (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).
  • Page 46: 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.
  • Page 50: Scripts / Lua

    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.
  • Page 57: Network

    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.
  • Page 58: Connection Via Rj-45 Cable

    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.
  • Page 61: Point-To-Point Wireless Connection

    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.
  • Page 63: Connecting To A Wifi Network

    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.
  • Page 65: System

    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.
  • Page 67: Security

    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...
  • Page 70: Backup, Restore And Firmware

    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 ✓...
  • Page 72: Usb/Mmc 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. •...
  • Page 75: Register

    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).
  • Page 76: Reboot

    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...
  • Page 77: Ssh Server Configuration For Store & Forward (Rsync)

    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...
  • Page 78: Content Groups

    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.
  • Page 79: Installing Ssh On Linux

    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...
  • Page 80: Creating Users 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...
  • Page 81: Generating Ssh Keys

    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...
  • Page 82: Adding Audio Content To The Ssh Server

    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.
  • Page 83: Configurind The Remote Source In The Player

    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...
  • Page 85: Tp-Control Player Json Commands Product Overview

    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.
  • Page 88: Configurations Commands

    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.
  • Page 89: Preset Commands

    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.
  • Page 90: Script Commands

    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"}...
  • Page 91: Panel Commands

    DEVICE BOOT CONFIG COMMAND Available BootPreset1 options are: 1 – PRESET1, 2 – keep status {"jsonrpc":"2.0","method":"Device.BootPreset1","BootPreset1":2} DEVICE GET MAC {"jsonrpc":"2.0","method":"Device.GetMac"} {"mac":"32 41 41 20 40 42"} DEVICE GET GALLERY REGISTRATION KEY {"jsonrpc":"2.0","method":"Device.GetRegkey"} {"regkey":"2E1BB146B2DB2WA1"} 8.10 PANEL COMMANDS PANEL SET LOCK SETTINGS Set panel Lock to “UNLOCK ALL”...
  • Page 92: Player Lua Sdk Introduction

    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. •...
  • Page 93: Player Lua Sdk V1.02

    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 ✔...
  • Page 94: Conventions

    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:...
  • Page 97: Config. (Cfg) Functions

    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.
  • Page 98: Preset Functions

    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...
  • Page 100: Event Functions

    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...
  • Page 101: Calendar (Cal) Functions

    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 –...
  • Page 102: Store And Forward (Saf) Functions

    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...
  • Page 103: Device (Dev) Functions

    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:...
  • Page 104: Panel Functions

    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 –...
  • Page 105: Finder Functions

    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...

Table of Contents