Skip to content

Commit df97471

Browse files
authored
Update README.md
1 parent ebd1683 commit df97471

1 file changed

Lines changed: 1 addition & 172 deletions

File tree

README.md

Lines changed: 1 addition & 172 deletions
Original file line numberDiff line numberDiff line change
@@ -220,6 +220,7 @@ Your water heater entity will be created as `water_heater.water_heatpump`
220220
| **Off** | Water heater disabled | Off |
221221
| **Eco** | Energy efficient heating | Economy mode |
222222
| **Performance** | High performance heating | Hybrid mode |
223+
| **Electric** | Electric heating | E-heater mode |
223224

224225
---
225226

@@ -339,7 +340,6 @@ automation:
339340
## 📈 Roadmap
340341

341342
* [ ] **Full Modbus integration** (eliminate external modbus dependency)
342-
* [ ] **Additional modes** (Electric/E-heater support)
343343
* [ ] **Enhanced diagnostics** (error reporting, connection status)
344344
* [ ] **Energy monitoring** (power consumption tracking)
345345
* [ ] **Advanced scheduling** (built-in time/temperature profiles)
@@ -373,174 +373,3 @@ If this integration helped you, please:
373373

374374
*Happy heating! 🔥*
375375

376-
*Transform your Chromagen Midea 170L heat pump into a smart, Home Assistant-controlled powerhouse!*
377-
378-
---
379-
380-
## 🎯 What You'll Achieve
381-
382-
This guide walks you through creating a fully functional climate entity in Home Assistant that can:
383-
384-
- ✅ Control target temperature
385-
- ✅ Turn the heat pump on/off
386-
- ✅ Monitor real-time status
387-
- ✅ Integrate with automations and dashboards
388-
389-
## 🧩 The Solution Overview
390-
391-
We're upgrading from basic Modbus sensors to a proper climate entity by:
392-
393-
1. **Installing** `hass-template-climate` from HACS
394-
2. **Configuring** Modbus sensors in `modbus.yaml`
395-
3. **Creating** a climate template in `configuration.yaml`
396-
397-
---
398-
399-
## 🛠️ Hardware Shopping List
400-
401-
402-
| Item | Description | Link |
403-
| ------------------------------ | --------------------------------------------- | ---------------------------------------------------------------- |
404-
| **EW-11A RS485 to WiFi** | The magic bridge (EW11A-0 + 4pin connector) | [AliExpress](https://www.aliexpress.com/item/32916128353.html) |
405-
| **240VAC to DC PSU** | 12V recommended (5-18V supported) | *Your local electronics supplier* |
406-
| **Jumper wires & terminals** | For neat connections | *Hardware store* |
407-
408-
---
409-
410-
## ⚡ Hardware Installation
411-
412-
> **⚠️ Safety First**: Have a licensed electrician handle the 240VAC connections!
413-
414-
### Step 1: Power Supply Installation
415-
416-
- Install appropriate PSU using available spade terminals inside the main HWS cover (circled in green in images below)
417-
- Follow local electrical regulations
418-
419-
### Step 2: EW-11A Connections
420-
421-
**📍 Pin-out Reference** *(left to right when looking down at screws)*:
422-
423-
```
424-
Pin 1: Black → RS485A from heater
425-
Pin 2: Grey → RS485B from heater
426-
Pin 3: Red → VCC (5-18V DC)
427-
Pin 4: Black → GND from DC supply + Yellow GND from heater
428-
```
429-
430-
<img width="772" height="214" alt="EW11-A connector pinout diagram" src="https://github.com/user-attachments/assets/92e0001d-2b15-4da6-9f66-24c7b342c4d9" />
431-
432-
### Step 3: RS485 Wiring
433-
434-
- Locate the service connector outside the main panel (circled in red in images below)
435-
- Connect RS485 wires to the EW-11A 4-pin connector
436-
- *Tip*: You can either remove pins for direct termination or use jumpers
437-
438-
<img width="480" height="466" alt="Heat pump internal connections" src="https://github.com/user-attachments/assets/cc9e1120-d59a-4429-9ee7-6fd3f841a29d" />
439-
440-
<img width="525" height="343" alt="EW11-A wiring diagram" src="https://github.com/user-attachments/assets/e0152cac-3086-4ed3-9c2a-4943a15ee336" />
441-
442-
---
443-
444-
## 📡 EW11-A Configuration
445-
446-
### Initial Setup
447-
448-
1. **Connect** to WiFi network `EWxxxxx` (based on MAC address)
449-
2. **Browse** to `10.10.100.254`
450-
3. **Login** with username: `admin`, password: `admin`
451-
452-
### Serial Port Settings
453-
454-
Only the following should need changing:
455-
456-
```
457-
Baud Rate: 9600
458-
Flow Control: Disable
459-
Protocol: RS485
460-
```
461-
462-
### Communications Settings
463-
464-
Only the following should need changing:
465-
466-
```
467-
Socket Settings → Local Port: 502
468-
```
469-
470-
### WiFi Configuration
471-
472-
1. **System Settings** → Change WiFi mode to `STA`
473-
2. **Scan** for your network and enter credentials, OR manually enter:
474-
- STA SSID: `your_network_name`
475-
- STA KEY: `your_wifi_password`
476-
477-
### Optional: Static IP Setup
478-
479-
```
480-
WAN Settings:
481-
├── DHCP: Disabled
482-
├── WAN IP: <IP address of your choice>
483-
├── Subnet Mask: <as per your network>
484-
├── Gateway: <your router's IP>
485-
└── DNS: 8.8.8.8 or your preference
486-
```
487-
488-
3. **Submit** and **restart** the EW11-A
489-
490-
---
491-
492-
## 🏠 Home Assistant Configuration
493-
494-
### Phase 1: Install Template Climate
495-
496-
1. **HACS** → **Integrations** → **⋮** → **Custom repositories**
497-
2. **Add**: `[https://github.com/jcwillox/hass-template-climate](https://github.com/jcwillox/hass-template-climate.git)`
498-
3. Find the repo in HACS and **Download**, then **restart** Home Assistant
499-
500-
### Phase 2: Modbus Configuration
501-
502-
- **Place** the provided `modbus.yaml` in your HA config folder
503-
- Update the **host** value in `modbus.yaml` to the IP address you have set for the EW-11A (or determine the DHCP address it has)
504-
- This replaces basic climate entities with proper target temperature sensors
505-
506-
### Phase 3: Climate Template
507-
508-
- **Add** the climate template configuration to your `configuration.yaml`
509-
- This creates the final climate entity with full control capabilities
510-
511-
---
512-
513-
## 📁 Required Files
514-
515-
516-
| File | Purpose |
517-
| ---------------------- | ------------------------------------------------------- |
518-
| `modbus.yaml` | Defines Modbus sensors and target temperature control |
519-
| `configuration.yaml` | Contains the climate template entity |
520-
521-
---
522-
523-
## 🙏 Credits & References
524-
525-
**Special thanks to:**
526-
527-
- **ill_hey** - Original HA Community post and instructions
528-
- **BrittonA** - Initial Modbus YAML configuration
529-
530-
**Source threads:**
531-
532-
- [HA Community Discussion](https://community.home-assistant.io/t/chromagen-midea-170l-heat-pump-hot-water-system-modbus-integration-success/773718/12)
533-
- [BrittonA's Gist](https://gist.github.com/BrittonA/339d25efb934bdb4f451ba7e2f920ba3)
534-
535-
---
536-
537-
## 🚀 Next Steps
538-
539-
Once configured, your heat pump will appear as a proper climate entity in Home Assistant, ready for:
540-
541-
- Dashboard cards
542-
- Automations based on time/temperature
543-
- Voice control integration
544-
- Energy monitoring and optimization
545-
546-
*Happy heating! 🔥*

0 commit comments

Comments
 (0)