Update README

This commit is contained in:
Geoff Davis 2020-03-11 15:05:47 -07:00
parent b9061043a5
commit 32ff547c7b

View File

@ -13,6 +13,17 @@ Wirelessly control your Mitsubishi Comfort HeatPump with an ESP8266 or ESP32 usi
### Build a control circuit as detailed in the SwiCago/HeatPump README. ### Build a control circuit as detailed in the SwiCago/HeatPump README.
You can use either an ESP8266 or an ESP32. You can use either an ESP8266 or an ESP32.
### Clone this repository into your ESPHome configuration directory
This repository needs to live in your ESPHome configuration directory, as it doesn't work correctly when used as a Platform.IO library, and there doesn't seem to be an analog for that functionality for esphome code.
On Hass.IO, you'll want to do something like:
* Change directories to your esphome configuration directory.
* `mkdir -p src`
* `cd src`
* `git clone https://github.com/geoffdavis/esphome-mitsubishiheatpump.git`
### Configure your ESPHome device with YAML ### Configure your ESPHome device with YAML
Note: this component DOES NOT use the ESPHome `uart` component, as it requires Note: this component DOES NOT use the ESPHome `uart` component, as it requires
@ -26,30 +37,32 @@ the `HardwareSerial` handle within the ESPHome framework.
Create an ESPHome YAML configuration with the following sections: Create an ESPHome YAML configuration with the following sections:
* `esphome: libraries:` * `esphome: libraries:`
* `climate:` - set up a custom climate, change the Serial port as needed. * `climate:` - set up a custom climate, change the Serial port as needed.
* ESP8266 only: `logger: baud\_rate: 0` - disables serial port logging on sole hardware UART * ESP8266 only: `logger: baud\_rate: 0` - disables serial port logging on the
sole ESP8266 hardware UART
```yaml ```yaml
esphome: esphome:
libraries: libraries:
#- SwiCago/HeatPump
- https://github.com/geoffdavis/HeatPump#init_fix - https://github.com/geoffdavis/HeatPump#init_fix
- https://github.com/geoffdavis/esphome-mitsubishiheatpump includes:
- src/esphome-mitsubishiheatpump
# Enable logging # Enable logging
logger: logger:
# ESP8266 ONLY: # ESP8266 only - disable serial port logging, as the HeatPump component
# disable serial port logging, as the HeatPump component needs # needs the sole hardware UART on the ESP8266
# the sole hardware UART on the ESP8266 baud_rate: 0
baud_rate: 0
climate: climate:
- platform: custom - platform: custom
# ESP32 only - change &Serial to &Serial1 or &Serial2 and remove the
# logging:baud_rate above to allow the built-in UART0 to function for
# logging.
lambda: |- lambda: |-
auto my_heatpump = new MitsubishiHeatPump(&Serial); auto my_heatpump = new MitsubishiHeatPump(&Serial);
App.register_component(my_heatpump); App.register_component(my_heatpump);
return {my_heatpump}; return {my_heatpump};
climates: climates:
- name: "My Heat Pump" - name: "Den Mini-Split Heat Pump"
``` ```
Note that you can change the &