Ballu AC ESP32-C6 Controller

Implementation of ESP32-C6 based AC controller that bridges Zigbee (Home Assistant) communication with UART-based MideaUART protocol for Ballu air conditioner control.

Overview

This project implements a bridge between Zigbee (Home Assistant) and UART-based MideaUART protocol for controlling Ballu air conditioners using an ESP32-C6 microcontroller.

Features

UART communication at 9600 baud 8N1 for MideaUART protocol
Zigbee ZCL Thermostat cluster implementation
Bidirectional communication between Zigbee and UART layers
Status monitoring and error handling
Configurable timing controls (50ms command spacing)

Directory Structure

src/
  uart_driver.c/h      - UART driver implementation
  midea_protocol.c/h   - MideaUART protocol encoding/decoding
  zigbee_zcl.c/h       - Zigbee ZCL Thermostat cluster
  integration_layer.c/h- Integration between Zigbee and UART layers
  main.c               - Application entry point

test/
  uart_driver_test.c          - Unit tests for UART driver
  midea_protocol_test.c       - Unit tests for MideaUART protocol
  zigbee_zcl_test.c           - Unit tests for Zigbee ZCL
  integration_layer_test.c    - Unit tests for integration layer

docs/
  protocol.md                 - MideaUART protocol details
  zcl_hvac.md                 - Zigbee ZCL Thermostat cluster details
  Hardware integration guide.md - Hardware connection information
  Build system details.md     - Build system and dependencies

## Getting Started

### Prerequisites

- ESP-IDF toolchain
- ESP32-C6 development board
- UART to TTL converter (for debugging)

### Building

```bash
make build

Uploading

make upload

Running Tests

make test

Implementation Progress

See docs/plans/2026-07-05-ballu-ac-esp32c6-controller-implementation.md for detailed implementation plan and progress tracking.

License

This project is licensed under the MIT License.

1.9 KiB Raw Blame History