https://github.com/omniflux/esphome-fujitsu-halcyon
Fujitsu AirStage-H (Halcyon) component for ESPHome
https://github.com/omniflux/esphome-fujitsu-halcyon
airstage esphome fujitsu halcyon hvac
Last synced: 3 months ago
JSON representation
Fujitsu AirStage-H (Halcyon) component for ESPHome
- Host: GitHub
- URL: https://github.com/omniflux/esphome-fujitsu-halcyon
- Owner: Omniflux
- License: mit
- Created: 2023-12-07T22:06:28.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-06T18:21:35.000Z (6 months ago)
- Last Synced: 2024-11-06T19:29:05.117Z (6 months ago)
- Topics: airstage, esphome, fujitsu, halcyon, hvac
- Language: C++
- Homepage:
- Size: 19.5 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Fujitsu AirStage-H component for ESPHome
An ESPHome component to control Fujitsu AirStage-H (product line previously known as Halcyon) units via the three wire (RWB) bus.
```yaml
substitutions:
name: halcyon-controller
friendly_name: Halcyon Controller
halcyon_name: My AC
esp_board: esp32-poe-iso
packages:
wifi: !include common/wifi.yaml
external_components:
- source: github://Omniflux/esphome-fujitsu-halcyon
- source: github://Omniflux/esphome-tzsp
esphome:
name: ${name}
friendly_name: ${friendly_name}
platformio_options:
build_flags:
- -std=gnu++2a
build_unflags:
- -std=gnu++11
esp32:
board: ${esp_board}
framework:
type: esp-idf
api:
ota:
password: !secret ota_password
sensor:
- platform: uptime
name: "Uptime"
update_interval: 60s
button:
- platform: restart
name: Restart device
entity_category: config
- platform: safe_mode
name: Safe Mode Boot
entity_category: diagnostic
#logger:
# level: DEBUG
uart:
tx_pin: GPIO13 # Device dependent
rx_pin: GPIO14 # Device dependent
baud_rate: 500
parity: EVEN
climate:
- platform: fujitsu-halcyon
name: ${halcyon_name}
# Fujitsu devices use 0 and 1, but 2-15 should also work. Must not skip addresses
controller_address: 1 # 0=Primary, 1=Secondary
#temperature_controller_address: 0 # Fujitsu controller address to read temperature from
#temperature_sensor_id: my_temp_sensor # ESPHome sensor to read temperature from
#ignore_lock: true # Ignore feature lock - not sure if this works
# To capture communications for debugging / analysis
# Use Wireshark with https://github.com/Omniflux/fujitsu-airstage-h-dissector
# tzsp:
# ip: 192.168.1.20
# protocol: 255
```
Configure TZSP and use Wireshark with [fujitsu-airstage-h-dissector](https://github.com/Omniflux/fujitsu-airstage-h-dissector) to debug / decode the Fujitsu serial protocol.
## Related projects
- FOSV's [Fuji-Atom-Interface](https://github.com/FOSV/Fuji-Atom-Interface)
- Aaron Zhang's [esphome-fujitsu](https://github.com/FujiHeatPump/esphome-fujitsu)
- Jaroslaw Przybylowicz's [fuji-iot](https://github.com/jaroslawprzybylowicz/fuji-iot)
- Raal Goff's [FujiHeatPump](https://github.com/unreality/FujiHeatPump)
- Raal Goff's [FujiHK](https://github.com/unreality/FujiHK)
- Myles Eftos's [Reverse engineering](https://hackaday.io/project/19473-reverse-engineering-a-fujitsu-air-conditioner-unit)