Uponor Smatrix Base PRO X-148 User manual

Uponor Smatrix Base PRO Controller X-148
Modbus RTU
EN Installation manual
CD0000403

Table of contents
1 Installation............................................................................. 3
1.1 General................................................................................... 3
1.2 Preparation............................................................................. 3
1.3 Connecting to the BMS cable................................................. 4
1.4 Modbus RTU settings............................................................. 5
1.5 Cabling and topology.............................................................. 5
1.6 Channel allocation.................................................................. 5
1.7 Installation example, Modbus RTU......................................... 5
2 Supported Modbus RTU functions...................................... 6
2.1 Frame format: Read Coil......................................................... 6
2.2 Frame format: Read Discrete Input......................................... 7
2.3 Frame format: Read Holding Registers.................................. 8
2.4 Frame format: Read Input Registers....................................... 9
2.5 Frame format: Write Single Coil............................................ 11
2.6 Frame format: Write Single Holding Register........................ 11
2.7 Frame format: Write Multiple Coils........................................ 13
2.8 Frame format: Write Multiple Holding Registers................... 13
3 Available variables.............................................................. 15
3.1 Temperature conversion....................................................... 15
3.2 Controller limitations............................................................. 15
3.3 Coil data points..................................................................... 16
3.4 Discrete Input data points..................................................... 19
3.5 Input Register data points..................................................... 21
3.6 Holding Register data points................................................. 22
4 Troubleshooting.................................................................. 29
4.1 No communication between controller and BMS.................. 29
4.2 Slow communication, or high latency, between Uponor
system and BMS................................................................... 29
4.3 Wrong parameters changed in Uponor system
compared to BMS settings.................................................... 29
2 | Uponor Smatrix Base PRO Controller X-148 Modbus RTU | Installation manual

1 Installation
1.1 General
Caution!
Send all settings from BMS, such as set points, limits,
override etc. cyclically. Max 30 minutes interval time is
recommended.
Note
Basic knowledge and training on BMS and Modbus RTU
is required for installation and setup of Base PRO with
Modbus RTU.
Note
General setup handling, such as thermostat registration,
can be found in the Quick Guide for Uponor Smatrix
Base PRO (X-147).
The Uponor Smatrix Base PRO Controller X-148 Modbus RTU is
preloaded with the correct software for connection and integration to
a building management system (BMS) through a Modbus RTU
connection over RS-485.
The BMS gets access to the following in the Base PRO system.
Read:
• Outdoor temperature
• Room temperature
• Floor temperature
• Humidity level
• Actuator status
• Pump or boiler status
• General purpose input (GPI) status
• Loss of thermostat connection
• Dynamic heat curve offset in integrated heat pump*
Read and write:
• Room setpoint
• Min/max levels for setpoint
• Activation of setpoint overrride for analog thermostats
• Min/max levels for floor temperature
• Heating/Cooling state
• Heating/Cooling offset
• Comfort/ECO
• Autobalancing on/off
• Cooling not allowed for a room
• Comfort setting
• Integrated heat pump defrost state*
• Relative humidity (RH) control
* Requires Heat Pump Integration via BMS to be activated in U_BMS.txt.
1.2 Preparation
Caution!
If an Uponor Smatrix Base PRO Interface I-147 is
connected, it must be unregistered and disconnected.
Caution!
Do not remove the microSD card while the controller is
powered on.
Caution!
Be careful when editing the configuration in the
U_BMS.txt file.
Preferably use Notepad in Windows since other editors
might add scrap and/or hidden characters to the file.
Note
Make sure that the thermostats are registered to
consecutive channels so the BMS can read and write all
channels in an efficient way. That is, addressing multiple
channels in one message.
Note
Make sure the correct slave address is set (between 1
and 247, unique for each controller in the system), and
that the other communication settings in the U_BMS.txt
file match the Modbus RTU settings in the BMS.
To connect a BMS to the Uponor Smatrix Base PRO controller some
preparations must be made.
1. Connect and register thermostats and system device
# 1
# 2
# ...
1
SI0000215
Connect and register thermostats, and system devices, to the
controllers.
See Uponor Smatrix Base PRO installation and operation
manual, or quick guide, for information registering devices to the
controller.
2. Software
The controller X-148 Modbus RTU is preloaded with the correct
software already when delivered.
Uponor Smatrix Base PRO Controller X-148 Modbus RTU | Installation manual | 3

3. Edit the U_BMS.txt file
U_BMS.txt
U_BMS.txt
U_BMS.txt
# 1 Slave 1
# 2
# ...
Slave 2
Slave ...
3
SI0000218
Edit the U_BMS.txt file, on the controller microSD card, to setup
the controller Modbus RTU interface.
Available settings (default in bold):
• BMS Slave address: 1 to 247
• BMS Baud rate: 19200 or 9600
• BMS Parity: even, odd, no (or none)
• Heat pump integration via BMS: off or on
on = enables dynamic heat curve offset in integrated heat
pump, and integrated heat pump defrost state.
• Exclude zone from heat curve offset calculation:
0, or 1 through 12 (0 = no channel)
Select master channels of the zones (lowest numbered
channel in the zone) to exclude.
The zone subchannels follow the state of the master
channel.
Example: 3,5,12 = exludes channels with master channels
3, 5 and 12.
• Bypass zone: 0, or 1 to 12 (0 = no channel, example: 3,12)
Select master channels of the zones (lowest numbered
channel in the zone) to bypass, MAXIMUM 2 channels.
The zone subchannels follow the state of the master
channel.
Example: 4,12 = bypasses zones with master channels 4
and 12.
• Ceiling cooling channel: 0, or 1 to 12 (0 = no channel,
example: 1,4,10)
Select the channels which controls ceiling cooling in the
zones. The zone subchannels will not follow the state of the
master channel.
Example: 1,4,10 = set ceiling cooling to channels 1, 4 and
10.
• BMS Temperature format: c or f
c = Celsius, f = Fahrenheit
Repeat for each Base PRO controller in the system.
4. Connect the controllers
Slave 1 Slave 2 Slave ...
4
SI0000219
Connect the controllers to each other using the Base PRO
controller system device bus.
5. Connect the Base PRO system
Slave 1 Slave 2 Slave ...
BMS
5
SI0000220
Connect the Base PRO system to the BMS.
1.3 Connecting to the BMS cable
Caution!
Depending on EMC conditions in the installation, and/or
distance between the devices, the "-" connection on the
Base PRO controller might be needed.
X-148
1
SI0000221
X-148
---
+BA A AAA BBBB ++ - -
2
BMS
SI0000222
X-148
3
SI0000223
The illustrations above show how to connect a BMS to the Modbus
RTU interface on the controller.
4 | Uponor Smatrix Base PRO Controller X-148 Modbus RTU | Installation manual

To connect a BMS to the controller:
1. Ensure that the power is disconnected from the controller.
2. Connect the BMS cable to the Base PRO controller system
device bus.
Study the wiring diagrams of the controller to locate the
connector position.
3. Connect power to the controller again.
See documentation from BMS supplier for more information about
BMS integration.
1.4 Modbus RTU settings
Configure the Modbus RTU interface in the BMS to match the
controller settings:
• Bitrate: 19200 or 9600 bps
• Data bits: 8
• Stop bits: 1
• Parity bit: even, odd, no (or none)
• Flow control: No
1.5 Cabling and topology
Caution!
Be thorough about the cabling and connections.
Only use Uponor recommended cables and go for a line
bus topology.
Caution!
Be prepared to add 120 ohm termination resistors
between “A” and “B” on end devices, if the total bus
length goes over 250 m or if any communication
problems are noticed.
Caution!
Always connect also the “-“ between the controllers on
the global bus and to the BMS.
1.6 Channel allocation
Note
For multiple channel rooms, only operate on the first
channel, i.e. the master channel.
1.7 Installation example, Modbus
RTU
Caution!
The Uponor Smatrix Base PRO Interface I-147 cannot be
used in Modbus RTU installations.
I-147
X-148
230 V AC
T-141
T-143
T-144
T-145
T-146
T-148
T-149
PRO
PRO
AB –
230 V AC
BMS
SD0000033
Uponor Smatrix Base PRO Controller X-148 Modbus RTU | Installation manual | 5

2 Supported Modbus RTU functions
The Base PRO controller supports the following functions for Modbus
RTU communication.
Description Function code (hex)
Read Coil 0x01
Read Discrete Input 0x02
Read Holding Registers 0x03
Read Input Registers 0x04
Write Single Coil 0x05
Write Single Holding Register 0x06
Write Multiple Coils 0x0F
Write Multiple Holding Registers 0x10
• Discrete Inputs (read only) and Coils (read and write) are
function codes consisting of 1 bit of data. Most often on or off.
• Input Registers (read only) and Holding Registers (read and
write) are function codes consisting of 2 bytes (16 bit) of data.
Most often temperature data or settings.
2.1 Frame format: Read Coil
Request
Slave address
(0x01 – 0xF7)
Function code
(0x01)
Starting register address
(0x0000 – 0xFFFF)
Number of coils to read
(1 – 2000)
CRC
1 byte 1 byte 2 bytes 2 bytes 2 bytes
Response
Slave address
(0x01 – 0xF7)
Function code
(0x01)
Byte count
(N)
Coil status
(n = N, or n=N+1 if the number of coils to
read can be divided by 8 with a reminder
separated from 0)
CRC
1 byte 1 byte 1 byte n bytes 2 bytes
Response in case of error
Slave address
(0x01 – 0xF7)
Error code
(0x81)
Exception code
(01, 02, 03, 04, or 06)
CRC
1 byte 1 byte 1 byte 2 bytes
Example:
Request example:Read Heating/Cooling and Comfort/ECO states
Slave address
(0x01)
Function code
(0x01)
Starting register
address HI
(0x00)
Starting register
address LO
(0x00)
Number of coils to
read HI
(0x00)
Number of coils to
read LO
(0x02)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read Heating/Cooling and Comfort/ECO states
Slave address
(0x01)
Function code
(0x01)
Byte count
(0x01)
Coil status
1 to 8 (0x02)
CRC
1 byte 1 byte 1 byte 1 byte 2 bytes
6 | Uponor Smatrix Base PRO Controller X-148 Modbus RTU | Installation manual

2.2 Frame format: Read Discrete Input
Request
Slave address
(0x01 – 0xF7)
Function code
(0x02)
Starting register address
(0x0000 – 0xFFFF)
Number of coils to read
(1 – 2000)
CRC
1 byte 1 byte 2 bytes 2 bytes 2 bytes
Response
Slave address
(0x01 – 0xF7)
Function code
(0x02)
Byte count
(N)
Coil status
(n = N, or n=N+1 if the number of coils to
read can be divided by 8 with a reminder
separated from 0)
CRC
1 byte 1 byte 1 byte n bytes 2 bytes
Response in case of error
Slave address
(0x01 – 0xF7)
Error code
(0x82)
Exception code
(01, 02, 03, 04, or 06)
CRC
1 byte 1 byte 1 byte 2 bytes
Example:
Request example:Read all discrete inputs
Slave address
(0x01)
Function code
(0x02)
Starting register
address HI
(0x00)
Starting register
address LO
(0x00)
Number of coils to
read HI
(0x00)
Number of coils to
read LO
14 bits (0x0E)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read all discrete inputs
Slave address
(0x01)
Function code
(0x02)
Byte count
(0x02)
Coil status 1 to 8
(0xAA)
Coil status 9 to 16
(0x0A)
CRC
1 byte 1 byte 2 bytes 1 byte 1 byte 2 bytes
Request example:Read actuator status, channel 12
Slave address
(0x01)
Function code
(0x02)
Starting register
address HI
(0x00)
Starting register
address LO
Register 12 (0x0B)
Number of coils to
read HI
(0x00)
Number of coils to
read LO
1 bit (0x01)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read actuator status, channel 12
Slave address
(0x01)
Function code
(0x02)
Byte count
(0x01)
Coil status channel 12
ON (0x01)
CRC
1 byte 1 byte 1 byte 1 byte 2 bytes
Request example:Read actuator status, all channels
Slave address
(0x01)
Function code
(0x02)
Starting register
address HI
(0x00)
Starting register
address LO
(0x00)
Number of coils to
read HI
(0x00)
Number of coils to
read LO
12 bits (0x0C)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read actuator status, all channels
Slave address
(0x01)
Function code
(0x02)
Byte count
(0x02)
Coil status 1 to 8
(0xAA)
Coil status 9 to 12
(0x0A)
CRC
1 byte 1 byte 2 bytes 1 byte 1 byte 2 bytes
Uponor Smatrix Base PRO Controller X-148 Modbus RTU | Installation manual | 7

2.3 Frame format: Read Holding Registers
Request
Slave address
(0x01 – 0xF7)
Function code
(0x03)
Starting register address
(0x0000 – 0xFFFF)
Quantity of holding registers to read
(0x0001 – 0x007D)
CRC
1 byte 1 byte 2 bytes 2 bytes 2 bytes
Response
Slave address
(0x01 – 0xF7)
Function code
(0x03)
Byte count
(2*N) N = quantity of registers
Holding register CRC
1 byte 1 byte 1 byte 2*N bytes 2 bytes
Response in case of error
Slave address
(0x01 – 0xF7)
Error code
(0x83)
Exception code
(01, 02, 03, 04, or 06)
CRC
1 byte 1 byte 1 byte 2 bytes
Example:
Request example:Read setpoints (21.0 ˚C / 69.8 ˚F = value 689, 0x02BA),12 channels
Slave address
(0x01)
Function code
(0x03)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 1 (0x00)
Quantity of holding
registers to read HI
(0x00)
Quantity of holding
registers to read LO
12 channels (0x0C)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read setpoints (21.0 ˚C / 69.8 ˚F = value 689, 0x02BA),12 channels
Slave address
(0x01)
Function code
(0x03)
Byte count
(0x18)
Holding
register HI
(channel 1)
(0x02)
Holding
register LO
(channel 1)
(0xBA)
... Holding
register HI
(channel 12)
(0x02)
Holding
register LO
(channel 12)
(0xBA)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte ... 1 byte 1 byte 2 bytes
Request example:Read setpoint (21.0 ˚C / 69.8 ˚F = value 689, 0x02BA), channel 10
Slave address
(0x01)
Function code
(0x03)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 10 (0x09)
Quantity of holding
registers to read HI
(0x00)
Quantity of holding
registers to read LO
1 channel (0x01)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read setpoint (21.0 ˚C / 69.8 ˚F = value 689, 0x02BA), channel 10
Slave address
(0x01)
Function code
(0x03)
Byte count
(0x02)
Holding register HI
(0x02)
Holding register LO
(0xBA)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Request example:Read comfort setting, channel 12
Slave address
(0x01)
Function code
(0x03)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 72 (0x47)
Quantity of holding
registers to read HI
(0x00)
Quantity of holding
registers to read LO
1 channel (0x01)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read comfort setting, channel 12
Slave address
(0x01)
Function code
(0x03)
Byte count
(0x02)
Holding register HI
(0x02)
Holding register LO
(0xBA)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
8 | Uponor Smatrix Base PRO Controller X-148 Modbus RTU | Installation manual

Request example:Read heating/cooling offset temperature
Slave address
(0x01)
Function code
(0x03)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 73 (0x48)
Quantity of holding
registers to read HI
(0x00)
Quantity of holding
registers to read LO
(0x01)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read heating/cooling offset temperature
Slave address
(0x01)
Function code
(0x03)
Byte count
(0x02)
Holding register HI
(0x02)
Holding register LO
2 °C (0x24)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
2.4 Frame format: Read Input Registers
Request
Slave address
(0x01 – 0xF7)
Function code
(0x04)
Starting register address
(0x0000 – 0xFFFF)
Quantity of holding registers to read
(0x0001 – 0x007D)
CRC
1 byte 1 byte 2 bytes 2 bytes 2 bytes
Response
Slave address
(0x01 – 0xF7)
Function code
(0x04)
Byte count
(2*N) N = quantity of registers
Input register CRC
1 byte 1 byte 1 byte 2*N bytes 2 bytes
Response in case of error
Slave address
(0x01 – 0xF7)
Error code
(0x84)
Exception code
(01, 02, 03, 04, or 06)
CRC
1 byte 1 byte 1 byte 2 bytes
Example:
Request example:Read room temperature data (21.0 ˚C / 69.8 ˚F = value 689, 0x02BA) for all zones
Slave address
(0x01)
Function code
(0x04)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 2 (0x01)
Quantity of input
registers to read HI
(0x00)
Quantity of input
registers to read LO
12 channels (0x0C)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read room temperature data (21.0 ˚C / 69.8 ˚F = value 689, 0x02BA) for all zones
Slave address
(0x01)
Function code
(0x04)
Byte count
(0x18)
Input register
HI (channel 1)
(0x02)
Input register
LO (channel 1)
(0xBA)
... Input register
HI (channel
12)
(0x02)
Input register
LO (channel
12)
(0xBA)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte ... 1 byte 1 byte 2 bytes
Uponor Smatrix Base PRO Controller X-148 Modbus RTU | Installation manual | 9

Request example:Read floor temperature data (21.0 ˚C / 69.8 ˚F = value 689, 0x02BA) for all zones
Slave address
(0x01)
Function code
(0x04)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 26 (0x19)
Quantity of input
registers to read HI
(0x00)
Quantity of input
registers to read LO
12 channels (0x0C)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read floor temperature data (21.0 ˚C / 69.8 ˚F = value 689, 0x02BA) for all zones
Slave address
(0x01)
Function code
(0x04)
Byte count
(0x18)
Input register
HI (channel 1)
(0x02)
Input register
LO (channel 1)
(0xBA)
... Input register
HI (channel
12)
(0x02)
Input register
LO (channel
12)
(0xBA)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte ... 1 byte 1 byte 2 bytes
Request example:Read humidity value (85% RH) for channel 12
Slave address
(0x01)
Function code
(0x04)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 25 (0x18)
Quantity of input
registers to read HI
(0x00)
Quantity of input
registers to read LO
1 channel (0x01)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read humidity value (85% RH) for channel 12
Slave address
(0x01)
Function code
(0x04)
Byte count
(0x02)
Input register HI
(0x00)
Input register LO
(0x55)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Request example:Read thermostat loss alarm
Slave address
(0x01)
Function code
(0x04)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 38 (0x25)
Quantity of input
registers to read HI
(0x00)
Quantity of input
registers to read LO
(0x01)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Read thermostat loss alarm
Slave address
(0x01)
Function code
(0x04)
Byte count
(0x02)
Input register HI
(0x08)
Input register LO
(0x01)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Request example:Offset heat pump heat curve with -10 degrees
Slave address
(0x01)
Function code
(0x04)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 39 (0x26)
Quantity of input
registers to read HI
(0x00)
Quantity of input
registers to read LO
(0x01)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example:Offset heat pump heat curve with -10 degrees
Slave address
(0x01)
Function code
(0x04)
Byte count
(0x02)
Input register HI
(0x00)
Input register LO
(0xF6)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
10 | Uponor Smatrix Base PRO Controller X-148 Modbus RTU | Installation manual