📌 Description

This adapter integrates with APsystems EZ1 microinverters using the device’s local HTTP API (port 8050).
It allows reading real‑time inverter data and controlling certain device parameters.

✔ Supported Features

• Read realtime power and energy values
• Read device information (firmware, SSID, IP, etc.)
• Read alarm states
• Set MaxPower
• Set On/Off state
• Support for multiple devices in one adapter instance
• HTTP timeout + retry logic
• Optional email alerting on repeated errors
• Includes a VIS2 widget for monitoring and control

🔗 Manufacturer Information

APsystems EZ1 product page:
https://apsystems.com

🛠 Installation

Install via ioBroker Admin:

Adapters → Search “apsystems-ez1” → Install

or via CLI:

iobroker install iobroker.apsystems-ez1

⚙️ Configuration

The adapter supports multiple devices via a JSON array:

Devices

Example:

[
  { "name": "Roof", "ip": "192.168.1.50" },
  { "name": "Garage", "ip": "192.168.1.51" }
]

pollInterval

• Interval in seconds between polls
• Default: 30

httpTimeout

• HTTP timeout in milliseconds
• Default: 5000

httpRetries

• Number of retry attempts
• Default: 2

EZ1 API-Port

• IP Port Number of device
• Default: 8050

alertEmail

• Optional email address for persistent error alerts
• Requires local sendmail

📊 Created States

All states are created under:

apsystems-ez1.<instance>.devices.<DeviceName>.*

Device Information

|State |Type |Description| | -------- | ------- | ------- | |deviceId |string |Device ID| |devVer |string |Firmware version| |ssid |string |Connected WiFi SSID| |ipAddr |string |Device IP address|

Power & Energy

|State |Type |Description| | -------- | ------- | ------- | |output.p1 |number |Power channel 1 (W)| |output.p2 |number |Power channel 2 (W)| |output.p |number |Total power (W)| |output.e1 |number |Energy channel 1 (kWh)| |output.e2 |number |Energy channel 2 (kWh)| |output.e |number |Total energy (kWh)| |output.te1 |number |Lifetime energy channel 1| |output.te2 |number |Lifetime energy channel 2|

Control

|State |Type |Write |Description| | -------- | ------- | ------- | ------- | |control.maxPower |number |yes |Set Max Power (W)| |control.onOff |boolean |yes |Turn inverter on/off|

Alarms

|State |Type |Description| | -------- | ------- | ------- | |alarm.og |boolean |Off‑grid alarm| |alarm.isce1 |boolean |DC1 short circuit| |alarm.isce2 |boolean |DC2 short circuit| |alarm.oe |boolean |Output fault|

🖼 VIS2 Widget

A VIS2 widget template is included under:

vis2/ez1-control

It displays:

• Power & energy values
• Alarm states
• MaxPower & On/Off controls

You may need to adjust the instance ID inside the widget.

🌐 EZ1 Local API Endpoints

The adapter uses the following endpoints:

GET /getDeviceInfo
GET /getOutputData
GET /getMaxPower
GET /getAlarm
GET /getOnOff

GET /setMaxPower?p=VALUE
GET /setOnOff?status=0|1

🧪 Development & Testing

Install dependencies:

npm install

Run tests:

npm test

Run adapter in dev‑server:

dev-server watch

📦 Publishing

Releases are handled via GitHub Actions. Push a tag like:

v0.1.7

and a new release will be published automatically.

Changelog

0.2.4 (2026-02-06)

• Fix review findings

0.2.3 (2026-01-13)

• release 0.2.3 to npm

0.1.6

• Fix warning at startup of validator function

0.1.5

• First pre‑release version

0.1.4

• First hardware‑tested version

0.1.3

• Refactor release script, add i18n step, avoid duplicates

0.1.2

• Fix JSON parsing and repository checker issues; add dminUI config and icons

0.1.1

• Initial release

🧑‍💻 Author

Haining Zhi
GitHub: https://github.com/zhihaining

License

MIT License Copyright (c) 2026