Master Release Notes

From OpenMotics
Jump to: navigation, search

Contents

General

The Master firmware is published as Open Source since firmware release V3.140.104. Below you'll find all the changes since that release.

The firmware updates happening in the Openmotics portal (Settings - Update) contain not only the firmware update of the Master, but also the firmware of other modules as well as the updates for the Beagle Bone Black. All these different firmware updates are assembled in a package which get's a general version number. This version number which you see in the portal is not the same as the Firmware Version of the Master. To check which firmware version is installed on the Master, in the Openmotics portal, go to Settings - Maintenance and open maintenance mode by pressing the Connect button. Type the instruction firmware version to read the Master Firmware version.

V3.143.65

Date: 28/1/2019

Resolved bugs

Added functionality

  • Array Clean Up
  • The current thermostat setpoints are being kept in eeprom (Page199/byte64-91). After a startup, the latest thermostat setpoint will be used.

V3.143.61

Date: 30/12/2018

Resolved bugs

  • The changes in V3.143.60 of the watchdog timer have generated an instability of the micro controller clock, this version resolves this issue.

Added functionality

V3.143.60

Date: 09/12/2018

Resolved bugs

  • None

Added functionality

  • Timing for the watchdog timer has been improved
  • Logging has been added so start time and reason is logged in eeprom, see memory model page 255.

V3.143.56

Date: 05/11/2018

Resolved bugs

  • None

Added functionality

  • "Group Follow Output" functionality has been added. Every output can have one group action defined, that group action will be executed on every output change. See Memory Model page 66.

V3.143.55

Date: 28/10/2018

Resolved bugs

  • In very rare circumstances, the master could become unresponsive. The root cause has been detected and resolved.
  • Modification have been made to the watchdog timer so in case of an unresponsiveness, within 8 seconds, the master will be restarted.

Added functionality

  • The Real Time clock now also stores the output status in RAM so in case of a power outage or restart, the lights and outputs (except for Roller/shutter modules in large installation mode will always be switched off when a restart is performed) will restores the latest output status (the dimmer value is not kept in RAM so it will go to 100%).

V3.143.51

Date: 19/10/2018

Resolved bugs

  • API Instruction "FX" gave CRC errors, this release resolves this bug

Added functionality

  • The API instruction "FX" has been expanded so not only CAN Control factory can be done but also partially erase of the CAN Control
  • The CLI instruction "can control erase" has been added
  • The API instruction "FV" during live mode of the bus has been enabled

V3.143.49

Date: 21/9/2018

Resolved bugs

  • When only outputs are configured on a Bus, the bus remains silent and actions dedicated to the output modules are not sent over the RS485 bus. This release solves the issue.

Added functionality

  • In previous releases, the leds of the modules are put in power safe mode automatically. In this release, the leds remain in standard mode and can be changed by using BA64.

V3.143.47

Date: 14/9/2018

Resolved bugs

  • Delayed queue action: delay time in Delay Queue Action (BA 235) has been corrected, a 1 second offset was present

Added functionality

  • Virtual shutters have been added

V3.143.37

Date: 25/8/2018

Resolved bugs

  • None

Added functionality

  • API instruction "WT" has been added to write Timer Value of the selected output

V3.143.36

Date: 21/8/2018

Resolved bugs

  • During start-up, not all timer values where updated resulting that for some lights, the timer was not working when the light was turned on for the first time, after the second time, the timer was working normally. This version is a fix for this bug.
  • When toggling an output off using Basic Action 162, the default timer value was not set in the active timer. This version is a fix of this bug.

Added functionality

  • Supports API instruction "FX" to erase internal and external eeprom of a slave module.

V3.143.35

Date: 2/8/2018

Resolved bugs

  • During start-up, the thermostat outputs used for cooling and heating (eeprom page 199 Byte 0-15) are not put in the correct state. This version resolves this issue.

Added functionality

  • None

V3.143.34

Date: 18/4/2018

Resolved bugs

  • None

Added functionality

  • In this version, a broadcast message will be sent to the CAN controls (Firmware version 3.1.22 or higher) once a minute to update the status of all CAN leds

V3.143.33

Date: 12/3/2018

Resolved bugs

  • In some circumstances, the API instruction "el" (error list) gave CRC miscalculations, this has been resolved in this release

Added functionality

  • None

V3.143.32

Date: 18/2/2018

Resolved bugs

  • In some circumstances, the timer function of virtual outputs did not work properly. This version resolves this problem.

Added functionality

  • The temperature sensors linked to thermostats have limited temperature range to avoid thermostats to trigger temperature/cooling demand with extreme values. In a standard configuration, the acceptable values will only work in a temperature range between 5 and 45 degree, values outside this range (only for sensors linked to thermostats) will be ignored (and thus not used nor displayed). These values can be modified in eeprom page 0 Byte 34 & 35, see Memory Model.

Known Issues

  • None

V3.143.28

Date: 14/11/2017

Resolved bugs

  • None

Added functionality

  • 1 function in Memory model added for repeated output messages (see Memory Model Page 0 Byte 33)
  • The messages of the input modules (which are captured by the CAN Control) will also contain output data which allows better consistency of the micro CAN leds. In order to work, the CAN Control needs at least Firmware version 3.1.17

Known Issues

  • None

V3.143.26

Date: 6/9/2017

Resolved bugs

  • None

Added functionality

  • Basic Action 75 and 76 have been added so the power of the micro CAN's can be switched ON and OFF

Known Issues

  • None

V3.143.25

Date: 12/8/2017

Resolved bugs

  • None

Added functionality

  • When a group action or other action is executed with multiple delayed action, the system is checking for doubles and removes any doubles. When a group action is written for example to switch ON/OFF multiple times the same light with delayed action (BA235), doubles are removed and this same light was only switched ON/OFF a single time. For this, BA79 has been added, see Action Types.

Known Issues

  • None

V3.143.24

Date: 5/7/2017

Resolved bugs

  • None

Added functionality

  • Basic Action 134, 135, 136 and 141 could only be used in normal thermostat mode, not in Thermostat Multi Tenant. To guarantee compatibility and usability with previous firmware versions, and the fact that the gateway will always put the installation in Multi-tenant mode, we've extended these Basic Actions to also work in Multi-tenant mode.

Known Issues

  • None

V3.143.20

Date: 8/6/2017

Resolved bugs

  • None

Added functionality

  • This version adds the support of up to 32 thermostats. Previous versions supported a maximum of 24 thermostats. See Memory Model Page 0 Byte 59.
  • Due to the above changes, API instructions "AR", "AW", "pL", "SL", "ml", "tl" and "TL" will have a variable number of bytes depending on the maximum number of thermostats defined in this eeprom value. See API Reference Guide.
  • Due to the above changes, some modifications have been made to the memory model for RDT10 support (H213/C217, H214/C218, H215/C219 and H216/C220)
  • This version supports the CLI instruction "discover can control" which allows, after adding DALI outputs, to add new virtual outputs modules without having to push the init button so DALI outputs can be added from distance
  • The Master API instruction "ST" has been modified so "ST" can read which page/byte is synchronising (between Master and the CAN control(s)) and can also change which page must be synchronised now.

Known Issues

  • None

V3.143.17

Date: 13/4/2017

Resolved bugs

  • When thermostats are used in heating mode, the outside temperature is compared with the thermostat threshold temperature. When the outside temperature is higher then the threshold temperature, the thermostat system should go in "OFF" state. This function was not working anymore as of Firmware version V3.143.x. This version fixes this bug

Added functionality

  • This version supports DALI functionality and DALI groups, see DALI Installation Guide
  • Basic Action 73 and 74 has been added to switch ON and switch OFF DALI groups, see Action Types
  • CLI instructions "sync page", "sync stop", "sync debug on" and "sync debug off" have been added, see CLI Reference Guide
  • Light Group functionality is added so multiple lights can follow a virtual output, see Light Groups

Known Issues

  • None

V3.143.10

Date: 29/2/2017

Resolved bugs

  • In some rare occasions, the thermostat pump doesn't switch on, this release will fix this issue
  • Basic Action 90 didn't work as expected, this release does fix this problem as well

Added functionality

  • None

Known Issues

  • None

V3.143.3

Date: 15/1/2017

Resolved bugs

  • None

Added functionality

  • Thermostat multi-tenancy has been added, see Thermostat Multi Tenant page.
  • BA (Basic Actions) 90 and 91 has been added to put individual thermostat in Automatic or Manual mode, see Action Types
  • Some old CLI commands have been removed
  • API instruction "ws" has been extended with config 67 to 71
  • API instruction "ml" has been added to read out the Thermostat Multi-Tenant configuration bytes

Known Issues

  • None

V3.142.24

Date: 12/12/2016

Resolved bugs

  • Bootloading was sometimes interrupted by normal Master communication making bootloading fail. This update will bring the RS485 bus in silent mode until the bootloader actions are done.

Added functionality

  • None

Known Issues

  • None

V3.142.23

Date: 12/12/2016

Resolved bugs

  • Sometimes, when leaving discovery mode (to add modules for example), the scanning of the modules stopped so no switches or outputs are responding anymore. This release fixes this issue.

Added functionality

  • None

Known Issues

  • None


V3.142.22

Date: 7/11/2016

Resolved bugs

  • None

Added functionality

  • Improvements were made for the slave bootloader functionality

Known Issues

  • None

V3.142.19

Date: 15/10/2016

Resolved bugs

  • None

Added functionality

  • In the Memory Model, at the input pages 2-31, byte 252 is used now. This byte indicates if an input module is a normal input module or a CAN input module. For more information, see Memory Model.
  • When more then 1 CAN control is used, faster synchronization is established by first synchronizing page 0 and output pages 33-62. This will make the programmed CAN leds to be enabled much faster.
  • When using the CLI instruction "error list", you will also see which modules are CAN modules. For more information, see CLI Reference Guide.


Known Issues

  • None

V3.142.18

Date: 6/9/2016

Resolved bugs

  • None

Added functionality

  • Basic Action 212 to 219 have been added. These Basic actions are able to switch ON/OFF CAN leds and activate different led functions. It's also possible to set the minimum and maximum brightness by using Basic Actions.
  • The CAN Control will also be added as an output module "C"
  • This firmware release will also support multiple CAN controls

Known Issues

  • Virtual outputs can not yet trigger CAN leds

V3.142.15

Date: 28/6/2016

Resolved bugs

  • None

Added functionality

  • Add virtual Sensor functionality, see Virtual Sensors
  • Add virtual input functionality, see Virtual Inputs
  • Add virtual output functionality, see Virtual Outputs
  • The Master software includes the RS485 additional eeprom information in the communication towards the input modules of the CAN Controller. The CAN Controller will act as a sniffer on the RS485 bus to know the different states of the input and output modules. The only way to properly structure all the data received on the RS485 bus is to know the exact configuration of system (which is stored in the eeprom of the Gateway). The changes made in this release will distribute the eeprom information of the Gateway to the input slave modules so it can be picked up by the CAN controller. After multiple minutes, the full configuration of the Gateway is copied to the CAN Controller through the input messages on the RS485 bus.
  • At Startup, for new installations, Large Installation mode will be automatically enabled

Known Issues

  • Virtual outputs can not yet trigger CAN leds

V3.141.34

Date: 24/04/2016

Resolved bugs

  • None

Added functionality

  • In the Memory Model, Page0 Byte30 has been added which enables/disables the sensor temperature correction. For more information, see Memory Model.

V3.141.31

Date: 20/03/2016

Resolved bugs

  • The 24 ports input module and the 24 ports output module gave some RS485 communication errors, this release solves these problems.

Added functionality

  • None

V3.141.30

Date: 17/01/2016

Resolved bugs

  • When pump groups with delay are programmed, sometimes, the pump output will be activated (when one of the pump outputs have been switched off and in a short period switched off again) and 30 seconds later switched off again. This was because the delay action was not cleaned. This is solved in this firmware version.
  • In some very rare circumstances when the thermostats are in automatic mode, an I2C error was detected by the master when reading eeprom temperatures values resulting the temperatures to be set at 20 degree. This bug has been resolved in this firmware version.

Added functionality

  • None

V3.141.29

Date: 30/12/2015

Resolved bugs

  • Basic Action 239 (Toggle freely assigned Bit) was not working
  • Discovery mode was not working properly due to a small bug in the API (instruction MI) between the Master processor and the Beagle Bone Black

Added functionality

  • None

V3.141.25

Date: 20/09/2015

Resolved bugs

  • None

Added functionality

  • The Dimmer follow function has been added for thermostats: When using multiple actuators in 1 room, it's useful to couple them together so 1 output can be used to drive all the linked actuators. This firmware version allows to use this feature in a thermostat setup. For more information how to use this feature in a more advanced thermostat setup, please see Daikin Setup.

V3.141.22

Date: 10/07/2015

Resolved bugs

  • In maintenance mode, in some circumstances, when wrong instruction are typed, no error message was returned.

Added functionality

  • None

V3.141.21 (General Version 1.5)

Date: 12/06/2015

Resolved bugs

  • When modules are disconnected (for example removed from the RS485 bus), the bus will slow down and makes the other modules less responsive since the Master will try to reconnect with non-responding module. This Bug fix will bring the non responding module offline after x number of tries (See Memory Model Page0/Byte29).

Added functionality

  • Basic Action 8 has been added which resets the bus errors and makes the system retry when a module has been put offline.

V3.141.19

Date: 09/05/2015

Resolved bugs

None

Added functionality

  • The number of Pulse counters inputs (for water, gas, electricity etc) is increased from 8 to 24
  • The API instruction of the Master has been changed to accommodate the 24 Pulse counters and a CRC has been added.
  • The memory model (Page 0 Byte 160-167) has been changed (Page 0 Byte 160-183) to be able to store the additional input numbers for the Pulse Counters
  • The memory model Page 195 (which holds the name of the 8 Pulse counters) have been moved to Page 98-99 to be able to store all 24 names of the Pulse Counters

V3.141.18

Date: 25/04/2015

Resolved bugs

  • In large installation mode, when using Roller/shutters in group with 1 button command (Basic Action 107), in some circumstances, 2 presses were needed to activate the Roller/shutters. This is solved in this firmware version.

Added functionality

  • This firmware adds the Cooling functions and supports the Daikin Airco system in combination with the RTD-10 control board. For more information, please consult the Heating/Cooling pages. For installation manual, see Daikin Setup
  • This firmware adds the Basic Action 60 so switches can generate events that are picked up the Beagle Bone black (by using for example the plugin-in system) or by the RTI equipment being used. An example: When a long press on a switch is used, all lights must go off and all my hifi and tv gear needs to be switched off as well.
  • This firmware adds the API instruction EV to sent Events to the beagle Bone black and RTI (when enabled) that are generated by Basic Action 60

V3.140.141

Date: 28/3/2015

Resolved bugs

  • None

Added functionality

  • For outputs that needs to follow another output, the Openmotics system allows you to program a "follow" function (1 output that follows the other). An example is a 0-10V dimmer: Some dimmers on the market doesn't switch off completely meaning that you need to put the dimmer on a relay output as well. At that moment, the dimmer output will be leading and the relay output will follow. Another example is that you've 2 outputs for the same light (or output) so 1 output needs to follow the other (if the first output goes on, the "follow" output will follow, the same when the output or light goes off). See Memory Model section 4.10 "Dimmer Follow Output" Page 65 in eeprom.

V3.140.131

Date: 29/11/2014

Resolved bugs

  • Switch Type Bug: In some rare circumstance and when traditional toggle switches are used, the user must apply 2 toggle actions to make the switch action to work. This bug has been resolved.

Added functionality

  • None

V3.140.129

Date: 2/11/2014

Resolved bugs

  • None

Added functionality

  • This firmware adds the Large Installation functionality that supports 30 additional Shutter/Store modules. This means that 30 input modules, 30 output modules and 30 Shutter/Store modules can be integrated with one single Gateway. The Large Installation option adds some additional API instructions, Memory model adaptions, error codes etc. All this information can be found on the Large Installation page.
  • New CLI instruction: timer queue list
Returns a list of all timer entries in the timer queue.


Returns
[Queue line] [action type] [action number] [timer input] [timer seconds]
[Queue line] [action type] [action number] [timer input] [timer seconds]
...

Example:

timer queue list
output:
000 102 005 240 119
001 106 015 240 035

V3.140.107

Date: 28/9/2014

Resolved bugs

  • None

Added functionality

  • Switch type selection: For installations that needs toggle switches instead of push buttons, the needed changes are added in the firmware to support this functionality. In the eeprom, an additional page (page 97) is used to configure the switch type of each input. For more details, please see Memory Model.

To change this setting, you can use the Openmotics portal or this can be done manual by using maintenance mode.

example: eeprom write 97 62 0 will program switch 62 as toggle switch, eeprom activate will activate the changes made in eeprom

V3.140.105 (General Version 1.4)

Date: 21/8/2014

Resolved bugs

  • Time bug: In some very rare occasions, the real time clock reports an hour higher than 23 making the time synchronization fail between the master and gateway controller. An additional check in the Master as well as the gateway controller has been added to avoid this sync failure.

Added functionality

  • None