This custom component integrates OneMeter Cloud smart energy meters with Home Assistant, allowing you to monitor your energy usage directly in your smart home dashboard.
- Monitor real-time energy usage from OneMeter devices
- Track positive, negative, and absolute energy consumption
- Monitor reactive energy components (R1, R4)
- View instantaneous power measurements
- View device diagnostic information (battery voltage, meter info)
- View monthly usage statistics
- Make sure HACS is installed in your Home Assistant instance
- Go to HACS → Integrations
- Click the "+" button and search for "OneMeter"
- Select "OneMeter Cloud integration" and click "Install"
- Restart Home Assistant
- Download the latest release from the releases page
- Extract the contents to your Home Assistant
custom_componentsdirectory - Restart Home Assistant
- Go to Home Assistant Settings → Devices & Services
- Click "Add Integration"
- Search for "OneMeter Cloud" and select it
- Enter your OneMeter Cloud API key and Device ID
- Configure update interval in the options (if needed)
This integration provides the following sensors:
| Sensor | Description | Unit | Category |
|---|---|---|---|
| Energy A+ (total) | Positive active energy consumption | kWh | Energy |
| Energy A- (total) | Negative active energy (production) | kWh | Energy |
| Energy R1 (total) | Reactive energy R1 component | kvarh | Energy |
| Energy R4 (total) | Reactive energy R4 component | kvarh | Energy |
| Energy |A| (total) | Absolute active energy total | kWh | Energy |
| Instantaneous Power | Current power usage | kW | Power |
| Battery Voltage | Device battery voltage | V | Diagnostic |
| Meter Serial Number | Meter identification number | - | Diagnostic |
| Tariff | Current energy tariff | - | Energy |
| This Month Usage | Energy consumption in current month | kWh | Energy |
| Previous Month Usage | Energy consumption in previous month | kWh | Energy |
Additional diagnostic sensors are available but disabled by default:
- Meter error code
- Physical address
- Successful readings count
- Failed readings count
The energy sensors from this integration can be added to the Home Assistant Energy Dashboard:
- Go to Settings → Dashboards → Energy
- Add the OneMeter energy consumption sensor (Energy A+ total)
- If you have solar production, add the Energy A- sensor as a grid return/solar production source
- No data appears: Check if your OneMeter Cloud account is active and has connected devices
- Authentication errors: Verify your API key is correct
- API errors: Check if your device ID is correct and the device is online
- Rate limiting: If you experience API rate limiting, increase the update interval in the integration options
This integration uses the official OneMeter Cloud API. For more information, see the API documentation.
Contributions are welcome! Please feel free to submit a Pull Request.
MIT License - see the LICENSE file for details.