docs: note the air quality sensor's readings need homebridge 2.5.1 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Robotic: fix the heading, the room type numbers, the power source status, list the docking states the example sets, say Homebridge does not refuse a mid-run clean mode change, and read the live state
HVAC: fix the setpointRaiseLower mode values, add the Dry and Sleep system modes, and read the live state
Closure: add the window covering's starting state, with the position-aware flags it needs, and read the live state
Sensors: fix the PM unit value (4 = µg/m³), the occupancy sensor types, the lux formula, the smoke alarm ranges, and read the live state
Switches: read the live state, not accessory.clusters
Smart Plugs: read the live state, not accessory.clusters
Lighting: fix the clusters examples and their output, and onLevel's range and null meaning
Customising Features: add ActionSwitch, and the features option for the vacuum's direct clean mode change
Advanced Patterns: drop the master control and context persistence the power strip does not have, and match its real async methods
Best Practices: what Home really shows when a command fails, string cluster names are typed too, and assign api in the example
Error Handling: a plain error does not crash the accessory, show the real log lines, list every cluster with handlers, and fix the light example
Core Concepts: use the real colour handler names, fix the power source status values, and correct which battery features are composed
Getting Started: list every device type Homebridge 2.5.0 has, and say context is required
_Sidebar: link the closure and media page
Introduction: link the missing guide pages, and list generic switches, air quality and the closure and media page
Home: link Configuration, Node Version and the closure and media page
Beta Version: point debug logging at the real Debug Mode settings
Node Version: recommend the latest LTS (v26), or v22 on 32-bit ARM
Closure and Media Devices: rename from New Device Types, compose a closure through deviceRequirements, and put a player and speaker in one accessory
Enabling Matter: Matter accessories show in the UI, turning Matter off keeps the pairing, the child bridge port limit is 65533, and the port range is a setting
Custom Devices: add the fields registration needs, and always pass a part ID, since the parent has no onOff cluster
Monitoring External Changes: compare against the live state from getAccessoryState, not accessory.clusters
State Management: recommend reading live state, warn that accessory.clusters is only the starting state, and complete the cluster names list
Value Conversions: fix the XY scale (65536, max 65279), the humidity and battery scales, and two mired values
Matter Types: list the 24 clusters types really holds, use numbers for the vacuum mode tags, and fix LatchBolt, the XY and percentage ranges and the fan example
API Reference: fix the clusters examples and device type names, document deviceRequirements, and correct unregister, update and QR codes
Add appliance and energy device pages, and the new example options
Update for homebridge 2.5.0: register every accessory on every start, and document the new options
require homebridge 2.4.0