About esphome_samsung_hvac_bus

ESPHome Samsung HVAC Integration is an ESPHome component that connects and controls Samsung HVAC units (air conditioners and heat pumps) via a hardware bus (F1/F2 lines). It supports both NASA and NonNASA protocols, enabling multisplit control, temperature monitoring, energy tracking, and real-time notifications, enhancing your smart home setup.

o

Published by

omerfaruk-aran

Visit View Profile

README.md

View on GitHub

ESPHome Samsung HVAC Integration

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.

🌟 Overview

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. See: NASA Protocol Notes → https://docs.samsung-hvac.aran.net.tr/wiki/nasa/samsung_nasa_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.

📚 Key Features

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: https://docs.samsung-hvac.aran.net.tr/wiki/Features-Overview/

🚀 Quick Start

Check Compatibility: Make sure your Samsung unit is compatible by reviewing: https://docs.samsung-hvac.aran.net.tr/wiki/Compatibility/
Install and Configure: Follow the detailed instructions in: https://docs.samsung-hvac.aran.net.tr/wiki/Installation-Guide/

🔧 Troubleshooting & FAQ

Need help?

Troubleshooting: https://docs.samsung-hvac.aran.net.tr/wiki/Troubleshooting/
FAQ: https://docs.samsung-hvac.aran.net.tr/wiki/Frequently-Asked-Questions-(FAQ)/

📖 Learn More

NASA vs NonNASA Protocols: https://docs.samsung-hvac.aran.net.tr/wiki/NASA-vs-NonNASA-Protocols/
Development Notes: https://docs.samsung-hvac.aran.net.tr/wiki/Development/

📢 Announcements & Community

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: https://docs.samsung-hvac.aran.net.tr/wiki/Credits-and-Contributors/

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!

esphome_samsung_hvac_bus