---
id: py-ccm15
version: "1.1.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# py-ccm15 — A package to control Midea CCM15 data converter modules

License: permissive · Maintenance: active · Downloads: 73.6K/mo

## What it is and what it does

py-ccm15 is a Python library that bridges your code to Midea CCM15 data converters—devices that translate RS-485 VRF bus signals to TCP/IP. It exposes an async HTTP client for reading and writing the state of up to 64 indoor air conditioning units connected to a single CCM15 gateway. The library handles the low-level XML protocol and bit-level status decoding, so you work with simple Python objects representing AC mode, fan mode, temperature, and setpoint rather than raw bytes.

The package is built on httpx and xmltodict, making it lightweight and easy to integrate into async Python applications. It supports optional password authentication for firmware versions that require it, and includes detailed protocol documentation for advanced use cases. Typical usage involves instantiating a CCM15Device with the gateway's IP and port, calling get_status_async() to poll unit states, and calling async_set_state() to send control commands.

Use it for:

- Build a Home Assistant integration or custom automation to monitor and control Midea VRF air conditioning systems.
- Create a web dashboard or mobile app backend that reads real-time temperature and mode from multiple AC units via CCM15.
- Implement scheduled or sensor-triggered AC control (e.g., turn off units when room is unoccupied).
- Log historical temperature and energy data from Midea VRF systems for analysis or billing.
- Integrate CCM15-controlled AC units into a broader smart-home or building-management system.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides an async Python interface to communicate with Midea CCM15 data converters over HTTP, enabling control and monitoring of air conditioning units connected via the CCM15 gateway.

Yes. The package is actively maintained, has no known vulnerabilities, installs with minimal friction, and fills a clear niche for Midea CCM15 users who want programmatic control. The async design and low dependency count make it suitable for production use. Install it if you own a CCM15 gateway and need Python-based automation or monitoring.

## Install

pip install py-ccm15
uv add py-ccm15
poetry add py-ccm15

## Installing py-ccm15

Before you install: Low friction: pure Python wheel with only two runtime dependencies (httpx and xmltodict). Actively maintained with a recent release (41 days ago) and no known vulnerabilities.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install py-ccm15

import asyncio
from ccm15 import CCM15Device

async def main():
    device = CCM15Device("192.168.1.100", 80)
    state = await device.get_status_async()
    print(state.devices)

asyncio.run(main())

Requires Python 3.7+; CCM15 gateway must be reachable over HTTP on the specified host and port.

Verify before relying:

- Whether the package works with all Midea CCM15 firmware versions or only specific ones.
- Performance characteristics when controlling many indoor units (up to 64 claimed) simultaneously.
- Timeout and retry behavior for network failures or unresponsive gateways.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 73.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

midea ccm15 control, ac unit gateway python, hvac async interface, ccm15 data converter, air conditioning control library, midea vrf controller, async hvac gateway, hvac-control, midea-integration, async-iot

[View on SkillFed](https://skillfed.io/packages/py-ccm15) · [View on PyPI](https://pypi.org/project/py-ccm15/)