py-ccm15

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 on this page — 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

py-ccm15 on PyPI

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

Evidence: py_ccm15-1.1.2-py3-none-any.whl

Keywords: Midea, CCM15, data converter

Tags

More Monitoring packages