SES imagotag EDG1-0270-B digital network transceiver User Manual My

SES-imagotag GmbH digital network transceiver My

Contents

Quick start guide

Core ServiceQuick StartGuideLast change: 25.06.2018
Core Service Quick Start GuidePage 2 of 451 Electronic Shelf Labeling – A brief introduction 52 Label Family Introduction 62.1 General Key Features 62.2 The G1 label family 72.3 The VUSION label family 73 Get the latest software and documentation 83.1 Install software 83.2 System requirements 83.3 Installation process 83.4 SES-imagotag Customer and Partner Portal 94 Core Appliance 104.1 Why is it needed in the Store? 104.2 Key Features 105 Core Appliance initial setup 115.1 USB device configuration 115.2 Front side LEDdescription 125.3 Additional documentation 126 Start SES-imagotag Core Service and SES-imagotag Control Center 136.1 Starting SES-imagotag Core Service 136.1.1 Example articles 136.2 Starting SES-imagotag Control Center 146.2.1 SES-imagotag Control Center Login 156.3 Activating your license 157 ESL Access Point Configuration 177.1 Connect and configure AP-2010 177.1.1 Connect and configure 177.1.2 Discover the Access Point 177.1.3 Necessary configuration over the AP-2010 web UI 187.1.4 Necessary configuration at the SES-imagotag Control Center 197.1.5 The Status LED 197.2 Connect and configure LANCOM access point 207.2.1 First configuration steps 207.2.2 Access Point IP address 207.2.3 Configuration: Wireless ePaper 217.2.4 LCOS Menu Tree 217.2.5 Setup – Wireless ePaper 217.2.6 Status – Wireless ePaper 227.2.7 Necessary configuration at the SES-imagotag Control Center 227.2.8 Automatic channel selection 238 Selecting channels 259 Setup Security 26
Core Service Quick Start GuidePage 3 of 459.1 General encryption features and how does it work 269.2 Set the encryption key 2610 Register labels 2710.1 General procedure 2710.2 What's on the label? 2710.2.1 Registration page vs. Reset page 2810.3Handheld terminals, USB barcode scanner and SES-imagotag Core Service iOS-App 2910.4 Encryption status 2910.5 Unlocking labels 3011 Start tagging 3111.1 What can I do now? 3111.2 Sending pictures to labels 3111.3 Article management 3111.4 Matchings/Multi-Facing 3211.5 Set (extended) filters for enums 3311.5.1 Extended filter operators 3312 Templates 3512.1 General information about templates 3512.2 SES-imagotag Template Editor 3512.2.1 Starting SES-imagotag Template Editor 3512.2.2 Open default template file and load records from server: 3612.2.3 Design Mode 3712.2.4 Enable and show color red 3812.2.5 Help Content 3813 Integration 3913.1 Webservice integration 3913.2 Plugins 3913.3 Custom integration 3914 Troubleshooting 4014.1 SES-imagotag Core Service Dashboard 4114.2 Running the SES-imagotag Core Service as a background service 4114.3 Where can get a demo/development license key? 4114.4 Deleting the demo articles 4214.5 Establish a network configuration when no DHCP is available – Step by step 4214.6 Access point discovering with Bonjour Services 4214.7 What can I do if the Status LED of the AP-2010 access point doesn’t turn blue? 4314.8 Labels don’t come online 4314.9 The encryption does not work 4314.10 Unlocking labels 4314.11 Starting Java applications 4314.12 Encoding problems 44
Core Service Quick Start GuidePage 4 of 4514.13 Reserve RAM for Java heap space 4414.14 Further documentation 45
Core Service Quick Start GuidePage 5 of 451 Electronic Shelf Labeling – A brief introductionAn electronic shelf label is a device that shows article data and price information on its display. Incomparison to printed labels the information is automatically updated if price or article data changes.lCost reduction through elim-ination of manual pricechangeslFully automatic price updatesfrom the headquarters to thebranch stores within secondslProcess security and priceintegrity – 100% correlationbetween cash point and shelflIncreased flexibility in pricedesign and immediate reactionto market situation Image gaindue to use of highly moderntechnologylSimplified processes for storepersonnellEnhanced sales & price prof-itability maximize price per-formance and profitopportunities
Core Service Quick Start GuidePage 6 of 452 Label Family IntroductionIn general the SES-imagotag electronic shelf label family offers high-quality display options, operatingwith 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 theUSA and Canada the AP-2010 usa/canada bundle incl. antenna with limited data efficiency isrequired (based on the FCC/ICregulation).2.1 General Key Featuresl2.4 GHz proprietary radio protocollRadio coverage: up to 25 meterslBi-directional communicationl11 available communication channelslUltra-low power consumptionlCustomer-replaceable batterylFull graphical e-Ink display with paper-like readabilitylSuper wide viewing angle (nearly 180 degrees)lFlexible mounting options availablelMay be used in landscape and portrait modelFast response time (less than 15/30 seconds, depends on wakeup timelWater resistantl128-bit AES encryption with secure key exchangelMultiple pages support with preloading and fast page switchinglIntegrated NFCtaglG1 - Passive NFClVUSION - "Active" NFC
Core Service Quick Start GuidePage 7 of 452.2 The G1 label familyThe SES-imagotag G1 BWR label family is capable of changing all pixels to black, white or red. Thecurrent line-up has display sizes from 1.6 inch to 12.2 inch.Caption Display Res-olutionDensity(dpi)DisplayColorsUseablePagesActive Dis-play Area(mm)Updates/hour/AP(standard /FCC&IC mode)Battery life-time: 5years withN updatesper dayG1 1.6 BWR NFC 152 x 152 140 b/w/r4* 27.5 x 27.5 7500/4600 1G1 2.2 BWR NFC / Bossard2.2 red NFC 212 x 104 111 b/w/r4* 48.6 x 23.8 8500/5000 2G1 2.6 BWR NFC 296 x 152 125 b/w/r4* 60.1 x 30.7 4500/2600 2G1 2.7 BW NFC 264 x 176 117 b/w 8* 57.3 x 38.2 5000/2700 4G1 2.7 BWR NFC 264 x 176 117 b/w/r4* 57.3 x 38.2 4500 2G1 4.2 BW NFC 400 x 300 120 b/w 4* 84.8 x 63.6 3000/1600 4G1 4.2 BWR NFC 400 x 300 120 b/w/r4* 84.8 x 63.6 2000/1300 2G1 4.5 BW NFC 480 x 176 117 b/w 4* 104.2 x 38.2 4300 4G1 4.5 BWR NFC 480 x 176 117 b/w/r4* 104.2 x 38.2 2500/1500 2G1 6.0 BWR NFC 600 x 448 129 b/w/r4* 114.9 x 85.8 900/500 2G1 7.4 BW NFC 480 x 800 126 b/w 12* 97 x 161.6 1000/500 8G1 7.4 BWR NFC 480 x 800 126 b/w/r4* 97 x 161.6 600/300 2G1 12.2 BWR NFC 768 x 960 103 b/w/r6* 190.08 x237.60 300/150 2S-tag 6 HFNFC - - b/w 4 53 x 19.3 20000/20000 4*One useable page is shared with the registration code page. This page is initially shown when thelabel is shipped. After registration this page can be used as a custom page. To restore the originalcontent a service utility is required. To prevent accidentials overwrite this page is protected. To unlockthis 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 familyThe SES-imagotag VUSION (2.4GHz) 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 7.4 inch.Caption Model DisplayResolutionDensity(dpi)DisplayColorsUseablePagesActive DisplayArea (mm)Updates/hour/AP(standard /FCC&IC mode)Batterylifetime: 5years withNupdatesper dayVUSION 1.6 EDG2-0160-A 152 x 152 140 b/w/r4 27.5 x 27.5 7500/4600 1VUSION 2.2 EDG2-0220-A 212 x 104 111 b/w/r4 48.6 x 23.8 8500/5000 2VUSION 2.2 F EDG2-0220-A 212 x 104 111 b/w 4 48.6 x 23.8 10000/6500 1VUSION 2.6 EDG2-0260-A 296 x 152 125 b/w/r4 60.1 x 30.7 4500/2600 2VUSION 2.6 F EDG2-0260-A 296 x 152 125 b/w 4 60.1 x 30.7 6500/4500 1VUSION 4.2 EDG2-0420-A 400 x 300 120 b/w/r4 84.8 x 63.6 2000/1300 2VUSION 7.4 EDG2-0740-A 480 x 800 126 b/w/r4 97 x 161.6 600/300 2The content of all pages except page number 0 won't remain after a firmware update.
Core Service Quick Start GuidePage 8 of 453 Get the latest software and documentationRegister at the SES-imagotag Customer and Partner Portal to get access to the latest software anddocumentation.https://portal.imagotag.com3.1 Install softwareThere’s several software you’ll have to install in order to configure and setup your ESL system. You’lljust 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 Template Editor <template.zip>3.2 System requirementslServer hardware: Pentium 4 (2 GHz or higher), 2 GB RAMlJava Runtime Environment Version 6, Update 36 or higherlWindows XP, Windows 7, Windows Server 2008 (R2), Windows 10, Suse Enterprise Linux11, Ubuntu 12 (all 32/64-bit versions), Mac OS XlSES-imagotag Core ServicelSES-imagotag Access Point(s)lSES-imagotag Label(s)lLicense key3.3 Installation processPlease 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-files you can either use the windows internal archive-unpacker (seescreenshots) 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 #1After unpacking all 3 archives, your folder should look something like this:
Core Service Quick Start GuidePage 9 of 45FIGURE 1-3: Unpacked imagotag software folderThe SES-imagotag Core Service is now installed and you can step forward to point see Start SES-imagotag Core Service and SES-imagotag Control Center on page 13.3.4 SES-imagotag Customer and Partner PortalAfter user registration and activation you will have access to documentation.You can activate, manage and download your SES-imagotag software licenses see Start SES-imagotag Core Service and SES-imagotag Control Center on page 13.Your user account will not be assigned to a customer account yet. Ask our sales backoffice team foruser assignment (sales.at@ses-imagotag.com).
Core Service Quick Start GuidePage 10 of 454 Core ApplianceThe Core Appliance is a compact network device which can be used to run the SES-imagotag CoreService in the store, instead of using an additional dedicated server. The SES-imagotag Core Serviceis always needed in the store locally, also when cloud-based/centralized middleware systems likeJeegy S3 Centralized/Jeegy Cloud or Bison ESL Manager is used.4.1 Why is it needed in the Store?lContinuous communication with access points and labels is required (even without tasks)lLimited bandwidth between store and headquarterslDisconnected VPN connection will prevent proper operationlLoad (image rendering…) is distributed to stores4.2 Key FeatureslCore Appliance is optimized to run up to 30 000 labels and 7 access pointslEasier and faster shop installations (“Plug and Play”)lIs not recognized as an additional serverlLow maintenancelEasy replace/restore when hardware crasheslLimited deployment variabilitieslLower development costslLower support costslBetter brand recognitionlEasier to sell as a “solution in a box”lLess overall risk for system integrators
Core Service Quick Start GuidePage 11 of 455 Core Appliance initial setupTo operate the Core Appliance there are only a few steps necessary:1. Supply with power2. Turn it on (button on the backside of the device)3. Plug it into your network4. Initial setup5. Update to the latest versionPer default, the Core Appliance comes with DHCPenabled. So if you have a DHCPservice runningyou 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 aconfiguration file to configure the appliance initially.FIGURE 1-4: Core Appliance rear view5.1 USB device configurationYou can find an example configuration file (example.config) at ourSES-imagotag Customer andPartner Portal.Core Appliance service reference mode |Core Appliance example.config fileAfter downloading, editing and copying the configuration file onto any USBdevice, the configurationis automatically adopted after plugging in the USB flash drive into the Core Appliance. A triple beepindicates the successful configuration. A single beep signals that the configuration hasn't been setsuccessful.Theweb user interface of the Core Appliance is now available under http://<ip-address>.The initial configuration of the Core Appliance can be compared with the installation and start of anSES-imagotag Core Service. After configuration, you can access the Core Appliance via the SES-imagotag Control Center from every system connected to your network (see Starting on page 1).Example.config fileTo set up your Core Appliance for the first run you'll have to set at least the following networkparameters:lIPaddresslSubnet masklOptional: Gateway, DNSTo set the parameters mentioned above the contents of the configuration file might look like this:# Set IP address of bridge interfaceset network br0 192.168.1.100 255.255.255.0# Set a gateway
Core Service Quick Start GuidePage 12 of 45set gateway 192.168.1.1# Set a nameserverset dns 192.168.1.21Note:This simple bridge configuration connects the network interfaces. No matter where the networkcable is plugged in, the appliance is accessible via the configured bridge address.5.2 Front side LEDdescriptionOn the front side of the appliance you can see several status information:Core Appliance front view LEDstatus information (Core Appliance version 1.8.0 or higher)Upper LED:Power onLower LED: Core Appliance is activeUpper LED: OFF=service not running | Flashing=restart or softwareupdate in progress | ON=serviceLower LED: OFF=no internet connection | Slow flashing=no VPNconfiguration | Fast flashing=VPN not connected | ON=VPN connectedrunningUpper LED: Port in use (color based on transfer rate)Lower LED: Port/Device is active5.3 Additional documentationYou can find additional documentation regarding the Core Appliance (e.g. a complete service modereference) on our SES-imagotag Customer and Partner Portal.
Core Service Quick Start GuidePage 13 of 456 Start SES-imagotag Core Service and SES-imagotag ControlCenter6.1 Starting SES-imagotag Core ServiceIf you've recently configured yourCore Appliance the SES-imagotag Core Service software is alreadyrunning 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 thewindow doesn’t show up after all, make sure your Java installation and configuration is correct).FIGURE 1-5: Core Service web UIThe SES-imagotag Core Service will listen to TCP connections on Port 8000 and8001 and UDP connections on Port 8000. Please make sure that there is no firewallissue 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>:8000Login: admin/adminDuring the first start the SES-imagotag Core Service will automatically create a Derby1database. Ifanother database connection is needed or preferred, the connection parameters should be validatedby SES-imagotag GmbH.Note: As you can see there are several level numbers. You can find the description of the differentlevels in the Developer Reference (which is also part of the documentation available at the SES-imagotag Customer and Partner Portal) under “Integration Levels”.6.1.1 Example articlesFor easier usage some example articles can be preloaded at the time you start the SES-imagotagCore Service. You can find the corresponding XMLarticle data here: C:\ses-imagotag-core-service\server\data\fixtures\.1Apache Derby, an Apache DB subproject, is an open source relational database implemented entirely inJava
Core Service Quick Start GuidePage 14 of 45To enable and disable the preloading of these fixtures go to the system configuration and set thecorresponding property "importFixtures"true or false.Note: The article records are based on the XML-standard.6.2 Starting SES-imagotag Control CenterGo to the extracted directory and execute the “client.jar” file.FIGURE 1-6: Starting SES-imagotag Control CenterThe SES-imagotag Control Centeris configured to connect to a server on the local machine perdefault. In order to change this to a remote machine in a network you have to start the SES-imagotagControl Center with an additional parameter:WindowslCreate a shortcut/Edit existing short cutlRight click to the shortcut and select "Properties"lAppend “ --host hostnameOrIPAddress” at the end of the “Target” field. (Note: The text toappend starts with an space and there are 2 hyphens to add!)LinuxlAppend “ --host hostnameOrIPAddress” at the end of command (e.g. “java -jar client.jar --host192.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
Core Service Quick Start GuidePage 15 of 456.2.1 SES-imagotag Control Center LoginlUsername: adminlPassword: adminFIGURE 1-8: SES-imagotag Control Center Login6.3 Activating your licenseAfter starting the SES-imagotag Core Service and SES-imagotag Control Center it's necessary toactivate the license key which is included in the "Software License Document". To view your currentlicense status there's a License status dialog. You can find it in the SES-imagotag Control Centerunder "Help - License status". Since no license is activated/imported yet the window should looksimilar to this:FIGURE 1-9: License Status DialogCopy the "System serial" to the clipboard (STRG+Cor right click "Copy to clipboard")and then clickthe "License activation". You'll be automatically redirected to the SES-imagotag Customer andPartner Portal https://portal.imagotag.com.Please log in (or register a new user). After log in, you can see a summary of already activatedlicenses and/or activate a new license. Click "activate new license".Fill in "License key", copy/paste the "System serial"(from the "License Status"dialog), add aComment (optional) and click the "Activate"button.
Core Service Quick Start GuidePage 16 of 45FIGURE 1-10: Activate License (SES-imagotag Customer and Partner Portal)Download the generated license file and complete the licensing process by importing the license fileto your ESLsystem. With the successful activation of your license you're now able to register labelsand add ESL access points.FIGURE 1-11: Import of license file downloaded beforeNote: Press "F5"(after 15 seconds) to update the license status after license file import.Fore more details about the licensing mechanism see Per-server licensing from version 1.4.0 on page1
Core Service Quick Start GuidePage 17 of 457 ESL Access Point ConfigurationThe ESL access points AP-2010, MAP-2014 T/LANCOM L-151E and LANCOM LN-830E are thecommunication center in the store that transmits information to the labels. In order to ensure thecommunication between SES-imagotag Core Service, access point(s) and the labels the accesspoints have to be configured at the start of the SES-imagotag Core Service.7.1 Connect and configure AP-20107.1.1 Connect and configureBefore labels are able to communication with the SES-imagotag Core Service at least one ESLaccess point needs to be configured. In standard configuration the AP-2010 gets an IP-address viaDHCP (recommended) and is accessible via imagotag AP-2010 web UI:URL: http://<host|ip>:8080Login: admin/adminImportant Note: In this part of the Core Service Quick Start Guide it is assumed that a DHCP server ispresent (you can find the steps to discover the access point without DHCP in the Troubleshootingsection - see Establish a network configuration when no DHCP is available – Step by step on page 427.1.2 Discover the Access PointBefore you can configure the ESL access point it’s necessary that it will be discovered.The following points have to be observed:lConnect your machine to the same network as the APlPlug in the power supply of the access pointlDuring the boot process of the access point, start the SES-imagotag Core Service software onthe computerlWhen the access point is up (LEDturns orange), the SES-imagotag Core Service will discoverit with an IP address (Note: The discovering process may take up to 2 minutes)lUse the SES-imagotag Control Center to connect to your SES-imagotag Core ServicelUnder System – Access Point Status – the AP should be listed as discovered (after successfulboot sequence)
Core Service Quick Start GuidePage 18 of 45FIGURE 1-12: List of discovered ESL access pointsNow you’re able to configure the ESL access point via AP-2010 web UI under http://<DHCP-IP-address> or a right click on the discovered AP –> Open in browser....In the status overview you get some details about the AP-2010:FIGURE 1-13: AP-2010 Status overviewIt’s recommended for the demo installation not to use the “Centralized Configuration” feature andconfigure the AP manually.7.1.3 Necessary configuration over the AP-2010 web UIThe following actions need to be performed over the AP-2010 web UI1. Deactivate Centralized Configuration: Administration -> Configuration Mode2. Set up network details (or leave DHCP): Administration -> Network3. Set up an ESLchannel: Administration -> Wireless Channel
Core Service Quick Start GuidePage 19 of 45The AP-2010 supports 11 ESL channels. It’s recommended to choose one of therecommended channels: 3, 5, 8, 9 or 10. These channels do not interfere withstandard Wi-Fi channels 1, 6, 11 and are scanned by the labels more often. Forfurther information about selecting channels see point see Selecting channels onpage 25.7.1.4 Necessary configuration at the SES-imagotag Control CenterAfter the configuration in the AP-2010 web UI it’s necessary to add this AP via the SES-imagotagControl Center: System – Access Point Configuration – New … or right click on a discovered AP-Create configuration.FIGURE 1-14: SES-imagotag Control Center System - Access Pont Status - Create configurationChoose “Manual Configuration” if you don’t use Centralized Configuration and enter Access Point ID(AP ID) and IP address (Host).Note: After the basic configuration in the AP-2010 web UI, it is also possible to fill in AP-ID and AP-IPaddress 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 asONLINE. In addition the AP status LED should turn BLUE.Note: It is possible to configure the access point via hostname. To get this working there has to be acorresponding entry in the DNS.7.1.5 The Status LEDThere are several LED colors that indicates the main status of the access point.
Core Service Quick Start GuidePage 20 of 45Color Description NoteRed Boot processCan take about 2 minutes, if it takes much longer,the device is defective and there is a need forservice.Blue Normal mode ---YellowOperational, but notconnected to any server orno channel selected---Red (blinking) Running Firmware Update During this time there is no connection to theelectronic labelIf there are any problems regarding the ESL access point please see chapter see Troubleshooting onpage 40.7.2 Connect and configure LANCOM access pointThe LANCOM access point with Wireless-ePaper is the communication center in the store thattransmits price information to the labels. In order to ensure the communication between SES-imagotag Core Service, access point and the labels the LANCOM access point with Wireless-ePaperhas to be connected after the start of the SES-imagotag Core Service.One way to configure the access point is on the client.7.2.1 First configuration stepsAs described in the Installation Guide (printed version included in the package) you’ll have toconfigure the basic settings before setting up Wireless-ePaper using the SES-imagotag CoreService.1. Installing the software or configuration using a web browser and setup wizards2. Deploying and connecting the device3. Searching for and configuring the deviceAfter setting up the basic settings the following points have to be fulfilled:lKnowing the IP address of the LANCOM access pointlWLAN activatedImportant Note:LANCOM access point and the computer on which the SES-imagotag Core Serviceruns should be connected via Ethernet and not via Wi-Fi, as this will result to regular failures.7.2.2 Access Point IP addressBefore labels are able to communication with the SES-imagotag Core Service at least one accesspoint needs to be configured. After setting up the basics you should know the IP address of yourLANCOM access point:URL: http://<LANCOM-IP-address>Login with the password set before.
Core Service Quick Start GuidePage 21 of 45FIGURE 1-15: LANCOM Web GUI Login7.2.3 Configuration: Wireless ePaperUnder “Configuration – Wireless ePaper” you can check whether the module is activated or not. Youcan also select an ESL channel or leave the “Automatic selection” .FIGURE 1-16: Configuration - Wireless ePaperThe LANCOM access point supports 11 wireless ESL channels. It’s recommendedchoose one of the recommended ESL channels: 3, 5, 8, 9 or 10 first. Thesechannels are scanned by the labels more often.7.2.4 LCOS Menu TreeHere you’ll find the necessary information for the SES-imagotag Core Service Access PointConfiguration settings.7.2.5 Setup – Wireless ePaperNavigation: “LCOS Menu Tree – Setup – Wireless ePaper”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-17: LCOS Menu Tree - Setup - Wireless ePaperThe SES-imagotag Core Service will listen to TCP connections on Port 8000, 8001and also UDP connections on Port 8000 and the port set in LCOS Menu Tree(default 7353). Please make sure that there is no firewall issue and/or interferencewith other systems.
Core Service Quick Start GuidePage 22 of 457.2.6 Status – Wireless ePaperNavigation: “LCOS Menu Tree – Status – Wireless ePaper”After configuration you can see a summary of your Wireless ePaper settings underFIGURE 1-18: LCOS Menu Tree - Status - Wireless ePaper7.2.7 Necessary configuration at the SES-imagotag Control CenterAfter the configuration in the LANCOM web user interface it’s necessary to add this AP via the SES-imagotag Control Center: System -> Access Point Configuration -> New … when the accesspoint is discovered via System -> Access Point Status, right click on the discovered access pointand create the configuration.FIGURE 1-19: SES-imagotag Control Center - System - Access Point Configuration - NewChoose “Manual Configuration” and enter Access Point ID (AP ID), IP address (Host) and correctport value.
Core Service Quick Start GuidePage 23 of 45FIGURE 1-20: New Access Point ConfigurationNote: You can find the access point ID under “LCOS Menu Tree – Status – Wireless ePaper” or onthe backside of the access point, shown below.FIGURE 1-21: Wireless ePaper AP-ID on the backside of the access pointAfter saving the AP configuration you should see the AP under System -> Access Point Status asONLINE. Also the Status in the web-GUI of the LANCOM access point changes from State “Waiting-for-Controller-Connection” to “Running”FIGURE 1-22: Access point and Wireless-ePaper status changes7.2.8 Automatic channel selectionIf you don’t want the access point(s) to decide the channels (Automatic selection) automatically anESL channel must be selected on each access point in the network. There are 11 non overlapping
Core Service Quick Start GuidePage 24 of 45ESL channels reserved for the communication with the labels. Five of these ESL channels do notinterfere with typical Wi-Fi installations and should therefore be favored. These are the ESL channels3, 5, 8, 9 and 10 and they should be selected if there is a Wi-Fi installation on the Wi-Fi channels 1, 6and 11.FIGURE 1-23: Visualization of ESL channels vs. Wi-Fi channelsWarning: Do not select the same ESL channel on two access points within one area. This will causeinterferences and avoids labels from joining the network. The same ESL channel may only beselected on two access points if it can be guaranteed that every label is within the range of only one ofthese access points.
Core Service Quick Start GuidePage 25 of 458 Selecting channelsFor a working installation an ESL channel must be selected on each ESL access point in the network.There are 11 non overlapping ESL channels reserved for the communication with the labels. Five ofthese ESL 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-Fiinstallation on the Wi-Fi channels 1, 6 and 11.FIGURE 1-24: Comparison between common used Wi-Fi and ESLchannelsIf there is a Wi-Fi installation operating at 2.4 GHz (IEEE 802.11 b/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 leastoverlapping with the existing installation. If there is no ESL channel without any overlapping both theESL and existing installation should still work but there might be a reduced overall speed in bothinstallations.Warning: Do not select the same ESL channel on two access points within one area. This will causeinterferences and avoids labels from joining the network or being updated. The same ESL channelmay only be selected on two access points if it can be guaranteed that every label is within the rangeof only one of these access points.
Core Service Quick Start GuidePage 26 of 459 Setup SecurityThe security concept is based on individual registration codes for each label. Not only that the newconcept simplifies installations, it also provides stronger encryption and a secure key exchange withindividual communication key derived from a user defined network key.9.1 General encryption features and how does it worklSolid improved safetylEncrypted data type AES128 (Advanced Encryption Standard)lUser defined 128 bit network key for each installationlKey is distributed to labels automaticallyThe system requires a user defined 128 bit network key for each installation. The key is derived from apassphrase that is defined by the customer and stored in the SES-imagotag Core Service and usedby all ESL access points connected to that SES-imagotag Core Service to encrypt datacommunication to the labels.A per-label communication key is transmitted to the labels during the registration of them. Each labelis assigned an individual registration code (it combines label ID and PIN code and it’s analphanumeric case-sensitive code with 11 characters). The SES-imagotag Core Service will thanautomatically start the key exchange with the label secured by the PIN extracted from the registrationcode.9.2 Set the encryption keyFirst step is to set the parameter “encryptionPassphrase“under System – Configuration (you canchoose the encryption passphrase on your own).FIGURE 1-25: Set encryption keyNote: Do not change encryption passphrase if labels are already connected and encrypted (if youwant to change the encryption passphrase you’ll first have to unlock all labels – see Troubleshootingon page 40).
Core Service Quick Start GuidePage 27 of 4510 Register labelsIn order that labels can join the network it is necessary to register them first.10.1 General procedureVia the SES-imagotag Control Center under File – Register Labels it’s possible to register your labelsmanually with the registration code shown on each single label or you could import a CSV file withyour registration codes.Important Note: After the registration it could last a certain time until all registered labels are joined tothe network (from 30 minutes up to two hours, depending on configured ESL channels). After this youcan send images to each label (see Start tagging on page 31).FIGURE 1-26: Add/Delete Label and refresh entries10.2 What's on the label?All labels will arrive with its registration code (11-digit alphanumeric)shown on the display of the label.The code is printed as a 2D QR code, as a 1D Code128 barcode and as human readable text. Theregistration process for the customer is easy – he has only to scan one of the barcodes. The SES-imagotag Core Service will than automatically start the key exchange with the label secured by thePIN extracted from the registration code.The two relevant codes:1. The label ID (8-digit hexadecimal) to identify the label (it's also the radio address which issimilar to a MAC address).2. The registration code (11-digit alphanumeric) is required to activate the encryption. Thiscode also contains the label ID and a random PIN code.
Core Service Quick Start GuidePage 28 of 4510.2.1 Registration page vs. Reset pagePage Layouts G1 4.4Layout when shippedRegistration Page LayoutNote:The label ID can only be read and will not bedisplayed as barcode in this layout.Layout after successful registrationReset Page LayoutNote: After successful registration, the AES key isexchanged for encryption and the label switch to a pagewhere only the label ID is displayed as 1D Code128barcode.The sticker (on the bottom and on the back) always contain only the label ID and therefore should notbe used for registration if the encryption will be used. They are only intended for the later articleassignment (matching process).Here you can see the registration dialog in the SES-imagotag Control Center where one single labelhas been entered with the registration code (Pin =yes - security enabled)and the other one with thelabel ID (for old label versions < 3.0.0, Pin =no, no secured communication).FIGURE 1-27: Register labels dialog (registered with registration code and label ID)
Core Service Quick Start GuidePage 29 of 45Note: New versions of the SES-imagotag Core Service, SES-imagotag Control Center and AP-2010 (≥ 1.3.0) will also support old labels that do not come with a pre-programmed PIN code. Newlabels (≥ 3.0.0) will also work in old installations together with old labels but the SES-imagotag CoreService will not accept registration codes during the registration process. To register the labels it isrequired to scan the barcode with the label ID from the backside or the bottom edge of the label. Asthe SES-imagotag Core Service will not start the key exchange all data is transmitted unencrypted tothe labels.10.3 Handheld terminals, USB barcode scanner and SES-imagotag Core ServiceiOS-AppIt’s also possible to register labels with a commercial USB barcode scanner (2D/1D). You can alsouse the SES-imagotag Core Service iOS-App (for iPhone and iPod touch [only available onrequest]).Handheld terminals are mobile devices that are used to manage the ESL installation. If the handheldprovides a barcode scanner, it may be used easily to link articles and labels by scanning the articlebarcode (usually EAN, UPC or GTIN) and the unique ID of the label.Here you can see some screenshots of our SES-imagotag Core Service iOS-App:FIGURE 1-28: ESL-App Home-ScreenFIGURE 1-29: ESL-App RegistrationPageFIGURE 1-30: ESL-App MatchingPage10.4 Encryption statusHere are the encryption status a label could have:lAES: Communication with label is encrypted with 128 bit AESlNo PIN: Could not set encryption key as no PIN (registration code) was providedoSolution: Re-register label with registration codelKey unset: Communication is NOT yet encryptedoSolution: Set encryption passphrase and ping the label to start the encryption processlUnsupported: Encryption is not supported by label firmwarelUnknown: Security status is not determined yet
Core Service Quick Start GuidePage 30 of 45FIGURE 1-31: Encryption status10.5 Unlocking labelsIf the label was registered and a communication key was set it will no longer work in other networksusing a different network key passphrase. To unlock this labels for other networks an unlock code isrequired. The unlock code is similar to the registration code - it is a combination of the label ID and a128 bit PUK code.Via SES-imagotag Control Center select File – Unlock labels and enter the unlock key.FIGURE 1-32: Unlock Labels Dialog
Core Service Quick Start GuidePage 31 of 4511 Start tagging11.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 displayto show label ID and label ID barcode), refresh displays, switch to a preloaded page, create a newmatching (or multi-matching/multi-facing), set (extended)filters, check update logs, ...11.2 Sending pictures to labels1. Right click on one or more labels -> Send image…2. Select a picture (Note: Display size must match the resolution of the image)A. In the right pane, a priority (currently not relevant) could be set for the task, as well as thepage to which the image should be sent and whether the image is preloaded.B. If preloaded, the image is placed in the memory of the label, but not yet displayed. Theimage change will only be performed after the change to the relevant page. This allowsfor each label that images are cached on the various pages and be accessed quickly byswitching to the relevant page.3. By clicking on “open” the corresponding task(s) for the label(s) will be created and the transferbegins.11.3 Article managementFor complete management of your articles select Articles – All Articles in the SES-imagotagControl Center. Here you’re able to create/delete and edit your articles.The Smart Box Package comes with some predefined articles which you can see here. You can addsome more demo articles, edit the existing ones or just step further to the next point Matchings.FIGURE 1-33: Article management
Core Service Quick Start GuidePage 32 of 4511.4 Matchings/Multi-FacingThe logical link between articles and the label that shows the article information and price of thisarticles is called matching. With a matching the layout of the image rendered for the label is alsodefined by specifying the name of a template.In a more technical way a matching is the triple of:lLabel IDlArticle number(s) or GTINlName of the template fileNote: Only one matching per label is allowed but articles may be matched to more than one label.Select File – New matchings to open the dialog where you can select the desired data records andcreate a number of matchings at the same time. To generate a multi-matching, multiple articlenumbers separated with a comma have to be specified. Keep in mind that your template has to beable to render a image for multiple articles.FIGURE 1-34: New matchings dialogAnother way to create/edit matchings is under “Matchings – All Matchings”:lSelect the desired data records (Label ID, Article Number) in the following window “New Match-ing Record“(either manually or with the magnifying glass symbol). Select an appropriate tem-plate via “Template” that should be used to generate the image.lConfirm your choice by clicking Save. After that, the generated image is sent to the selectedlabel.FIGURE 1-35: Create a matching
Core Service Quick Start GuidePage 33 of 45It’s also possible to create Matchings with SES-imagotag Control Center under Labels and Articles,for this just select the desired article or label, right-click on it and select “New matching…” (the newmatching dialog will be pre-filled with the article or label information).11.5 Set (extended) filters for enumsThere are various filter options. Besides the known filter options you'll now have the possibility to setextended filters. Enable/disable the extended filter as shown in image below.FIGURE 1-36: Use and enable the extended filter modeWith the extended filter options it's possible to set and combine several filters. Click on the drop downmenu to see the different choices.FIGURE 1-37: SES-imagotag Control Center extended filter options11.5.1 Extended filter operatorsThe following operators are available:
Core Service Quick Start GuidePage 34 of 45Operator 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 currentRSSIvalue within -65 and -75) Doesn't apply to date and text.
Core Service Quick Start GuidePage 35 of 4512 TemplatesThe template is used to specify the fields, which should be rendered into the image. The SES-imagotag Core Service can handle multiple templates.12.1 General information about templatesThe image rendering process is based on XSL (EXtensible Stylesheet Language) templates. Theindividual image for the label is then generated by applying the template to a XML, which is based onthe properties of the label and is expanded by a custom XML from the user.The following steps are executed when processing a template:lGenerating a record XML based on the label/task information and custom information providedby the userlApplying the template (XSL) on the generated record XML. This results in a document con-taining the fields, specified in this reference and values referenced from the XMLlRendering the image (*.PNG) based on the previous outputFIGURE 1-38: Input and result of the rendering process12.2 SES-imagotag Template EditorIn order to use our rendering engine you must know our template language which is basically XSL.We do also have a SES-imagotag Template Editor with live preview, but you need a little bit time tosetup 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 softwareyou want (e.g. Gimp, Photoshop, Paint, …). You can even take some pre-rendered images from usfor each label type with the correct resolution as a template – you’ll find some in the SES-imagotagControl Center’s directory under data/images.12.2.1 Starting SES-imagotag Template EditorNavigate to the unpacked SES-imagotag Template Editor (see point Get the latest software anddocumentation on how to unpack the software package) and execute the “template.jar” file (seeTroubleshooting on page 40).
Core Service Quick Start GuidePage 36 of 45FIGURE 1-39: Starting the SES-imagotag Template Editor12.2.2 Open default template file and load records from server:lOpen the SES-imagotag Template Editor by clicking the “template.jar” file located in the tem-plate-directory (In our example it should be C:\imagotag\teamplate\).lNext step is to create a new template file or to open an existing one (The default.xsl templatefile is located in the server-directory under C:\imagotag\server\data\template\).lTo get a live preview you’ll have to load some records, in our case we load the demo articlerecords from our running server, see the following figure.FIGURE 1-40: Load Records from Server
Core Service Quick Start GuidePage 37 of 45After these steps your SES-imagotag Template Editor window should look something like this:FIGURE 1-41: SES-imagotag Template Editor with loaded records from server and default.xsl template file12.2.3 Design ModeYou can enable the graphical mode of the SES-imagotag Template Editor by selecting Settings –Configuration – tick Enable Design Mode and finally the Save-button. The Design Mode can beused for creating very simple templates. If you want to use for example conditions in your template,you cannot use the design mode and you should start from zero without the design mode of the SES-imagotag Template Editor.FIGURE 1-42: Enable Design Mode in SES-imagotag Template Editor
Core Service Quick Start GuidePage 38 of 45After enabling the Design Mode a new tab will show up.FIGURE 1-43: SES-imagotag Template Editor Design Tab12.2.4 Enable and show color redAs there are label types which are capable of showing the color "red"there's a short description howto enable this inside the xsl template file.lOptional: Query whether it is a "red" labell<xsl:when test="Label/DisplayWidth = XXX and Label/DisplayHeight =XXX and Label/DisplayColors = 'BLACK_WHITE_RED'">lAdd colors option to image tag:l<image width="XXX" height="XXX" colors="true" font-family="XXX">lShow something in color red, e.g. text:l<text font-size="XXX" condense="XXX" font-weight="XXX" color=”red”>12.2.5 Help ContentThere’s a link to the Help content for the SES-imagotag Template Editor, open it by clicking Help –Help Content in the SES-imagotag Template Editor or open the file index.html located inC:\imagotag\template\help\.Also you can find further information on the USB Stick under Documentation - Image RenderingReference.
Core Service Quick Start GuidePage 39 of 4513 Integration13.1 Webservice integrationThe SES-imagotag Core Service provides access to its interfaces methods through a RESTful webservice API. The web service is designed according to the “Representational State Transfer” (REST)architectural pattern.The SES-imagotag Core Service listens for incoming HTTP web service requests on the TCP port8001 by default.You can find further information and documentation about the webservice integration online underhttps://portal.imagotag.com/get/documentation13.2 PluginsWe provide several plug ins which are used for importing article information into the SES-imagotagCore Service.You can find further information and documentation about our integration plugins online underhttps://portal.imagotag.com/get/documentation13.3 Custom integrationFor custom integration we provide a Plugin-Interface. Software development service is available fromSES-imagotag software development team or third-party integration partners.For pricing get in touch with our sales team (sales.at@ses-imagotag.com).
Core Service Quick Start GuidePage 40 of 4514 TroubleshootingIf you run into any errors during connecting or sending images to labels, please refer to thedocumentation included in the SES-imagotag Core Service. This documentation can be found in theAP-2010 web UI of the SES-imagotag Core Service under “Documentation”.lFor problems updating the labels (error code column in labels window) refer to “Update ErrorCodes” or (task status column in labels window) refer to “Task Status”lFor connection status problems refer to “Connection Status”lFor label hardware errors (label error column in labels window) refer to “Label Error Codes”Code Problem Solution1 Label not licensed The label is not licensed. Import the proper license filefor the label or check for typos in the label id.3 Label not registered The label may have been deleted or has never beenregistered at all. Register label.10 Image does not match display sizeThe size of the image does not match the label’s displaysize. Please check the width and height of your imageand look up the display size in pixels for the label.These sizes have to be equal.11 Error during image rendering Check template (wrong or faulty)12 Error during image conversion Change format of the image to standard format (e.g.PNG or BMP)13 Invalid page Page not supported by label type, choose a differentpage14Could not process task becausethere are unfinished tasks waiting forthis labelAbort task or wait until unfinished tasks are finished20 Template not found Check template directory for missing template file21 Error during template parsing Correct template file (Invalid content found)22 Error during content documentcreation Check server and article record configuration30Could not send update becauselabel has insufficient power toperform the updateThe power status of the label is “Bad”, which means it isvery low on battery that in may not accomplish thedisplay update. Replace the battery of the label.62 HTTP communication error with theaccess pointThe server was not able to send the task to the AccessPoint. Please make sure that the Access Point is notoffline (System -> Access Point Status) and there is anestablished network connection between Access Pointand Server.63 Label authentication failed (wrongencryption key) Unlock the label64Task was removed from pipelinebecause previous transmission wasnot finished in timeResend the corresponding task(s)80 Error while writing task to database Check database connection92 Task type not supported Upgrade AP software to process this kind of task
Core Service Quick Start GuidePage 41 of 4514.1 SES-imagotag Core Service DashboardTo get a better overview accross your complete ESLsystem you can use the dashboard of the SES-imagotag Core Service. All kind of helpful information is shown here. You'll find the dashboard underhttp://<core-service-ip>:<port>/service/dashboard.xml14.2 Running the SES-imagotag Core Service as a background serviceThe SES-imagotag Core Service may be started as a normal application, but on a productive systemit is usually required to have it automatically started without a user logged in. To achieve this the SES-imagotag Core Service can be registered as a Windows service. It is than started automaticallywithout any graphics user interface.To install the SES-imagotag Core Service as a Windows service the batch file install_service.bat isprovided. If this file is executed with administrator privileges (Right click – Run as Administrator) it willinstall the SES-imagotag Core Service installation from the same directory as a Windows service withthe name ESL_SERVICE.The file uninstall_service.bat will remove the Windows service if executed with administratorprivileges.If you have any problems regarding the background service:lCheck if you have installed the correct JAVAversion corresponding to your system (x86/x64)lIf the SES-imagotag Core Service is already installed as a Windows service you have to unin-stall it first (uninstall_service.bat) and reinstall it again (install_service.bat).14.3 Where can get a demo/development license key?Ask the support.at@ses-imagotag.com or sales.at@ses-imagotag.com team for ademo/development license.
Core Service Quick Start GuidePage 42 of 4514.4 Deleting the demo articlesIn order to prevent the example articles from being re-added to the server, go to "System -Configuration"and set the "importFixtures"variable to false. Note: Please do not use the "Smart BoxPackage" for productive installation.14.5 Establish a network configuration when no DHCP is available – Step by step1. Set a laptops Ethernet adapter to DHCP2. Turn off all other network adapters (Wi-Fi)3. Connect to the same network as the AP-2010 (use a common Ethernet cable to connect yourdevice directly with the AP-2010)4. Start local SES-imagotag Core Service on laptop5. Use the SES-imagotag Control Center to connect to your local SES-imagotag Core Service6. Under System – Access Point Status – the AP should be listed as discovered (after successfulboot sequence – may take up to 2 minutes)lPress F5 on your keyboard or the refresh button in the ESL client to refresh the accesspoint status (the Client doesn’t refresh the status automatically!)7. One Column of the AP should now show the IP address8. Open a browser, type in http://<discovered-ip>:8080 orlat the SES-imagotag Control Center perform a right click on the discovered accesspoint – Open in browser – Maintenance – StatusNote: Restart your access point if discovering process takes more than 2 minutes.FIGURE 1-44: Restart and Factory Defaults button14.6 Access point discovering with Bonjour ServicesYou still got problems to find your ESL access point 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/DL999Note: After installation there’s no reboot required.If the access point is connected directly to the system where the “Bonjour Service” is installed (or on anetwork with running “Bonjour Service”) you can find the access point by typing the following in thebrowser of your choice:http://ap-<ID>.local:8080 (e.g. http://ap-12724.local:8080)Note: You can reach older versions of the AP with http://imagotag-ap.local:8080 (custom hostnamesare only available on newer versions of the access point)
Core Service Quick Start GuidePage 43 of 4514.7 What can I do if the Status LED of the AP-2010 access point doesn’t turn blue?lCheck the access point statuslCheck the access point configurationoNo channel setlCheck network reachability of the access pointlIs the access point registered to the SES-imagotag Core Service?lReboot the access point14.8 Labels don’t come onlineAfter the registration it could last a certain time until all registered labels are joined to the network (upto two hours, depending on number of access points and the channels used.lUp to 30 minutes with channels 3, 5, 8, 9 and 10lUp to 2 hours with channels 0, 1, 2, 4, 6 and 7Warning: A label must not be registered to multiple SES-imagotag Core Service installations at thesame time. It will only connect to one of this installations.14.9 The encryption does not workCheck the encryption passphrase via the SES-imagotag Control Center - System – Configuration.If label was already registered with a different passphrase you’ll have to unlock the label first in orderto register it on the SES-imagotag Core Service.14.10 Unlocking labelsIf the label was registered and a communication key was set it will no longer work in other networksusing a different network key passphrase. To unlock this labels for other networks an unlock code isrequired.Select File – Unlock labels and enter the unlock key.If you have any problems (the unlock code wasn't included or you can't find it) please contact theSES-imagotag Support Team (support.at@ses-imagotag.com).14.11 Starting Java applicationsBefore starting a Java application, make sure you have Java Runtime Environment Version 6 orhigher 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 theapplication. 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 thepath in the “Target” field. Double-click the shortcut.Linux:
Core Service Quick Start GuidePage 44 of 45Navigate via command line to the directory where the jar file lies and execute “java –jar<filename>.jar”In case your environment variables are not set properly (e.g. javaw.exe/java command could not befound) do the following steps:1. Locate your installation directory of your Java Runtime Environment2. Set JAVA_HOME VariableUnder Windows:lRight-click on “My Computer” and select “Properties”lClick the advanced tablClick the “EnvironmentVariables” buttonlUnder “SystemVariables”, click New.lEnter the variable name as JAVA_HOMElEnter the variable value as the installation directory of your Java Runtime EnvironmentlClick OKlLook for the Path variable in “SystemVariables” and edit itlAppend a semicolon (;) and %JAVA_HOME%\bin to itlClick OKlApplyChangesUnder Linux:lUse the “export” command to set your variableslexport JAVA_HOME=<pathToJRE>lexport PATH=$PATH:<pathToJRE>/binlIn order to make these changes persistent, write them into your .bash_profile file and use“source ~/.bash_profile” to apply the changes14.12 Encoding problemsPer default, UTF-8 encoding is used. If you have any problems regarding encoding you can force anyjava application to use UTF-8. By setting the (Windows) environment variable JAVA_TOOL_OPTIONS to -Dfile.encoding=UTF8, the (Java) System property will be set automatically every timea JVM is started.14.13 Reserve RAM for Java heap spaceAs the generation of PDFs in the Site Survey Tool might need a lot of memory (depending on theamount of measurements, uploaded pictures, …) we recommend to use half of the available memoryfor the Site Survey Tool.In this case, please start the Site Survey Tool via Command Line (or create a corresponding shortcutrespectively batch file) with corresponding parameters.If your notebook has 4 GB RAM, please reserve 2 GB for the Site Survey Tool with followingcommand:D:\Builds\sitesurvey>java -Xmx2g -jar sitesurvey.jar
Core Service Quick Start GuidePage 45 of 45Example:lm for megabyte-Xmx512mlg for gigabyte-Xmx2gThe same method can be used to reserve memory for the SES-imagotag Core Service.Detailed information regarding JAVA options: https://docs.oracle.com/cd/E13150_01/jrockit_jvm/jrockit/jrdocs/refman/optionX.html14.14 Further documentationPlease visit https://portal.imagotag.com for further documentation.

Navigation menu