This is a custom Home Assistant integration for MeshCore mesh radio nodes. It allows you to monitor and control MeshCore nodes via USB, BLE, or TCP connections.
⚠️ Work in Progress: This integration is under active development. BLE connection method hasn't been thoroughly tested yet.
Core integration is powered by meshcore-py.
Everything you need to know:
- ✅ Complete feature list
- ✅ Configuration guides
- ✅ Sensor documentation
- ✅ Service descriptions
- ✅ Automation examples
- ✅ Dashboard templates
- ✅ Troubleshooting guides
- Make sure you have HACS installed
- Add this repository as a custom repository in HACS:
- Go to HACS > Integrations
- Click on the three dots in the top right corner
- Select "Custom repositories"
- Add the URL of this repository
- Select "Integration" as the category
- Click "Install" on the MeshCore integration
- Copy the
custom_components/meshcoredirectory to your Home Assistantcustom_componentsdirectory - Restart Home Assistant
- Go to Settings > Devices & Services
- Click + Add Integration and search for "MeshCore"
- Follow the setup wizard to configure your connection
For detailed configuration instructions, see the documentation.
- Clone this repository
- Copy
custom_components/meshcoreto your Home Assistant config directory - Restart Home Assistant
- Add the integration through the UI
Run tests with pytest:
pytest tests/- Report issues on GitHub Issues
- Contributions are welcome via pull requests
- Documentation contributions are also welcome!
- Home Assistant (version 2023.8.0 or newer)
- MeshCore node with firmware that supports API commands
- For BLE: Bluetooth adapter on the Home Assistant host (direct connection only; proxy connections don't work with PIN pairing)
- For USB: USB port on the Home Assistant host
This project is licensed under the MIT License - see the LICENSE file for details.
