valashko / xaapi

Java API for interacting with Aqara-compatible devices

XAAPI

Java API for interacting with Aqara-compatible devices.

The ones which connect to a gateway through Zigbee:

• Xiaomi Door and Window Sensor
• Xiaomi Button
• Xiaomi Plug (Socket)
• Xiaomi Magic Cube
• Xiaomi Motion Sensor

Built-in into the gateway:

• Xiaomi Gateway Light
• Xiaomi Gateway Illumination Sensor

Examples

Discover

XiaomiGateway gateway = XiaomiGateway.discover(); // works only for single gateway at the moment

Bind manually

XiaomiGateway gateway = new XiaomiGateway("192.168.1.105"); // works for multiple gateways

Subscribe and receive updates

IInteractiveDevice.SubscriptionToken illuminationChangeSubscriptionToken =
    gateway.getBuiltinIlluminationSensor().subscribeForIlluminationChange((Integer value) -> System.out.println("Illumination changed to: " + value));

String buttonSid = "158d0001232e95";
IInteractiveDevice.SubscriptionToken buttonActionsSubscriptionToken =
    gateway.getDevice(buttonSid).asXiaomiSwitchButton().subscribeForActions((String action) -> System.out.println("Button: " + action));

ExecutorService threadPool = Executors.newFixedThreadPool(1);
gateway.startReceivingUpdates(threadPool);
threadPool.awaitTermination(60, TimeUnit.SECONDS); // run for 60 seconds

Unsubscribe

// cancelling subscription is optional
gateway.getDevice(buttonSid).asXiaomiSwitchButton().unsubscribeForActions(buttonActionsSubscriptionToken);

xaapi's Issues

API

Hi, i used your code since 2 years, but have you a link to an official documentation ? I want to used the two way switch. Thanks

Support of other devices?

Hello
Any plans to support more devices? Or, in other words, how one can add more devices not in this list yet? And is this library supporting the Aqara gateway or only the Mi gateway?

So some backstory:
I am not a xiaomi/aqara user myself but I am thinking of diving deep into this technology.
So, before buying it, I am curious to see what my possibilities are.
Of course, since I am a developer myself, I could further help with this software if I decide to buy this device for me.