SES imagotag E00018, E00023, E00019, E00020, E00017 Quick Start Guide
...
Quick Start
Guide
Last change: 31.05.2016
Applies to software version 1.6.0 or higher
Quick Start Guide
[Introduction] 4
1 Electronic Shelf Labeling – A brief introduction 4
2 What’s in your Smart Box? 5
3 The G1 label family 6
3.1 Key Features 7
4 Core appliance 8
4.1 Key Features 8
[Getting Started] 9
1 Get the latest software and documentation 9
2 Install software 9
2.1 System requirements 9
2.2 Installation process 9
2.3 imagotag Customer and Partner Portal 10
3 Core appliance initial setup 11
3.1 USB device configuration 11
3.2 Configuration file creator 12
3.3 Front side LEDdescription 13
3.4 Additional documentation 13
4 Start Core Service and Control Center 14
4.1 Starting imagotag Core Service 14
4.2 Starting imagotag Control Center 15
4.3 Activating your license 17
5 Access Point Configuration 19
5.1 Connect and configure AP-2010 19
5.2 Connect and configure MAP-2014 T/Q & LANCOM L-151e/322e 22
5.3 Selecting channels 27
6 Setup Security 28
6.1 General encryption features and how does it work 28
6.2 Set the encryption key 28
7 Register labels 29
7.1 General procedure 29
7.2 What's on the label? 29
Page 2 of 50
Quick Start Guide
7.3 Handheld terminals, USB barcode scanner and iOS-App 31
7.4 Encryption status 32
7.5 Unlocking labels 33
8 Start tagging 35
8.1 What can I do now? 35
8.2 Sending pictures to labels 35
8.3 Article management 35
8.4 Matchings/Multi-Facing 36
8.5 Set (extended) filters for enums 38
8.5 Templates 39
9 Integration 44
9.1 Webservice integration 44
9.2 Plugins 44
9.3 Custom integration 44
[Troubleshooting] 45
1 FAQ 45
1.1 imagotag Core Service Dashboard 47
1.2 Running the imagotag Core Service as a background service 47
1.3 Where can I find the license file for my SmartBox? 48
1.4 Deleting the demo articles 48
1.5 Labels don’t come online 48
1.6 The encryption does not work 48
1.7 Unlocking labels 48
1.8 Starting Java applications 48
1.9 Encoding problems 50
1.10 Further documentation 50
Page 3 of 50
Quick Start Guide
[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 integrity
– 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
FIGURE 1-1: Electronic Shelf Labeling
l Enhanced sales & price profitability
maximize price performance and
profit opportunities
Page 4 of 50
Quick Start Guide
2 What’s in your Smart Box?
l 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.
l 1x Access Point AP-2010 incl. Antenna
o
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 ESLchannels.
l 1x Mounting Plate
o
Metal Mounting Plate for Mounting the AP-2010 on Walls, Ceilings or other Mounting-Rails.
l 2x Caddy Clips
o
With our system you’re able to mount your labels almost wherever you want.
l 1x Power Plug
o
Power Plug to supply power for the AP-2010 (Power over Ethernet is also available).
Page 5 of 50
Quick Start Guide
3 The G1 label family
The imago G1 electronic shelf label family offers high-quality display options, operating with a
replaceable battery and thus working without 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 1.6 inch to 7.4 inch. They may be used in landscape
and portrait mode and can be customized with changeable front covers.
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/ICregulation).
Caption
G1 retail 1.6 red NFC 152 x 152 140 b/w/r 4* 27.5 x 27.5 7500/4600 1
G1 retail 2.2 red NFC / Boss-
ard 2.2 red NFC
G1 retail 2.6 red NFC 296 x 152 125 b/w/r 4* 60.1 x 30.7 4500/2600 2
G1 retail 2.7 264 x 176 117 b/w 8* 57.3 x 38.2 5000/2700 4
G1 retail 2.7 red NFC 264 x 176 117 b/w/r 4* 57.3 x 38.2 4500 2
G1 retail 4.2 400 x 300 120 b/w 4* 84.8 x 63.6 3000 4
G1 retail 4.2 red NFC 400 x 300 120 b/w/r 4* 84.8 x 63.6 2000/1300 2
G1 retail 4.4 400 x 300 113 b/w 4* 90 x 67 3000/1600 4
G1 retail 4.4 red NFC 400 x 300 113 b/w/r 4* 90 x 67 2000 2
G1 retail 4.5 480 x 176 117 b/w 4* 104.2 x 38.2 4300 4
G1 retail 4.5 red NFC 400 x 300 113 b/w/r 4* 90 x 67 2500 2
G1 retail 7.4 800 x 480 126 b/w 12* 97 x 161.6 1000/500 8
G1 retail 7.4 red NFC 800 x 480 126 b/w/r 4* 97 x 161.6 600/300 2
S-tag 6 HFNFC - - b/w 4 53 x 19.3 20000/20000 4
Display Res-
olution
212 x 104 111 b/w/r 4* 48.6 x 23.8 8500/5000 2
Density
(dpi)
Display
Colors
Useable
Pages
Active Dis-
play Area
(mm)
Updates/hour/AP
(standard /
FCC&IC mode)
Battery
lifetime: 5
years with
N updates
per day
*One useable page is shared with the registration code page. This page is initially shown when
the label is 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 imagotag support.
The content of all pages except page number 0 won't remain after a firmware update.
Page 6 of 50
Quick Start Guide
3.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 NFCtag as an option
Page 7 of 50
Quick Start Guide
4 Core appliance
The core appliance/core appliance mini is a compact network hardware which can be used to
run the imagotag Core Service in the store, instead of using an additional dedicated server. The
imagotag Core Service is always needed in the store locally, also when cloud-based/centralized
middleware systems like Jeggy S or Bison ESL Suite is used.
4.1 Key Features
l core appliance is optimized to run up to 30 000 labels and 7 access points
l core appliance mini is optimized to run up to 500 labels and 3 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 Less overall risk for system integrators
Page 8 of 50
Quick Start Guide
[Getting Started]
1 Get the latest software and documentation
Register at the imagotag Customer and Partner Portal to get access to the latest software
suite and documentation.
https://portal.imagotag.com
After registration your access is limited. Contact the imagotag Support Team
(support@imagotag.com)to get further access and information.
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. imagotag Core Service (previously known as imagotag ESL Server) <server.zip>
2. imagotag Control Center (previously known as imagotag 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 or higher
l Windows XP, Windows 7, Windows Server 2008 (R2), Windows 10, Suse Enterprise Linux
11, Ubuntu 12 (all 32/64-bit versions), Mac OS X
l imagotag Core Software Suite
l imagotag AP-2010
l imagotag Labels
l License key
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).
Page 9 of 50
Quick Start Guide
FIGURE 1-2: Unpack/Install imagotag Software #1 FIGURE 1-3: Unpack/Install imagotag Software #2
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 Core Service and
Control Center - Start Core Service and Control Center.
2.3 imagotag Customer and Partner Portal
After user registration and activation you will have access to documentation and you can
activate, manage and download your imagotag software licenses see Activating your license on
page 17. 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 10 of 50
Quick Start Guide
3 Core appliance initial setup
To operate the 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
Per default, the imagotag core appliance comes with DHCPenabled. So if you have a
DHCPservice running you can find it with the MAC address which is printed on the bottom side
of the appliance.
If there's no way to get access to the DHCPserver we recommend to use a USBdevice with a
configuration file to configure the appliance initially.
FIGURE 1-5: Core appliance rear view
3.1 USB device configuration
You can find an example configuration file (example.config) at our customer portal.
Core appliance service reference mode | Core appliance example.config file
After downloading, editing and copying the configuration file onto any USBdevice, the
configuration is automatically adopted after plugging in the USB flash drive into the appliance.
A triple beep indicates the successful configuration. A single beep signals that the
configuration hasn't been set successful.
The web UIinterface of the appliance is now available under http://<ip-address>.
The initial configuration of the appliance can be compared with the installation and start of an
imagotag Core Service. After configuration, you can access the appliance via the imagotag
Control Center from every system connected to your network (see Starting imagotag Control
Center on page 15).
Page 11 of 50
Quick Start Guide
3.1.1 Example.config file
To set up your appliance for the first run you'll have to set at least the following network
parameters:
l IPaddress
l Subnet mask
l Optional: Gateway, DNS
To set the parameters mentioned above the 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
# 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 appliance is accessible via the configured bridge address.
3.2 Configuration file creator
You'll also find a appliance configuration file creator wizard at our imagotag Customer and
Partner Portal. The wizard will help to create the correct configuration file which is used to set
the following configuration parameters:
Mandatory:
l Appliance ID
l IPaddress
l Subnet mask
Optional:
l Title
l Store ID
l Comment
l Hostname
l Default Gateway
l Nameserver 1
l Nameserver 2
Page 12 of 50
Quick Start Guide
FIGURE 1-6: Appliance configuration file creator
3.3 Front side LEDdescription
On the front side of the appliance you can see several status information:
FIGURE 1-7: Core appliance front view LEDstatus information
Power on
Core Appliance is active
Core service running
Task executed
Port in use
Port/Device is active
3.4 Additional documentation
You can find additional documentation regarding the imagotag core appliance (e.g. a complete
service mode reference) on our imagotag Customer and Partner Portal
Page 13 of 50
Quick Start Guide
4 Start Core Service and Control Center
4.1 Starting imagotag Core Service
If you've recently configured your imagotag core appliance the ESLService is already running
and you can step forward to the next step 15
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-8: Core Service web UI
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 imagotag Core Service 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 part of the documentation available at the imagotag Customer and Partner Portal) under
“Integration Levels”.
1
Apache Derby, an Apache DB subproject, is an open source relational database implemented
entirely in Java
Page 14 of 50
Quick Start Guide
4.1.1 Example articles
For easier usage some example articles can be preloaded at the time you start the imagotag
Core Service. You can find the corresponding XMLarticle 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.
4.2 Starting imagotag Control Center
Go to the extracted client directory and execute the “client.jar” file.
FIGURE 1-9: 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!)
Page 15 of 50
Loading...