SES imagotag EDG2 0270 B User Manual

Core Service Quick Start Guide

Last change: 17.12.2019

Core Service Quick Start Guide

1 Electronic Shelf Labeling – A brief introduction 4 2 Label Family Introduction 5

2.1 GeneralKey Features 5

2.2 The G1 label family 5

2.3 The VUSION label family 6

3 Get the latest software and documentation 7

3.1 Installsoftware 7

3.2 System requirements 7

3.3 Installationprocess 7

3.4 SES-imagotag Customer and Partner Portal 8

4 Core Appliance 9

4.1 Why is it needed in the Store? 9

4.2 Key Features 9

5 Core Appliance initial setup 10

5.1 USB device configuration 10

5.2 Front side LEDdescription 11

5.3 Additional documentation 11

6 Start SES-imagotag Core Service and SES-imagotag Control Center 12

6.1 Starting SES-imagotag Core Service 12

6.1.1Example articles 12

6.2 Starting SES-imagotag Control Center 13

6.2.1SES-imagotag Control Center Login 13

6.3 Activating your license 14

7 ESL Access Point Configuration 16

7.1 Connect and configure AP-2010 16

7.1.1Connect and configure 16

7.1.2Discover the AccessPoint 16

7.1.3Necessary configuration on the AP-2010 web UI 17

7.1.4The Status LED 18

7.2 Adding AP-2010 to ESL system 19

7.2.1SES-imagotag Core Service 19

7.2.2JeegyCloud/JeegyS3 20

8 Selecting channels 21 9 Setup Security 22

9.1 Generalencryption features and how does it work 22

9.2 Set the encryption key 22

10 Register labels 23

10.1General procedure 23

10.2What's on the label? 23

10.2.1Registration page vs. Reset page 24

10.3Handheld terminals, USB barcode scanner and SES-imagotag Core Service iOS-App 25

10.4Encryption status 25

10.5Unlocking labels 26

11 Start tagging 27

Page 2 of 45

Core Service Quick Start Guide

11.1What can I do now? 27

11.2Sending pictures to labels 27

11.3Article management 27

11.4Matchings/Multi-Facing 28

11.5Set (extended) filters for enums 29

11.5.1Extended filter operators 29

12 Templates 31

12.1General information about templates 31

12.2SES-imagotag TemplateEditor 31

12.2.1Starting SES-imagotag TemplateEditor 31

12.2.2Open default template file and load records from server: 32

12.2.3Design Mode 33

12.2.4Enable and show color red 34

12.2.5Help Content 34

13 Integration 35

13.1Webservice integration 35

13.2Plugins 35

13.3Custom integration 35

14 Troubleshooting 36

14.1SES-imagotag Core Service Dashboard 36

14.2Running the SES-imagotag Core Service as a background service 37

14.3Where can get a demo/development licensekey? 37

14.4Deleting the demo articles 37

14.5Establish a network configuration when no DHCP is available – Step by step 38

14.6Accesspoint discovering with Bonjour Services 38

14.7What can I do if the StatusLED of the AP-2010 access point doesn’t turn blue? 38

14.8Labelsdon’t come online 39

14.9The encryptiondoes not work 39

14.10Unlocking labels 39

14.11Starting Java applications 39

14.12Encoding problems 40

14.13Reserve RAM for Java heap space 40

14.14Further documentation 41

15 Declaration 42 16 Warning 45

Page 3 of 45

Core Service Quick Start Guide

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 labelsthe information is automaticallyupdated if price or article data changes.

l Cost reduction through elim-

l Fully automatic price updates

l Process security and price

l Increased flexibilityin price

l Simplified processes for store

l Enhancedsales & price prof-

ination of manualprice changes

from the headquarters to the branch storeswithin seconds

integrity – 100% correlation between cash point and shelf

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

personnel

itability maximizeprice performance and profit opportunities

Page 4 of 45

Core Service Quick Start Guide

2 Label Family Introduction

The SES-imagotag electronic shelf labelfamily offers high-quality display options, operating with a replaceable battery, thus working without any external power supply.

The performance of the labels (updates per hour) depends on the mode of the access point. In the USA and Canada the AP-2010 usa/canada bundle incl. antenna with limited data efficiency is required (based on the FCC/ICregulation).

2.1 General Key Features

l 2.4 GHz proprietary radio protocol l Radio coverage: up to 25 meters l Bi-directional communication 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 Different configurationsavailable (theft protection, display protection, LED flash) l Label versions for deep-freezing environments l Super wide viewingangle (nearly 180 degrees) l Flexible mounting options available l May be used in landscape and portrait mode l Fast response time (less than 15/30 seconds, depends on wakeup time) l 128-bit AES encryption with secure key exchange l Multiple pages support with preloading and fast page switching l Integrated"Active" NFC l IntegratedPassive NFC tag l IntegratedNFC

l G1 - Passive NFC l VUSION - "Active" NFC

2.2 The G1 label family

The SES-imagotag G1 BWR label family is capable of changing all pixels to black, white or red. The current line-up has display sizes from 1.6 inch to 12.2 inch.

Caption

G1 1.6 BWR NFC 152 x 152 140 b/w/r 4* 27.5 x 27.5 7500/4600 1 G1 2.2 BWR NFC / Bossard

2.2 red NFC G1 2.6 BWR NFC 296 x 152 125 b/w/r 4* 60.1 x 30.7 4500/2600 2

G1 2.7 BW NFC 264 x 176 117 b/w 8* 57.3 x 38.2 5000/2700 4

G1 2.7 BWR NFC 264 x 176 117 b/w/r 4* 57.3 x 38.2 4500 2

G1 4.2 BW NFC 400 x 300 120 b/w 4* 84.8 x 63.6 3000/1600 4

G1 4.2 BWR NFC 400 x 300 120 b/w/r 4* 84.8 x 63.6 2000/1300 2

G1 4.5 BWR NFC 480 x 176 117 b/w/r 4* 104.2 x 38.2 2500/1500 2

G1 6.0 BWR NFC 600 x 448 129 b/w/r 4* 114.9 x 85.8 900/500 2

G1 7.4 BW NFC 480 x 800 126 b/w 12* 97 x 161.6 1000/500 8

G1 7.4 BWR NFC 480 x 800 126 b/w/r 4* 97 x 161.6 600/300 2

S-tag 6 HFNFC - - b/w 4 53 x 19.3 20000/20000 4

Battery life-

Display Res-

olution

Density

(dpi)

Display

Colo rs

Useable

Pages

Active Dis-

play Area

(mm)

Updates/hour/AP

(standard /

FCC&IC mode)

212 x 104 111 b/w/r 4* 48.6 x 23.8 8500/5000 2

time: 5 years with N updates

per day

Page 5 of 45

Core Service Quick Start Guide

*One useable page is shared with the registration code page. This page is initially shown when the labelis shipped. After registration this page can be used as a custom page. To restore the original content a service utility is required. To prevent accidentials overwrite this page is protected. To unlock this page contact the SES-imagotag support team.

The content of all pages except page number 0 won't remain after a firmware update.

2.3 The VUSION label family

The SES-imagotag VUSION (2.4GHz) electronic shelf label familyis capable of changing all pixels to black, white or red. The current line-up has display sizesfrom 1.6 inch to 12.2 inch. Theymay be used in landscape and portrait mode and can be configured in terms of radio, theft protection, display protection and LED flash.

Caption Model

VUSION 1.6 EDG2-0160-A 152 x 152 140 b/w/r 4 27.5 x 27.5 7500/4600 1

VUSION 2.2

VUSION 2.2 F EDG2-0220-A 212 x 104 111 b/w 4 48.6 x 23.8 10000/6500 1*

VUSION 2.6 EDG2-0260-A 296 x 152 125 b/w/r 4 60.1 x 30.7 4500/2600 2

VUSION 2.6 F EDG2-0260-A 296 x 152 125 b/w 4 60.1 x 30.7 6500/4500 1*

VUSION 2.7

VUSION 3.7 EDG2-0370-A 416 x 240 130 b/w/r 4 81.54 x 47.04 2000/1300 2

VUSION 4.2 EDG2-0420-A 400 x 300 120 b/w/r 4 84.8 x 63.6 2000/1300 2

VUSION 4.5 EDG2-0450-A 480 x 176 117 b/w/r 4 104.2 x 38.2 2500/1500 2

VUSION 5.9 EDG2-0590-A 720 x 256 134 b/w/r 4 138.96 x 49.40 1100/550 2

VUSION 7.4 EDG2-0740-A 480 x 800 126 b/w/r 4 97 x 161.6 600/300 2

VUSION 9.7 EDG2-0970-A 960 x 672 121 b/w/r 4 201.60 x 141.12 300/150 2

VUSION 12.2 EDG2-1220-A 768 x 960 103 b/w/r 6 190.08 x 237.6 300/150 1

EDG2-0220-A EDG3-0220-A

EDG2-0270-A EDG2-0270-B

* Battery lifetime: 3 years with N updates per day

Display Res-

olution

212 x 104 111 b/w/r 4 48.6 x 23.8 8500/5000 2

264 × 176 117 b/w/r 4 57.3 x 38.2 4500/2600 2

Density

(dpi)

Display

Colo rs

Useable

Pages

Active Disp lay

Area (mm)

Updates/hour/AP

(standard /

FCC&IC mode)

Battery

lifetime: 5 years with N updates

per day

The content of all pages except page number 0 won't remain after a firmware update.

Page 6 of 45

Core Service Quick Start Guide

3 Get the latest software and documentation

https://portal.imagotag.com

3.1 Install software

There’s several software you’ll have to installin 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. SES-imagotag Core Service <server.zip>

2. SES-imagotag Control Center <client.zip>

3. SES-imagotag TemplateEditor <template.zip>

3.2 System requirements

l Server hardware: Pentium 4 (2 GHz or higher), 2 GB RAM l JavaRuntime Environment Version 6, Update 36 or higher l Windows 7, Windows 10, Windows Server 2008 (R2), Windows Server 2012, Windows

Server 2016, Suse Enterprise Linux 11, Ubuntu 12 (all 32/64-bit versions), Mac OS X

l SES-imagotag Core Service l SES-imagotag AccessPoint(s) l SES-imagotag Label(s) l License key

3.3 Installation process

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

Note: To unpack the zip-filesyou 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-1:

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

After unpacking all 3 archives, your folder should look something like this:

Page 7 of 45

Core Service Quick Start Guide

FIGURE 1-3: Unpacked imagotag software folder

The SES-imagotag Core Service is now installed and you can step forward to point see Start SESimagotag Core Service and SES-imagotag Control Center on page 12.

3.4 SES-imagotag Customer and Partner Portal

After user registration and activation you will have accessto documentation.

You can activate, manage and download your SES-imagotag software licensessee Start SES- imagotag Core Service and SES-imagotag Control Center on page 12.

Your user account will not be assigned to a customer account yet. Ask our salesbackoffice team for user assignment (sales.at@ses-imagotag.com).

Page 8 of 45

Core Service Quick Start Guide

4 Core Appliance

The Core Appliance is a compact network device which can be used to run the SES-imagotag Core Service in the store, instead of using an additional dedicated server. The SES-imagotag Core Service is always needed in the store locally, also when cloud-based/centralizedmiddleware systems like JeegyS3 Centralized/Jeegy Cloud or Bison ESL Manager is used.

4.1 Why is it needed in the Store?

l Continuouscommunication with access pointsand labels is required (even without tasks) l Limited bandwidth between store and headquarters l Disconnected VPN connection will prevent proper operation l Load (image rendering…) is distributed to stores

4.2 Key Features

l Core Appliance is optimized to run up to 30 000 labels and 7 access points l Easier and faster shop installations (“Plug and Play”) l Is not recognized as an additional server l Low maintenance l Easy replace/restore when hardware crashes l Limited deployment variabilities l Lower development costs l Lower support costs l Better brand recognition l Easier to sell as a “solution in a box” l Lessoverall risk for system integrators

Page 9 of 45

Core Service Quick Start Guide

5 Core Appliance initial setup

To operate the Core Appliance there are only a few steps necessary:

1. Supply with power

2. Turn it on (button on the backside of the device)

3. Plug it into your network

4. Initial setup

5. Update to the latest version

Per default, the Core Appliance comes with DHCPenabled. So if you have a DHCPservice running you can find it with the MAC address which is printed on the bottom side of the Core Appliance.

If there's no way to get access to the DHCPserver we recommend to use an USBdevice with a configurationfile to configure the appliance initially.

FIGURE 1-4: Core Appliance rear view

5.1 USB device configuration

You can find an example configuration file (example.config) at ourSES-imagotag Customer and Partner Portal.

Core Appliance service reference mode | Core Appliance example.config file

After downloading, editing and copying the configuration file onto any USBdevice, the configuration is automatically adopted after plugging in the USB flash drive into the Core Appliance. A triple beep indicates the successful configuration. A single beep signalsthat the configuration hasn't been set successful.

Theweb user interface of the Core Appliance is now available under http://<ip-address>.

The initial configuration of the Core Appliancecan be compared with the installation and start of an SES-imagotag Core Service. After configuration, you can accessthe Core Appliance via the SESimagotag Control Center from every systemconnected to your network (see Start SES-imagotag Core Service and SES-imagotag Control Center on page 12).

Example.config file

To set up your Core Appliancefor the first run you'll have to set at least the following network parameters:

l IPaddress l Subnet mask l Optional: Gateway, DNS

To set the parametersmentioned abovethe contents of the configuration file might look like this:

# Set IP address of bridge interface set network br0 192.168.1.100 255.255.255.0 # Set a gateway set gateway 192.168.1.1

Page 10 of 45

Core Service Quick Start Guide

# Set a nameserver set dns 192.168.1.21

Note:This simple bridge configuration connects the network interfaces. No matter where the network cable is plugged in, the applianceis accessible via the configured bridge address.

5.2 Front side LEDdescription

On the front side of the appliance you can see several statusinformation:

Core Appliance front view LEDstatus information (Core Appliance version 1.8.0 or higher)

Upper LED:Power on Lower LED: Core Appliance is active

Upper LED: Port in use (color based on transfer rate) Lower LED: Port/Device is active

5.3 Additional documentation

You can find additionaldocumentation regarding the Core Appliance (e.g. a complete service mode reference) on our SES-imagotag Customer and Partner Portal.

Page 11 of 45

Core Service Quick Start Guide

6 Start SES-imagotag Core Service and SES-imagotag Control

Center

6.1 Starting SES-imagotag Core Service

If you've recently configured yourCore Appliancethe SES-imagotag Core Service software is already running and you can step forward to the next step.

In order to start the SES-imagotag Core 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: Core Service web UI

The SES-imagotag Core 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 SES-imagotag Core Service you can check the web user interface:

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

During the first start the SES-imagotag Core Service will automaticallycreate a Derby1database. If another database connection is needed or preferred, the connection parameters should be validated by SES-imagotag GmbH.

Note: As you can see there are several level numbers. You can find the description of the different levels in the Developer Reference (which is also part of the documentation available at the SESimagotag Customer and Partner Portal) under “Integration Levels”.

6.1.1 Example articles

For easier usage some example articlescan be preloaded at the time you start the SES-imagotag Core Service. You can find the corresponding XMLarticledata here: C:\ses-imagotag-coreservice\server\data\fixtures\.

To enable and disable the preloading of these fixtures go to the systemconfiguration and set the correspondingproperty "importFixtures"trueor false.

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

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

Page 12 of 45

Core Service Quick Start Guide

6.2 Starting SES-imagotag Control Center

Go to the extracted directory and execute the “client.jar” file.

FIGURE 1-6: Starting SES-imagotag Control Center

The SES-imagotag Control Centerisconfigured 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 SES-imagotag Control Center with an additional parameter:

Windows

l Create a shortcut/Edit existing short cut l Right clickto the shortcut and select "Properties" 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 SES-imagotag Control Center with parameter

6.2.1 SES-imagotag Control Center Login

l Username: admin l Password: admin

Page 13 of 45

Core Service Quick Start Guide

FIGURE 1-8: SES-imagotag Control Center Login

6.3 Activating your license

After starting the SES-imagotagCore Service and SES-imagotag Control Center it's necessary to activate the license key which is included in the "Software License Document". To view your current license statusthere's a License status dialog. You can find it in the SES-imagotag Control Center under "Help - License status". Since no license is activated/imported yet the window should look similar to this:

FIGURE 1-9: License Status Dialog

Copy the "System serial" to the clipboard (STRG+Cor right click "Copy to clipboard")and then click the "License activation". You'll be automatically redirected to the SES-imagotag Customer and Partner Portal https://portal.imagotag.com.

Please log in (or register a new user). After log in, you can see a summary of already activated licensesand/or activate a new license. Click "activate new license".

Fill in "License key", copy/paste the "System serial"(from the "License Status"dialog), add a Comment (optional) and click the "Activate"button.

Page 14 of 45

+ 31 hidden pages