Uponor Smatrix Base PRO X-147 User manual

Uponor Smatrix Base PRO Controller X-147
Modbus RTU interface
EN Installation manual

2 l Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual
1 Installation
1.1 General
With a Modbus RTU software update, the Base PRO controller can
be connected and integrated to a building management system
(BMS) through a Modbus-RTU connection over RS-485.
Note
Basic knowledge and training on BMS and Modbus RTU
is required for installation and setup of Base PRO with
Modbus RTU.
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
• Min/max levels for oor 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*
* Requires Heat Pump Integration via BMS to be activated in U_BMS.txt.
1.2 Preparation
# 1
# 2
# ...
1
Table of Contents
1 Installation................................................................................ 2
1.1 General...................................................................................... 2
1.2 Preparation ................................................................................ 2
1.3 Connecting the BMS cable ........................................................ 4
1.4 Modbus RTU settings ................................................................ 4
1.5 Installation example, Beckhoff 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 ....................................... 10
2.5 Frame format: Write Single Coil .............................................. 12
2.6 Frame format: Write Single Holding Register .......................... 13
2.7 Frame format: Write Multiple Coils .......................................... 15
2.8 Frame format: Write Multiple Holding Registers...................... 16
3 Available variables ................................................................ 17
3.1 Temperature conversion .......................................................... 17
3.2 Controller limitations ................................................................ 18
3.3 Coil data points........................................................................ 19
3.4 Discrete Input data points........................................................ 21
3.5 Input Register data points........................................................ 22
4 Troubleshooting .................................................................... 29

Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual l 3
X147_XYZ.hex
# 1
# 2
# ...
2
3
10 s
U_BMS.txt
U_BMS.txt
U_BMS.txt
# 1 Slave 1
# 2
# ...
Slave 2
Slave ...
4
Slave 1 Slave 2 Slave ...
5
Slave 1 Slave 2 Slave ...
BMS
6
To connect a BMS to the Uponor Smatrix Base PRO controller some
preparations must be made.
1. Connect and register thermostats, and system devices, to the
controllers.
Caution!
If an Uponor Smatrix Base PRO Interface I-147 is
connected, it must be unregistered and disconnected.
Note
Make sure that the thermostats are registered to
consecutive channels so the BMS can read and write
all channels in an efcient way. That is, addressing
multiple channels in one message.
See Uponor Smatrix Base PRO installation and operation manual,
or quick guide, for information registering devices to the controller.
2. Update the software of the controllers with the Modbus RTU
compatible software (available on the Uponor website).
See separate documentation for information on how to update the
software of a controller.
3. Press the <, OK, and >buttons simultaneously (for about
10 seconds) until the power LED ashes, and all channel LEDs
turn off. The controller has been reset to factory default.
4. Edit the U_BMS.txt le, on the controller microSD card, to setup
the controller Modbus RTU interface.
Available settings (default in bold):
- BMS Slave address: 1to 247
- BMS Baud rate: 19200 or 9600
- BMS Parity: even, odd, or no
- 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.
Repeat for each Base PRO controller in the system.
Caution!
Do not remove the microSD card while the controller
is powered on.
Note
Make sure the correct slave address is set (between
1 and 247, unique for each controller in the system),
and that the other setting match the Modbus RTU
settings in the BMS.
5. Connect the controllers to each other using the Base PRO
controller system device bus.
6. Connect the Base PRO system to the BMS.

4 l Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual
1.3 Connecting the BMS cable
The illustration below shows how to connect a BMS to the Modbus
RTU interface on the controller.
X-147
1
X-147
---+BAAAA
AB
BBB++--
GND(+)(-)
2
BMS
X-147
3
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.
Caution!
Depending of EMC conditions in the installation, and/
or distance between the devices, the - connection on
the Base PRO controller might be needed.
3. Connect power to the controller again.
See documentation from BMS supplier for more information about
BMS integration.
1.4 Modbus RTU settings
Congure 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, or no
• Flow control: No

Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual l 5
1.5 Installation example, Beckhoff Modbus RTU
PE PE
––
++
24V 0V
X0 00
BECKHOFF
CX9020
TC
FB1
FB2
HDD
HDD
2
1
PWR
X000 X100 X102
X103
DVI-D
X001
RS232
RS485
X101
X300
I-147
X-147
230 V AC
BMS
T-141
T-143
T-144
T-145
T-146
T-147
T-148
T-149
PRO
PRO
Beckhoff Modbus RTU
X300
AB–
24V 0V
LN
230 V AC
RxD+
RxD-
TxD-
TxD+
Caution!
If an Uponor Smatrix Base PRO Interface I-147 is
connected, it must be unregistered and disconnected.
Caution!
Depending of EMC conditions in the installation, and/or
distance between the devices, the - connection on the
Base PRO controller might be needed.

6 l Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual
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 bytes 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
2 Supported Modbus-RTU functions

Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual l 7
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
Examples:
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 byte 1 bytes 1 bytes 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 bytes 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 byte 1 bytes 1 bytes 2 bytes

8 l Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual
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
Examples:
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 bytes 1 bytes 2 bytes

Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual l 9
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
(0x00)
Holding register LO
Off (0x00)
CRC
1 byte 1 byte 1 byte 1 bytes 1 bytes 2 bytes
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
(0x00)
Holding register LO
2 °C (0x24)
CRC
1 byte 1 byte 1 byte 1 bytes 1 bytes 2 bytes

10 l Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual
2.4 Frame format: Read Input Registers
Request
Slave address
(0x01 – 0xF7)
Function code
(0x04)
Starting register address
(0x0000 – 0xFFFF)
Quantity of input 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)
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
Examples:
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 bytes 1 bytes ... 1 bytes 1 bytes 2 bytes
Request example: Read oor 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 oor 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 bytes 1 bytes ... 1 bytes 1 bytes 2 bytes

Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual l 11
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 bytes 1 bytes 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 bytes 1 bytes 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 bytes 1 bytes 2 bytes

12 l Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual
2.5 Frame format: Write Single Coil
Request
Slave address
(0x01 – 0xF7)
Function code
(0x05)
Starting register address
(0x0000 – 0xFFFF)
Output value to write
(0xFF00 = 1, 0x0000 = 0)
CRC
1 byte 1 byte 2 bytes 2 bytes 2 bytes
Response
Slave address
(0x01 – 0xF7)
Function code
(0x05)
Output address to write
(0x0000 – 0xFFFF)
Output value written
(0xFF00 = 1, 0x0000 = 0)
CRC
1 byte 1 byte 2 bytes 2 bytes 2 bytes
Response in case of error
Slave address
(0x01 – 0xF7)
Error code
(0x85)
Exception code
(01, 02, 03, 04, or 06)
CRC
1 byte 1 byte 1 byte 2 bytes
Example:
Request example: Change state from ECO to Comfort
Slave address
(0x01)
Function code
(0x05)
Starting register
address HI
(0x00)
Starting register
address LO
Register 2 (0x01)
Output value to write
HI
(0x00)
Output value to write
LO
(0x00)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example: Change state from ECO to Comfort
Slave address
(0x01)
Function code
(0x05)
Output address to
write HI
(0x00)
Output address to
write LO
Register 2 (0x01)
Output value written
HI
(0x00)
Output value written
LO
(0x00)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes

Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual l 13
2.6 Frame format: Write Single Holding Register
Request
Slave address
(0x01 – 0xF7)
Function code
(0x06)
Starting register address
(0x0000 – 0xFFFF)
Register value
(0x0000 – 0xFFFF)
CRC
1 byte 1 byte 2 bytes 2 bytes 2 bytes
Response
Slave address
(0x01 – 0xF7)
Function code
(0x06)
Output address to write
(0x0000 – 0xFFFF)
Output value written
(0x0000 – 0xFFFF)
CRC
1 byte 1 byte 2 bytes 2 bytes 2 bytes
Response in case of error
Slave address
(0x01 – 0xF7)
Error code
(0x86)
Exception code
(01, 02, 03, 04, or 06)
CRC
1 byte 1 byte 1 byte 2 bytes
Examples:
Request example: Write 23 ˚C (73.4 ˚F = value 734, 0x02DE) setpoint, channel 5
Slave address
(0x01)
Function code
(0x06)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 5 (0x04)
Register value HI
(0x02)
Register value LO
(0xDE)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example: Write 23 ˚C (73.4 ˚F = value 734, 0x02DE) setpoint, channel 5
Slave address
(0x01)
Function code
(0x06)
Output address to
write HI
(0x00)
Output address to
write LO
Start at 5 (0x04)
Output value written
HI
(0x02)
Output value written
LO
(0xDE)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Request example: Write 25 ˚C (77.0 ˚F = value 770, 0x0302) maximum oor temperature limit, channel 12
Slave address
(0x01)
Function code
(0x06)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 59 (0x3A)
Register value HI
(0x03)
Register value LO
(0x02)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example: Write 25 ˚C (77.0 ˚F = value 770, 0x0302) maximum oor temperature limit, channel 12
Slave address
(0x01)
Function code
(0x06)
Output address to
write HI
(0x00)
Output address to
write LO
Start at 59 (0x3A)
Output value written
HI
(0x03)
Output value written
LO
(0x02)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes

14 l Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual
Request example: Write 12 % comfort setting, channel 12
Slave address
(0x01)
Function code
(0x06)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 72 (0x47)
Register value HI
(0x00)
Register value LO
(0x0C)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example: Write 12 % comfort setting, channel 12
Slave address
(0x01)
Function code
(0x06)
Output address to
write HI
(0x00)
Output address to
write LO
Start at 72 (0x47)
Output value written
HI
(0x00)
Output value written
LO
(0x0C)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Request example: Write 5 ˚C (41.0 ˚F = value 410, 0x005A) heating/cooling offset temperature
Slave address
(0x01)
Function code
(0x06)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 73 (0x48)
Register value HI
(0x00)
Register value LO
(0x5A)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example: Write 5 ˚C (41.0 ˚F = value 410, 0x005A) heating/cooling offset temperature
Slave address
(0x01)
Function code
(0x06)
Output address to
write HI
(0x00)
Output address to
write LO
Start at 73 (0x48)
Output value written
HI
(0x00)
Output value written
LO
(0x5A)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes

Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual l 15
2.7 Frame format: Write Multiple Coils
Request
Slave address
(0x01 – 0xF7)
Function code
(0x0F)
Starting register
address
(0x0000 – 0xFFFF)
Quantity of outputs
(0x0001 – 0x07B0)
Byte count
(N)
Output value to write CRC
1 byte 1 byte 2 bytes 2 bytes 1 byte n bytes 2 bytes
Response
Slave address
(0x01 – 0xF7)
Function code
(0x0F)
Starting register address
(0x0000 – 0xFFFF)
Quantity of outputs
(0x0001 – 0x07B0)
CRC
1 byte 1 byte 2 bytes 2 bytes 2 bytes
Response in case of error
Slave address
(0x01 – 0xF7)
Error code
(0x8F)
Exception code
(01, 02, 03, 04, or 06)
CRC
1 byte 1 byte 1 byte 2 bytes
Example:
Request example: Changes states to Cooling and ECO
Slave address
(0x01)
Function code
(0x0F)
Starting
register
address HI
(0x00)
Starting
register
address LO
(0x00)
Quantity of
outputs HI
(0x00)
Quantity of
outputs LO
(0x02)
Byte count
(0x01)
Output value
to write
(0x03)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 1 byte ? bytes 2 bytes
Response example: Changes states to Cooling and ECO
Slave address
(0x01)
Function code
(0x0F)
Starting register
address HI
(0x00)
Starting register
address LO
(0x00)
Quantity of outputs
HI
(0x00)
Quantity of outputs
LO
(0x02)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes

16 l Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual
2.8 Frame format: Write Multiple Holding Registers
Request
Slave address
(0x01 – 0xF7)
Function code
(0x10)
Starting register
address
(0x0000 – 0xFFFF)
Quantity of registers
(0x0000
–
0x007B)
Byte count
(2*N)
N = quantity of
registers
Register value CRC
1 byte 1 byte 2 bytes 2 bytes 1 byte 2*N bytes 2 bytes
Response
Slave address
(0x01 – 0xF7)
Function code
(0x10)
Starting register address
(0x0000 – 0xFFFF)
Quantity of registers written
(0x0000 – 0x007B)
CRC
1 byte 1 byte 2 bytes 2 bytes 2 bytes
Response in case of error
Slave address
(0x01 – 0xF7)
Error code
(0x90)
Exception code
(01, 02, 03, 04, or 06)
CRC
1 byte 1 byte 1 byte 2 bytes
Example:
Request example: Write 23 ˚C (73.4 ˚F = value 734, 0x02DE) maximum setpoint limit and 18 ˚C (64.4 ˚F = value 644, 0x0284) minimum setpoint limit,
channel 5
Slave
address
(0x01)
Function
code
(0x10)
Starting
register
address HI
(0x00)
Starting
register
address
LO
Start at 21
(0x14)
Quantity of
registers
HI
(0x00)
Quantity of
registers
LO
(0x02)
Byte
count
(0x04)
Register
21 value
HI
(0x02)
Register
21 value
LO
(0xDE)
Register
22 value
HI
(0x02)
Register
22 value
LO
(0x84)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes
Response example: Write 23 ˚C (73.4 ˚F = value 734, 0x02DE) maximum setpoint limit and 18 ˚C (64.4 ˚F = value 644, 0x0284) minimum setpoint limit,
channel 5
Slave address
(0x01)
Function code
(0x10)
Starting register
address HI
(0x00)
Starting register
address LO
Start at 21 (0x14)
Quantity of registers
written HI
(0x00)
Quantity of registers
written LO
(0x02)
CRC
1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 2 bytes

Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual l 17
These variables are available when communicating with the Base
PRO controller (with the Modbus RTU compatible software installed).
3.1 Temperature conversion
The Uponor Smatrix Base PRO controller uses Fahrenheit to read
and calculate temperatures.
To convert the data value into celcius, use the following mathematical
formula.
Celcius = ((data value – 320)/1.8)/10
Note
If no data value is availabe the celcius value is set to
1802.6.
Temperature (absolute value)
Celsius (˚C) Fahrenheit (˚F) Data value Hex value
-40.0 -40.0 -400 0xFE70
-30.0 -22.0 -220 0xFF24
-20.0 -4.0 -40 0xFFD8
-17.8 0.0 0 0x0
-10.0 14.0 140 0x8C
-5.0 23.0 230 0xE6
0.0 32.0 320 0x140
1.0 33.8 338 0x152
5.0 41.0 410 0x19A
10.0 50.0 500 0x1F4
15.0 59.0 590 0x24E
18.0 64.4 644 0x284
20.0 68.0 680 0x2A8
21.0 69.8 698 0x2BA
25.0 77.0 770 0x302
30.0 86.0 860 0x35C
35.0 95.0 950 0x3B6
40.0 104.0 1040 0x410
3 Available variables
Temperature (relative value)
Celsius (˚C) Data value Hex value
0.1 2 0x02
1.0 18 0x13
4.0 72 0x48
5.0 90 0x5A
Humidity (absolute value)
Relative humidity (%) Hex value
0 0x0000
5 0x0005
10 0x000A
15 0x000F
20 0x0014
25 0x0019
30 0x001E
35 0x0023
40 0x0028
45 0x002D
50 0x0032
55 0x0037
60 0x003C
65 0x0041
70 0x0046
75 0x004B
80 0x0050
85 0x0055
90 0x005A
95 0x005F
100 0x0064

18 l Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual
3.2 Controller limitations
Cooling state
An ordinary Base PRO system (with touch screen, not connected
to a BMS) uses an offset temperature to adjust the setpoints when
switching between heating and cooling. This setting is only available
via the touch screen interface (I-167), which is not installed when
connected to a BMS.
When connected to a BMS, and the heating/cooling state is set
to cooling, the cooling offset is set to 0 ˚C (0 °F), leaving the zone
setpoints to be changed by the BMS.
ECO state
If the Base PRO system is set to ECO state the controller applies an
ECO setback value of 4 ˚C (4 °F) to the setpoints (which is shown in
the thermostats).
When the BMS reads the setpoint, when in ECO state, it will recieve
the actual setpoint (without the ECO setback value applied).
Example
Setpoint written/read from BMS 21 ˚C (69.8 °F)
Comfort/ECO state 1 (ECO)
Setpoint shown in thermostat 17 ˚C (62.6 °F)
Zones
The Base PRO controller can control a maximum of 6 actuator
channels, 12 if a slave module is installed. These channels are then
divided into zones which are linked to a thermostat.
A zone can consist of 1 to 12 channels, and not all channels must be
connected to an actuator and linked to a thermostat.
When writing to a channel, address the lowest channel number
(master channel) in the zone (if more chan one channel in the zone)
in order to change the value/state for the whole zone.
Comfort setting
The Base PRO can set a basic level of comfort for a zone when there
is no demand for heating. The value set is the percentage of time the
actuators are opened.
It will shorten the heat up time for the room, which is useful in rooms
where other heating sources, e.g. a replace, is present.
When the BMS reads the comfort setting it will recieve the actual
percentage.
Max/min limitations
If the BMS writes a setpoint to a zone, the Base PRO controller
applies maximum and minimum limitations before checking if there is
a demand for heating or cooling. The limited setpoint is also shown
on the thermostat.
The maximum and minumlimitations are also affected whether the
controller is set to Comfort or ECO state.
When the BMS reads the setpoint it will recieve the actual setpoint
(without limitation applied).
Example
Setpoint written/read from BMS 28 ˚C (82.4 °F)
Room setpoint max temperature 25 ˚C (77 °F)
Room setpoint min temperature 15 ˚C (59 °F)
Setpoint in room thermostat 25 ˚C (77 °F)
Comfort/ECO state 0 (Comfort)
Room temperature 20 ˚C (68 °F)
Heating demand YES
Dynamic heat curve offset in integrated heat
pump
The Base PRO system can dynamically adjust the heat curve offset
in a BMS integrated heat pump. The BMS reads the value from the
controller and sends it to the heat pump.
The heat curve can be offset between -10 ˚C and +10 ˚C (-10 ˚F and
+10 ˚F).
When the BMS reads the heat curve offset from the controller it will
recieve a absolute degree value to offset the heat curve in the heat
pump.
Caution!
The heat pump must be connected to the BMS.
Do not use the heat pump integration connectors on the
Base PRO controller.
Note
This function requires Heat pump integration via BMS
set to on on the microSD card to be activated.

Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual l 19
3.3 Coil data points
These datapoints can be both read or written, and contains the status of different controller settings (binary, on/off).
Note
1 = 0xFF00,
0 = 0x0000
Display name Register
address
(decimal)
Function code
(Hex)
Type Analogue/
Binary
Coding
Heating/Cooling state 00001
0x01 Read
Binary Unsigned.
1 = Cooling, 0 = Heating (default)
0x05 Write
0x0F Write multiple
Comfort/ECO state 00002
0x01 Read
Binary Unsigned.
1 = ECO, 0 = Comfort (default)
0x05 Write
0x0F Write multiple
Auto balancing on/off 00003
0x01 Read
Binary Unsigned.
1 = ON (default), 0 = Off
0x05 Write
0x0F Write multiple
Cooling not allowed channel 1 00004
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple
Cooling not allowed channel 2 00005
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple
Cooling not allowed channel 3 00006
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple
Cooling not allowed channel 4 00007
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple
Cooling not allowed channel 5 00008
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple
Cooling not allowed channel 6 00009
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple
Cooling not allowed channel 7 00010
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple
Cooling not allowed channel 8 00011
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple
Cooling not allowed channel 9 00012
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple

20 l Uponor Smatrix Base PRO Controller X-147 Modbus RTU interface l Installation manual
Display name Register
address
(decimal)
Function code
(Hex)
Type Analogue/
Binary
Coding
Cooling not allowed channel 10 00013
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple
Cooling not allowed channel 11 00014
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple
Cooling not allowed channel 12 00015
0x01 Read
Binary
Unsigned.
0 = Cooling not allowed
1 = Cooling allowed (default)
0x05 Write
0x0F Write multiple
Integrated heat pump defrost state* 00016
0x01 Read
Binary
Unsigned.
0 = Heat pump defrost off/stopped (default)
1 = Heat pump defrost started
0x05 Write
0x0F Write multiple
* Requires Heat Pump Integration via BMS to be activated in U_BMS.txt. It takes about 2 minutes for the actuators in the Base PRO system to be fully
opened.