{"id":48957109,"url":"https://github.com/f18m/esphome-fancoil-controller","last_synced_at":"2026-04-18T00:11:19.343Z","repository":{"id":349880055,"uuid":"1204342155","full_name":"f18m/esphome-fancoil-controller","owner":"f18m","description":"ESPHome project to control a dumb fancoil unit","archived":false,"fork":false,"pushed_at":"2026-04-07T23:55:58.000Z","size":7845,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-08T01:25:45.785Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/f18m.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-07T23:26:59.000Z","updated_at":"2026-04-07T23:56:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/f18m/esphome-fancoil-controller","commit_stats":null,"previous_names":["f18m/esphome-fancoil-controller"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/f18m/esphome-fancoil-controller","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f18m%2Fesphome-fancoil-controller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f18m%2Fesphome-fancoil-controller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f18m%2Fesphome-fancoil-controller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f18m%2Fesphome-fancoil-controller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/f18m","download_url":"https://codeload.github.com/f18m/esphome-fancoil-controller/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f18m%2Fesphome-fancoil-controller/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31950906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T17:29:20.459Z","status":"ssl_error","status_checked_at":"2026-04-17T17:28:47.801Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-18T00:11:18.727Z","updated_at":"2026-04-18T00:11:19.322Z","avatar_url":"https://github.com/f18m.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# esphome-fancoil-controller\n\nESPHome project to control a multi-speed fancoil unit.\n\n\n## About Fancoils\n\nFancoil systems are basically just a fan connected to hot/chill water pipes \nthat are used to either heat/chill the environment.\nThey do not heat or chill the water themselves, but they rather exchange heat\nbetween the pipes and the air.\nThey can be:\n\n* 2 pipes\n* 4 pipes\n\nfan coils.\n\nThey can be static speed or multi-speed.\n\n\n## Project targets\n\n\nThis project is all about making HomeAssistant-friendly non-smart fancoil units and\nsupports multi-speed fancoils.\n\nFrom this project perspective it doesn't matter if your fancoil is 2pipes or 4pipes.\n\nThis project is also agnostic about the voltage used by your fancoil (e.g. 120V US voltage or 240V EU voltage)\nfor the reason that it just activates relays exposing dry contacts.\n\n## Architecture Overview\n\n\u003cimg title=\"Wiring\" alt=\"Wiring\" src=\"images/overview.drawio.png\"\u003e\n\n## Electrical Considerations\n\nThis project has been tested with the following fancoils:\n* [Aermec FCX42P](./datasheets/Aermec_FCX_TECHNICAL_MANUAL_Eng.pdf), whose characteristics are:\n    * Electrical power:\n        * Max power draw: 57W\n    * Cooling power:\n        * High speed: 3.4kW\n        * Medium speed: 2.78kW\n        * Low speed: 2.31kW\n\n## Board Details\n\n\u003cimg title=\"Board\" alt=\"Board\" src=\"images/esp-relay-board.png\"\u003e\n\n## Connection Details\n\n\u003cimg title=\"Wiring\" alt=\"Wiring\" src=\"images/connection-details.drawio.png\"\u003e\n\n## Wiring Details\n\nThese notes are specific to the fancoil model [Aermec FCX42P](./datasheets/Aermec_FCX_TECHNICAL_MANUAL_Eng.pdf).\nIt exposes a connector with 4 wires:\n\n* Blue: earth wire\n* Black: should be connected to LIVE wire to enable MAX speed \n* Brown: should be connected to LIVE wire to enable MEDIUM speed \n* Red: should be connected to LIVE wire to enable MIN speed \n\n\u003cimg title=\"Wiring\" alt=\"Wiring\" src=\"images/wiring.png\"\u003e\n\nThis makes it trivial connecting it to the relays as showsn in previous pictures above.\n\n## Labelling of the board\n\nSince most likely your fancoil controller will be installed in some hidden box\nand will stay around for a lot of time (many years hopefully), I suggest to provide \nsome documentation reference for that.\nA simple approach is to print a QR code pointing at this page.\n\nHere you can find a QR code I produced with the optimal [miniQR code generator](https://mini-qr-code-generator.vercel.app/):\n\n\u003cimg title=\"qrcode\" alt=\"qrcode\" src=\"images/qr-code.png\"\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff18m%2Fesphome-fancoil-controller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ff18m%2Fesphome-fancoil-controller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff18m%2Fesphome-fancoil-controller/lists"}