71 lines
1.9 KiB
Markdown
71 lines
1.9 KiB
Markdown
# Ballu AC ESP32-C6 Controller
|
|
|
|
Implementation of ESP32-C6 based AC controller that bridges Zigbee controller) 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
|
|
|
|
```bash
|
|
make upload
|
|
```
|
|
|
|
### Running Tests
|
|
|
|
```bash
|
|
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. |