zegelin / samsung-hvac-mtqq

Bidirectional bridge between Samsung residential HVAC units and MQTT
MIT License
6 stars 3 forks source link
hvac mqtt rs485 samsung

Samsung HVAC ⇌ MQTT

Control of select Samsung residential HVAC units over MQTT by emulating a secondary wired remote control.

logo

Planned features:

Status

This project also contains partial emulators for the Main WRC, Indoor Units, and ERVs to aid in reverse-engineering the WRC protocol.

Compatibility and Limitations

My HVAC system is single zone, single unit, single remote. I'm unable to test the more advanced features supported on more complex systems such as multiple zones, multiple indoor units, ERV/ventilators, blade control, humidity/CO² reading, etc, though I have had some success reverse engineering the protocol to implement partial support for these features.

Notably Command 0xA0 ("Change Indoor Unit Settings") still has a number of unknowns fields. As this is a blanket "change all" settings command I cannot predict how this functions on systems that support additional untested features.

The COM2/WRC bus possibly has two protocol versions: non-NASA and NASA. This project currently only supports the non-NASA variant. If your controller model number ends with N the bus is using the NASA variant.

My system topology is:

Component Model
Outdoor Unit AC120HCAFKH/SA
Indoor Unit AC120HBHFKH/SA
Wired Remote Control MWR-WE10

My assumption is that the following wired remote controls talk the same protocol:

Model Description
MWR-WE10 Wired Remote Controller
MWR-WE11 Wired Remote Controller
MWR-WE13 Wired Remote Controller
MWR-SH00 Simple Wired Controller
MWR-WH00 Wired Remote Controller
MWR-WH01 Wired Remote Controller

Background

Wiring Diagram

Samsung HVAC units have two RS-485 control buses: COM1 (F1/F2) and COM2 (F3/F4). The first (COM1) connects the indoor units (such as ceiling cassettes, in-roof duct units, and wall-mount consoles) to their counterpart outdoor units. The second (COM2) connects the indoor units to the wired remote controls (WRC).

This project currently focuses on the second (COM2) bus (which this project terms the WRC bus).

Bus Baud Settings
COM1 9600 1 stop bit, Even parity, 8 data bits
COM2 2400 1 stop bit, Even parity, 8 data bits

Glossary

Some useful terminology definitions:

ERV: Energy Recovery Ventilator

FJM: Free Joint Multi

EMS: ECO Heating System

DVM: Digital Variable Multi

VRF: Variable Refrigerant Flow

MDS: Motion Detect Sensor

EEV: Electronic Expansion Valve

RMC address: indoor unit group address

SAC: System Air-conditioner Control

NASA: ?

RAC: Residential AC

CAC: Commercial AC

AHU: Air Handling Unit

Thanks

Many thanks to Danny De Gaspari for his excellent work on Samsung-HVAC-buscontrol. Without his initial reverse enginering work this project wouldn't be possible.