Juno Zigbee Light Integration for Home Assistant

A Home Assistant custom integration for advanced management of Juno Zigbee lights. This integration extends the functionality provided by Home Assistant's native Zigbee Home Automation (ZHA) integration by adding device settings management, firmware monitoring, and enhanced control capabilities. Supports all Juno light models including RB56SC, ABL-LIGHT-Z-201, and others.

Features

• Advanced Light Control: Enhanced control over Juno Zigbee light brightness and on/off states
• Multi-Model Support: Compatible with all Juno light models (RB56SC, ABL-LIGHT-Z-201, and more)
• Settings Management: Configure and manage device-specific settings
• Firmware Monitoring: Track firmware versions and device information
• Device Attributes: Access detailed device information including manufacturer, model, and firmware version
• Seamless ZHA Integration: Works alongside Home Assistant's ZHA integration without conflicts

Requirements

• Home Assistant 2024.1.0 or later
• Zigbee Home Automation (ZHA) integration installed and configured
• Juno Zigbee light(s) paired with ZHA (any model)

Installation

HACS Installation (Recommended)

1. Open HACS in your Home Assistant instance
2. Click on Integrations
3. Click the three dots menu in the top right corner
4. Select Custom repositories
5. Add this repository URL: https://github.com/ncecowboy/Ha-juno-zigbee
6. Select category: Integration
7. Click Add
8. Find "Juno RB56SC Zigbee Light" in the integration list
9. Click Download
10. Restart Home Assistant

Manual Installation

1. Download the latest release from GitHub
2. Extract the downloaded file
3. Copy the custom_components/juno_rb56sc folder to your Home Assistant config/custom_components/ directory
   • If the custom_components directory doesn't exist, create it in your config folder
4. Restart Home Assistant

Configuration

1. Ensure your Juno device is already paired with ZHA:

   • Go to Settings → Devices & Services → Zigbee Home Automation
   • Pair your Juno light if not already done

2. Add the Juno integration:

   • Go to Settings → Devices & Services
   • Click Add Integration
   • Search for "Juno RB56SC"
   • Select one or more Juno devices from the list (only unconfigured devices are shown)
   • Click Submit
   • Repeat if you want to add more devices later

3. The integration will create additional entities for your device:

   • Light control entity (enhanced)
   • Firmware version sensor
   • Manufacturer sensor
   • Model sensor

Usage

Light Control

The integration creates an enhanced light entity that provides:

• On/Off control
• Brightness adjustment (0-255)
• State synchronization with ZHA

Example automation:

automation:
  - alias: "Set Juno Light to 50% at sunset"
    trigger:
      - platform: sun
        event: sunset
    action:
      - service: light.turn_on
        target:
          entity_id: light.juno_rb56sc_light
        data:
          brightness: 128

Sensors

The integration provides several diagnostic sensors:

• Firmware Version: Shows the current firmware version installed on the device. This sensor automatically updates when firmware is updated through the ZHA integration.
• Manufacturer: Displays the device manufacturer
• Model: Shows the device model number

These can be used in automations or displayed on dashboards to monitor device information.

Firmware Updates

Firmware updates for Juno devices are handled through the ZHA integration:

1. Check the Firmware Version sensor to see your current firmware version
2. Go to Settings → Devices & Services → Zigbee Home Automation
3. Select your Juno device
4. If a firmware update is available, you'll see an option to update
5. After updating through ZHA, the Firmware Version sensor will automatically reflect the new version

Note: Firmware update availability depends on your Zigbee coordinator and the update files available in your ZHA configuration.

Version Management

This integration follows Semantic Versioning:

• Major version (X.0.0): Breaking changes
• Minor version (0.X.0): New features, backward compatible
• Patch version (0.0.X): Bug fixes, backward compatible

Current version: 1.2.2

Troubleshooting

No devices found during setup

Problem: The integration reports "No Juno devices found"

Solution:

1. Ensure your device is paired with ZHA first
2. Verify the device manufacturer in the device registry shows "Juno"
3. The integration supports all Juno light models (RB56SC, ABL-LIGHT-Z-201, etc.)

Light control not working

Problem: Light doesn't respond to commands

Solution:

1. Check that the underlying ZHA light entity is working
2. Verify the device is online in the ZHA integration
3. Try reloading the Juno RB56SC integration
4. Check Home Assistant logs for error messages

State not updating

Problem: Light state doesn't reflect actual device state

Solution:

1. The integration syncs state from ZHA every 30 seconds
2. Manually refresh by reloading the integration
3. Check ZHA integration for device connectivity issues

Development

Project Structure

custom_components/juno_rb56sc/
├── __init__.py          # Integration initialization
├── config_flow.py       # Configuration UI
├── const.py            # Constants and configuration
├── light.py            # Light platform
├── sensor.py           # Sensor platform
├── strings.json        # UI strings and translations
└── manifest.json       # Integration metadata

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request with appropriate labels (see Version Management)

For information about versioning and changelog guidelines, see Version Management Guide.

Reporting Issues

Please report issues on the GitHub issue tracker.

Include:

• Home Assistant version
• Integration version
• Device model and firmware version
• Relevant log entries
• Steps to reproduce

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Acknowledgments

• Home Assistant community
• ZHA integration developers
• HACS for making custom integration distribution easy

Support

For support:

• Check the documentation
• Review existing issues
• Create a new issue if needed