{"id":4595,"date":"2023-10-06T13:41:00","date_gmt":"2023-10-06T20:41:00","guid":{"rendered":"https:\/\/portal.staylinked.com\/sl\/kb\/?post_type=ht_kb&p=4595"},"modified":"2023-12-13T10:12:40","modified_gmt":"2023-12-13T18:12:40","slug":"session-pairing","status":"publish","type":"ht_kb","link":"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/session-pairing\/","title":{"rendered":"Session Pairing"},"content":{"rendered":"\n

In this example, we will leverage features within Evolve to display a barcode on the Primary device for our Peripheral device to scan to pair the TE sessions.  StayLinked supports a variety of methods in order to pair TE sessions across multiple devices.  <\/p>\n\n\n\n

This can be accomplished using a devices\u2019 IP address, MAC address or StayLinked Session ID.  With DHCP in use, the IP addresses can change even during a worker\u2019s shift depending on the DHCP server\u2019s settings, which would eventually require re-pairing the devices. <\/p>\n\n\n\n

MAC addresses can be used for pairing, but Android 11 and later devices do not report their MAC addresses to applications for security reasons.  <\/p>\n\n\n\n

Therefore, the most robust way to pair a TE session across two devices is leveraging the StayLinked Session ID.  With StayLinked, the TE sessions are maintained at the server regardless of anything happening with the mobile device IP addresses, device resets, etc.  For this important reason, we will focus on using the StayLinked Session ID for pairing in this example.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Step 1<\/strong>: Create Host Group for Peripheral devices<\/h2>\n\n\n\n

In the Administrator under \u201cTelnet Host Groups\u201d create a Host Group and give it any name.  For this demo we named it \u201cPartner\u201d. Any Peripheral devices we define will point to this Host Group. <\/p>\n\n\n\n

All other devices in this example will be considered \u201cPrimary\u201d devices, which will point to the Default Host Group.<\/p>\n\n\n\n

Right click in the white area of the new Host Group and add a new host.  We are naming this new host \u201cPartner_Session\u201d. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

SmartTip!<\/strong>  Adding the suffix \u201c_Session\u201d to the host name gives us an indicator within the host name of the type of sharing in use.<\/p><\/blockquote>\n\n\n\n

Open the Emulation pull-down menu and choose \u201cSHARE-SESSION\u201d.  This setting defines this host as the one for Peripheral devices that will share sessions using the Session ID of a Primary device. <\/p>\n\n\n\n

Hit \u201cOK\u201d in the \u201cAdd New Host Entry\u201d window, and click \u201cFile \u2013 Save Changes\u201d as you leave the \u201cAdd Host Group\u201d section.<\/p>\n\n\n\n

Step 2<\/strong>: Display Pairing Barcode on Primary Device<\/h2>\n\n\n\n

This API will command a Primary device to display its Session ID in the form of a barcode for the purposes of pairing the TE session with a Peripheral device.<\/p>\n\n\n\n

In your Host Entry, click \u201cManage \u2013 Session Settings\u201d.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

<\/p>

Within \u201cSession Settings\u201d click the \u201cGlobal API\u2019s\u201d tab.  Right click in the white area and choose \u201cAdd Evolve Display API\u201d from the dropdown menu.<\/p><\/blockquote>\n\n\n\n

\"\"<\/figure>\n\n\n\n

SmartTip!<\/strong>  We will be assigning a number that we will use to call this Global API later.  This screen will display any API\u2019s that are already defined.  You want to record the numbers of any global API's that is already in use for when we assign the API number in the next step.  In this case, the blank white area shows no existing Global API\u2019s are in use.<\/p><\/blockquote>\n\n\n\n

From the \u201cAPI Number\u201d drop down menu, choose a number for this global API that we will reference.  You can enter any value that is not already in use from 1 to 999.  For this example, we will choose \u201c9\u201d.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The API \u201cCategory\u201d defaults to \u201cDisplay\u201d.  This is the category we want in order to display content in a barcode.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

From the \u201cAction\u201d drop-down menu, choose \u201cDisplay Content in a Barcode\u201d.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

For \u201cDevice Type:\u201d we will define which devices out of our defined \u201cDevice Groups\u201d we want to function as Primary devices (forklift computers, hand-helds) for our Peripheral devices (wearables).  <\/p>\n\n\n\n

For this example, let\u2019s assume we have a range of different Primary devices and we want to pair WS50 wearables as Peripheral devices.  <\/p>\n\n\n\n

Since we know that the WS50 in this scenario will always behave as a Peripheral device, we can tell the StayLinked server to allow any device other than a WS50 within our Device Groups to display this barcode for pairing. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

In this case we have entered \u201c!WS*\u201d.  The \u201c!\u201d is a wildcard indicating ANYTHING OTHER THAN what follows will apply to this setting. Therefore \u201c!WS*\u201d would represent any device that does NOT start with \u201cWS\u201d will be capable of displaying a pairing barcode when prompted to.<\/p>\n\n\n\n

We will now define: <\/p>\n\n\n\n

  • Devices this setting applies to <\/li>
  • Caption for the displayed barcode <\/li>
  • Content that the barcode represents <\/li>
  • Barcode type to be displayed<\/li><\/ul>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    Double click \u201cTarget Devices\u201d and ensure the box is checked for \u201cHost Device\u201d.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Double click \u201cCaption for displayed barcode\u201d and enter the text to appear above the barcode when it is displayed to the user.  For this example we have used \u201cSCAN TO PAIR\u201d.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Double click \u201cContent to display in barcode\u201d and enter [sessionid].  This mnemonic will identify the StayLinked Session ID in use by the current Session.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Double click \u201cBarcode Type\u201d and ensure the box is checked for \u201cQR Code\u201c.  In this scenario we are using WS50 as the peripheral device that will scan this barcode, and they are all equipped with 2D imagers. In the case of a different peripheral device that is limited to a 1D laser or linear imager for barcode scanning, check \u201cCode39\u201d as the barcode type.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    The final result should look like the image below.  Push \u201cOK\u201d to save changes. <\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    <\/p>\n\n\n\n

    The \u201cGlobal API\u201d tab now displays our new entry. <\/p>\n\n\n\n

    From the File pulldown menu, select \u201cSave All\u201d.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Step 3<\/strong>: Define Peripheral Devices<\/h2>\n\n\n\n

    In \u201cDevice Groups\u201d right click in the white area and add a new device group.  For this example we will use \u201cWS50\u201d.<\/p>\n\n\n\n

    Configure the IP address range for these units.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Define the Device Type.  In this example we are using \u201cWS50*\u201d<\/p>\n\n\n\n

    Enter the name of the Host Group we want these units to point to.  In this example we are using \u201cPartner\u201d to match the name of the Peripheral Host Group we defined earlier.<\/p>\n\n\n\n

    Check the box to \u201cAuto Add Evolve Device Access\u201d.<\/p>\n\n\n\n

    Press \u201cOK\u201d.  Our Device Groups should now look like the image below.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Step 4<\/strong>: Add a Pairing Button<\/h2>\n\n\n\n

    We need to include a button for the worker on the Primary Devices to display the pairing barcode when required.<\/p>\n\n\n\n

    Since we will be calling our Global API #9, we can put this button on multiple screens wherever it makes the most sense for the workflow. In this example, we want to enable session pairing from the RF Menu of the StayLinked WMS demo.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    We have created a Designer screen that is a duplicate of the screen from the host and added a \u201c-PAIR-\u201d button. <\/p>\n\n\n\n

    This Designer screen will only appear on devices with 17 rows and 45 columns, matching the configuration of our VC80 Primary Devices.  We can add more Designer screens with the \u201c-PAIR-\u201d button as necessary to cover a wider range of Primary Devices.  <\/p>\n\n\n\n

    To create this button, right click where you want it to appear on the designer screen and choose \u201cAdd \u2013 Constant\u201d.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    For this example, we have entered \u201c-PAIR-\u201d as our label, with a Bolded black font and yellow Backcolor. <\/p>\n\n\n\n

    We call our Global API using the Tap Script.  In this example, we are calling Global API #9 using \u201c[*global9]\u201d.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Step 5<\/strong>: Scan To Pair The Session<\/h2>\n\n\n\n

    On the Primary device navigate to the screen that includes the \u201c-PAIR-\u201d button that we created.  In this example it is the StayLinked WMS RF Menu screen.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Press the \u201c-PAIR-\u201d button on the Primary device.  This will call the Global API that we defined and display a barcode encoded with the device\u2019s Session ID.  Notice also that the Caption we defined (SCAN TO PAIR) appears above the barcode.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Connect to the Host from the Peripheral device, in this case the WS50.  You will see a prompt to scan the sharing barcode.  Any device that is pointed to the Partner Host Group will display this screen once connected. <\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Scan the barcode on the Primary Device using the Peripheral Device, and the TE session should appear on the Peripheral Device screen.  On the Primary Device, press the \u201cDISMISS\u201d button below the barcode and you should see the TE session.  The TE Session is now paired across both devices.<\/p>\n\n\n\n

    \"\"<\/figure>\n","protected":false},"excerpt":{"rendered":"

    In this example, we will leverage features within Evolve to display a barcode on the Primary device for our Peripheral device to scan to pair the TE sessions.  StayLinked supports a variety of methods in order to pair TE sessions across multiple devices.  This can be accomplished using a devices\u2019…<\/p>\n","protected":false},"author":8,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[94],"ht-kb-tag":[],"yoast_head":"\nSession Pairing – StayLinked<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.staylinked.com\/knowledge-base\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Session Pairing – StayLinked\" \/>\n<meta property=\"og:description\" content=\"In this example, we will leverage features within Evolve to display a barcode on the Primary device for our Peripheral device to scan to pair the TE sessions.  StayLinked supports a variety of methods in order to pair TE sessions across multiple devices.  This can be accomplished using a devices\u2019...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/session-pairing\/\" \/>\n<meta property=\"og:site_name\" content=\"StayLinked\" \/>\n<meta property=\"article:modified_time\" content=\"2023-12-13T18:12:40+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2023\/10\/Spotlight-Pairing-1-3-1024x528.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"11 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/#website\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/\",\"name\":\"StayLinked Knowledge Base\",\"description\":\"Partner Portal Resources and Support\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/portal.staylinked.com\/sl\/kb\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/session-pairing\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2023\/10\/Spotlight-Pairing-1-3.png\",\"contentUrl\":\"https:\/\/portal.staylinked.com\/sl\/kb\/wp-content\/uploads\/2023\/10\/Spotlight-Pairing-1-3.png\",\"width\":2946,\"height\":1520},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/session-pairing\/#webpage\",\"url\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/session-pairing\/\",\"name\":\"Session Pairing – StayLinked\",\"isPartOf\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/session-pairing\/#primaryimage\"},\"datePublished\":\"2023-10-06T20:41:00+00:00\",\"dateModified\":\"2023-12-13T18:12:40+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/session-pairing\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/session-pairing\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/session-pairing\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/portal.staylinked.com\/sl\/kb\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Articles\",\"item\":\"https:\/\/portal.staylinked.com\/sl\/kb\/knowledge-base\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Session Pairing\"}]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","_links":{"self":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/4595"}],"collection":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/users\/8"}],"replies":[{"embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/comments?post=4595"}],"version-history":[{"count":18,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/4595\/revisions"}],"predecessor-version":[{"id":4769,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb\/4595\/revisions\/4769"}],"wp:attachment":[{"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/media?parent=4595"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=4595"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/portal.staylinked.com\/sl\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=4595"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}