[ST Edge] NAMRON Panel Heater 540139X Series

SmartThings Edge Driver for the NAMRON Panel Heater 540139X Series

I have created a dedicated SmartThings Edge driver for the NAMRON AS 540139X Zigbee panel heater series, including the commonly used NAMRON 5401399 Panel Heater 1000 W.

This driver is intended for the Namron panel heaters sold in 400 W, 600 W, 800 W and 1000 W versions, in both white and black variants. These heaters are Zigbee thermostatic panel heaters with integrated temperature control, local display/buttons, electrical measurement and cumulative energy metering.

Out of the box, the device may be detected by SmartThings as a generic Zigbee meter, a Zigbee switch, Zigbee thing or only partially as a thermostat-like device. That is enough to prove that something Zigbee-ish is alive, but it is not enough to make the heater properly useful in SmartThings. A heater is not just a plug.

This driver adds proper SmartThings support for the thermostat, heating control, power monitoring and the Namron/Sunricher-specific configuration attributes.


Supported devices

The driver supports the NAMRON AS 540139X family:

Model Variant
5401392 400 W white
5401396 400 W black
5401393 600 W white
5401397 600 W black
5401394 800 W white
5401398 800 W black
5401395 1000 W white
5401399 1000 W black

The main tested device is the NAMRON AS 5401399, but the full 540139X family uses the same Zigbee implementation and is included in the driver fingerprints.

Manufacturer/model matching is done explicitly for:

Manufacturer: NAMRON AS
Models:       5401392, 5401393, 5401394, 5401395,
              5401396, 5401397, 5401398, 5401399

The driver also includes fallback fingerprints for the manufacturer spelling Namron, in case the device reports a slightly different manufacturer string.


Main features

The driver exposes the panel heater as a proper SmartThings thermostat/heater device with metering.

Thermostat and heating control

Supported:

  • Current room temperature
  • Heating setpoint
  • Thermostat mode: off / heat
  • Thermostat operating state: idle / heating
  • Switch-style on/off control mapped to thermostat mode
  • Refresh
  • Local temperature calibration

The switch tile is intentionally mapped to the thermostat mode:

  • On → heat mode
  • Off → off mode

This makes the heater easier to use in routines and automations, while the thermostat controls remain available as the more precise interface.


Temperature setpoint

The heater supports a heating setpoint range of:

5 °C to 35 °C

The driver exposes the setpoint with a normal thermostat-style UI and uses 0.5 °C steps.

Internally, Zigbee thermostat temperatures are handled in centi-degrees Celsius. For example:

19.0 °C = 1900
21.5 °C = 2150

The driver keeps that scaling explicit instead of pretending thermostats are simple switches wearing a nice plastic front panel.


Power and energy monitoring

The heater includes electrical measurement and energy metering. The driver supports:

  • Instantaneous power in watts
  • Voltage
  • Current
  • Cumulative energy in kWh

The device exposes these through standard Zigbee clusters:

Function Zigbee cluster
Energy metering Simple Metering 0x0702
Voltage/current/power Electrical Measurement 0x0B04

The driver reads and stores the device’s multiplier/divisor values and applies the correct scaling when reporting values to SmartThings.

This is important because raw Zigbee electrical values are not always already in user-facing units. The device may report something like “2301” and expect the driver to know that the divisor is 10. Without correct scaling, you either get a useful voltage reading or something that looks like the heater is powered by a small thunderstorm.


Namron/Sunricher-specific settings

The interesting part of this device is that several useful settings are not standard Zigbee thermostat attributes. They are manufacturer-specific attributes on the Thermostat cluster.

The driver supports the confirmed proprietary attributes used by the 540139X series.

Manufacturer code:

0x1224

Cluster:

Thermostat cluster 0x0201

Supported manufacturer-specific attributes:

Feature Attribute Description
Display brightness 0x1000 Local display brightness, 1–7
Display auto-off 0x1001 Whether the display turns off automatically
Power-up status 0x1004 Manual/default behaviour or restore last state
Window detection 0x1009 Enables/disables open-window detection
Hysteresis 0x100A Heating hysteresis, 0.5–2.0 °C
Window-open state 0x100B Read-only internal open-window state

These attributes require the correct manufacturer code on read, write and configure-reporting commands. Without that, the device will either ignore the request or treat the driver with the kind of silent contempt only Zigbee devices can truly master.


Device settings

The following settings are available through the SmartThings device settings/preferences:

  • Local temperature calibration
  • Child lock
  • Hysteresis
  • Display brightness
  • Display auto-off
  • Power-up behaviour
  • Window detection

The first release intentionally keeps these as device preferences instead of custom capabilities. That makes the driver simpler, more reliable and easier to test across the full 540139X family.

The goal was not to create a decorative capability museum. The goal was to make the heater work properly.


Child lock

The child lock is implemented through the standard Zigbee Thermostat User Interface Configuration cluster:

Cluster:   0x0204
Attribute: 0x0001 keypadLockout

This controls the physical button lock on the heater.


Hysteresis

The heater exposes hysteresis as a manufacturer-specific value.

The important detail is the scaling:

Raw value 5  = 0.5 °C
Raw value 10 = 1.0 °C
Raw value 20 = 2.0 °C

The SmartThings driver exposes this as normal user-facing values from 0.5 °C to 2.0 °C and handles the raw conversion internally.


Open-window detection

The heater has an internal open-window detection feature. When enabled, the heater can detect a sudden temperature drop and react accordingly.

The driver exposes:

  • A preference to enable/disable window detection
  • A read-only window-open state

The read-only window-open state is also mapped to a contact-style state in SmartThings so it can be used in routines.

Important: this does not mean the heater contains a physical contact sensor. It is a virtual representation of the heater’s own internal open-window detection state.


Zigbee technical details

The device uses endpoint 1 for its main functionality.

Known endpoint/cluster layout:

Endpoint 1

Profile:

Home Automation profile 0x0104

Device type:

Thermostat 0x0301

Input clusters include:

Cluster Name
0x0000 Basic
0x0003 Identify
0x0004 Groups
0x0005 Scenes
0x0009 Alarms
0x000A Time
0x0201 Thermostat
0x0204 Thermostat User Interface Configuration
0x0702 Simple Metering
0x0B04 Electrical Measurement

Output clusters include:

Cluster Name
0x0019 OTA Upgrade

The device may also expose the usual Zigbee Green Power proxy endpoint 242. The driver does not need to do anything special with that endpoint.


Reporting and configuration

On configuration, the driver binds and configures reporting for the important standard clusters and attributes:

  • Thermostat mode
  • Local temperature
  • Heating setpoint
  • Running state
  • Child lock
  • Energy metering
  • Voltage
  • Current
  • Active power
  • Namron/Sunricher-specific configuration attributes

The driver also reduces local temperature report spam by configuring a reportable change of 0.5 °C.

That is especially useful because some thermostatic devices like to report every tiny temperature movement. Technically impressive, practically annoying.


What is intentionally not implemented

A few things are deliberately not included in this release.

Local weekly schedule / program mode

The heater has local manual/auto concepts on the device itself, but the exact schedule/program implementation is not exposed cleanly enough through the confirmed public Zigbee implementation to justify guessing.

So the driver currently supports:

off
heat

It does not attempt to manage local weekly schedules.

That may be investigated later if reliable device logs or raw Zigbee traces confirm the exact behaviour.

Experimental Sunricher thermostat attributes

Only the confirmed attributes used by this Namron 540139X panel heater family are implemented.

There are related Sunricher/Namron thermostats with additional attributes for other hardware types, including floor-heating thermostats and PRO models. Those are intentionally not included here, because this driver is for the 540139X panel heater family.


Installation notes

Install the Namron Panel Heater driver through this channel, then pair or re-pair the heater with SmartThings.

If the heater was previously paired as a generic meter or generic Zigbee device, it may need to be removed and paired again so the new fingerprint can be applied.

After pairing, use Refresh once and wait a little while for the first attribute reports to arrive.

For best testing, check the following:

  1. Device pairs with the Namron Panel Heater driver
  2. Current temperature is shown
  3. Setpoint can be changed
  4. Heat/off works
  5. Power increases when the heater is actively heating
  6. Voltage/current/power/energy values are shown
  7. Child lock preference works
  8. Display brightness preference works
  9. Hysteresis preference writes correctly
  10. Window detection can be enabled/disabled

Why a dedicated driver?

Because this device is more than a generic Zigbee meter.

A generic handler may see the power metering part. A generic thermostat handler may see part of the thermostat. But this device combines:

  • Thermostat control
  • Electrical measurement
  • Energy metering
  • Local display behaviour
  • Child lock
  • Hysteresis
  • Power-up behaviour
  • Open-window detection

Some of that is standard Zigbee. Some of it is manufacturer-specific. A complete integration needs both.

That is exactly what this driver does.

It keeps the standard parts standard, handles the proprietary Namron/Sunricher parts explicitly, and avoids guessing where the device behaviour is not yet proven.


Current status

The driver has been tested with an external tester and the reported result is:

So this is no longer just a “maybe the clusters look right on paper” driver. It has been confirmed on real hardware.

As always with heating devices: test carefully, verify the displayed state against the physical device, and do not rely on untested automations for anything safety-critical.

A smart heater is still a heater. The “smart” part should make it more convenient, not more exciting.


Sources and references

The driver was developed and cross-checked against the following sources:

Great work @Andreas_Roedl !

(As I’m not in the position to test right now: What does the icon for the panel hester look like?)

Thermostat: