Mitsubishi HVAC Controller

This package aims to make it simpler to make your Mitsubishi HVAC unit smarter, more private, and easier to control. This package brings local, cloud-free control to your HVAC system using community driven open source software.

Why?

• 100% Local Control – Your data stays in your home. No cloud, no fees, no privacy worries.
• Open Source – Powered by ESPHome and the community. Inspect, modify, and contribute.
• Compact & Clean – Installs inside your mini-split for a seamless look.
• DIY or Pre-Assembled – Build it yourself or order a ready-to-go kit (shop coming soon).

Find full setup guides and a YAML config generator so you can customize your device for features like remote temperature sensors, vane control, and advanced diagnostics.

Quick Start

1. Pick Your Hardware: Choose from M5Stack Atom S3 Lite or NanoC6. Pre-assembled kits coming soon.
2. Optional: Flash the Firmware: Use the YAML generator and ESPHome Dashboard, or flash via ESPHome Web.
3. Connect to Wi-Fi: Plug in via USB-C and use the Wi-Fi setup tool, or join the device’s Wi-Fi and visit 192.168.4.1. Enter your Wi-Fi credentials.
4. Install in Your HVAC: Power off, connect the CN105-to-Grove cable, tuck the device inside, and restore power.
5. Web UI: Access the device’s local IP for direct control. If you don't desire further integration, you can stop here!
6. Integrate with Home Assistant: The device will appear in ESPHome and be auto-discovered by Home Assistant.

For more detailed instructions, visit the setup guide.

Disclaimer & Safety

Working on HVAC systems can be risky and may void warranties. Proceed only if you’re confident. This project is provided as-is, without warranty or liability.

Gratitude

Special thanks to echavet, the ESPHome community, SwiCago, and geoffdavis for their foundational work.