Welcome to the ESPHome Samsung HVAC Integration project! This project provides an ESPHome component to integrate Samsung HVAC units (air conditioners or heat pumps) seamlessly into Home Assistant. Our goal is to empower users with comprehensive control and monitoring of their HVAC systems using modern, open-source tools.
This project focuses on Samsung HVAC units that communicate via a dedicated hardware bus (commonly F1/F2, sometimes called R1/R2). Samsung uses two main protocols for communication between indoor and outdoor units:
- NASA Protocol: Newer models utilize this more advanced protocol.
- NonNASA Protocol: Older units often rely on this simpler protocol.
The integration is designed to support both protocols, ensuring compatibility across a wide range of Samsung AC units.
This integration offers a variety of powerful features:
- Multisplit Support for controlling multiple indoor units.
- Temperature and Humidity Monitoring with detailed data.
- Energy Monitoring Sensors for tracking power consumption.
- AC Mode and Target Temperature Control.
- Real-Time Error Code Monitoring and Notifications.
For a detailed breakdown, see the Features Overview page.
- Check Compatibility: Make sure your Samsung unit is compatible by reviewing the Compatibility page.
- Install and Configure: Follow the detailed instructions in our Installation Guide to get started.
Need help? Visit the Troubleshooting page for common fixes or check out our FAQ for frequently asked questions.
- NASA vs NonNASA Protocols: Discover the technical differences between the two protocols here.
- Development Notes: Interested in extending the project? Visit the Development page for advanced configurations and debugging tips.
For the latest updates and discussions, visit our Discussions section. We welcome contributions and feedback from the community! Special recognition goes to Steve Wagner (@lanwin) for founding and shaping this project. 🚀
We are grateful to all contributors who have played a role in developing and enhancing this project. Their dedication and efforts have shaped what this project is today.
For a complete list of contributors and to learn more about their roles, visit our Credits and Contributors page.
Your contributions are always appreciated! If you are interested in getting involved, please check out our CONTRIBUTING.md for guidelines on how to get started.
Thank you for being part of the ESPHome Samsung HVAC community!