# ax206-usb-display-macos: driving the QDtech display over USB

> ax206-usb-display-macos implements macOS control of a QDtech AX206-derived USB display. Its Python driver sends RGB565 frames through USB Mass-Storage Bulk-Only framing and the device's BLIT command; an image viewer and live system dashboard use that driver.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/sunzhengya/ax206-usb-display-macos>
- Primary source: <https://github.com/sunzhengya/ax206-usb-display-macos/blob/ba77faa6982847318365fee9ece5bc510fa19f5c/README.md>
- Catalog page: <https://awesomerea.org/resources/ax206-usb-display-macos-case/>
- Record JSON: <https://awesomerea.org/resources/ax206-usb-display-macos-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/ax206-usb-display-macos-case/index.md)

## Requirements & limits

- **Prerequisites:** macOS, a compatible 480×320 AX206 display, libusb and the listed Python packages are required.
- **Limits:** The documented SmartCool firmware implements BLIT only; other vendor commands can stall the USB endpoint.
- **License:** GPL-3.0 license.

## Primary sources

1. <https://github.com/sunzhengya/ax206-usb-display-macos/blob/ba77faa6982847318365fee9ece5bc510fa19f5c/README.md>

## More in Protocols

- [SP542E MQTT ↔ BLE bridge: local control through the controller protocol](https://awesomerea.org/resources/sp542e-ha-bridge-case/index.md) · Case study
- [ESPHome — Technibel SCDF32C5I IR Climate: reconstructing air-conditioner infrared control](https://awesomerea.org/resources/esphome-technibel-scdf32-case/index.md) · Case study
- [Atomberg BLDC IR Remote: reconstructing fan infrared commands](https://awesomerea.org/resources/atomberg-bldc-ir-remote-case/index.md) · Case study
- [GameGent: reconstructing GameSir Tarantula Pro HID configuration](https://awesomerea.org/resources/gamegent-tarantula-pro-case/index.md) · Case study
- [xgecu-t48-reverse: reconstructing the T48 eMMC USB protocol](https://awesomerea.org/resources/xgecu-t48-reverse-case/index.md) · Case study
- [Miele XKM3000Z: reconstructing a local Zigbee appliance bridge](https://awesomerea.org/resources/miele-xkm3000z-bridge-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.