Nexmosphere XPERIENCE XC-938 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.
XC-938
The XC-938 is an Xperience controller with 1 optical audio input,
4 optical audio output switches, 2 RGBW LED Outputs and
4 X-talk interfaces:
111. Optical audio switch 1 1. X-talk interface 001
112. Optical audio switch 2 2. X-talk interface 002
113. Optical audio switch 3 3. X-talk interface 003
114. Optical audio switch 4 4. X-talk interface 004
IN. Optical input
A. RGBW LED output A (Generic API address 005, RGBW channel A)
B. RGBW LED output B (Generic API address 005, RGBW channel B)
USB. API interface (micro-USB connector)
LED. White status LED
DC. 12-24VDC Power input (2.1mm DC socket)
Hardware setup
1. Connect one or more Elements to any of the 4 X-talk interfaces.
2. Connect one or more RGB(W) LED strips to any of the 2 RGBW LED outputs*.
3. Connect an audio source to the optical input using an optical cable with mini-toslink connector.
4. Connect one or more speaker to any of the optical output switches using an optical cable with mini-toslink connector.
5. Connect the 12 or 24VDC power supply to the DC power input connector. Make sure the voltage of the power supply
matches the operating voltage of the RGBW LED strips (12VDC or 24VDC).
6. Connect the micro-USB cable to a 3rd party device (e.g. Digital Signage Player or PC).
7. Wait until the white status LED stops blinking. This lasts about 5 seconds.
*RGBW LED strips including connection cable are available as an accessory (product codes L-X5.....l). If you want to connect your own RGBW LED strips, separate
connection cables are also available as an accessory (product codes CA5-S..C).
Software setup for testing (Terminal)
Typically, the XC-938 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 XC-938 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 XC-938 controller, place a 50mS delay between each command.
*In case the XC-938 controller is not recognized as a COM port by the 3rd party device, a driver (Prolic PL2303) can be downloaded here.
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]
QUICK START GUIDE
XC-938 XPERIENCE CONTROLLER
© 2020 Nexmosphere. All rights reserved. v1.0 / 10-20
All content contained herein is subject to change without prior notice.
1
USB
DC
LED
5 6
A B
XC
4
5 5
23 1
114
112
113
111
IN

Functionality
The XC-938 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 RGBW LED strips
or optical audio switches) 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.
3rd party devices and software
This Quick Start Guide oers a generic explanation of the setup and operation of the XC-938 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.
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]
QUICK START GUIDE
XC-938 XPERIENCE CONTROLLER
© 2020 Nexmosphere. All rights reserved. v1.0 / 10-20
All content contained herein is subject to change without prior notice.
2
Example 1 | RGBW LED control
To control an RGBW LED strip connected to RGBW channel A or B send one of the following API example commands from
the 3rd party device to the XC-938 controller:
Set the LED strip connected to RGBW channel Ato color 0 (default white*) at 80% brightness with 0.5 seconds ramp time:
*An overview of the default RGBW LED colors is provided on the nal page of this document.
Set the LED strip connected to RGBW channel Bto color 3 (default blue*) at 100% brightness with 1.2 seconds ramp time:
Set the LED strip connected to RGBW channel A to pulse between two ramps. Ramp1: Color 2 (default green*) at 100% with
1.0 seconds ramp time. Ramp 2: Color 2 (default green*) at 5% with 0.5 seconds ramp time.
Set the LED strip connected to RGBW channel B to pulse between two ramps. Ramp1: Color 6 (default turquoise*) at 80%
with 0.7 seconds ramp time. Ramp 2: Color 8 (default pink*) at 100% with 0.7 seconds ramp time.
Set the LED strip of all 2 RGBW channels (X) to color 5 (default purple*) at 65% brightness with 0.8 seconds ramp time:
G005B[A 0 80 5]
G005B[B 3 100 12]
G005B[A 2 100 10 2 5 5]
G005B[B 6 80 7 8 100 7]
G005B[X 5 65 8]
XC-938
(Xperience controller) USB-A to Micro-USB cable
(connect to 3rd party device)
DC Power supply
(24V)
XC
AB

© 2020 Nexmosphere. All rights reserved. v1.0 / 10-20
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
QUICK START GUIDE | XC-938 XPERIENCE CONTROLLER
Example 2 | Optical audio switch control
To control an optical audio switch, send one of the following API example commands from the 3rd party device to the XC-
938 controller:
Activate optical audio switch 1
Activate optical audio switch 2
Activate optical audio switch 3
Activate optical audio switch 4
Activate all optical switches
Deactivate optical audio switch 1
Deactivate optical audio switch 2
Deactivate optical audio switch 3
Deactivate optical audio switch 4
Deactivate all optical switches
G111A[1]
G112A[1]
G113A[1]
G114A[1]
G115A[15] G115A[0]
G111A[0]
G112A[0]
G113A[0]
G114A[0]
XC-938
(Xperience controller)
Opcal cables
(connect to speaker)
Opcal cable
(connect to audio source)
USB-A to Micro-USB cable
(connect to 3rd party device)
DC Power supply
(24V)
XC
IN
111
112
113
114
Example 3 | Presence sensor
When an XY-Presence sensor connected to X-talk
interface 001 detects a person in distance zone 4, the
following API serial command is sent from the XC-938 to
the 3rd party device: X001A[4]
When an XY-Presence sensor connected to X-talk
interface 001 does not detect a person, the following API
serial command is sent from the XC-938 to the 3rd party
device: X001A[1]
XC-938
(Xperience controller)
USB-A to Micro-USB cable
(connect to 3rd party device)
DC Power supply
(24V)
XY-146
(presence sensor)
XC

© 2020 Nexmosphere. All rights reserved. v1.0 / 10-20
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
QUICK START GUIDE | XC-938 XPERIENCE CONTROLLER
Example 4 | RFID sensor
When tag 2 is picked up from an antenna connected to
X-talk interface 004, the following API serial commands are
sent from the XC-938 to the 3rd party device:
XR[PU002]
X004A[1]
When tag 1 is placed on an antenna connected to X-talk
interface 004, the following API serial commands are sent
from the XC-938to the 3rd party device:
XR[PB001]
X004A[0]
Example 5 | Button input
When button 1 of a (touch) button interface connected
to X-talk interface 003 is pressed, the following API serial
commands are sent from the XC-938 to the 3rd party
device: X003A[3]
When button 4 of a (touch) button interface connected
to X-talk interface 003 is pressed, the following API serial
commands are sent from the XC-938 to the 3rd party
device: X003A[17]
XR
XR-C10
(RFID antenna)
XR-C10
RFID Tags
(number 1-3)
XR-DR1
(RFID antenna driver
XC-938
(Xperience controller)
USB-A to Micro-USB cable
(connect to 3rd party device)
DC Power supply
(24V)
XC
Push buons
(with LED, 4x)
XT-B4N
(4x buon interface)
XT-4F
(Touch buons)
XT-B4
1 2 3 4
XC-938
(Xperience controller)
DC Power supply
(24V)
XC
USB-A to Micro-USB cable
(connect to 3rd party device)
Example 6 | Button LED control
To set all button LEDs of a (touch) button interface
connected to X-talk interface 003 to “on”, send the
following API commands from the 3rd party device to the
XC-938 controller:
To set all button LEDs of a (touch) button interface
connected to X-talk interface 003 to “o”, send the
following API commands from the 3rd party device to the
XC-938 controller:
X003A[255]
X003A[0]
Push buons
(with LED, 4x)
XT-B4N
(4x buon interface)
XT-4F
(Touch buons)
XT-B4
1 2 3 4
XC-938
(Xperience controller)
DC Power supply
(24V)
XC
USB-A to Micro-USB cable
(connect to 3rd party device)

© 2020 Nexmosphere. All rights reserved. v1.0 / 10-20
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
QUICK START GUIDE | XC-938 XPERIENCE CONTROLLER
Combining Elements
The XC-938 Xperience controller has 4 optical audio switches, 2 RGBW LED outputs and 4 X-talk interfaces to which any
combination of Elements can be connected. For example, all examples in this Quick Start Guide can be combined on a
single XC-938. 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.
Default RGBW LED colors
The XC-938 controller is pre-programmed with 10 default colors:
Please refer to the API Manual to learn how to overwrite the default colors with your own preferred RGBW LED colors.
R
G
B
w
0
0
0
0
100
1
R
G
B
w
100
0
0
0
2
R
G
B
w
0
100
0
0
3
R
G
B
w
0
0
100
0
4
R
G
B
w
100
75
0
0
5
R
G
B
w
100
0
100
0
6
R
G
B
w
0
100
100
0
7
R
G
B
w
100
25
0
0
8
R
G
B
w
100
0
50
0
9
R
G
B
w
50
100
0
0
Opcal cables
(connect to speaker)
Opcal cable
(connect to audio source)
XC-938
(Xperience controller)
USB-A to Micro-USB cable
(connect to 3rd party device)
DC Power supply
(24V)
XC
AB
Push buons
(with LED, 4x)
XT-B4N
(4x buon interface)
XT-4F
(Touch buons)
XT-B4 1 2 3 4
XR
XR-C10
(RFID antenna)
XR-C10
RFID Tags
(number 1-3)
XR-DR1
(RFID antenna driver
XY-146
(presence sensor)
IN
111
112
113
114