This custom integration connects EcoSense cloud-connected radon monitors to Home Assistant, providing current radon readings and alert levels.
- Radon Level sensor with configurable units (
pCi/LorBq/m³) - Alert Level sensor (Green / Orange / Red) with EPA-based thresholds
- Device info and automatic cloud polling every 5 minutes
- Unit configuration during setup and changeable via integration options
- Click the badge at the top of this README.
- Your Home Assistant will open with the repository pre-selected in HACS.
- Follow the prompts to install and then restart Home Assistant.
- In HACS, go to Integrations → Custom repositories and add this repository URL as Integration.
- Search for "EcoSense Radon" in HACS and install it.
- Restart Home Assistant.
Copy the custom_components/ecosense_radon/ folder into your Home Assistant custom_components/ directory and restart Home Assistant.
- Go to Settings > Devices & Services in Home Assistant.
- Click Add Integration and search for "EcoSense Radon".
- Enter your EcoSense cloud username and password when prompted.
- Select your preferred radon unit:
- pCi/L (Picocuries per Liter) - Default
- Bq/m³ (Becquerels per Cubic Meter)
You can change the radon unit at any time:
- Go to Settings > Devices & Services
- Find your EcoSense Radon integration
- Click Configure
- Select your preferred unit and click Submit
| Entity ID suffix | Description | Unit |
|---|---|---|
radon_level |
Radon Level | pCi/L or Bq/m³ |
alert_level |
Alert Level (status) | — |
The alert level sensor uses EPA-recommended thresholds that automatically adjust based on your selected unit:
- Green: < 2.7 pCi/L
- Orange: 2.7 - 4.0 pCi/L (EPA recommends considering mitigation)
- Red: > 4.0 pCi/L (EPA recommends fixing your home)
- Green: < 100 Bq/m³
- Orange: 100 - 150 Bq/m³ (EPA recommends considering mitigation)
- Red: > 150 Bq/m³ (EPA recommends fixing your home)
- Requires EcoSense cloud account (no local/Bluetooth support)
If you see a "Cannot connect" error, double-check your credentials and network.
To enable debug logging, add the following to your configuration.yaml:
logger:
default: info
logs:
custom_components.ecosense_radon: debugPull requests are welcome! Please follow the code style enforced by ruff.