Quick Start Guide Last change: 31.05.2016 Applies to software version 1.6.
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 8 Core appliance 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 11 Core appliance initial setup 3.1 USB device configuration 11 3.
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 44 Integration 9.1 Webservice integration 44 9.2 Plugins 44 9.3 Custom integration 44 [Troubleshooting] 45 1 45 FAQ 1.
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.
Quick Start Guide 2 What’s in your Smart Box? l l l l 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. 1x Access Point AP-2010 incl.
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.
Quick Start Guide 3.1 Key Features l l l l l l l l l l l l l l l l 2.
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.
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.
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.
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 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 appliance.
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 l l IP address Subnet mask 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.
Quick Start Guide FIGURE 1-6: Appliance configuration file creator 3.3 Front side LED description On the front side of the appliance you can see several status information: FIGURE 1-7: Core appliance front view LED status 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.
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 ESL Service 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.
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 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. 4.
Quick Start Guide FIGURE 1-10: Starting ESL Client with parameter Page 16 of 50
Quick Start Guide 4.2.1 imagotag Control Center Login l l Username: admin Password: admin FIGURE 1-11: imagotag Control Center Login 4.3 Activating your license After starting the imagotag Core Service and imagotag Control Center it's necessary to activate the license key 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 imagotag Control Center under "Help - License status".
Quick Start Guide FIGURE 1-13: Activate License (imagotag Customer and Partner Portal) 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-14: Import of license file downloaded before Note: Press "F5" (after 15 seconds) to update the license status after license file import.
Quick Start Guide 5 Access Point Configuration The access points AP-2010, MAP-2014 T/Q and LANCOM L-131e/L-322e are the communication center in the store that transmits information to the labels. In order to ensure the communication between imagotag Core Service, access point(s) and the labels the access points have to be configured at the start of the imagotag Core Service. 5.1 Connect and configure AP-2010 5.1.
Quick Start Guide FIGURE 1-15: List of discovered Access Points Now you’re able to configure the access point via AP-2010 web UI under http:// or a right click on the discovered AP –> Open in browser...
Quick Start Guide It’s recommended for the demo installation not to use the “Auto-Config” feature and configure the AP manually. 5.1.3 Necessary configuration over the AP-2010 web UI The following actions need to be performed over the web-GUI 1. Deactivate Centralized Configuration: Administration -> Configuration Mode 2. Set up network details (or leave DHCP): Administration -> Network 3. Set up an ESL channel: Administration -> Wireless Channel The AP-2010 supports 11 ESL channels.
Quick Start Guide Note: After the basic configuration in the AP-2010 web UI, it is also possible to fill in AP-ID and AP-IP-Address automatically. For this choose "Create Configuration..." under System – Access Point Status - Right click on the discovered and configured Access Point. After saving the AP configuration you should see the AP under System – Access Point Status as ONLINE. In addition the AP status LED should turn BLUE. Note: It is possible to configure the access point via hostname.
Quick Start Guide l l Knowing the IP address of the AP-2010 WLAN activated Important Note: AP-2010 and the computer on which the imagotag Core Service runs should be connected via Ethernet and not via WiFi, as this will result to regular failures. 5.2.2 Access Point IP Before labels are able to communication with the server at least one access point needs to be configured.
Quick Start Guide It’s possible to change the ESL channels and do activate or deactivate the Wireless ePaper system. Here you can also find the selected UDP port for the communication (port 7353 per default). FIGURE 1-20: Figure - LCOS Menu Tree - Setup - Wireless ePaper The service will listen to TCP connections on Port 8000, 8001 and 8080 and also UDP connections on Port 8000 and the port set in LCOS Menu Tree (default 7353).
Quick Start Guide FIGURE 1-22: Figure - ESL Client AP configuration - System -> Access Pont Configuration -> New Choose “Manual Configuration” and enter Access Point ID (AP ID), IP address (Host) and correct port value. FIGURE 1-23: Figure - New Access Point Configuration Note: You can find the Access Point ID under “LCOS Menu Tree – Status – Wireless ePaper” or on the backside of the Access Point, shown below.
Quick Start Guide After saving the AP configuration you should see the AP under System -> Access Point Status as ONLINE. Also the Status in the web-GUI of the LANCOM Access Point changes from State “Waiting-for-Controller-Connection” to “Running” FIGURE 1-25: Figure – Access Point and Wireless-ePaper status changes 5.2.
Quick Start Guide 5.3 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 6 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. 6.
Quick Start Guide 7 Register labels In order that labels can join the network it is necessary to register them first. 7.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 7.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 FIGURE 1-30: Register labels dialog (registered with registration code and label ID) Note: New versions of the imagotag Core Service, imagotag Control Center 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 imagotag Core Service will not accept registration codes during the registration process.
Quick Start Guide FIGURE 1-31: ESL-App Home-Screen FIGURE 1-32: ESL-App Registration Page 7.
Quick Start Guide FIGURE 1-34: Encryption status 7.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 imagotag Control Centerselect File – Unlock labels and enter the unlock key.
Quick Start Guide FIGURE 1-35: Unlock Labels Dialog Note: The unlock-code for the specific labels is enclosed in the Smart Box (in an envelope).
Quick Start Guide 8 Start tagging 8.1 What can I do now? As soon as labels are online you can do several things: Send images to labels, assign tags, show the current images, ping labels, reset labels (reset display to show label ID and label ID barcode), refresh displays, switch to a preloaded page, create a new matching (or multi-matching/multi-facing), set (extended) filters, check update logs, ... 8.2 Sending pictures to labels 1. Right click on one or more labels -> Send image… 2.
Quick Start Guide FIGURE 1-36: Article management 8.4 Matchings/Multi-Facing The logical link between articles and the label that shows the article information and price of this articles is called matching. With a matching the layout of the image rendered for the label is also defined by specifying the name of a template.
Quick Start Guide FIGURE 1-37: 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 8.5 Set (extended) filters for enums There are various filter options. Besides the known filter options you'll now have the possibility to set extended filters. Enable/disable the extended filter as shown in image below. FIGURE 1-39: Use and enable the extended filter mode With the extended filter options it's possible to set and combine several filters. Click on the drop down menu to see the different choices.
Quick Start Guide FIGURE 1-40: imagotag Control Center extended filter options 8.5.1 Extended filter operators The following operators are available: 8.5 Operator Description < Less than > Greater than <= Less than and equal >= Greater than and equal ! Negation (Not) = Equals : Defines a range (e.g. RSSI filter -65:-75 shows all labels with current RSSI value within -65 and -75) Doesn't apply to date and text.
Quick Start Guide 8.5.2 Template Editor In order to use our rendering engine you must know our template language which is basically XSL. We do also have a Template Editor with live preview, but you need a little bit time to setup everything and get familiar with it. Therefore we suggest to send pre-rendered images to labels (right-click on a label -> send image) which you can create with every image manipulation software you want (e.g. Gimp, Photoshop, Paint, …).
Quick Start Guide 8.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 45). FIGURE 1-42: Starting the Template Editor 8.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\teamplate\).
Quick Start Guide After these steps your Template Editor window should look something like this: FIGURE 1-44: Template Editor with loaded records from server and default.xsl template file 8.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 After enabling the Design Mode a new tab will show up. FIGURE 1-46: Template Editor Design Tab 8.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 9 Integration 9.1 Webservice integration 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.com/get/documentation 9.
Quick Start Guide [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 UI of the server under “Documentation”.
Quick Start Guide 80 92 because previous transmission was not finished in time Error while writing task to database Task type not supported Check database connection Upgrade AP software to process this kind of task Page 46 of 50
Quick Start Guide 1.1 imagotag Core Service Dashboard To get a better overview accross your complete ESL system you can use the new dashboard. All kind of helpful information is collected here. You'll find the dashboard under http://:/service/dashboard.xml 1.
Quick Start Guide 1.3 Where can I find the license file for my SmartBox? You find the license file (which has to be activated at the imagotag Customer and Partner Portal enclosed in the SmartBox in a "License Envelope". 1.4 Deleting the demo articles In order to prevent the example articles from being re-added to the server, go to "System Configuration" and set the "importFixtures" variable to false. 1.
Quick Start Guide If the .jar file extension is known and associated with Java, just double-click the jar file to start the application. Otherwise if the extension is not recognized: Windows: Create a shortcut of the jar file, right-click on it and open properties. Prepend “javaw.exe –jar“ to the path in the “Target” field. Double-click the shortcut. Linux: Navigate via command line to the directory where the jar file lies and execute “java –jar .
Quick Start Guide Under Windows: l Right-click on “My Computer” and select “Properties” l Click the advanced tab l Click the “EnvironmentVariables” button l Under “SystemVariables”, click New. l Enter the variable name as JAVA_HOME l Enter the variable value as the installation directory of your Java Runtime Environment l Click OK l Look for the Path variable in “SystemVariables” and edit it l Append a semicolon (;) and %JAVA_HOME%\bin to it l Click OK l ApplyChanges Under Linux: l Use the “export” command