Nexmosphere XN-165 XPERIENCE User manual

Xperience platform
All of Nexmosphere’s controllers are built on the same platform principles. If this is your rst time using a Nexmosphere
controller, we recommend to rst read https://nexmosphere.com/technology/xperience-platform/ to learn the basics about
our platform and its terminology.
XN-165
The XN-165 is an Xperience controller with 2 X-talk interfaces and
4 Push button interfaces:
1. X-talk interface 001
2. X-talk interface 002
3.1. Push button interface 1 (X-talk address 003)
3.2. Push button interface 2 (X-talk address 003)
3.3. Push button interface 3 (X-talk address 003)
3.4. Push button interface 4 (X-talk address 003)
USB. 5V Power input and API interface (micro-USB connector)
LED. White status LED
Hardware setup
1. Connect one or more Elements to any of the 2 X-talk interfaces. Connect push buttons to the push button interfaces.*
2. Connect the micro-USB cable to a 3rd party device (e.g. Digital Signage Player or PC).
3. Wait until the white status LED stops blinking. This lasts about 5 seconds.
*Nexmosphere oers several push buttons with pre-assembled cable and connector. The product codes for these push buttons are S-B90xxx and S-B95xxx.
Software setup for testing (Terminal)
Typically, the XN-165 controller is connected to a 3rd party device, such as a Digital Signage Player, on which CMS software is installed that has built-in
functionality for sending and receiving Serial Events. However, if you want to do a rst test on a PC or Mac, follow the instructions below:
1. Download a terminal program. For example Termite or Hercules.
2. Open the Terminal program and go to settings. Choose the COM port on which the XN-135 controller enumerated*.
In most cases this is the highest available number in the COM port drop-down setting.
3. Set the COM port settings to the following values
Baudrate 115200 Flow Control None
Parity None EOL CR+LF
Data Bits 8 Protocol ASCII
Stop Bits 1
4. Set the COM port to “Open”. The controller is now ready for use.
5. When sending consecutive API serial commands to the XN-165 controller, place a 50mS delay between each command.
*In case the XN-165 controller is not recognized as a COM port by the 3rd party device, a driver (Prolic PL2303) can be downloaded here.
Functionality
The XN-165 runs our API which provides serial output when a specic sensor Element is triggered (for example a pick-up,
or -motion sensor or touch button) and provides control over output Elements (for example controlling LED strips) via serial
input commands. These API serial commands are typically used to create interactive Xperiences for Digital Signage.
The complete API Manual and additional helpful documents can be found on https://nexmosphere.com/support-
documentation. To get you started, we’ve included some starter examples of our Elements and the corresponding API serial
commands on the following pages.
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]
QUICK START GUIDE

© 2021 Nexmosphere. All rights reserved. v1.0 / 08-21
All content contained herein is subject to change without prior notice.
1
XN
1 2
3.1 3.2 3.3 3.4
USB
LED

3rd party devices and software
This Quick Start Guide oers a generic explanation of the setup and operation of the XN-165 Xperience controller. It does
not cover information on how to integrate the Controllers, Elements and their API triggers in specic 3rd party devices or
software. We have manuals available with step-by-step instructions on how to integrate Nexmosphere products with the
products of our hardware, -and software partners. You’ll nd these on the support and partner pages of our website.

Up to 4 push buttons can be connected directly to the XN-165 via Push button interface 1-4.
When a button is pressed, the following API serial commands are sent from the XN-165 to the 3rd party device:
Push button 1 is pressed X003A[3] Push button which was pressed last is released X003A[0]
Push button 2 is pressed X003A[5]
Push button 3 is pressed X003A[9]
Push button 4 is pressed X003A[17]
In case the push buttons have 3.3V LEDs, these can be set to 4 dierent states: on, o, slow blink and fast blink.
Each button LED can be set to a dierent state. However the API command for controlling the LEDs indicates and sets the
state for all LEDs simultaneously. Some example commands are provided below:
all LEDs o
LED 1 slow blink, other LEDS o
LED 1 on, other LEDS o
LED 1 fast blink, other LEDS o
all LEDs fast blink
LED 2 slow blink, other LEDS o
LED 2 on, other LEDS o
LED 2 fast blink, other LEDS o
all LEDs slow blink
LED 3 slow blink, other LEDS o
LED 3 on, other LEDS o
LED 3 fast blink, other LEDS o
all LEDs on
LED 4 slow blink, other LEDS o
An overview of the all available LED control commands is provided in Appendix A on the nal pages of the this document.
LED 4 on, other LEDS
LED 4 fast blink, other LEDS o
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]
QUICK START GUIDE

© 2021 Nexmosphere. All rights reserved. v1.0 / 08-21
All content contained herein is subject to change without prior notice.
2
X003A[0]
X003A[2]
X003A[3]
X003A[1]
X003A[170]
X003A[32]
X003A[48]
X003A[16]
X003A[85]
X003A[8]
X003A[12]
X003A[4]
X003A[255]
X003A[128]
X003A[192]
X003A[64]
XN
XN-165
(Xperience controller)
USB-A to Micro-USB cable
(connect to 3rd party device)
Push bu�ons
(with LED)
1 2 3 4

© 2021 Nexmosphere. All rights reserved. v1.0 / 08-21
All content contained herein is subject to change without prior notice.
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]
3


When a presence sensor connected to X-talk interface
001 detects a person in distance zone 4, the following API
serial command is sent from the XN-165 to the 3rd party
device: X001A[4]
When a presence sensor connected to X-talk interface
001 does not detect a person, the following API serial
command is sent from the XN-165 to the 3rd party device:
X001A[1]

When tag 2 is picked up from an antenna connected to
X-talk interface 001 the following API serial commands are
sent from the XN-165 to the 3rd party device:
XR[PU002]
X001A[1]
When tag 1 is placed on an antenna connected to X-talk
interface 001, the following API serial commands are sent
from the XN-165 to the 3rd party device:
XR[PB001]
X001A[1]
XR[PU002]
XN-165
(Xperience controller)
USB-A to Micro-USB cable
(connect to 3rd party device)
XR
XR-C10
(RFID antenna)
XR-C10
RFID Tags
(number 1-3)
XR-DR1
(RFID antenna driver
XN
XN-165
(Xperience controller)
XY-146
(presence sensor)
USB-A to Micro-USB cable
(connect to 3rd party device)
XN

To initiate an X-Wave LED pattern on an X-Wave connected
to X-talk interface 002, send one of the following API
example commands from the 3rd party device to the XN-
165 controller:
40% brightness, color 0 (white), 0.5 second ramp time
Blue pulsing pattern (99% to 20%), 1.8 second ramp time
White wave pattern moving to the left
X002B[240005]
X002B[399C1801020C180018]
X002B[499018001200009]
USB-A to Micro-USB cable
(connect to 3rd party device)
XW-L96
(X-Wave LED)
XW-L9
XN-165
(Xperience controller)
XN

© 2021 Nexmosphere. All rights reserved. v1.0 / 08-21
All content contained herein is subject to change without prior notice.
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]
4


The XN-165 Xperience controller has 2 X-talk interfaces and 4 push button interfaces to which any combination of Elements
can be connected. For example, three of the examples in this Quick Start Guide can be combined on a single XN-165.
The API commands and operation will remain the same. When connecting multiple Elements that require a high amount of
current (LEDs or push buttons with LED ring), calculate the total required current of the Elements and check if this is within
the specication of the controller and its power supply source.
USB-A to Micro-USB cable
(connect to 3rd party device)
XW-L96
(X-Wave LED)
Push bu�ons
(with LED)
XW-L9
XR XR-C10
(RFID antenna)
XR-C10
RFID Tags
(number 1-3)
XR-DR1
(RFID antenna driver
XN-165
(Xperience controller)
XN

© 2021 Nexmosphere. All rights reserved. v1.0 / 08-21
All content contained herein is subject to change without prior notice.
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]

5
LED 1 LED 2 LED 3 LED 4
X003A[ 0]o o o o
X003A[ 1] fast blink o o o
X003A[ 2] slow blink o o o
X003A[ 3] on o o o
X003A[ 4]o fast blink o o
X003A[ 5] fast blink fast blink o o
X003A[ 6] slow blink fast blink o o
X003A[ 7] on fast blink o o
X003A[ 8]o slow blink o o
X003A[ 9] fast blink slow blink o o
X003A[ 10] slow blink slow blink o o
X003A[ 11] on slow blink o o
X003A[ 12]o on o o
X003A[ 13] fast blink on o o
X003A[ 14] slow blink on o o
X003A[ 15] on on o o
X003A[ 16]o o fast blink o
X003A[ 17] fast blink o fast blink o
X003A[ 18] slow blink o fast blink o
X003A[ 19] on o fast blink o
X003A[ 20]o fast blink fast blink o
X003A[ 21] fast blink fast blink fast blink o
X003A[ 22] slow blink fast blink fast blink o
X003A[ 23] on fast blink fast blink o
X003A[ 24]o slow blink fast blink o
X003A[ 25] fast blink slow blink fast blink o
X003A[ 26] slow blink slow blink fast blink o
X003A[ 27] on slow blink fast blink o
X003A[ 28]o on fast blink o
X003A[ 29] fast blink on fast blink o
X003A[ 30] slow blink on fast blink o
X003A[ 31] on on fast blink o
X003A[ 32]o o slow blink o
X003A[ 33] fast blink o slow blink o
X003A[ 34] slow blink o slow blink o
X003A[ 35] on o slow blink o
X003A[ 36]o fast blink slow blink o
X003A[ 37] fast blink fast blink slow blink o
X003A[ 38] slow blink fast blink slow blink o
X003A[ 39] on fast blink slow blink o
X003A[ 40]o slow blink slow blink o
X003A[ 41] fast blink slow blink slow blink o
X003A[ 42] slow blink slow blink slow blink o
X003A[ 43] on slow blink slow blink o
X003A[ 44]o on slow blink o
7. Appendix A
All available combinations of button
LED control commands

© 2021 Nexmosphere. All rights reserved. v1.0 / 08-21
All content contained herein is subject to change without prior notice.
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]

6
LED 1 LED 2 LED 3 LED 4
X003A[ 45] fast blink on slow blink o
X003A[ 46] slow blink on slow blink o
X003A[ 47] on on slow blink o
X003A[ 48]o o on o
X003A[ 49] fast blink o on o
X003A[ 50] slow blink o on o
X003A[ 51] on o on o
X003A[ 52]o fast blink on o
X003A[ 53] fast blink fast blink on o
X003A[ 54] slow blink fast blink on o
X003A[ 55] on fast blink on o
X003A[ 56]o slow blink on o
X003A[ 57] fast blink slow blink on o
X003A[ 58] slow blink slow blink on o
X003A[ 59] on slow blink on o
X003A[ 60]o on on o
X003A[ 61] fast blink on on o
X003A[ 62] slow blink on on o
X003A[ 63] on on on o
X003A[ 64]o o o fast blink
X003A[ 65] fast blink o o fast blink
X003A[ 66] slow blink o o fast blink
X003A[ 67] on o o fast blink
X003A[ 68]o fast blink o fast blink
X003A[ 69] fast blink fast blink o fast blink
X003A[ 70] slow blink fast blink o fast blink
X003A[ 71] on fast blink o fast blink
X003A[ 72]o slow blink o fast blink
X003A[ 73] fast blink slow blink o fast blink
X003A[ 74] slow blink slow blink o fast blink
X003A[ 75] on slow blink o fast blink
X003A[ 76]o on o fast blink
X003A[ 77] fast blink on o fast blink
X003A[ 78] slow blink on o fast blink
X003A[ 79] on on o fast blink
X003A[ 80]o o fast blink fast blink
X003A[ 81] fast blink o fast blink fast blink
X003A[ 82] slow blink o fast blink fast blink
X003A[ 83] on o fast blink fast blink
X003A[ 84]o fast blink fast blink fast blink
X003A[ 85] fast blink fast blink fast blink fast blink
X003A[ 86] slow blink fast blink fast blink fast blink
X003A[ 87] on fast blink fast blink fast blink
X003A[ 88]o slow blink fast blink fast blink
X003A[ 89] fast blink slow blink fast blink fast blink

© 2021 Nexmosphere. All rights reserved. v1.0 / 08-21
All content contained herein is subject to change without prior notice.
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]

7
LED 1 LED 2 LED 3 LED 4
X003A[ 90] slow blink slow blink fast blink fast blink
X003A[ 91] on slow blink fast blink fast blink
X003A[ 92]o on fast blink fast blink
X003A[ 93] fast blink on fast blink fast blink
X003A[ 94] slow blink on fast blink fast blink
X003A[ 95] on on fast blink fast blink
X003A[ 96]o o slow blink fast blink
X003A[ 97] fast blink o slow blink fast blink
X003A[ 98] slow blink o slow blink fast blink
X003A[ 99] on o slow blink fast blink
X003A[ 100]o fast blink slow blink fast blink
X003A[ 101] fast blink fast blink slow blink fast blink
X003A[ 102] slow blink fast blink slow blink fast blink
X003A[ 103] on fast blink slow blink fast blink
X003A[ 104]o slow blink slow blink fast blink
X003A[ 105] fast blink slow blink slow blink fast blink
X003A[ 106] slow blink slow blink slow blink fast blink
X003A[ 107] on slow blink slow blink fast blink
X003A[ 108]o on slow blink fast blink
X003A[ 109] fast blink on slow blink fast blink
X003A[ 110] slow blink on slow blink fast blink
X003A[ 111] on on slow blink fast blink
X003A[ 112]o o on fast blink
X003A[ 113] fast blink o on fast blink
X003A[ 114] slow blink o on fast blink
X003A[ 115] on o on fast blink
X003A[ 116]o fast blink on fast blink
X003A[ 117] fast blink fast blink on fast blink
X003A[ 118] slow blink fast blink on fast blink
X003A[ 119] on fast blink on fast blink
X003A[ 120]o slow blink on fast blink
X003A[ 121] fast blink slow blink on fast blink
X003A[ 122] slow blink slow blink on fast blink
X003A[ 123] on slow blink on fast blink
X003A[ 124]o on on fast blink
X003A[ 125] fast blink on on fast blink
X003A[ 126] slow blink on on fast blink
X003A[ 127] on on on fast blink
X003A[ 128]o o o slow blink
X003A[ 129] fast blink o o slow blink
X003A[ 130] slow blink o o slow blink
X003A[ 131] on o o slow blink
X003A[ 132]o fast blink o slow blink
X003A[ 133] fast blink fast blink o slow blink
X003A[ 134] slow blink fast blink o slow blink

© 2021 Nexmosphere. All rights reserved. v1.0 / 08-21
All content contained herein is subject to change without prior notice.
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]

8
LED 1 LED 2 LED 3 LED 4
X003A[ 135] on fast blink o slow blink
X003A[ 136]o slow blink o slow blink
X003A[ 137] fast blink slow blink o slow blink
X003A[ 138] slow blink slow blink o slow blink
X003A[ 139] on slow blink o slow blink
X003A[ 140]o on o slow blink
X003A[ 141] fast blink on o slow blink
X003A[ 142] slow blink on o slow blink
X003A[ 143] on on o slow blink
X003A[ 144]o o fast blink slow blink
X003A[ 145] fast blink o fast blink slow blink
X003A[ 146] slow blink o fast blink slow blink
X003A[ 147] on o fast blink slow blink
X003A[ 148]o fast blink fast blink slow blink
X003A[ 149] fast blink fast blink fast blink slow blink
X003A[ 150] slow blink fast blink fast blink slow blink
X003A[ 151] on fast blink fast blink slow blink
X003A[ 152]o slow blink fast blink slow blink
X003A[ 153] fast blink slow blink fast blink slow blink
X003A[ 154] slow blink slow blink fast blink slow blink
X003A[ 155] on slow blink fast blink slow blink
X003A[ 156]o on fast blink slow blink
X003A[ 157] fast blink on fast blink slow blink
X003A[ 158] slow blink on fast blink slow blink
X003A[ 159] on on fast blink slow blink
X003A[ 160]o o slow blink slow blink
X003A[ 161] fast blink o slow blink slow blink
X003A[ 162] slow blink o slow blink slow blink
X003A[ 163] on o slow blink slow blink
X003A[ 164]o fast blink slow blink slow blink
X003A[ 165] fast blink fast blink slow blink slow blink
X003A[ 166] slow blink fast blink slow blink slow blink
X003A[ 167] on fast blink slow blink slow blink
X003A[ 168]o slow blink slow blink slow blink
X003A[ 169] fast blink slow blink slow blink slow blink
X003A[ 170] slow blink slow blink slow blink slow blink
X003A[ 171] on slow blink slow blink slow blink
X003A[ 172]o on slow blink slow blink
X003A[ 173] fast blink on slow blink slow blink
X003A[ 174] slow blink on slow blink slow blink
X003A[ 175] on on slow blink slow blink
X003A[ 176]o o on slow blink
X003A[ 177] fast blink o on slow blink
X003A[ 178] slow blink o on slow blink
X003A[ 179] on o on slow blink

© 2021 Nexmosphere. All rights reserved. v1.0 / 08-21
All content contained herein is subject to change without prior notice.
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]

9
LED 1 LED 2 LED 3 LED 4
X003A[ 180]o fast blink on slow blink
X003A[ 181] fast blink fast blink on slow blink
X003A[ 182] slow blink fast blink on slow blink
X003A[ 183] on fast blink on slow blink
X003A[ 184]o slow blink on slow blink
X003A[ 185] fast blink slow blink on slow blink
X003A[ 186] slow blink slow blink on slow blink
X003A[ 187] on slow blink on slow blink
X003A[ 188]o on on slow blink
X003A[ 189] fast blink on on slow blink
X003A[ 190] slow blink on on slow blink
X003A[ 191] on on on slow blink
X003A[ 192]o o o on
X003A[ 193] fast blink o o on
X003A[ 194] slow blink o o on
X003A[ 195] on o o on
X003A[ 196]o fast blink o on
X003A[ 197] fast blink fast blink o on
X003A[ 198] slow blink fast blink o on
X003A[ 199] on fast blink o on
X003A[ 200]o slow blink o on
X003A[ 201] fast blink slow blink o on
X003A[ 202] slow blink slow blink o on
X003A[ 203] on slow blink o on
X003A[ 204]o on o on
X003A[ 205] fast blink on o on
X003A[ 206] slow blink on o on
X003A[ 207] on on o on
X003A[ 208]o o fast blink on
X003A[ 209] fast blink o fast blink on
X003A[ 210] slow blink o fast blink on
X003A[ 211] on o fast blink on
X003A[ 212]o fast blink fast blink on
X003A[ 213] fast blink fast blink fast blink on
X003A[ 214] slow blink fast blink fast blink on
X003A[ 215] on fast blink fast blink on
X003A[ 216]o slow blink fast blink on
X003A[ 217] fast blink slow blink fast blink on
X003A[ 218] slow blink slow blink fast blink on
X003A[ 219] on slow blink fast blink on
X003A[ 220]o on fast blink on
X003A[ 221] fast blink on fast blink on
X003A[ 222] slow blink on fast blink on
X003A[ 223] on on fast blink on
X003A[ 224]o o slow blink on

© 2021 Nexmosphere. All rights reserved. v1.0 / 08-21
All content contained herein is subject to change without prior notice.
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]

10
LED 1 LED 2 LED 3 LED 4
X003A[ 225] fast blink o slow blink on
X003A[ 226] slow blink o slow blink on
X003A[ 227] on o slow blink on
X003A[ 228]o fast blink slow blink on
X003A[ 229] fast blink fast blink slow blink on
X003A[ 230] slow blink fast blink slow blink on
X003A[ 231] on fast blink slow blink on
X003A[ 232]o slow blink slow blink on
X003A[ 233] fast blink slow blink slow blink on
X003A[ 234] slow blink slow blink slow blink on
X003A[ 235] on slow blink slow blink on
X003A[ 236]o on slow blink on
X003A[ 237] fast blink on slow blink on
X003A[ 238] slow blink on slow blink on
X003A[ 239] on on slow blink on
X003A[ 240]o o on on
X003A[ 241] fast blink o on on
X003A[ 242] slow blink o on on
X003A[ 243] on o on on
X003A[ 244]o fast blink on on
X003A[ 245] fast blink fast blink on on
X003A[ 246] slow blink fast blink on on
X003A[ 247] on fast blink on on
X003A[ 248]o slow blink on on
X003A[ 249] fast blink slow blink on on
X003A[ 250] slow blink slow blink on on
X003A[ 251] on slow blink on on
X003A[ 252]o on on on
X003A[ 253] fast blink on on on
X003A[ 254] slow blink on on on
X003A[ 255] on on on on