Nexmosphere XM-350 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.
XM-350 with SM-115 ShopBus Module
The XM-350 is an Xperience controller with 1 X-talk interface and a ShopBus interface. To the ShopBus interface, up to 8
ShopBus modules can be connected. An SM-115 ShopBus module has 8 X-talk interfaces and 5 RGB LED outputs.
The API address of an X-talk interface is determined by adding the number of the X-talk interface to the base address of the
XM or ShopBus module. For example if a message is sent to X-talk interface 7 of the ShopBus module closest to the XM-
controller, the API address of the X-talk interface is 217.
An SM-115 ShopModule has 1 RGB control module with 5 RGB LED outputs. The API address of an RGB LED output is
the same as the base address of the RGB module. The specic RGB channel (A, B, C, D or E) can be indicated in the API
command itself. For example, if a message is sent to an RGB channel of the SM-115 module closest to the XM-controller,
the API address is 221.
Hardware setup
1. Connect one or more Elements to any of the X-talk interfaces on the XM-350 or SM-115 module(s).
2. Connect one or more RGB LED strips to any of the RGB LED outputs on the SM-115 module(s).
3. Connect a serial cable* to the API interface and to a 3rd party device (e.g. Digital Signage Player or PC).
4. Connect the SM-115 Module(s) to the XM-350 interface using ShopBus cables.**
5. Connect a 12VDC or 24VDC power supply to the 12-24VDC power socket on the SM-115 module(s).
Make sure the voltage of the power supply matches the RGB LED strips.
6. Connect a 5VDC power supply to the 5VDC power socket of the XM-350 module.
7. Wait until the green status LED on the XM-350 controller stops blinking. This lasts about 10 seconds.
*Nexmosphere has 2 serial cables available which are compatible with the XM-350: CA-9J9B (RJ9 to 3.5mm jack) and CA-9D9B (RJ9 to DB-9). Next to these
serial cables, a compatible Serial-to-USB cable is also available: CA-9U9B (RJ9 to USB-A). The driver for this cable can be downloaded here.
**Nexmosphere has 2 types of ShopBus cables available: black (CAS-N..B) and red (CAS-N..R). Black ShopBus cables don’t have power feedthrough and are
required for connecting SM-115 modules.
00X
1
API
DC
DCDCDCDC IN IN IN INOUT
OUT
OUTOUT
SD
4 3 2 1 8 7 6 5 4 3 2 1 8 7 6 5 4 3 2 1 8 7 6 5 4 3 2 1 8 7 6 5
LED
ERR
XM-350
21X
LED
31X
LED
81X
LED
91X
LED
SM-115
221
B A DC
24V
DC
24V
DC
24V
DC
24V
E D C
LED
SM-115
321
B A
E D C
LED
SM-115
821
B A
E D C
LED
SM-115
921
B A
E D C
LED
RGB X-talk RGB X-talk RGB X-talk RGB X-talk
Nexmosphere
Le Havre 136
5627 SW Eindhoven • The Netherlands
T [phone]
[e-mail]
QUICK START GUIDE


© 2021 Nexmosphere. All rights reserved. v1.0 / 06-21
All content contained herein is subject to change without prior notice.
1
DC. 5VDC Power input (2.5mm DC socket)
DC 24V. 12-24VDC Power input (2.1mm DC socket)
OUT. ShopBus Interface OUT (RJ25)
IN. ShopBus Interface IN (RJ25)
API. API interface (RJ9)
SD. SD card slot for bootloading
LED. Green status LED
ERR. Red error LED
Blue
Red
Green
+12/24 V

Software setup for testing (Terminal)
Typically, the XM-350 controller is connected to a 3rd party device, such as a Digital Signage Player, on which CMS software is installed which 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, Hercules or SerialTools.
2. Open the Terminal program and go to settings. Choose the COM port to which the XM-350 controller is connected*.
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 XM-350 controller, place a 75mS delay between each command.
*In case the XM-350 controller is connected via a Serial-to-USB cable or adapter, typically this is the highest available number in the COM port drop-down
setting.
Functionality
The XM-350 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.
3rd party devices and software
This Quick Start Guide oers a generic explanation of the setup and operation of the XM-350 controller with SM-100 ShopBus
Module. 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


© 2021 Nexmosphere. All rights reserved. v1.0 / 06-21
All content contained herein is subject to change without prior notice.
2

The RGB LED control commands for the SM-115 module are identical to the commands for the EM-6 module. To control
an RGB LED strip connected to RGB channel A, B, C, D or E of an SM-115 module, send one of the following API example
commands from the 3rd party device to the XM-350 controller:
Set the LED strip connected to RGB channel A of the RGB module with address 221 to color 0 (default white*) at 80%
brightness with 0.5 seconds ramp time:
*An overview of the default RGB LED colors is provided on the nal page of this document.
Set the LED strip of all 5 RGB channels (X) of the RGB module with address 221 to color 3 (default blue*) at 100% brightness
with 1.2 seconds ramp time:
Set the LED strip connected to RGB channel C of the RGB module with address 221 to pulse between 2 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.
G221B[A 0 80 5]
G221B[X 3 100 12]
G221B[B 2 100 10 2 5 5]
+
B
DC24V
R
G
+
B
R
G
+
B
DC24V
R
G
+
B
R
G
+
B
DC24V
R
G
+
B
R
G
+
B
DC24V
R
G
+
B
R
G
+
B
DC24V
R
G
+
B
R
G
+
B
DC24V
R
G
+
B
R
G
+
B
DC24V
R
G
+
B
R
G
+
B
DC24V
R
G
+
B
R
G
Power supply
(24V)
ShopBus
cable
(to XM-350)
B A
E D C
21X221

© 2021 Nexmosphere. All rights reserved. v1.0 / 06-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 an XY-Presence sensor connected to X-talk
interface 315 detects a person in distance zone 4, the
following API serial command is sent from the XM-350 to
the 3rd party device: X315A[4]
When an XY-Presence sensor connected to X-talk
interface 315 does not detect a person, the following API
serial command is sent from the XM-350 to the 3rd party
device: X315A[1]

When tag 2 is picked up from an antenna connected to
X-talk interface 218, the following API serial commands are
sent from the XM-350 to the 3rd party device:
XR[PU002]
X218A[1]
When tag 1 is placed on an antenna connected to X-talk
interface 218, the following API serial commands are sent
from the XM-350 to the 3rd party device:
XR[PB001]
X218A[0]
XR
XR-C10
(RFID antenna)
XR-C10
XR-DR1
(RFID antenna driver
XM-350
(Xperience
controller)
SM-115
(ShopBus module)
Power supply
(5V/2A)
CAS-N..B
(ShopBus cable)
CA-9U9B
(connect to
3rd party device)
8 7 6 5
4 3 2 1
221 21X
Power supply
(24V)
XNR-S13
(RFID tags nr 1-3)
12
3
XY-146
(presence sensor)
SM-115
(ShopBus module)
4 3 2 1
221 21X
SM-115
(ShopBus module)
4 3 2 1
321 31X
XM-350
(Xperience
controller)
Power supply
(5V/2A)
CAS-N..B
(ShopBus cable)
CAS-N..B
(ShopBus cable)
CA-9U9B
(connect to
3rd party device)
8 7 6 5 8 7 6 5
Power supply
(24V)
Power supply
(24V)
SM-115
(ShopBus module)
4 3 2 1
221 21X
SM-115
(ShopBus module)
4 3 2 1
321 31X
XM-350
(Xperience
controller)
Power supply
(5V/2A)
CAS-N..B
(ShopBus cable)
CAS-N..B
(ShopBus cable)
CA-9U9B
(connect to
3rd party device)
8 7 6 5 8 7 6 5
XT-B4N6
(4x bu�on interface)
XT-4F
(Touch bu�ons)
Push bu�ons
(with LED, 4x)
XT-B4
1 2 3 4
Power supply
(24V)
Power supply
(24V)
Example 4 | Button input
When button 1 of a (touch) button interface connected
to X-talk interface 314 is pressed, the following API serial
commands are sent from the XM-350 to the 3rd party
device: X314A[3]
When button 4 of a (touch) button interface connected
to X-talk interface 314 is pressed, the following API serial
commands are sent from the XM-350 to the 3rd party
device: X314A[17]

© 2021 Nexmosphere. All rights reserved. v1.0 / 06-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


To set all button LEDs of a (touch) button interface
connected to X-talk interface 314 to “on”, send the
following API commands from the 3rd party device to the
XM-350 controller:

To initiate an X-Wave LED pattern on an X-Wave connected
to X-talk interface 217, send one of the following API
example commands from the 3rd party device to the XM-
350 controller:
To set all button LEDs of a (touch) button interface
connected to X-talk interface 314 to “o”, send the
following API commands from the 3rd party device to the
XM-350 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
X314A[255]
X217B[240005]
X217B[399C1801020C180018]
X217B[499018001200009]
X314A[0]
XM-350
(Xperience
controller)
SM-115
(ShopBus module)
Power supply
(5V/2A)
CAS-N..B
(ShopBus cable)
CA-9U9B
(connect to
3rd party device)
8 7 6 5
4 3 2 1
221 21X
XW-L9
XW-L96
(X-Wave LED)
Power supply
(24V)
SM-115
(ShopBus module)
4 3 2 1
221 21X
SM-115
(ShopBus module)
4 3 2 1
321 31X
XM-350
(Xperience
controller)
Power supply
(5V/2A)
CAS-N..B
(ShopBus cable)
CAS-N..B
(ShopBus cable)
CA-9U9B
(connect to
3rd party device)
8 7 6 5 8 7 6 5
XT-B4N6
(4x bu�on interface)
XT-4F
(Touch bu�ons)
Push bu�ons
(with LED, 4x)
XT-B4
1 2 3 4
Power supply
(24V)
Power supply
(24V)

© 2021 Nexmosphere. All rights reserved. v1.0 / 06-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


The XM-350 Xperience controller with SM-115 ShopBus module has a scalable amount of 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 an XM-
350 with 2 SM-115 ShopBus modules. 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.
XY-146
(presence sensor)
XW-L9
XR
XR-C10
(RFID antenna)
XR-C10
XR-DR1
(RFID antenna driver
XNR-S13
(RFID tags nr 1-3)
XW-L96
(X-Wave LED)
XM-350
(Xperience
controller)
Power supply
(5V/2A)
CAS-N..B
(ShopBus cable) CAS-N..B
(ShopBus cable)
CA-9U9B
(connect to
3rd party device)
SM-115
(ShopBus module)
Power supplies
(24V)
SM-115
(ShopBus module)
CAX-M6W
(X-talk cable)
Power supply
(24V)
XT-B4N6
(4x bu�on interface)
XT-4F
(Touch bu�ons)
Push bu�ons
(with LED, 4x)
XT-B4 1 2 3 4
+
B
DC24V
R G
+
B R G
+
B
DC24V
R G
+
B R G
+
B
DC24V
R G
+
B R G
+
B
DC24V
R G
+
B R G
12
3

The SM-115 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 RGB LED colors. The RGB
LED output command for the SM-115 are identical with the commands for the EM-6 module.
R
G
B
0
100
100
100
1
R
G
B
100
0
0
2
R
G
B
0
100
0
3
R
G
B
0
0
100
4
R
G
B
100
75
0
5
R
G
B
100
0
100
6
R
G
B
0
100
100
7
R
G
B
100
25
0
8
R
G
B
100
0
50
9
R
G
B
50
100
0