A Home Assistant integration for Basis Smart panels by Basis NZ Ltd.
- Real-time Power Monitoring - Track current power consumption, import/export power, and primary current at the panel level
- Circuit-level Insights - Monitor power, current, and voltage for each individual circuit
- Energy Statistics - View daily and monthly energy import/export totals
- Circuit Control - Remotely control circuit standby states through Home Assistant
- Connectivity Status - Binary sensor showing panel connection status
- Multi-panel Support - Manage multiple Basis panels from a single integration
- Home Assistant 2025.1.0 or newer
- A Basis Smart Panel with an active cloud connection
- Basis account credentials
- Open HACS in Home Assistant
- Click on "Integrations"
- Click the three dots in the top right corner and select "Custom repositories"
- Add this repository URL and select "Integration" as the category
- Click "Add"
- Search for "Basis Smart Panel" and install it
- Restart Home Assistant
- Download the
custom_components/basis_smart_panelfolder from this repository - Copy it to your
config/custom_components/directory - Restart Home Assistant
- Go to Settings > Devices & Services
- Click Add Integration
- Search for "Basis Smart Panel"
- Follow the OAuth2 authentication flow to link your Basis account
| Entity | Description | Update Interval |
|---|---|---|
| Current Power | Net power consumption (W) | 5 seconds |
| House Consumption Power | Power being used by the house (W) | 5 seconds |
| Generation Power | Power being generated by solar (W) | 5 seconds |
| Primary Current | Main current draw (A) | 5 seconds |
| Consumption Energy Today | Energy consumed by the house today (kWh) | 5 minutes |
| Generation Energy Today | Energy generated by solar today (kWh) | 5 minutes |
| Consumption Energy This Month | Energy consumed by the house this month (kWh) | 5 minutes |
| Generation Energy This Month | Energy generated by solar this month (kWh) | 5 minutes |
For each circuit in your panel:
- Power (W)
- Current (A)
- Voltage (V)
- Connected - Shows whether the panel is currently connected to the Basis cloud
- Circuit Standby - Control the standby state of individual circuits (where supported)
For issues with this integration, please open an issue on GitHub.
This project may contain trademarks or logos for Basis NZ Ltd. products or services. See TRADEMARKS.md for details.
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.