Add support for OWON AC221 IR controller #11106

jacky202509 · 2025-12-26T08:13:41Z

Summary

This PR adds support for the OWON AC221, an IR (infrared) controller device.

The AC221 is an IR-only device and does not provide real state feedback from
controlled appliances, therefore optimistic control is used.

Changes

Add a new device definition for the OWON AC221 IR controller
Define the OWON private cluster with proper TypeScript typing
Implement one-key pairing as a SET-only action
Parse and expose one-key pairing result data from the device
Avoid unknown (?) UI states in zigbee2mqtt

Motivation

Previously, the AC221 was not supported and one-key pairing resulted in an
unknown state in the UI. Since IR devices are inherently one-way, treating
pairing as an action instead of a readable state better matches the device
behavior and improves user experience.

Compatibility

No breaking changes
Existing devices and configurations are unaffected

Tested with

OWON AC221
zigbee2mqtt (latest)

…tures (Koenkk#10369)

…kk/zigbee2mqtt.io#4289

…29034

…ostat (Koenkk#10387)

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> Co-authored-by: Koen Kanters <[email protected]>

…kk#10399)

…k#10396) Co-authored-by: MaDMaLKaV <[email protected]> Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> Co-authored-by: Koen Kanters <[email protected]>

…perature_humidity_sensor_2 Koenkk/zigbee2mqtt#29137

Co-authored-by: ptvoinfo <[email protected]>

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> Co-authored-by: Koen Kanters <[email protected]>

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

…mp meter - Introduce DP135 to expose high-precision AC frequency - Only expose high-precision frequency for devices with applicationVersion >= 132 - Update tuyaDatapoints and exposes accordingly - Ensures backward compatibility for older devices

Koenkk · 2025-12-26T14:27:42Z

src/devices/owon.ts

        },
    } satisfies Fz.Converter<"fallDetectionOwon", OwonFallDetection, ["attributeReport", "readResponse"]>,
+
+    cb432Metering: {


Why is this needed? m.electricityMeter should cover this.

Thanks for the suggestion. I agree this is standard Electrical Measurement
functionality. To keep this PR focused on the CB432 device, I’ll remove the
device-specific alarm handling here and consider adding a generic
modernExtend in a separate PR.

Koenkk · 2025-12-26T14:28:50Z

src/devices/owon.ts

+        convert: (model, msg, publish, options, meta) => {
+            const result: KeyValue = {};
+
+            if (msg.data.acAlarmsMask !== undefined || msg.data[2048] !== undefined) {


given this is standard functionality, this can be added to

zigbee-herdsman-converters/src/lib/modernExtend.ts

Line 1893 in 5c1bd02

function genericMeter(args: MeterArgs = {}) {

Thanks for the suggestion. I agree this is standard Electrical Measurement
functionality. To keep this PR focused on the CB432 device, I’ll remove the
device-specific alarm handling here and consider adding a generic
modernExtend in a separate PR.

Koenkk · 2025-12-26T14:28:56Z

src/devices/owon.ts

+        },
+    } satisfies Fz.Converter<"haElectricalMeasurement", undefined, ["attributeReport", "readResponse"]>,
+
+    owonCb432ThresholdRead: {


Same as https://github.com/Koenkk/zigbee-herdsman-converters/pull/11106/changes#r2648314362

Thanks for the suggestion. I agree this is standard Electrical Measurement
functionality. To keep this PR focused on the CB432 device, I’ll remove the
device-specific alarm handling here and consider adding a generic
modernExtend in a separate PR.

Koenkk · 2025-12-26T14:29:13Z

src/devices/owon.ts

+    owonAcOneKeyPairingResponse: {
+        cluster: "manuSpecificOwonAc",
+        type: ["commandOneKeyPairingResponse", "commandOneKeyPairingResultUpdate"],
+        // biome-ignore lint/suspicious/noExplicitAny: required for converter compatibility


Please remove (and don't use any below`)

I had remove it

Koenkk · 2025-12-26T14:29:27Z

src/devices/owon.ts

+            }
+
+            return payload;
+        },


Use satisfies Fz.Converter< with the custom cluster definition here

Adjusted to satisfies Fz.Converter for the manufacturer-specific cluster; command types are kept untyped as they are not part of ZCL definitions.

Koenkk · 2025-12-26T14:29:42Z

src/devices/owon.ts

+                };
+            }
+            return {};
+        },


Same as https://github.com/Koenkk/zigbee-herdsman-converters/pull/11106/changes#r2648315108

Adjusted to satisfies Fz.Converter for the manufacturer-specific cluster; command types are kept untyped as they are not part of ZCL definitions.

Koenkk · 2025-12-26T14:30:06Z

src/devices/owon.ts

+
+    owonCB432Threshold: {
+        key: ["over_voltage_threshold", "over_current_threshold", "over_power_threshold"],
+        convertSet: async (entity, key, value, meta) => {


Same as https://github.com/Koenkk/zigbee-herdsman-converters/pull/11106/changes#r2648314362

Thanks for the suggestion. I agree this is standard Electrical Measurement
functionality. To keep this PR focused on the CB432 device, I’ll remove the
device-specific alarm handling here and consider adding a generic
modernExtend in a separate PR.

Koenkk · 2025-12-26T14:30:40Z

src/devices/owon.ts

        model: "CB432",
        vendor: "OWON",
        description: "32A/63A power circuit breaker",
-        extend: [m.onOff(), m.electricityMeter({cluster: "metering"})],


Please keep these extends here (same for other definitions)

Thanks for the suggestion. I agree this is standard Electrical Measurement
functionality. To keep this PR focused on the CB432 device, I’ll remove the
device-specific alarm handling here and consider adding a generic
modernExtend in a separate PR.

Koenkk · 2025-12-26T14:30:54Z

src/devices/owon.ts

                ID: 0xfd00,
                manufacturerCode: Zcl.ManufacturerCode.OWON_TECHNOLOGY_INC,
                attributes: {
-                    status: {ID: 0x0000, type: Zcl.DataType.ENUM8, write: true, max: 0xff},


Why was this removed?

This attribute is now defined via deviceAddCustomCluster. In this typed definition write is not a supported property anymore, so it’s omitted while keeping the same functionality.

Koenkk · 2025-12-26T14:31:18Z

src/devices/owon.ts

        extend: [
-            m.onOff({endpointNames: ["l1", "l2", "l3"]}),
+            m.onOff({endpointNames: ["l1", "l2", "l3"], powerOnBehavior: false}),
            m.iasZoneAlarm({


Use m.deviceEndpoints here (remove meta: {multiEndpoint: true}, and endpoint: (device) => ({l1: 1, l2: 2, l3: 3}),)

Using m.deviceEndpoints handles multi-endpoint, so meta.multiEndpoint is not needed.
This device does not support the StartUpOnOff attribute, so powerOnBehavior is explicitly disabled.

…eedback

Koenkk · 2026-01-01T13:15:12Z

src/devices/owon.ts

        vendor: "OWON",
        whiteLabel: [{vendor: "Oz Smart Things", model: "WSP403"}],
        description: "Smart plug",
-        extend: [m.onOff(), m.electricityMeter({cluster: "metering"}), m.forcePowerSource({powerSource: "Mains (single phase)"})],


Please use this instead of the configure/tozigbee/fromzigbee/expose

The device is now migrated to modernExtend.
Power-on behavior is intentionally disabled as WSP403 does not reliably support startUpOnOff.

A minimal configure() is kept only to customize metering reporting parameters,
which are not configurable via modernExtend in this codebase.

A minimal configure() is kept only to customize metering reporting parameters,

To have a consistent experience, all devices should have the same reporting parameters unless there is a really good reason not to, is there one in this case?

The custom reporting parameters are added because WSP403 reports
metering data very infrequently with the default configuration.

In practice this results in delayed or missing power updates,
which makes real-time power monitoring unreliable for this device.

The adjusted reporting improves usability without increasing
network traffic significantly.

WSP403 reports metering data very infrequently

I don't understand, it should report with the same frequency as all other plugs right? The default can be found here:

zigbee-herdsman-converters/src/lib/modernExtend.ts

Line 1961 in 0adcd38

// Report change with every 0.05A change

You're right, thanks for pointing this out.

After reviewing modernExtend.electricityMeter(), it already configures
standard reporting for seMetering.
The custom configure() is not needed here and will be removed to keep
reporting consistent with other devices.

Koenkk · 2026-01-01T13:15:20Z

src/devices/owon.ts

        model: "WSP402",
        vendor: "OWON",
        description: "Smart plug",
-        extend: [m.onOff(), m.electricityMeter({cluster: "metering"})],


Same as https://github.com/Koenkk/zigbee-herdsman-converters/pull/11106/changes#r2656351482

The device is now migrated to modernExtend.
Power-on behavior is intentionally disabled as WSP402 does not reliably support startUpOnOff.

A minimal configure() is kept only to customize metering reporting parameters,
which are not configurable via modernExtend in this codebase.

… reporting

src/devices/owon.ts

Koenkk · 2026-01-07T18:55:52Z

Thanks!

Could you also submit a picture for the docs (guide)? Make sure that the file name is AC221.png

jacky202509 · 2026-01-08T02:57:53Z

I’ve submitted the device picture for the docs, named AC221.png.

DerDreschner and others added 30 commits November 13, 2025 14:22

feat: Bosch BSEN-W: re-work implementation to expose all official fea…

dba937b

…tures (Koenkk#10369)

fix: Schneider Electric CCT5010-0001: disable power on behaviour Koen…

a583437

…kk/zigbee2mqtt.io#4289

fix: Moes SFL02-Z-*: disable mcuSyncTime Koenkk/zigbee2mqtt#28486

88dc1c9

fix: Tuya TS0601_cover_11: fix integration Koenkk/zigbee2mqtt#28452

57123c4

chore(master): release 25.47.0 (Koenkk#10382)

ec572dc

fix: Tuya _TZ3000_okaz9tjs: fix configure failing Koenkk/zigbee2mqtt#…

02082e4

…29034

chore: update pull request template and external converter bot

dabcc99

chore: fix pull request template link

dc128aa

fix(ignore): Rename ZigBee -> Zigbee (Koenkk#10384)

d65c60e

feat: Schneider Electric EKO07259: update temperature range for therm…

da9b467

…ostat (Koenkk#10387)

fix(detect): SPZB0001 20231019 as Eurotronic COZB0001 (Koenkk#10386)

03fb93e

fix: Sinopé TH1123ZB-G2: fix energy value (Koenkk#10389)

e346983

chore(master): release 25.48.0 (Koenkk#10383)

5e8c965

feat(add): CZB01 (Koenkk#10393)

b09db91

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> Co-authored-by: Koen Kanters <[email protected]>

feat(add): 4099854295256 (Koenkk#10395)

3b6911e

fix(detect): Detect _TZE284_aaeaifez as Tuya ZWT198/ZWT100-BH (Koen…

1af151b

…kk#10399)

fix: Heiman: move custom cluster to zigbee-herdsman-converters (Koenk…

a6834e2

…k#10396) Co-authored-by: MaDMaLKaV <[email protected]> Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

feat: Innr RCL 231 T: support OTA (Koenkk#10401)

7bfa9aa

feat(add): WS90 (Koenkk#10402)

4adf2c7

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> Co-authored-by: Koen Kanters <[email protected]>

fix(detect): Detect _TZE204_rbbx5mfq as Tuya TS0601_illuminance_tem…

cc83b99

…perature_humidity_sensor_2 Koenkk/zigbee2mqtt#29137

fix: PTVO: various improvements (Koenkk#10408)

e75535f

Co-authored-by: ptvoinfo <[email protected]>

fix: Bosch BSD-2 (Smoke alarm II): re-work implementation (Koenkk#10404)

786917d

feat(add): WZDA1 (Koenkk#10410)

46a7f95

feat(add): TS0601_smoke_co (Koenkk#10329)

4eef5b7

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> Co-authored-by: Koen Kanters <[email protected]>

chore: add OIDC permission for tokenless publising

a236075

chore(master): release 25.49.0 (Koenkk#10409)

92a7181

feat(add): BB 287 C-2 (Koenkk#10420)

4e59d8c

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

feat(add): 929003853901 (Koenkk#10406)

77fe737

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

feat(add): HS1CG_H (Koenkk#10411)

5dd0cf1

feat(add): 929003736501 (Koenkk#10413)

6afcafe

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

jacky202509 and others added 5 commits November 13, 2025 15:51

types: add optional applicationVersion to DummyDevice for exposes

d7a4585

Merge branch 'master' into fix-owon-device

584f045

feat(owon): add AC221 IR device with one-key pairing support

1bf68a6

u

7fa9c15

Koenkk reviewed Dec 26, 2025

View reviewed changes

jacky202509 added 2 commits December 31, 2025 09:56

fix(owon): revert CB432 changes; align AC221 and SLC631 with review f…

abd143e

…eedback

Merge branch 'master' into fix-owon-device

454f87b

Koenkk reviewed Jan 1, 2026

View reviewed changes

Koenkk and others added 5 commits January 1, 2026 14:18

Improve typing

e2c1b0f

Merge branch 'master' into fix-owon-device

2b6cd0d

feat(OWON): add WSP403 WSP402 using modernExtend with custom metering…

c34a69b

… reporting

[autofix.ci] apply automated fixes

b8fab5e

fix(owon): align WSP403 metering reporting with defaults

65334f7

Koenkk reviewed Jan 7, 2026

View reviewed changes

src/devices/owon.ts Outdated Show resolved Hide resolved

Apply suggestion from @Koenkk

a0eee76

Koenkk merged commit 056279c into Koenkk:master Jan 7, 2026
3 checks passed

Koenkk mentioned this pull request Jan 7, 2026

chore(master): release 25.103.0 #11228

Merged

Add support for OWON AC221 IR controller #11106

Add support for OWON AC221 IR controller #11106

Conversation

jacky202509 commented Dec 26, 2025

Summary

Changes

Motivation

Compatibility

Tested with

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Koenkk commented Jan 7, 2026

Uh oh!

jacky202509 commented Jan 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

20 participants