Quick Start Guide Applies to software version 1.4.0 or higher Last change: 07.09.
Quick Start Guide imagotag GmbH [Introduction] 4 1 Electronic Shelf Labeling – A brief introduction 4 2 The G1 label family 5 2.1 Key Features 5 3 6 What’s in your Smart Box? [Getting Started] 7 1 Latest Software and Documentation 7 2 Install software 7 2.1 System requirements 7 2.2 Installation process 7 2.3 Customer Portal 9 3 Start Server and Client 10 3.1 Starting ESL Server 10 3.2 Starting ESL Client 11 3.
Quick Start Guide imagotag GmbH 7.5 Templates 27 8 31 Integration 8.1 Webservice integration 31 8.2 Plugins 31 8.3 Custom integration 31 [Troubleshooting] 32 1 32 FAQ 1.1 Running the ESL Server as a background service 33 1.2 Where can I find the license file for my SmartBox? 33 1.3 Deleting the demo articles 33 1.4 Establish a network configuration when no DHCP is available – Step by step 33 1.5 AP discovering with Bonjour Services 34 1.
Quick Start Guide imagotag GmbH [Introduction] 1 Electronic Shelf Labeling – A brief introduction An electronic shelf label is a device that shows article data and price information on its display. In comparison to printed labels the information is automatically updated if price or article data changes.
Quick Start Guide 2 imagotag GmbH The G1 label family The imago G1 electronic shelf label family offers high-quality display options, operating with a replaceable battery and thus working with any external power supply. The G1 red family is capable of changing all pixels to black, white or red. The current line-up has display sizes from 2 inch to 7.4 inch. They may be used in landscape and portrait mode and can be customized with changeable front covers. (missing or bad snippet) 2.
Quick Start Guide 3 imagotag GmbH What’s in your Smart Box? l l l l l l Page 6 of 36 2x G1 2.7 Labels / 1x G1 4.4 Label o The G1 electronic shelf label family offers high-quality display options, operating with a replaceable battery and thus working with any external power supply. Thanks to the perfect readability of the e-Ink displays and our outstanding wireless data transmission technology you can implement all your sales, marketing, and logistic strategies. 1x Access Point AP-2010 incl.
Quick Start Guide imagotag GmbH [Getting Started] 1 Latest Software and Documentation At the Customer Portal https://portal.imagotag.com you can view all your shipments, get access to registration- and unlock codes, check the warranty status of your labels, download your license files and access the latest software releases and documentation from this site. 2 Install software There’s several software you’ll have to install in order to configure and setup your ESL system.
Quick Start Guide #1 Page 8 of 36 imagotag GmbH
Quick Start Guide imagotag GmbH After unpacking all 3 archives, your folder should look something like this: FIGURE 1-4: Unpacked imagotag software folder The imagotag software is now installed and you can step forward to point Start Server and Client - Start Server and Client. 2.
Quick Start Guide imagotag GmbH 3 Start Server and Client 3.1 Starting ESL Server In order to start the ESL Service with the default configuration, just execute the jar file “server.jar” as described in [Troubleshooting] and wait for the small service GUI to show up (if the window doesn’t show up after all, make sure your Java installation and configuration is correct).
Quick Start Guide 3.2 imagotag GmbH Starting ESL Client Go to the extracted client directory and execute the “client.jar” file. FIGURE 1-6: Starting ESL Client The client is configured to connect to a server on the local machine per default. In order to change this to a remote machine in a network you have to start the client with an additional parameter: Windows l Create a shortcut/Edit existing short cut l Append “ --host hostnameOrIPAddress” at the end of the “Target” field.
Quick Start Guide imagotag GmbH 3.2.1 ESL Client Login l l Username: admin Password: admin FIGURE 1-8: ESL Client Login 3.3 Activating License After starting the ESL Server and Client it's necessary to activate the license which is included in the "Software License Document". To view your current license status there's a License status dialog. You can find it in the ESL Client under "Help - License status".
Quick Start Guide imagotag GmbH FIGURE 1-10: Activate License (imagotag Customer Center) Download the generated license file and complete the licensing process by importing the license file to your ESL system. With the successful activation of your SmartBox demo license you're now able to register and use up to five labels and one access point. FIGURE 1-11: Import of license file downloaded before Note: Press "F5" (after 15 seconds) to update the license status after license file import.
Quick Start Guide 4 imagotag GmbH Connect and configure Access Point AP-2010 The AP-2010 by imagotag is the communication center in the store that transmits price information to the labels. In order to ensure the communication between ESL Server, access point AP-2010 and the labels the access point has to be configured at the start of the ESL Server. One way to configure the access point is on the client. FIGURE 1-12: ESL Client Access Point Configuration 4.
Quick Start Guide 4.1.1 imagotag GmbH Discover the Access Point Before you can configure the access point it’s necessary that the server will discover it.
Quick Start Guide imagotag GmbH The AP-2010 supports 11 wireless channels. It’s recommended to choose one of the recommended channels: 3, 5, 8, 9 or 10. These channels do not interfere with standard Wi-Fi channels 1, 6, 11 and are scanned by the labels more often For further information about selecting channels see point Connect and configure Access Point AP-2010. 4.
Quick Start Guide 4.4 imagotag GmbH Selecting channels For a working installation a channel must be selected on each access point in the network. There are 11 non overlapping ESL channels reserved for the communication with the labels. Five of these channels do not interfere with typical Wi-Fi installations and should therefore be favored. These are the ESL channels 3, 5, 8, 9 and 10 and they should be selected if there is a Wi-Fi installation on the Wi-Fi channels 1, 6 and 11.
Quick Start Guide 5 imagotag GmbH Setup Security The security concept is based on individual registration codes for each label. Not only that the new concept simplifies installations, it also provides stronger encryption and a secure key exchange with individual communication key derived from a user defined network key. 5.
Quick Start Guide 6 imagotag GmbH Register labels In order that labels can join the network it is necessary to register them first. 6.1 General procedure Via the ESL Client under File – Register Labels it’s possible to register your labels manually with the registration code shown on each single label or you could import a CSV file with your registration codes. In order to refresh the entries press the refresh button shown in the next figure.
Quick Start Guide imagotag GmbH 6.2.1 Labels before and after registration Page Layouts G1 4.4 Layout when shipped Registration Page Layout Note: The label ID can only be read and will not be displayed as barcode in this layout. Layout after successful registration Reset Page Layout Note: After successful registration, the AES key is exchanged for encryption and the label switch to a page where only the label ID is displayed as 1D Code128 barcode.
Quick Start Guide imagotag GmbH Note: New versions of the ESL Server, ESL Client and AP-2010 (≥ 1.3.0) will also support old labels that do not come with a pre-programmed PIN code. New labels (≥ 3.0.0) will also work in old installations together with old labels but the ESL Server will not accept registration codes during the registration process. To register the labels it is required to scan the barcode with the label ID from the backside or the bottom edge of the label.
Quick Start Guide imagotag GmbH FIGURE 1-22: Encryption status 6.5 Unlocking labels If the label was registered and a communication key was set it will no longer work in other networks using a different network key passphrase. To unlock this labels for other networks an unlock code is required. The unlock code is similar to the registration code - it is a combination of the label ID and a 128 bit PUK code. Via ESL Clientselect File – Unlock labels and enter the unlock key.
Quick Start Guide 7 Start tagging 7.1 What can I do now? imagotag GmbH As soon as labels are online you can do several things: l l l l l l l l l l 7.2 Send image to label Assign tags Show the current image Ping label Reset label (reset display to show label ID and label ID barcode) Refresh display Switch to a preloaded page Create a new matching Set filters … Sending pictures to labels 1. Right click on one or more labels -> Send image… 2.
Quick Start Guide 7.3 imagotag GmbH Article management For complete management of your articles select Articles – All Articles in the ESL Client. Here you’re able to create/delete and edit your articles. The Smart Box comes with 4 predefined articles which you can see here. You can add some more demo articles, edit the existing ones or just step further to the next point Matchings. FIGURE 1-25: Article management 7.
Quick Start Guide imagotag GmbH FIGURE 1-26: New matchings dialog Another way to create/edit matchings is under “Matchings – All Matchings”: l l Select the desired data records (Label ID, Article Number) in the following window “New Matching Record“ (either manually or with the magnifying glass symbol). Select an appropriate template via “Template” that should be used to generate the image. Confirm your choice by clicking Save. After that, the generated image is sent to the selected label.
Quick Start Guide imagotag GmbH It’s also possible to create Matchings with ESL Client under Labels and Articles, for this just select the desired article or label, right-click on it and select “New matching…” (the new matching dialog will be pre-filled with the article or label information). 7.5 Set filters for enums It's possible to set and combine several filters. Click on the drop down menu to see the different choices. FIGURE 1-28: ESL Client filter options 7.5.
Quick Start Guide 7.5 imagotag GmbH Templates The template is used to specify the fields, which should be rendered into the image. The ESL Server can handle multiple templates. 7.5.1 General information about templates The image rendering process is based on XSL (EXtensible Stylesheet Language) templates. The individual image for the label is then generated by applying the template to a XML, which is based on the properties of the label and is expanded by a custom XML from the user.
Quick Start Guide imagotag GmbH 7.5.2.1 Starting Template Editor Navigate to the unpacked template directory (see point Installation process on how to unpack the software package) and execute the “template.jar” file (see [Troubleshooting] on page 32). FIGURE 1-30: Starting the Template Editor 7.5.2.2 Open default template-file and load records from server: l l l Open the Template Editor by clicking the “template.jar” file located in the template-directory (In our example it should be C:\imagotag\tea
Quick Start Guide imagotag GmbH After these steps your Template Editor window should look something like this: FIGURE 1-32: Template Editor with loaded records from server and default.xsl template file 7.5.2.3 Design Mode You can enable the graphical Template Editor by selecting Settings – Configuration – tick Enable Design Mode and finally the Save-button.
Quick Start Guide imagotag GmbH After enabling the Design Mode a new tab will show up. FIGURE 1-34: Template Editor Design Tab 7.5.2.4 Enable and show color red As there are new label types which are capable of showing the color "red" there's a short description how to enable this inside the xsl template file.
Quick Start Guide 8 Integration 8.1 Webservice integration imagotag GmbH The ESL server provides access to its interfaces methods through a RESTful web service API. The web service is designed according to the “Representational State Transfer” (REST) architectural pattern. The ESL server listens for incoming HTTP web service requests on the TCP port 8001 by default. You can find further information and documentation about the webservice integration online under https://portal.imagotag.
Quick Start Guide imagotag GmbH [Troubleshooting] 1 FAQ If you run into any errors during connecting or sending images to labels, please refer to the documentation included in the server. This documentation can be found in the AP-2010 web management interface of the server under “Documentation”.
Quick Start Guide 1.1 imagotag GmbH Running the ESL Server as a background service The ESL server may be started as a normal application, but on a productive system it is usually required to have it automatically started without a user logged in. To achieve this the ESL server can be registered as a Windows service. It is than started automatically without any graphics user interface. To install the ESL server as a Windows service the batch file install_service.bat is provided.
Quick Start Guide imagotag GmbH FIGURE 1-35: Restart and Factory Defaults button 1.5 AP discovering with Bonjour Services You still got problems to find your AP in your network? There's another workaround: You can use Apple's "Bonjour Print Services". Download and install “Bonjour Print Services“ for Windows (pre-installed under OSX): http://support.apple.com/kb/DL999 Note: After installation there’s no reboot required.
Quick Start Guide 1.8 imagotag GmbH The encryption does not work Check the encryption passphrase in Server Configuration (System – Configuration). If label was already registered with a different passphrase you’ll have to unlock the label first in order to register it on the server. 1.9 Unlocking labels If the label was registered and a communication key was set it will no longer work in other networks using a different network key passphrase.
Quick Start Guide l l imagotag GmbH Click OK ApplyChanges Under Linux: l Use the “export” command to set your variables l export JAVA_HOME= l export PATH=$PATH:/bin l In order to make these changes persistent, write them into your .bash_profile file and use “source ~/.bash_profile” to apply the changes 1.11 Encoding problems Per default, UTF-8 encoding is used. If you have any problems regarding encoding you can force any java application to use UTF-8.