HP Tips & tricks during installation and troubleshooting

From OpenMotics
Jump to navigation Jump to search

Introduction

The HP (Heat Pump) module is made to work in combination OpenMotics. This module will allow to built a full electric solution for Heating and Cooling in combination with a Heatpump. The HP module has following connections:

  • 6x NTC (temperature) probe connections
  • 4x 230VAC outputs
  • 2x Relay outputs (dry contacts)
  • 2x 0-10VDC inputs
  • 2x 0-10VDC outputs
  • 1x Aquastat input

Firmware information

Release notes

The Firmware release notes can be found here: HP Module Release Notes

Eeprom Memory Model

Location DEC Location HEX Description
0
0
Output Module ID_NE (Module is New "N" or Existing "E")
1
1
Output Module ID0
2
2
Output Module ID1
3
3
Output Module ID2
4
4
Output Module ID3
20
14
Sensor Module ID_NE (Module is New "N" or Existing "E")
21
15
Sensor Module ID0
22
16
Sensor Module ID1
23
17
Sensor Module ID2
24
18
Sensor Module ID3
64
40
Hardware Version
65
41
Firmware Version Major
66
42
Firmware Version Minor
67
43
Firmware Version Built
74
4A
Bootloader Flashmode variable
75
4B
Bootloader Timeout value
94
5E
Sensor debugging via local UART disabled (==255) or enabled (!=255)
95
5F
Sensor Refresh rate: Time (x40ms) between each cycle of sensors reading (Default 255x40ms=+/-10s)
96
60
PID0: Temperature Sensor (0-5) linked to this PID routine
97
61
PID0: Output (0-7) linked to this PID routine
98
62
PID0: PID P (MSB) Parameter
99
63
PID0: PID P (LSB) Parameter
100
64
PID0: PID I (MSB) Parameter
101
65
PID0: PID I (LSB) Parameter
102
66
PID0: PID D (MSB) Parameter
103
67
PID0: PID D (LSB) Parameter
104
68
PID0: PID Ti Parameter -> How often the I PID filter needs to be updated
105
69
PID0: PID I Clamp (MSB) -> Clamp value to avoid windup
106
6A
PID0: PID I Clamp (LSB) -> Clamp value to avoid windup
107
6B
PID0: PID OUT Clamp (MSB) -> Clamp value Output value
108
6C
PID0: PID OUT Clamp (LSB) -> Clamp value Output value
109
6D
PID0: Time (x10ms) between each PID execution (Default ?)
110
6E
PID0: Enable (==1 without local UART debug,==2 with local UART debug)/Disable (!=1 & !=2) PID
111
6F
PID0: Not in use
112
70
PID1: Temperature Sensor (0-5) linked to this PID routine
113
71
PID1: Output (0-7) linked to this PID routine
114
72
PID1: PID P (MSB) Parameter
115
73
PID1: PID P (LSB) Parameter
116
74
PID1: PID I (MSB) Parameter
117
75
PID1: PID I (LSB) Parameter
118
76
PID1: PID D (MSB) Parameter
119
77
PID1: PID D (LSB) Parameter
120
78
PID1: PID Ti Parameter -> How often the I PID filter needs to be updated
121
79
PID1: PID I Clamp (MSB) -> Clamp value to avoid windup
122
7A
PID1: PID I Clamp (LSB) -> Clamp value to avoid windup
123
7B
PID1: PID OUT Clamp (MSB) -> Clamp value Output value
124
7C
PID1: PID OUT Clamp (LSB) -> Clamp value Output value
125
7D
PID1: Time (x10ms) between each PID execution (Default ?)
126
7E
PID1: Enable (==1 without local UART debug,==2 with local UART debug)/Disable (!=1 & !=2) PID
127
7F
PID1: Not in use
128
80
PIDx: Reserved for additional PID filters
...
...
...
191
BF
PIDx: Reserved for additional PID filters
240
F0
Eeprom Protected Area: Production Year (DEC 0-99)
241
F1
Eeprom Protected Area: Production Month (DEC 1-12)
242
F2
Eeprom Protected Area: Production Day (DEC 1-31)
243
F3
Eeprom Protected Area: Production Company (DEC 0-9)
244
F4
Eeprom Protected Area: Serial Number MSB
245
F5
Eeprom Protected Area: Serial number LSB
246
F6
Eeprom Protected Area: Number of errors found during production testing

Configuration HVAC module

Command line Interface (CLI)

The Brain(+) has a command line interface that interacts directly with the Master processor of the Brain(+). Since the HVAC module communicates directly with the Master processor, it's a good practice to test functionality on this layer before integrating on a higher layer (graphical interface, cloud and others).

The Master processor has a CLI (Command Line Interface) with about 160 different instructions. Details regarding the CLI instruction set can be found here: CLI Reference Guide AIO and AIO Tips & tricks during installation and troubleshooting

In the portal, maintenance mode can be opened (or an UART cable can be used to directly connect to the Brain(+)).

Debug information will also appear on the HVAC module. This information can be seen by connecting an UART cable on the HVAC module (115200 baud).

Connecting the HVAC module

Connecting the HVAC module is easy:

  • Connect an UTP between the Brain(+) and the HVAC module to have the RS485 bus connected. Make sure to insert the termination plug on the first and the last module on the bus.
  • Connect the necessary NTC temperature sensors
  • Connect 230VAC on the HVAC module: The HVAC module doesn't use the power of the RS485 bus but uses its own power supply in case of Brain and/or bus power problem so fail safe can still happen on the HVAC module

Discovery of the HVAC module

Discovery of a new HVAC modules happens fully automatic and no manual actions are needed. In the below example, we plugged a new Input, CAN Control and HVAC module. As you can see below on the CLI output, the 3 modules have been added just after power on of the Brain:

----------Hardware Check------------
FRAM found
EEPROM found (255)
**I2C2 failed, address=152 i2cMode=4**
**DAC5574 not found**
Brain detected
AT24C02 found
MCP7940 RTC found
 -> Clock is running
PCA9534_1 found
PCA9539_1 found
PCA9539_2 found
LM75 found
Std (125kbps) CAN settings used
CAN speed is set at 125kbps
Search started
New Sensor module found: 084.001.126.000
New Input module (I) found: 073.017.243.000
New Can Control module found: 067.051.255.000
New Output module (O) found: 079.001.126.000
Search done

As you can see, 2 modules have the same ID2, ID3 & ID4 (These are the modules generated by the HVAC module). Performing the CLI instruction "error list" or "el" will give following result:

el
--- Total Uptime: 000442 Hours, Last Startup: 17:12:59 31/12/21   ---
--- Module Type: BRAIN, RS485 mode: 0, Board: 29'C  --.--V --.--A ---
--- PWR RS485/CAN: 1/1, CANTERM: 1, BB Debug: 255, Fw: 1.0.120       ---
-------Output------------ID---------Err-------Status--------Pwr---
 00 (l I 000->007) 108.000.000.000 00000   GOOD       (000)  1
 01 (O H 008->015) 079.001.126.000 00000   GOOD       (000)  0
-------Input-------------ID---------Err-------Status--------Pwr---
 00 (i I 000->007) 105.000.000.000 00000   GOOD       (000)  1
 01 (I E 008->015) 073.017.243.000 00000   GOOD       (016)  1
-------Sensor------------ID---------Err-------Status--------Pwr---
 00 (T H 000->007) 084.001.126.000 00000   GOOD       (080)  0
-------CAN Control-------ID---------Err-------Status--------Pwr---
 00 (C E 000->000) 067.051.255.000 00000   GOOD       (016)  1
OK

The 2 modules with "H" in the third column are the modules generated by the HVAC module:

  • 1 output module with ID79.1.126.0: The relays in the HVAC module are linked with this module
  • 1 Sensor module with ID84.1.126.0: The sensors of the HVAC module:
    • Sensor 0-5: External connected NTC's
    • Sensor 6: Not used
    • Sensor 7: Board sensor (Temperature and humidity)

The temperature list can be seen by using following CLI instruction:

sensor list
-Sensor---Temp (Offset)---Hum------Bright---CO2------VOC-----Dali--Setpoint--Th Mode--Name-----------
000 (T)  +22.0'C (+00)     NC       NC      NC       NC     255(0)   NC      000
001 (T)  +23.0'C (+00)     NC       NC      NC       NC     255(0)   NC      000
002 (T)  +23.0'C (+00)     NC       NC      NC       NC     255(0)   NC      000
003 (T)  +22.5'C (+00)     NC       NC      NC       NC     255(0)   NC      000
004 (T)  +22.5'C (+00)     NC       NC      NC       NC     255(0)   NC      000
005 (T)  +22.0'C (+00)     NC       NC      NC       NC     255(0)   NC      000
006 (T)    NC    (+00)     NC       NC      NC       NC     255(0)   NC      000
007 (T)  +27.0'C (+00)    039%      NC      NC       NC     255(0)   NC      000
OK

Configuring the HVAC module

The HVAC module has an onboard eeprom that contains all the configuration parameters. In the beginning of this page, you can find the memory model with all configuration bytes. We'll explain the use of these bytes in the following section.

Configuring the sensor parameters

As you can see in the Eeprom Memory Model, only 2 bytes are used to configure the sensors:

  • Byte 94: On the HVAC module, an UART cable can be connected on which debug information can be displayed. Also, after each temperature measurement of all sensors, a debug line will be printed on the UART console when Byte 94 is put at 0.
  • Byte 95: This byte will program the speed of sensor measurement, each unit is 40ms. Standard non programmed value in eeprom is 255 which means 255x40ms=+/-10s so every 10 seconds a measurement of all sensors is executed.

To have good PID results, a measurement of the sensors every 10 seconds is too slow, a measurement of 1 second should be much better so the value in eeprom should be put at 25. To accomplish this, we need to program this value in the eeprom of the remote HVAC module. To do so, we use the CLI instruction "eeprom write" followed by the 4 ID's of the module (can be the HVAC output or sensor module ID's), followed by the eeprom address and then the byte to be programmed.

eeprom write 79 1 126 0 95 25
OK

Configuring the PID parameters

Testing the PID filter