Error code 380 missing in ERROR_CODES + missing fallback for unknown codes

[mkaufmann0983]

Description:
First of all, thank you for maintaining this integration – it works great
and is very useful! I wanted to report a small issue I encountered after
the latest update.

• Boiler sends error code 380, which is not defined in ERROR_CODES (const.py)
• This caused all sensors to show "Unknown" after the update
• Fix applied locally:
  1. Added "380" as placeholder to ERROR_CODES in const.py
  2. Added dynamic fallback in HargassnerErrorSensor.native_value (sensor.py)
     to prevent HA exceptions for any future unknown error codes

Request:

1. Add correct description for error code 380 (see Hargassner manual)
2. Add the dynamic fallback as permanent fix in sensor.py

Thanks again for your work on this integration!

[github-actions]

AI Analysis

Technical Summary:

Technical Requirements and Constraints:

1. Error Code Addition: Define error code 380 in the ERROR_CODES dictionary within const.py with the correct description from the Hargassner manual.
2. Fallback Mechanism: Implement a dynamic fallback mechanism in the HargassnerErrorSensor.native_value method (sensor.py) to handle future unknown error codes without causing Home Assistant (HA) exceptions.

Implementation Considerations:

• Error Code Definition: Ensure that error code 380 is described accurately. Cross-reference with the official Hargassner manual to avoid misrepresentation.
• Dynamic Fallback: The fallback implementation should be generic and robust, providing meaningful feedback when an error code is not defined. For example, the fallback could display the raw error code or a message like "Error code not recognized."
• Backward Compatibility: Ensure that modifications to the sensor logic do not break existing user configurations or integrations

---

This summary was automatically generated by AI to help with triage and may not be 100% accurate.

[karlspace]

Hi @mkaufmann0983, thanks for reporting this – and for providing such a clear description with the root cause already identified! 🙌

You're right on both points. Here's the fix:

1. Error code 380

We cross-referenced all error codes against the official Hargassner Nano-PK manual. Error 380 is:

• DE: Wartung fällig, Werkswartung durchführen lassen
• EN: Service due - factory maintenance required

While at it, we expanded ERROR_CODES from 15 → 294 entries, covering the full Nano-PK manual. A few existing descriptions were also corrected to match the official wording.

2. Dynamic fallback for unknown error codes

Great catch — the underlying issue was subtle: the sensor uses SensorDeviceClass.ENUM, which means Home Assistant only accepts values listed in _attr_options. The existing f"Error {code}" fallback returned a string that wasn't in that list, causing HA to show "Unknown".

The fix now dynamically adds any unknown error code to the options list before returning it, so this can never happen again — regardless of which code your boiler sends. It also respects the configured language (Error 380 / Fehler 380).

Fix is on main, will be part of the next release. Thanks again for the detailed report!

[karlspace]

Fixed in commit 1479eaf. Will be included in the next release.