1.1 System requirements ................................................................................................................................. 8 1.2 Installation process .................................................................................................................................... 8 2.1 Starting ESL Server ................................................................................................................................... 10 2.1.1 Example articles ........
6.2 Sending pictures to labels ........................................................................................................................ 23 6.3 Article management ................................................................................................................................. 24 6.3.1 Import articles .......................................................................................................................................... 24 6.4 Matchings ..................
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.
Figure 2 - Smart Box Outside 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. 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. The AP-2010 by imagotag is the communication center in the store that transmits price information to the labels.
: Developer Reference, Image Rendering Reference and CSV/XML Import Plugin Metal Mounting Plate for Mounting the AP-2010 on Walls, Ceilings or other Mounting-Rails. With our flexible system you’re able to mount your labels almost wherever you want. Power Plug to supply power for the AP-2010 (Power over Ethernet is also available).
As described above, the USB stick contains several software, so you’ll have to install (you’ll just have to unpack 3 archives) the following: (1) ESL Server (2) ESL Client (3) Template Editor Server hardware: Pentium 4 (2 GHz or higher), 2 GB RAM Java Runtime Environment Version 6, Update 36 Windows XP, Windows 7, Windows Server 2008 (R2), Suse Enterprise Linux 11, Ubuntu 12 (all 32/64-bit versions) imagotag Server/Client applications (2x .
After unpacking all 3 archives, your folder should look something like this: Figure 6 - Unpacked imagotag software folder That’s it, the imagotag software is now installed and you can step forward to point 2 - Start Server and Client.
In order to start the ESL Service with the default configuration, just execute the jar file “server.jar” as described in [Troubleshooting] 2 - Starting Java applications 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). Figure 7 - ESL Service GUI The service will listen to TCP connections on Port 8000 and 8001 and UDP connections on Port 8000.
Navigate to the unpacked client directory (see point 1.2 on how to unpack the software package) and execute the “client.jar” file (see [Troubleshooting] point 2 on how to start a jar file). Figure 8 - Starting ESL Client The client is configured to connect to a server on the local machine per default.
Username: admin Password: admin Figure 10 - ESL Client Login Navigate to the unpacked template directory (see point 1.2 on how to unpack the software package) and execute the “template.jar” file (see [Troubleshooting] point 2 on how to start a jar file).
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 12 - ESL Client Access Point Configuration Before labels are able to communication with the server at least one access point needs to be configured.
Connect your machine to the same network as the AP Plug in the power supply of the access point During the boot process of the access point, start the ESL server software on the computer (see point 2.
with standard Wi-Fi channels 1, 6, 11 and are scanned by the labels more often For further information about selecting channels see point 3.4. After the configuration in the web-GUI it’s necessary to add this AP via the ESL Client: System -> Access Point Configuration -> New … Figure 14 - ESL Client AP configuration - System -> Access Pont Configuration -> New Choose “Manual Configuration” if you don’t use Auto-Config and enter Access Point ID (AP ID) and IP address (Host).
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. Figure 15 - Visualization of used channels of the imagotag AP-2010 If there is a Wi-Fi installation operating at 2.4 GHz (IEEE 802.11b/g/n) or any other radio frequency (RF) technology that uses the 2.4 GHz ISM band make sure to select the ESL channels that are least overlapping with the existing installation.
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.
First step is to set the parameter “encryptionPassphrase“ under System – Configuration (you can choose the encryption Passphrase on your own). Figure 16 - Set encryption key : Do not change encryption passphrase if labels are already connected and encrypted (if you want to change the encryption passphrase you’ll first have to unlock all labels – see [Troubleshooting] point 1.8).
In order that labels can join the network it is necessary to register them first. 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 Figure 17.
Imago G1 2.7 Imago G1 4.4 Before registration Successful registration (key set, active encryption) Here you can see the registration dialog in the ESL Client where one single label has been entered with the registration code and the other one with the label ID (for old label versions < 3.0.0).
: New versions of the imago gateway, client and access point (≥ 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 gateway 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.
Figure 22 – Encryption status 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 Client select File – Unlock labels and enter the unlock key.
As soon as labels are online you can do several things: 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 … 1) 2) 3) Right click on one or more labels -> Send image… Select a picture ( : Display size must match the resolution of the image – see imago G1 label family on page 5) a.
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 25 - Article management There’s also the possibility to import articles from a *.CSV-file.
Figure 26 - How the article.config looks like in the Smart Box installation The article number field is mandatory, every other field is optional an can be left empty (e.g. 100000;;;;;;). o : If you add an article via ESL Client, price and name will be mandatory The order of the first 2 fields articleNumber and gtin in the CSV file is essential. The order of the other fields is not essential since they are identified by their fieldname (e.g. name=, price=).
Figure 28 - Importing articles via ESL Client : In order to refresh the entries press the refresh button or F5 Figure 29 - Imported demo articles
6.3.1.1 Field description Name Description articleNumber Unique id of the article. This field is mandatory. gtin1,gtin2,gtin3.. GTIN is the global trade item number of an article. For an article there can be multiple GTINs specified. The numbers must be valid GTIN codes (for more information see http://en.wikipedia.org/wiki/Global_Trade_Item_Number) name The name field of the article price The article’s price with “.” (dot) as decimal separator.
Select File – New matchings to open the dialog where you can select the desired data records and create a number of matchings at the same time. Figure 30 - New matchings dialog Another way to create/edit matchings is under “Matchings – All Matchings”: 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.
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). The template is used to specify the fields, which should be rendered into the image. The ESL Server can handle multiple templates. The image rendering process is based on XSL (EXtensible Stylesheet Language) templates.
To get a live preview you’ll have to load some records, in our case we load the demo article records from our running server, see the following figure. Figure 33 - Load Records from Server After these steps your Template Editor window should look something like this: Figure 34 - Template Editor with loaded records from server and default.xsl template file 6.5.2.
Figure 35 - Enable Design Mode in Template Editor After enabling the Design Mode a new tab will show up.
6.5.2.3 Help Content There’s a link to the Help content for the template editor, open it by clicking Help – Help Content in the Template Editor or open the file index.html located in C:\imagotag\template\help\. Also you can find further information on the USB Stick under Documentation - Image Rendering Reference. The ESL server provides access to its interfaces methods through a RESTful web service API.
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 web-GUI of the server under “Documentation”.
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.
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 : After installation there’s no reboot required.
The unlock-code for the specific labels is enclosed in the Smart Box (in an envelope). If you have any further problems please contact the imagotag support (support@imagotag.com). Before starting a Java application, make sure you have Java Runtime Environment Version 6 or higher installed and you have set the necessary environment variables. If the .jar file extension is known and associated with Java, just double-click the jar file to start the application.