aiorefoss
Asynchronous Python library for Refoss smart devices, designed for Home Assistant integration.
Features
- Async WebSocket connection
- Device authentication support for new firmware (EM16P v3.1.11+)
- Automatic auth challenge handling
- Real-time status updates
- Device configuration management
- Cross-platform JSON support (orjson with stdlib fallback)
Installation
pip install aiorefoss
With faster JSON support:
pip install aiorefoss[fastjson]
Quick Start
import asyncio
from aiorefoss.rpc_device.device import RpcDevice
from aiorefoss.common import process_ip_or_options
async def main():
options = await process_ip_or_options("192.168.1.100")
device = await RpcDevice.create(None, options)
await device.initialize()
print(f"Device model: {device.model}")
print(f"Firmware version: {device.firmware_version}")
await device.shutdown()
asyncio.run(main())
Requirements
- Python 3.12+
- aiohttp
- yarl
- orjson (optional, for better performance)
License
MIT
Support
- Email: support@refoss.net
- Issues: https://github.com/ashionky/aiorefoss/issues
1 maintainer
Metadata
1 maintainer
Release files for aiorefoss 1.0.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aiorefoss-1.0.6.tar.gz | 15.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aiorefoss-1.0.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 31.4 kB
Release files / aiorefoss-1.0.6.tar.gz
| Download URL | aiorefoss-1.0.6.tar.gz |
|---|---|
| Size | 15.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f95581d8e043965c2a7784195287727a4a7c67621d0aa540121409ed6c47de7c
|
|
BLAKE2b-256 checksum How to use checksums |
762dd341599881b987a5e849c69da62160b70d911ab9f69ddc6b484715a88aa5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Release files / aiorefoss-1.0.6-py3-none-any.whl
| Download URL | aiorefoss-1.0.6-py3-none-any.whl |
|---|---|
| Size | 16.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ce5aaf5e39114ec2f11f749244a5963cfa918453ec8537ad069f07159ce67262
|
|
BLAKE2b-256 checksum How to use checksums |
8e478c90dfb46741677edc8a4124402bc5a48ee27034dd0ee4f66db765474065
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
