https://github.com/aitjcize/ha-medole
HomeAssistant module for Medole Dehumidifier (米多力除濕機)
https://github.com/aitjcize/ha-medole
home-assistant homeassistant homekit
Last synced: 3 months ago
JSON representation
HomeAssistant module for Medole Dehumidifier (米多力除濕機)
- Host: GitHub
- URL: https://github.com/aitjcize/ha-medole
- Owner: aitjcize
- Created: 2025-05-28T05:34:27.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-11-24T01:58:00.000Z (7 months ago)
- Last Synced: 2025-11-24T06:49:00.557Z (7 months ago)
- Topics: home-assistant, homeassistant, homekit
- Language: Python
- Homepage:
- Size: 27.3 KB
- Stars: 3
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Medole Dehumidifier (米多力除溼機) Integration for Home Assistant
This is a custom component for Home Assistant that integrates Medole Dehumidifier devices via Modbus (serial or TCP). You need to connect a RS485 to Ethernet/Wi-Fi converter to the RS485 port of the Medole Dehumidifier.
## Features
- Control dehumidifier operation (on/off)
- Set target humidity
- Control fan speed
- Monitor temperature and humidity sensors
- Monitor device status and errors
## Installation
1. Copy the `custom_components/medole_dehumidifier` directory to your Home Assistant `custom_components` directory.
2. Restart Home Assistant.
3. Add the integration through the Home Assistant UI (Configuration > Integrations > Add Integration).
## Configuration
The integration can be configured through the Home Assistant UI. You'll need to provide:
- Name for the device
- Connection type (Serial or TCP)
- For Serial: Port, Slave ID, and optionally baudrate, bytesize, parity, and stopbits
- For TCP: Host, Port, and Slave ID
## Development
This project includes a Makefile with various targets for development:
```bash
# Install development dependencies (in a virtual environment)
make install-dev
# Run linters
make lint
# Format code
make format
# Check formatting without making changes
make check
# Clean up cache files
make clean
```
## License
This project is licensed under the MIT License - see the LICENSE file for details.