Refine some smart-home-interface comments and descriptions

Author: Guzz-T

luxtronik/datatypes.py

@@ -877,7 +877,8 @@ class ControlMode(SelectionBase):
         0: "Off",       # System value is used
         1: "Setpoint",  # Setpoint register value is used
         2: "Offset",    # System values + offset register value is used
-        3: "Level",
+        3: "Level",     # System values + smart-home-interface-settings
+                        # register value is used
     }
 
 
@@ -887,9 +888,9 @@ class LpcMode(SelectionBase):
     datatype_class = "selection"
 
     codes = {
-        0: "No-Limit",
-        1: "Soft-Limit",
-        2: "Hard-Limit",
+        0: "No limit",
+        1: "Soft limit",
+        2: "Hard limit",
     }
 
 
@@ -899,8 +900,8 @@ class LockMode(SelectionBase):
     datatype_class = "selection"
 
     codes = {
-        0: "Unlocked / Off",
-        1: "Locked / On",
+        0: "Off",       # Function is not locked
+        1: "On",        # Function is locked
     }
 
 class OnOffMode(SelectionBase):
@@ -920,9 +921,15 @@ class LevelMode(SelectionBase):
 
     codes = {
         0: "Normal",     # No correction
-        1: "Increased",  # Increase the temperature by the values within the SHI-settings
-        2: "Increased",  # Increase the temperature by the values within the SHI-settings
-        3: "Decreased",  # Decrease the temperature by the values within the SHI-settings
+        1: "Increased",  # Increase the temperature by the values
+                         # within the smart-home-interface-settings
+                         # TODO: Function unknown – requires further analysis
+        2: "Increased2", # Increase the temperature by the values
+                         # within the smart-home-interface-settings
+                         # TODO: Function unknown – requires further analysis
+        3: "Decreased",  # Decrease the temperature by the values
+                         # within the smart-home-interface-settings
+                         # TODO: Function unknown – requires further analysis
     }
 
 class PowerLimit(ScalingBase):

luxtronik/definitions/holdings.py

@@ -1,5 +1,10 @@
 """
-Constant list containing the complete holdings definitions.
+Constant list containing all 'holdings' definitions
+used by the Smart Home Interface (SHI) of the Luxtronik controller.
+
+Unlike the setting registers, these SHI register are volatile and intended for
+communication with smart home systems. 'Holding' registers are readable
+and writable and are used to control the heat pump externally.
 """
 from luxtronik.datatypes import (
     Celsius,

luxtronik/definitions/inputs.py

@@ -1,5 +1,10 @@
 """
-Constant list containing the complete inputs definitions.
+Constant list containing all 'inputs' definitions
+used by the Smart Home Interface (SHI) of the Luxtronik controller.
+
+Unlike the setting registers, these SHI register are volatile and intended for
+communication with smart home systems. 'Input' register are read-only
+and are used for display or to control other devices.
 """
 from luxtronik.datatypes import (
     Celsius,