Metadata-Version: 2.4
Name: blueretro-ble
Version: 0.1.0
Summary: BLE library for the BlueRetro retro-console Bluetooth adapter
Author-email: Hudson Brendon <contato.hudsonbrendon@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/hudsonbrendon/blueretro-homeassistant
Project-URL: Repository, https://github.com/hudsonbrendon/blueretro-homeassistant
Project-URL: Issues, https://github.com/hudsonbrendon/blueretro-homeassistant/issues
Keywords: bluetooth,ble,blueretro,home-assistant,retro-gaming
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Home Automation
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: bleak>=0.22.0
Requires-Dist: bleak-retry-connector>=3.5.0
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.23; extra == "test"
Requires-Dist: pytest-homeassistant-custom-component>=0.13; extra == "test"
Requires-Dist: pyserial>=3.5; extra == "test"
Requires-Dist: dbus-fast>=2.0; extra == "test"
Dynamic: license-file

# BlueRetro for Home Assistant

Autodiscovers a [BlueRetro](https://github.com/darthcloud/BlueRetro) adapter over Bluetooth
and exposes read-only sensors plus reboot/deep-sleep controls.

## Limits

- Works only while the adapter is **idle** (no controller connected). During gameplay the
  config BLE is unavailable, so entities show `unavailable` — by design, to protect gameplay.
- No battery or live controller input (the hardware does not expose them).

## Install

1. Add this repo as a HACS custom repository (category: Integration).
2. Install **BlueRetro** and restart Home Assistant.
3. Power the BlueRetro with no controller connected; Home Assistant discovers it automatically.

## Entities

- Sensors: Firmware, Game ID, Game, Config source, ABI version (diag), BD address (diag).
- Binary sensor: Config available (connectivity).
- Buttons: Reboot, Deep sleep.
