Connection State Event

Obtain device connection state events through the API.

Refer Get Device Connection Status.

Note

• If the device is already in a connected state, the connection API will return a success response, but no connection event will be reported.

Example

import asyncio
import cassiablue


async def stater():
    print("start recv state event")
    ok, _ = await cassiablue.start_recv_connection_state()
    print(type(ok), ok)
    if not ok:
        return

    async for evt in cassiablue.connection_result():
        print(type(evt), evt)


async def connector():
    print("start connect")

    params = '{"type": "random"}'
    addr = "20:00:00:00:00:01"
    ok, ret = await cassiablue.connect(addr, params)
    print("connect done:", type(ok), ok, type(ret), ret)

    await asyncio.sleep(3)

    ok, ret = await cassiablue.disconnect(addr)
    print("disconnect done:", type(ok), ok, type(ret), ret)


async def main():
    print("start")
    await asyncio.gather(stater(), connector())


print("hello")
asyncio.run(main())

API

async cassiablue.start_recv_connection_state() → tuple[ok: bool, result: str]

Enable retrieval of device connection state events to receive real-time updates of device connection status changes. Currently, only one subscription can be active at a time.

Returns:

• ok: Whether the operation was successful

• result: Execution result. For state event, refer to BLEConnectionResult

async cassiablue.connection_result() → BLEConnectionResult

Retrieve Connection State Event

Returns:

class BLEConnectionResult

class BLEConnectionResult

An asynchronous iterable object used to receive BLE state event in a streaming manner.

async __aiter__() → BLEConnectionResult

Returns itself, allowing the instance to be used directly in an async for loop.

async __anext__() → dict

Asynchronously retrieves the next state event from the global state_sse_client.queue and returns it.

If the queue is empty, it waits until new data becomes available.

Data Field Description

Field	Type	Description	Example
connectionState	str	Event Type	connected disconnected
rssi	int	RSSI	-65
handle	str	Device MAC	20:00:00:00:00:01
reason	str	Disconnect reason(disconnected valid)	host disconnect
packetLossRate	int	Packet loss rate(disconnected valid)	3

Note

• reason refer Error Messages