{"id":20011669,"url":"https://github.com/roscoe81/aircon-controller","last_synced_at":"2025-06-13T03:02:38.811Z","repository":{"id":129683040,"uuid":"174489912","full_name":"roscoe81/Aircon-Controller","owner":"roscoe81","description":"Raspberry Pi controller that provides the ability to control a Mitsubishi ducted air conditioner via its serial communications link so that it can be automated with the provision of temperature sensors in each room and monitoring/control of a two-zone airflow damper.","archived":false,"fork":false,"pushed_at":"2023-05-08T07:40:42.000Z","size":19804,"stargazers_count":15,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-05T06:57:16.541Z","etag":null,"topics":["air-conditioner","air-conditioning","aircon","airconditioners","airconditioning","damper","home-automation","iot","mitsubishi","mqtt","python","raspberry-pi","serial-communication","smart-home","thermostat"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roscoe81.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2019-03-08T07:31:01.000Z","updated_at":"2024-08-18T04:08:08.000Z","dependencies_parsed_at":"2024-11-13T07:39:17.345Z","dependency_job_id":null,"html_url":"https://github.com/roscoe81/Aircon-Controller","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/roscoe81/Aircon-Controller","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roscoe81%2FAircon-Controller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roscoe81%2FAircon-Controller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roscoe81%2FAircon-Controller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roscoe81%2FAircon-Controller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roscoe81","download_url":"https://codeload.github.com/roscoe81/Aircon-Controller/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roscoe81%2FAircon-Controller/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259571641,"owners_count":22878182,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["air-conditioner","air-conditioning","aircon","airconditioners","airconditioning","damper","home-automation","iot","mitsubishi","mqtt","python","raspberry-pi","serial-communication","smart-home","thermostat"],"created_at":"2024-11-13T07:27:01.626Z","updated_at":"2025-06-13T03:02:36.081Z","avatar_url":"https://github.com/roscoe81.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aircon-Controller\nController for a Mitsubishi air conditioner (Model FDC508HES3)\nProvides mqtt control of the airconditioner using the serial communications link that runs\nbetween Mitsubishi's RCD-H-E remote control unit and the CNB port on the air conditioner's control board.\nAlso provides the ability to control a damper so that airflow can be directed to the correct air conditioning zone.\nAn inclinometer is provided for the damper in order to detect its position and control the air flow between zones with greater precision.\n\nThis project requires a separate mqtt-based controller that captures the actual temperatures of each room, compares those temperatures to desired temperature levels and controls the air conditioner and damper to align the desired and actual temperatures. I've implemented such a [controller](https://github.com/roscoe81/Home-Manager) as part of a more comprehensive Home Automation System.\n\n## Hardware Schematics\n![Aircon Controller Schematic](https://github.com/roscoe81/Aircon-Controller/blob/master/Schematics%20and%20Photos/Aircon%20Controller_schem.png)\n\n![Damper Position Sensor Schematic](https://github.com/roscoe81/Aircon-Controller/blob/master/Schematics%20and%20Photos/Aircon%20Damper%20Position%20Sensor_schem.png)\n\n![Damper Control Board Schematic](https://github.com/roscoe81/Aircon-Controller/blob/master/Schematics%20and%20Photos/Aircon%20Damper%20Control%20Board_schem.png)\n\n## Hardware Photographs\n![Aircon Controller](https://github.com/roscoe81/Aircon-Controller/blob/master/Schematics%20and%20Photos/IMG_1565.png)\n\n![Damper Position Sensor](https://github.com/roscoe81/Aircon-Controller/blob/master/Schematics%20and%20Photos/IMG_1432.png)\n\n**Note that the damper controller switches high voltages and it should only be constructed and deployed by a licensed electrician.**\n\n## Air Conditioner Communications Protocol\nI've included a [document](https://github.com/roscoe81/Aircon-Controller/blob/master/Serial%20Comms/Aircon%20Controller%20Comms.pdf) that shows what I found when reverse engineering the protocol between the Mitsubishi RCD-H-E remote control unit and the CNB port on the air conditioner's main unit. There are still gaps in some areas of that protocol but all essential functions are covered.\n\n![Communications Protocol](https://github.com/roscoe81/Aircon-Controller/blob/master/Serial%20Comms/F43B66E8-F1EA-4F13-B185-9C76222CD1DF.jpeg)\n\n## Version 5.1 Gen\nVersion 5.1 Gen adds the ability to control dampers for each room and to control fan speed. Hardware changes were necessary to control each room damper.\n\n![Aircon Room Damper Schematic](https://github.com/roscoe81/Aircon-Controller/blob/master/Schematics%20and%20Photos/Aircon%20Room_Damper_schem.png)\n\n![Aircon Controller with Room Dampers](https://github.com/roscoe81/Aircon-Controller/blob/master/Schematics%20and%20Photos/IMG_2116.png).\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE.md file for details\n\n## Acknowledgements\n\nI'd like to acknowledge the work done by [Hadley Rich](https://github.com/hadleyrich/MQMitsi) who did similar work on a Mitsubishi air conditioner that provided me with the inspiration to undertake this task.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froscoe81%2Faircon-controller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froscoe81%2Faircon-controller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froscoe81%2Faircon-controller/lists"}