homebridge-aiseg-shutter-command

Homebridge plugin for AiSEG-connected shutters.

This plugin exposes AiSEG shutters as HomeKit WindowCovering accessories. It is designed for shutters controlled through the Panasonic AiSEG web interface.

Version History

0.2.4

• Fix README Version History placement so release notes appear near the main documentation instead of at the bottom.
• No runtime behavior changes from 0.2.3.

0.2.3

• Compact AiSEG status error logging so transient network or script errors no longer dump large Python tracebacks into the Homebridge log.
• Keep the cached HomeKit state when AiSEG status polling fails temporarily.

Screenshots

The screenshots show the Home app tile view and the detail view with the horizontal tilt slider.

Features

• Open / close control from HomeKit
• HomeKit horizontal tilt angle control
• Stop switch accessory
• Status polling from AiSEG
• Motion guard to reduce stale-state jumps
• Strong tilt snapping for HomeKit
• Package-local Python scripts included
• No external Python requests dependency
• Shared AiSEG Python core used internally

Supported HomeKit tilt values

The HomeKit tilt slider follows the configured tilt preset.

Three-step mode

| HomeKit tilt | Meaning | |---:|---| | 0° | closed tilt | | 30° | middle tilt | | 60° | high tilt | | 90° | open tilt |

Six-step mode

| HomeKit tilt | Meaning | |---:|---| | 0° | closed tilt | | 15° | angle1 | | 30° | angle2 | | 45° | angle3 | | 60° | angle4 | | 75° | angle5 | | 90° | angle6 |

Starting from v0.1.12, the plugin more strongly echoes the snapped tilt value back to HomeKit. This helps prevent the Home app slider from visually sticking to unwanted intermediate values.

Notes

This plugin is designed and tested for Sanwa Shutter shutters connected to AiSEG2/3 with a HEMS-compatible operation unit HEM-800B.

Tested environment includes:

• Sanwa Shutter shutters
• AiSEG2/3 web control
• HEMS-compatible operation unit HEM-800B
• AiSEG adapter / related Panasonic equipment: MKN7751K

Normal users only need to configure:

• AiSEG IP address or host name
• AiSEG web password
• Node ID for each shutter

Internal AiSEG request parameters are hidden from the Homebridge UI because they normally do not need to be changed.

How to find the Node ID

You can check each shutter's Node ID from the AiSEG web page:

1. Open the AiSEG web interface.
2. Go to Device Control > Shutter.
3. Open the browser developer tools with F12.
4. Go to the Network tab and filter by Fetch/XHR.
5. Press an action button for the target shutter.
6. Open the operation request.
7. Check the request payload. The shutter Node ID is the 9-digit nodeId value.

Hidden internal settings

The following AiSEG request parameters are intentionally hidden from the Homebridge UI:

• device ID
• EOJ
• device type
• page
• page325
• track
• request_by_form
• acceptId

The plugin still uses internal defaults for these values.

Related plugin

For AiSEG2 awning windows, use:

• homebridge-aiseg-awning-window-command

Requirements

• Homebridge
• Node.js
• Python 3 available in the Homebridge environment

No additional Python package installation is required.

Version history

0.1.14

• Improved HomeKit Scene and Shortcut behavior for blind shutter tilt commands.
• Ignores short-lived TargetPosition 0 echoes from HomeKit immediately after a tilt command.
• Prevents HomeKit from converting a tilt command into an unintended close command.
• Keeps normal open and close operations unchanged outside the short guard window.

0.1.13

• Re-published the v0.1.12 improvements under a new npm version because npm versions cannot be overwritten.
• Kept the HomeKit tilt snapping improvement.
• Kept README screenshots, inline version history, CHANGELOG, and simplified Homebridge UI settings.

0.1.12

• Improved the snap behavior of the HomeKit tilt slider for AiSEG2/3 shutters.
• Tilt values now snap more firmly to the configured tilt preset.
• Updated the README and CHANGELOG documentation.
• Added Home app screenshots to the README.
• Hid internal AiSEG request parameters to simplify the Homebridge UI settings.

0.1.11

• Refactored Python scripts to use a shared aiseg_device.py core.
• Kept aiseg_shutter.py as a compatibility wrapper.
• Continued to bundle package-local Python scripts.
• Continued to avoid Python requests dependency.

0.1.10

• Bundled the AiSEG shutter Python script inside the npm package.
• Removed fixed private IP and node ID values from the packaged script.
• Passed user-specific values from Homebridge config to Python via environment variables.
• Removed dependency on the external Python requests package.

0.1.9 and earlier

• Early development releases for AiSEG shutter control.
• Improved direct AiSEG status polling and HomeKit display stability.

See CHANGELOG.md for the same history in changelog format.