John Ogle
a5a6b9d4b6
- Update README with complete setup guide and all blueprint URLs - Add PACKAGE_SETUP_GUIDE with step-by-step setup instructions - Add ROOM_CONFIGURATION_GUIDE with bedroom, living room, and bathroom examples - Add HARDWARE_TESTING_CHECKLIST for validating with real Inovelli switches - Add CHANGELOG documenting v1.0.0 release - Add validation script for automated YAML testing - Add test configuration example for testing without hardware
3.7 KiB
3.7 KiB
Hardware Testing Checklist
Prerequisites
- Inovelli Blue Dimmer VZM31-SN paired with Zigbee2MQTT
- Switch in Smart Bulb Mode (select.xxx_smart_bulb_mode = "Smart Bulb Mode")
- buttonDelay set to 500ms or 700ms (select.xxx_button_delay)
- Smart bulbs powered and responsive
- Adaptive Lighting integration installed and configured
- All packages and blueprints loaded
Switch Configuration Tests
- Smart Bulb Mode enabled: Load always powered
- LED bar displays color correctly
- LED intensity acceptable (adjust if too bright/dim)
- Button presses detected: event.xxx_action updates
- Single tap: Shows "up_single" or "down_single"
- Double tap: Shows "up_double" or "down_double" reliably
- Triple tap: Shows "up_triple" or "down_triple" reliably
- Config button: Shows "config_single"
Mode Cycling Tests
- Config button press triggers automation
- Mode cycles through all available modes
- Mode cycles back to first after last mode
- input_select updates in UI
- LED color changes to match mode
- LED flash pulse visible (3 seconds)
- Colors distinguishable for each mode
- Cycle works from any starting mode
Mode Application Tests
For each mode:
- Adaptive: AL settings reset to configuration defaults
- Reading: Brightness increases, color cools
- Theater: Brightness decreases, color warms
- Sleep: Very dim, red/amber color
- Manual Override: AL paused, manual control enabled
Button Action Tests
- Double tap up: Brightness boosts +50%
- Double tap up: Color temperature increases +1000K
- Double tap down: Returns to AL control immediately
- Triple tap up: Sets 100% brightness, 4000K (neutral)
- Triple tap down: Sets 5% brightness, warm red
- Auto-reset: Returns to AL after configured timeout
- Auto-reset: Works after boost action
- Auto-reset: Works after max brightness
- Auto-reset: Works after night light
Weekend Mode Tests (if configured)
- Enables automatically Friday 10pm
- Disables automatically Sunday 10pm
- Sunrise time shifts when enabled
- Max brightness reduces when enabled
- Settings restore when disabled
- Triple-tap toggle works (if configured)
- LED flash confirms toggle
Presence Integration Tests (if configured)
- Presence sensor triggers correctly
- Lights turn on when occupied
- Lights stay on while occupied
- Manual control resets after room empty
- Mode resets after room empty (if configured)
- Delay timing is appropriate
- Works with multiple sensors (OR logic)
Edge Cases and Failure Modes
- Rapid button presses don't cause errors
- Mode change while lights off doesn't error
- Switching modes rapidly doesn't break AL
- Zigbee network congestion doesn't cause issues
- Home Assistant restart preserves mode
- AL switch off doesn't break mode system
- Invalid mode name doesn't crash automation
- Missing entity gracefully fails
Performance Tests
- Mode change response < 1 second
- LED update response < 1 second
- Button action response < 1 second
- AL adaptation smooth (no flicker)
- No automation trace errors
- No excessive log warnings
Multi-Room Tests
- Multiple rooms work independently
- Mode cycling doesn't affect other rooms
- LED colors consistent across rooms
- Performance acceptable with many rooms
- Global package shared correctly
Documentation Accuracy
- All entity IDs in examples are correct format
- Zigbee2MQTT topics match actual topics
- Service calls work as documented
- Examples produce expected behavior
- Troubleshooting guide solves real issues