pyoase 0.1.0

Async client and O-Net protocol codec for OASE InScenio FM-Master (EGC / OASE Control) devices

pyoase

Async Python client and O-Net protocol codec for OASE InScenio FM-Master (Easy Garden Control / "OASE Control") smart garden & pond power controllers.

It talks to the OASE cloud (Azure AD B2C + REST) using just your OASE account email and password, and controls the device by relaying its native O-Net protocol packets through the cloud's SendONetPacket endpoint. This library is the engine behind the OASE Home Assistant integration.

Not affiliated with OASE GmbH. Use at your own risk.

Install

pip install pyoase

Quick start

import asyncio, aiohttp
from pyoase import OaseAuth, OaseCloudClient, onet

async def main():
    async with aiohttp.ClientSession() as session:
        auth = OaseAuth(session, "[e-mail]", "your-password")
        client = OaseCloudClient(session, auth)

        inv = await client.async_get_inventory()
        gw = next(g for g in inv.gateways if g.is_fm_master)
        print(gw.sockets)  # SocketsState(socket1=..., dimmer_value=...)

        await client.async_set_socket(gw.id, onet.Socket.SOCKET_1, on=True)
        await client.async_set_dimmer_value(gw.id, 128)

asyncio.run(main())

CLI

export OASE_EMAIL=[e-mail] OASE_PASSWORD='...'
python -m pyoase inventory
python -m pyoase set --gateway <gateway-id> --socket 1 --on
python -m pyoase set --gateway <gateway-id> --dimmer 128

How it works

• Auth — the OASE B2C tenant only exposes the interactive B2C_1A_SignUp_SignIn policy (no password grant), so OaseAuth scripts the browser login flow headlessly (authorize → SelfAsserted → confirmed → token, PKCE S256) and caches the refresh token. See docs/REVERSE_ENGINEERING.md.
• Reads — GET /User/Inventory returns fully structured state (SocketsState, PumpState), no packet parsing required.
• Writes — POST /Gateway/{id}/SendONetPacket relays a raw O-Net packet to the gateway. The path parameter is the gateway GUID id (not the serial). onet.py builds the SET_LIVE_SCENE packets; it is a clean-room port of the MIT-licensed ioBroker.oasecontrol codec (see NOTICE).

The onet codec (stdlib-only)

from pyoase import onet
pkt = onet.set_socket_packet(onet.Socket.SOCKET_1, onet.ON)   # bytes ready for SendONetPacket
onet.parse_socket_state(scene_bytes)                          # -> SocketState

onet and the data models import without aiohttp, so the codec can be used standalone.

Development

python -m pytest        # onet golden vectors + model parsing (no network)
ruff check .

License

MIT. The protocol codec is a clean-room reimplementation; see NOTICE.