SES imagotag E00005, E00007, E00004, E00008, E00011 Quick Start Guide

...

Quick Start Guide

Applies to software version 1.4.0 or higher Last change: 07.09.2015 Author: Kurt Haller-Walzl

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 What’s in your Smart Box? 6

[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.3 Activating License 12

4 Connect and configure Access Point AP-2010 14

4.1 Connect and configure 14

4.2 Necessary configuration over the AP-2010 web management interface 15

4.3 Necessary configuration at the ESL Client 16

4.4 Selecting channels 17

4.5 The Status LED 17

5 Setup Security 18

5.1 General encryption features and how does it work 18

5.2 Set the encryption key 18

6 Register labels 19

6.1 General procedure 19

6.2 What's on the label? 19

6.3 Handheld terminals, USB barcode scanner and iOS-App 21

6.4 Encryption status 21

6.5 Unlocking labels 22

7 Start tagging 23

7.1 What can I do now? 23

7.2 Sending pictures to labels 23

7.3 Article management 24

7.4 Matchings 24

7.5 Set filters for enums 26

Page 2 of 36

Quick Start Guide imagotag GmbH

7.5 Templates 27

8 Integration 31

8.1 Webservice integration 31

8.2 Plugins 31

8.3 Custom integration 31

[Troubleshooting] 32

1 FAQ 32

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.6 What can I do if the Status LED of the AP-2010 access point doesn’t turn blue? 34

1.7 Labels don’t come online 34

1.8 The encryption does not work 35

1.9 Unlocking labels 35

1.10 Starting Java applications 35

1.11 Encoding problems 36

1.12 Further documentation 36

Page 3 of 36

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.

l Cost reduction through elimination

of manual price changes

l Fully automatic price updates from

the headquarters to the branch stores within seconds

l Process security and price integ-

rity – 100% correlation between cash point and shelf

l Increased flexibility in price design

and immediate reaction to market situation Image gain due to use of highly modern technology

l Simplified processes for store per-

sonnel

l Enhanced sales & price prof-

itability maximize price performance and profit opportunities

FIGURE 1-1: Electronic Shelf Labeling

Page 4 of 36

Quick Start Guide imagotag GmbH

2 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.1 Key Features

l 2.4 GHz bi-directional MSK proprietary radio l Radio coverage: up to 25 meters l Return Signal: yes l 11 available communication channels l Ultra-low power consumption l Customer-replaceable battery l Full graphical e-Ink display with paper-like readability l Changeable and customizable front covers l Super wide viewing angle (nearly 180 degrees) l Flexible mounting options available l May be used in landscape and portrait mode l Fast response time (less than 15 seconds) l Water resistant l 128-bit AES encryption with secure key exchange l Multiple pages support with preloading and fast page switching l Integrated NFCtag as an option

Page 5 of 36

Quick Start Guide imagotag GmbH

3 What’s in your Smart Box?

2x G1 2.7 Labels / 1x G1 4.4 Label

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

The AP-2010 by imagotag is the communication center in the store that transmits price information to the labels. Up to 10 000 labels can be managed per access point and the self-organizing network allows automatic roaming of labels without manual handling. It supports 11 selectable ESLchannels.

1x Installation Guide with USB Stick

ESLServer: The ESLServer is a Java software that is required to manage the imag- otag access points and electronic shelf labels.

ESLClient: The ESLClient is also Java based software. It’s a graphical user interface (GUI) for monitoring and for the configuration of the ESLServer. The ESLClient con- nects to the ESLClient. The server may be installed on the same machine or any other machine that is accessible over the network.

Template Editor: To render images from article records on the ESLServer, the layout must be predefined in a template file. Therefor an editor to create and edit template files with live preview based on example records is also on the imagotag USB stick.

Other documentation: Developer Reference, Image Rendering Reference and CSV/XML Import Plugin

1x Mounting Plate

Metal Mounting Plate for Mounting the AP-2010 on Walls, Ceilings or other MountingRails.

2x Caddy Clips

With our system you’re able to mount your labels almost wherever you want.

1x Power Plug

Power Plug to supply power for the AP-2010 (Power over Ethernet is also available).

Page 6 of 36

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. You’ll just have to extract the following 3 archives in a location of your choice:

1. ESL Server <server.zip>

2. ESL Client <client.zip>

3. Template Editor <template.zip>

2.1 System requirements

l Server hardware: Pentium 4 (2 GHz or higher), 2 GB RAM l Java Runtime Environment Version 6, Update 36 l Windows XP, Windows 7, Windows Server 2008 (R2), Suse Enterprise Linux 11, Ubuntu 12

(all 32/64-bit versions)

l imagotag Server/Client applications (2x .zip archives) l imagotag AP-2010 l imagotag Labels and license files

2.2 Installation process

Please unpack the zip-archives <server.zip>, <client.zip> and <template.zip> on your machine e.g. under C:\imagotag\.

Note: To unpack the zip-files you can either use the windows internal archive-unpacker (see screenshots) or an unpack tool of your choice (e.g. the free tool 7zip – www.7zip.org).

FIGURE 1-2: Unpack/Install imagotag Software FIGURE 1-3: Unpack/Install imagotag Software #2

Page 7 of 36

Quick Start Guide imagotag GmbH

Page 8 of 36

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.3 Customer Portal

At the Customer Portal 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.

After user registration and activation you will have access to documentation and you can activate, manage and download your imagotag software licenses see Activating License on page

12. Your user account will not be assigned to a customer account yet. If assigned, you have access to all shipments here including lists of label IDs, registration codes and unlock codes. To get access there must be a completed order and your account needs to be verified (existing customer account required).

Page 9 of 36

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

FIGURE 1-5: ESLServer web management interface

The service will listen to TCP connections on Port 8000 and 8001 and UDP connections on Port 8000. Please make sure that there is no firewall issue and/or interference with other systems.

After start of the service you can check the web-GUI of the server:

URL: http://<host|ip>:8000 Login: admin/admin

During the first start the ESLServer will automatically create a Derby1database. If another database connection is needed or preferred, the connection parameters should be validated by imagotag.

Note: As you can see there are several level numbers, by default the server instance will start in level 3. You can find the description of the different levels in the Developer Reference (which is also available at the Customer Portal) under “Integration Levels”.

3.1.1 Example articles

For easier usage some example articles can be preloaded at the time you start the ESLServer. You can find the corresponding XMLarticle data here: C:\imagotag\server\data\fixtures\.

To enable and disable the preloading of these fixtures go to the system configuration and set the corresponding property "importFixtures"true or false.

Note: The article records are based on the XML-standard.

Page 10 of 36

Apache Derby, an Apache DB subproject, is an open source relational database implemented entirely in

Java

Quick Start Guide imagotag GmbH

3.2 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. (Note: The text to

append starts with an space and there are 2 hyphens to add!)

Linux

l Append “ --host hostnameOrIPAddress” at the end of command (e.g. “java -jar client.jar -

-host 192.168.1.100” Note: The text to append starts with an space and there are 2 hyphens to add!)

FIGURE 1-7: Starting ESL Client with parameter

Page 11 of 36

+ 25 hidden pages