Opticon ESL Server Manual

Opticon ESL Server Manual

Electronic shelf label
Hide thumbs Also See for ESL Server:
Table of Contents

Advertisement

Electronic Shelf Label
ESL Server manual
User Manual
The ESL server manual describes how to
v1.0.62.2
demonstrate and set up the Opticon ESL solution.

Advertisement

Table of Contents
loading

Summary of Contents for Opticon ESL Server

  • Page 1 Electronic Shelf Label ESL Server manual User Manual The ESL server manual describes how to v1.0.62.2 demonstrate and set up the Opticon ESL solution.
  • Page 2: Document History

    PRODUCT. Serial Number A serial number appears on all Opticon products. This official registration number is directly related to the device that is purchased. Do not remove the serial number from your Opticon device. Removing the serial number voids the warranty.
  • Page 3: Table Of Contents

    3.2. Installing and finding the EBS3x / EBS40 base stations ........... 15 3.3. Installing and activating the ESLs ..................16 3.4. Mounting ESLs ........................17 4. Linking of ESLs to products ....................18 4.1. Linking in the ESL server application ................19...
  • Page 4 Opticon ESL ESL Server manual v1.0.62.2 4.2. Linking using an Opticon batch terminal ................20 4.3. Linking using the provided web application ............... 20 5. Configuring the base stations ....................21 5.1. Configuring the RF channel ....................21 5.2. Changing the local name ....................22 5.3.
  • Page 5 Appendix F: SQLite demo configuration ..................89 Appendix G: DB2 demo configuration ..................91 Appendix H: Restoring the ESL server back to default (CSV) ........... 93 Appendix I: Using the SQL API ..................... 94 Appendix J: Version history ......................99...
  • Page 6: Features And Specifications

     6.0V 2A Power supply (European)  PC Installation Software (ESL server and web application)  Opticon ESL Server User Manual The demo kit does NOT include a barcode terminal or scanner, which can be used to link ESLs to products using barcodes.
  • Page 7: Environmental Specifications

    Opticon ESL ESL Server manual v1.0.62.2 1.4. Environmental Specifications Operating Temperature and Humidity (EE201) 1.4.1. Temperature: 5 to 50° C Humidity: 20-85% Storage Temperature and Humidity (EE201) 1.4.2. Temperature: -20 to 60° C Humidity: 20-85% 1.5. Interface Specifications The radio interface of both the base stations and ESLs have the following specifications: ...
  • Page 8: Main Batteries

    Opticon ESL ESL Server manual v1.0.62.2 Main Batteries 1.6.2. The main batteries in the EE20x are 2 CR2450 Li-Mn batteries:  Nominal capacity: 2x600 mAh  Nominal voltage: 3V  Low voltage: Less than 2.8 V  Operating time: >7 years (default settings; 4 refreshes/day; 15-25° C)
  • Page 9: Hardware Specifications

    Opticon ESL ESL Server manual v1.0.62.2 1.7. Hardware Specifications Items Specifications Remarks Stellaris LM3S9B96 (EBS-30) Cortext-M4F TM4C129 (EBS-40) Type CC2530-F128 (EE200) CC2533-F96 (EE201) 256 KB (EBS-30) / 512 KB (EBS-40) Internal ROM 128 KB (EE200) 96 KB (EE201) 96KB (EBS-30) / 256KB (EBS-40)
  • Page 10: Serial Number

    Opticon ESL ESL Server manual v1.0.62.2 1.8. Serial Number EBS-30 / EBS-31 / EBS-40 1.8.1. The serial number can be found on the back of the base station. The base stations also have a unique MAC-address which is used for both Ethernet and radio communication.
  • Page 11: Solution Overview

    SQL if desired.  SQL API. The ESL server supports a full SQL API, which can be used to create your own (web) application by executing SQL queries to (remotely) control and monitor the ESL...
  • Page 12: Csv-File Based Solution

    2.1. CSV-file based solution The CSV-file based solution operates by running the provided ESL server application that:  Monitors an input folder in which CSV-product databases are being placed by a back office system and processes them (optionally with pre-processing by a middleware application).
  • Page 13: Sql Solution

    The SQL-based solution provides the possibility to monitor and control multiple stores using one central or multiple local SQL databases in combination with the provided web application. The local ESL server application(s) will:  Monitor a local or central SQL database using staging tables and processes them.
  • Page 14: Csv / Sql Hybrid Solution

    When using external content management solution the back office or content management system handles the generation of the images and the linking of products to ESLs. The ESL server application basically only monitors an input folder for new images and distributes them to the corresponding base stations / ESLs.
  • Page 15: Setting Up The Hardware And Software

    To be able to quickly link ESLs to products using barcodes, you can use the following options:  USB-HID barcode scanner (connected to the ESL server or by using the local web application)  OPH1004, H13, OPN2006 or OPH300x barcode terminal (incl. communication cradle/cable) ...
  • Page 16: Installing And Activating The Esls

    Opticon ESL ESL Server manual v1.0.62.2 After starting the application for the first time, no base station will be available to communicate with ESLs. Press the ‘Find’ button on the ‘Base stations-tab to find the connected base station. Select the discovered base station to add and connect your PC to the base station.* If activated ESLs are nearby, then the ESL count will start incrementing as they start connecting to the base station.
  • Page 17: Mounting Esls

    ‘DEACTIVATED’ message has disappeared from the screen. Active ESL’s will be periodically seek for an Opticon base station, so as soon as an Opticon base station is within range, they will associate with it and start sending data requests and status information to it.
  • Page 18: Linking Of Esls To Products

    This makes it ideal for demonstration purposes and small installations.  Disadvantage: The ESL server usually isn’t located right next to the products and ESLs in a store, which makes scanning both the ESLs and products and time consuming process 2.
  • Page 19: Linking In The Esl Server Application

    4.1. Linking in the ESL server application Linking in the ESL server application can be done manually and by using any USB-HID barcode scanner. Hint: Using a USB-HID barcode scanner is quick and avoids human error. To (un)link an ESL, either select the ESLs-tab of the ESL-server and double click on an ESL that needs to be (un)linked and then type, scan or find a product in the product database and then press apply.
  • Page 20: Linking Using An Opticon Batch Terminal

    Linking using the provided web application Using Opticon’s H21, H22, H32 or any other Wifi terminal it is possible to link ESLs to products and monitor the ESL system using a WiFi connection. This is done by installing a local web-server that runs the provided web page to perform the linking.
  • Page 21: Configuring The Base Stations

    Opticon ESL ESL Server manual v1.0.62.2 5. Configuring the base stations Base stations have very few configurations besides the configuration of the Ethernet settings (which will be described in chapter 5.4). The only vital configuration is the RF channel on which the base station operates.
  • Page 22: Changing The Local Name

    Opticon ESL ESL Server manual v1.0.62.2 find the base station. If you do wish to use any of the other channels, then it’s necessary to first configure a different RF channel selection into the ESLs before configuring the base stations.
  • Page 23: Configuring The Ethernet Settings

    The LAN-ID makes it possible to run two or more parallel ESL networks next to each other. By default the LAN-ID is 0000, which means any Opticon ESL will connect to this base station. To run two ESL networks in parallel, change the LAN-ID of both networks to non-zero.
  • Page 24: Factory Default

    IP-address: 169.254.19.63 using the configuration webpage.  Do not use a WiFi connection to connect your ESL server to the EBS-3x/4x’s to unsure a reliable connection.  The default password of the configuration page is ‘admin’.
  • Page 25: Base Station Firmware Update

    5.6. Base station firmware update The latest firmware is always included in the latest ESL server application, which can be downloaded from our FTP: ftp://ftp.opticon.com/pub/ESL/ You can upgrade the firmware by selecting the base station in the base station-tab of the ESL server application and pressing the firmware update button on the bottom right.
  • Page 26: Configuration And Monitoring Of Esls

    Opticon ESL ESL Server manual v1.0.62.2 6. Configuration and monitoring of ESLs 6.1. Configuration of ESLs There are a number of configurations that can be made in the ESLs to control, customize them and to regulate power consumption. To edit configurations of an ESL, go to the ‘ESL’-tab base station tab and select the ESLs that you which to configure.
  • Page 27: Associate Interval

    Opticon ESL ESL Server manual v1.0.62.2  Scan channels  Temperature range Associate interval 6.1.1. When an ESL is not connected to any base station it will automatically start looking for nearby base stations. Since searching for base station consumes a relative large amount of power it will not continuously search, but only once every couple of seconds.
  • Page 28: Poll - Info Ratio

    Opticon ESL ESL Server manual v1.0.62.2 Poll - Info Ratio 6.1.5. The poll info ratio determines how often ESLs will automatically send their current status and settings to the base stations. By default the ESLs will transmit this information once every 40 polls, so a ratio of 1:39.
  • Page 29: Monitoring Of Esls

    Opticon ESL ESL Server manual v1.0.62.2 6.2. Monitoring of ESLs All available information of an ESL can be displayed in the ESL-tab. Each column can be enabled or disabled by right-clicking of the column-header and (un)selecting items of the list below.
  • Page 30: Filtering Esls

    Opticon ESL ESL Server manual v1.0.62.2 6.3. Filtering ESLs Using the newly added filter options in the ESL-tab it’s possible to sort and filter on almost any ESL property. 6.4. Controlling ESLs ESLs can be further controlled by using the ‘Actions’ of the ESL-tab. To use these features, select one of more ESLs and then select the action that you wish to execute.
  • Page 31: Actions

    Load balancing 6.4.2. ESL server 1.45 and higher has to possibility to automatically and manually re-balance the ESLs over all available base stations. Enabling this option on a daily basis improved the average link quality of the ESLs, because all ESLs with poor link quality will check if there’s a better base station available.
  • Page 32: Firmware Update

    Comma separated files. It’s easy to setup and it’s suitable for smaller projects and demos with a limited number of ESLs. Disadvantage is that the ESL server is difficult to control and monitor by an external server due to the limited feedback on the status of the ESL system. Also CSV-based systems tend to become slow when used with large numbers (thousands) of ESLs.
  • Page 33: Csv Data Base Configuration

    CSV (to provide the product databases and ESL-product links) and SQL (to log all ESL and Base station status information). This makes it easy to link the back-office to the ESL server using CSV-files and all status information will be available for remote monitoring. See chapter 7.1.
  • Page 34: Changing The Database Format And Settings

    Input Folder Directory in which the back office uploads the new product data files (see chapter 9.1. The database files must have the file extension .csv in order to be detected by the ESL server application. Besides database files, it’s also possible to place ESL-product link files (see chapter 9.2),...
  • Page 35 Opticon ESL ESL Server manual v1.0.62.2 Output Folder It will contain 2 CSV-files:  dbase.csv (combined product database)  linked.csv (ESL-products links) When using a bar code terminal for linking, it can also contain the following file:  scan.csv (truncated article database) Any processed CSV-files from the Input folder will be moved to the sub-folder: ...
  • Page 36: Sql Data Base Configuration

    The ESL server application will generate most SQL tables automatically, except for the product tables, which contain the product database. The ESL Server installation contains example queries to quickly set-up a demo for each database format. The example queries can be found in the following folder of your installation ...
  • Page 37 The demo configuration for DB2 can be found in ‘Appendix G: DB2 demo configuration’ Note: make sure the SQL-account, that is to be used by the ESL server, has sufficient rights to read, write and create these tables. Also makes sure that the used login doesn’t require periodic...
  • Page 38: Tables

    7.2.1.1 Link table Important note: Only the ESL server is allowed to modify this table directly. A link staging table is used for changing the content of this table, which is described in the following chapter. The ESL server requires a link table that contains the links between the products and ESLs.
  • Page 39 [DELETE] VARCHAR(1) Changed links should be inserted in the link staging table and the ESL server will automatically detect and process this data and insert the data into the Link table. If the processed data requires an ESL to be updated, it will automatically generate a new image and sent it to the ESL.
  • Page 40 Opticon ESL ESL Server manual v1.0.62.2  Appendix C: MS-SQL demo configuration  Appendix D: Oracle demo configuration  Appendix E: PostgreSQL demo configuration  Appendix F: SQLite demo configuration  Appendix G: DB2 demo configuration The only mandatory column in the product table is the (product) ID column. If no additional barcode column is used, this column should be a VARCHAR string and marked as the PRIMARY KEY.
  • Page 41 7.2.1.4 Product staging table Changed product information should be inserted in the product staging table and the ESL server will automatically detect and process this data and insert the data into the Product table. If the processed data requires an ESL to be updated, it will automatically generate a new image and sent it to the ESL.
  • Page 42 ESL Server manual v1.0.62.2 7.2.1.5 ESL status and configuration table When using SQL, the ESL server automatically creates a table called ‘labelstatus’. This table is used to store all information about each ESL in the server and has the following table design.
  • Page 43 This field will contain the UTC time of the last received poll for data. <Null> means unknown / never received. (This field is currently not updated on each poll to reduce the amount of SQL queries executed by the ESL server).
  • Page 44 Opticon ESL ESL Server manual v1.0.62.2 LAST_INFO This field will contain the UTC time of the last reported status by the ESL. <Null> means unknown / never received. LAST_IMAGE This field will contain the UTC time of the last successful image update.
  • Page 45 Opticon ESL ESL Server manual v1.0.62.2 2 = Image update queued 3 = Image update queued and next already pending 4 = Image update failed 5 = Image update failed, waiting for retry 6 = Image update failed, busy retrying...
  • Page 46 LANID=0 will associate with this base stations 7.2.1.7 Logging table When using SQL, the ESL server automatically creates a table called ‘esllog. This table is used to store all alerts and events, except user activity. This table has the following table design...
  • Page 47 When using SQL, the ESL server automatically creates a table called ‘user. This table is used to store usernames, encrypted password and access rights. This table is used for user access control by the ESL server and the Web application. Users can only be added, removed or altered in the ESL server application.
  • Page 48: Connection

    Opticon ESL ESL Server manual v1.0.62.2 A product look-up table can be added for easy linking of products to ESLs by scanning the barcode of a product followed by the address barcode on the ESL. This table should only contain the bar codes and related unique product IDs and a short description of the product.
  • Page 49: Tables Configuration

    Opticon ESL ESL Server manual v1.0.62.2 Tables configuration 7.2.3. After a successful connection to the SQL server select the two product tables and two link tables. The other tables will be generated automatically, but can be renamed if desired. Fields configuration 7.2.4.
  • Page 50: Advanced Settings

    The ‘process staging tables’ setting specifies how often staging tables are processed (in seconds) 7.2.6.4 Update status tables interval The ‘update status tables’ setting specifies how often the ESL server updates the status of the ESLs and base stations in the database. 7.2.6.5...
  • Page 51: Apply And Reset

    Opticon ESL ESL Server manual v1.0.62.2 information of all the products that are linked to an ESL. The structure of this table must be identical to the structure of the selected ‘Product Table’. Note: Finding products that are not linked to an ESL and altering products in the Data-tab is not possible when this option is enabled.
  • Page 52: Open Database Connectivity (Odbc) Configuration

    ODBC data source control panel as System DSN and that the required ODBC driver has been installed. Make sure that the 32-bit or 64-bit architecture of the ODBC connection matches that of the ESL server (and, if used, of the HTTP-server of the web application).
  • Page 53 Opticon ESL ESL Server manual v1.0.62.2 ODBC DSN configuration to a MySQL database ODBC DSN configuration to an Oracle database ODBC DSN configuration to a PostgreSQL database...
  • Page 54: Csv / Sql Hybrid Configuration

    CSV-files, but all ESL and Base station status information are logged into an SQL database. This makes it easier to link the back-office to the ESL server using simple CSV-files and all status information is logged into an SQL database for external monitoring and trouble...
  • Page 55 ESLs are linked compared to using CSV only. To make such a configuration, start by configuring the ESL server with a standard CSV configuration as described in chapter 7.1. When done, go to the ‘Settings’-tab and change the ‘database format’ for logging to the desired SQL database format as shown below.
  • Page 56: External Content Management Configuration

    ESLs. The ESL server application monitors an input folder for new images and distributes them to the corresponding base stations / ESLs. The only main database configurations for this set-up in the ESL server are the ‘Input’ and ‘Output’...
  • Page 57 Display resolution (i.e. the EE201 image size is 200 x 96 pixels) <Height> <Ix> Used by the ESL server to keep track which image is currently displayed on the ESL. It should increment from 1 to 255, 1 to 255, etc. 0=reserved for the default image. Not incrementing...
  • Page 58: Manual Editing Of The Product Database

    Manual editing of the product database Using the ‘Data’-tab of the ESL server application it is possible to quickly view and edit the content of the current product database. To do this, select the field that you wish to change and edit the value.
  • Page 59: Designing The Esl Image Layout

    Opticon ESL ESL Server manual v1.0.62.2 8. Designing the ESL image layout Probably the most important step in the customization process of the ESL system is specifying the images that should be displayed on the ESLs. The template editing consists of 2 parts: ...
  • Page 60: Template Selection

    Opticon ESL ESL Server manual v1.0.62.2 8.1. Template Selection Template selection determines which image template is used under which conditions. The template selection area lists all the found templates in the specified ‘Template folder’ and shows if the template is currently enabled and, if so, under which condition it must be used.
  • Page 61: Conditions

    Opticon ESL ESL Server manual v1.0.62.2 Conditions 8.1.1. To make it possible to use different templates under different conditions, a template can be configured as:  ‘Default’- template Used if an ESL is linked to an known product  ‘Not found’-template Used if an ESL is linked to an unknown product ...
  • Page 62 Opticon ESL ESL Server manual v1.0.62.2 Hints and tips:  Only 1 ‘Default’-template can be enabled at a time  Only 1 ‘Not found’-template can be enabled at a time  ‘Conditional’-templates must be listed first, because the first template with a matching condition will be used.
  • Page 63: Using The Template Editor

    Opticon ESL ESL Server manual v1.0.62.2 8.2. Using the Template editor Image templates can be create and edited to design your own label layout. To edit an image layout template, press the button next an existing template or press the - button to create a new template.
  • Page 64 Opticon ESL ESL Server manual v1.0.62.2 Image templates currently support 7 types of objects that can be added to design the ESL layout: Text (fixed and dynamic) Lines Rectangles (filled / non-filled) Ellipses (filled / non-filled) Barcodes Images (monochrome or black/white/red; fixed and dynamic)
  • Page 65: Static And Dynamic Content

    Opticon ESL ESL Server manual v1.0.62.2 Static and dynamic Content 8.2.1. Static content of barcodes, images and text can be added by typing in the content-box: Dynamic content is added by specifying a column from your product database using the dropdown-list of the content-box: It’s also allowed to combine static context and/or multiple dynamic contents.
  • Page 66: Saving And Exporting A Template

    Opticon ESL ESL Server manual v1.0.62.2 8.3. Saving and exporting a template When done editing, press the -button to save the template. To save an existing under a different name, press the -button. To undo all unsaved changes press the...
  • Page 67 Opticon ESL ESL Server manual v1.0.62.2 If you leave these ‘Example data’ fields empty, then the preview of the Image template will show its text ‘as is’ in the previewer. You can either change the ‘Example data’ manually or you can select one product from the product database by pressing the -button.
  • Page 68: Connecting The Back Office Using Csv-Files

    9. Connecting the back office using CSV-files The back office triggers the ESL server application by placing a file, containing either only product modifications or a complete product database, in the ‘Input’ folder (see chapter 7.1). Only one file may reside in this folder to enforce sequential handling. This means that the Back office may only store another file, when the current file has been processed and moved to a different folder.
  • Page 69: Product-Esl Link Database Format

    To create, modify or delete the product-ESL links various methods can be used:  Using an Opticon barcode terminal (see chapter 10)  Using the ‘Data’-tab of the ESL server application (see chapter 7.7).  Using the web application for linking (see chapter 11) ...
  • Page 70 Opticon ESL ESL Server manual v1.0.62.2 The hardware variant is the 3 digit of the software version of an ESL. (For black/white/red ESLs a lowercase character must be used, for example use: ‘t’ for the EE150R) Example: 012;H;3889DC00010DACCD 014;H;3889DC00010DA152 008;H;3889DC00010DD7C5 013;H;3889DC00010DA234...
  • Page 71: Middleware Application (Csv-Files Only)

    Note: By default the use of a middleware application is disabled (‘CSV-parser’ field in the ‘Data’- tab is empty). The ESL server application can use a middleware application to process the CSV-files from the Back office into a combined CSV-file that the ESL server application uses.
  • Page 72: 10. Barcode Terminal Application

    Wifi and a web browser, like the H21, H22 or H32. This is done by installing a local HTTP-server on the ESL server to the web application for linking and monitoring. See chapter 11 for more information.
  • Page 73: Loading The Database Files On The Terminal

    To be able to transfer files between the ESL server application and the barcode terminal the serial port of the PC is used. Make sure you’ve enabled and configured the correct serial port in the ‘Setup’-tab in the server application.
  • Page 74: Oph100X, H13, Oph3000 Or Opl9728

    Opticon ESL ESL Server manual v1.0.62.2 For re-linking and unlinking of ESLs that already show a product, it’s also possible to add the MAC address barcode to your template file, by adding a small bar at the top of the template containing this barcode.
  • Page 75: Opn2002/3/4/5/6

    (linked.csv) back to the PC. After the barcode terminal has sent back the link database, the ESL server application will parse the product database and link database into image files and update the ESLs if necessary.
  • Page 76: 11. Using The Web Application For Linking And Monitoring

    After installation, start the ‘XAMPP Control panel’ and press the ‘Config’ button next to ‘Apache’ and open the ‘httpd.config’ file. Change the document root directory to the ‘/WebApp-Full' folder of your ESL server installation by changing both occurrences of ‘Documentroot’: Example: #<Directory "C:/xampp/htdocs">...
  • Page 77 The Web-application should be automatically configured by the ESL server to match the configuration of the ESL server itself. If this is not the cause, please verify that the Source folder of the Web application is correctly configured in the Data-tab.
  • Page 78: Web Application With Oracle, Postgresql, Sqlite, Ms-Sql And Db2

    To make sure the ESL server will always run on the background and can‘t be closed accidently, the ESL server can also be configured to run as service. To run the ESL server as service, run the ESL server as administrator and go to the ‘Settings-tab and enable the option: ‘Run as Service’.
  • Page 79 The service will be installed after pressing the ‘Install’ button and will start running as soon as the ESL server application is closed or after the PC has been rebooted. After that, the ESL service will automatically be stopped (and restarted afterwards) when the ESL...
  • Page 80: Appendix A: Demo Barcodes

    Opticon ESL ESL Server manual v1.0.62.2 Appendix A: Demo barcodes The quickest way to setup an ESL demonstration with barcode terminal is to simply use the included sample database and example templates. After installation of the software and hardware, the only configuration steps necessary are finding and adding of the base station and configuring the serial port of the barcode terminal.
  • Page 81: Appendix B: My-Sql Demo Configuration

    Opticon ESL ESL Server manual v1.0.62.2 Appendix B: My-SQL demo configuration The ESL Server installation contains example queries to quickly set-up a demo with MySQL. The example query can be found in the following folder of your installation.  ‘/Examples/MySQL’...
  • Page 82 Opticon ESL ESL Server manual v1.0.62.2 If the connection was successful, then press ‘Apply’ to save the settings. To create the product tables, use the Import-button to ‘Import’ the query-file:  ‘/Examples/MySQL/products_mysql.sql’ The product data should now appear in the Data-tab.
  • Page 83: Appendix C: Ms-Sql Demo Configuration

    Opticon ESL ESL Server manual v1.0.62.2 Appendix C: MS-SQL demo configuration The ESL Server installation contains example queries to quickly set-up a demo with MS-SQL. The example query can be found in the following folder of your installation.  ‘/Examples/MS-SQL’...
  • Page 84 Opticon ESL ESL Server manual v1.0.62.2 After making the configuration, use the ‘Test’-button to test the connection details. If the connection was successful, then press ‘Apply’ to save the settings. To create the product tables, use the Import-button to ‘Import’ the query-file: ...
  • Page 85: Appendix D: Oracle Demo Configuration

    Opticon ESL ESL Server manual v1.0.62.2 Appendix D: Oracle demo configuration The ESL Server installation contains example queries to quickly set-up a demo with Oracle. The example query can be found in the following folder of your installation.  ‘/Examples/Oracle’...
  • Page 86 Opticon ESL ESL Server manual v1.0.62.2 If the connection was successful, then press ‘Apply’ to save the settings. To create the product tables, use the Import-button to ‘Import’ the query-file:  ‘/Examples/Oracle/products_oracle.sql’ The product data should now appear in the Data-tab.
  • Page 87: Appendix E: Postgresql Demo Configuration

    Opticon ESL ESL Server manual v1.0.62.2 Appendix E: PostgreSQL demo configuration The ESL Server installation contains example queries to quickly set-up a demo with PostgreSQL. The example query can be found in the following folder of your installation.  ‘/Examples/PostgreSQL’...
  • Page 88 Opticon ESL ESL Server manual v1.0.62.2 If the connection was successful, then press ‘Apply’ to save the settings. To create the product tables, use the Import-button to ‘Import’ the query-file:  ‘/Examples/PostgreSQL/products_pgsql.sql’ Product changes can now be made:  Manually by editing the products in the Data-tab ...
  • Page 89: Appendix F: Sqlite Demo Configuration

    When using SQLite, the SQLite database will be automatically generated in the installation folder of the ESL server. Use the following configuration in the ESL server. (User name and password are ignored) After making the configuration, use the ‘Test’-button to test the connection details.
  • Page 90 Opticon ESL ESL Server manual v1.0.62.2 If the connection was successful, then press ‘Apply’ to save the settings. To create the product tables, use the Import-button to ‘Import’ the query-file:  ‘/Examples/SQLite/products_sqlite.sql’ The product data should now appear in the Data-tab.
  • Page 91: Appendix G: Db2 Demo Configuration

    When using DB2, it is mandatory to create an ODBC data source (i.e. called DB2_ODBC_ESL) to connect to the DB2 database. See chapter 7.3 for more information on ODBC. Use the following configuration in the ESL server. After making the configuration, use the ‘Test’-button to test the connection details.
  • Page 92 Opticon ESL ESL Server manual v1.0.62.2 If the connection was successful, then press ‘Apply’ to save the settings. To create the product tables, use the Import-button to ‘Import’ the query-file:  ‘/Examples/DB2/products_db2.sql’ The product data should now appear in the Data-tab.
  • Page 93: Appendix H: Restoring The Esl Server Back To Default (Csv)

    Opticon ESL ESL Server manual v1.0.62.2 Appendix H: Restoring the ESL server back to default (CSV) The ESL Server can be reverted to factory default by importing a configuration file found in the following folder of your installation.  ‘/Examples/Default Configuration’...
  • Page 94: Appendix I: Using The Sql Api

    SQL queries can be used as API to create your own application by executing SQL queries to control and monitor the ESL system, while running the ESL server as background service (See chapter 12 on how run the ESL server as service).
  • Page 95 Opticon ESL ESL Server manual v1.0.62.2 Supported ESL actions The following list of SQL-commands is currently supported to initiate an ESL action. Valid commands will be moved to the action_pending table. Disgarded commands will be moved to the action_results table...
  • Page 96 Opticon ESL ESL Server manual v1.0.62.2 Supported ESL settings The following list of SQL-commands is currently supported to change ESL settings. Valid commands will be moved to the action_pending table. Disgarded settings and settings that match the current setting will be moved to the action_results table.
  • Page 97 Opticon ESL ESL Server manual v1.0.62.2 Supported Base station actions The following list of SQL-commands is currently supported to initiate a base-station-action. Successfully executed and discarded commands will be moved to the action results-table. ACTION PARAM1 REACTIVATE_START MAC-Address (12) Timeout in sec (min 30, max 900) INSERT INTO `actions_staging`(`ACTION`, `MAC`, `PARAM1`) VALUES ('REACTIVATE_START', '00126AF5FFF8', 180);...
  • Page 98 Opticon ESL ESL Server manual v1.0.62.2 Supported External Trigger actions The following list of SQL-commands is currently supported to initiate external actions like calling an SQL script, batch file or 3 party application on a given event. Successfully executed and discarded commands will be moved to the action results-table.
  • Page 99: Appendix J: Version History

    April 30, 2014 V1.0.34 files Enabled logging of user activity by default Prevented double execution of ESL server Fixes various rare exceptions Fixed issue with image id's not incrementing Made SQL status/logging tables configurable Fixed not automatically reloading of Product table after using SQL staging...
  • Page 100 DHCP leases) Added field numbers to example data text boxes for easy-of-use Automatically configure web application settings on changing database settings in ESL-server Added SQL API for executing actions and changing settings in ESL server Fixed incorrect value of field separator...
  • Page 101 Template editor: Changed text-buttons to icons Added validation checks to exporting templates Fixed Windows 10 issues with MySQL Added support of reactivate by address range to ESL server Improved importing of setting files (at startup) Fixed same rare unhandled exceptions...
  • Page 102 Removed XML-editor for template editing and template selection Added GUI for editing conditions and extended matching conditions Simplified linking of ESLs to products in ESL server Added possibility to link using USB-HID barcode scanner Added support of arrow-keys to position object in templates Fixed issue with automatically updating dbconfig.php from the web...
  • Page 103 Huge performance update on processing of staging tables and importing CSV January 18, 2017 files into SQL Web application: Added warnings when ESL or ESL server is offline and allow scanning of ESL and product barcode in any sequence during linking Fixed uncaught exception on 32-bit systems with template editor...
  • Page 104 Improved importing of config-files: list of base stations can now be imported Fixed rare exception in discover box Reduced number of exception in log when TBSS350 is down Resolved issue with not all prices updating when multiple ESLs are newly linked (without restart of the ESL server) to the same product...

This manual is also suitable for:

Ebs-40Ebs-30Ebs-31

Table of Contents