ggvchen/orvibo-sdk

Java SDK for Orvibo devices

Orvibo Java SDK

This project aims to provide a reusable Java library that implements for communicating with Orvibo devices that use a UDP protcol, including S20 Smart Sockets and Allone Smart Remotes. A lot of the initial findings regarding the protocol were found https://stikonas.eu/wordpress/2015/02/24/reverse-engineering-orvibo-s20-socket/.

Version History

• 1.1.2 Fix to length parsing for commands greater than 255 bytes
• 1.1.1 AllOne Learn file fixes
• 1.1.0 Refactored packet handling
• 1.0.4 AllOne Learn fixes
• 1.0.3 Fix validation of AllOne responses
• 1.0.0 Add experimental support for AllOne devices
• 0.1.0 S20 support

Examples:

Network Discovery (MAC/deviceId is unknown):

package test;

import java.net.SocketException;

import com.github.tavalin.orvibo.OrviboClient;
import com.github.tavalin.orvibo.OrviboClient.OrviboDiscoveryListener;
import com.github.tavalin.orvibo.devices.OrviboDevice;

public class Main implements OrviboDiscoveryListener {

    public static void main(String args[]) {
        Main m = new Main();
        m.run();
    }

    public void run() {
        OrviboClient client = null;
        try {
            client = OrviboClient.getInstance();
            client.connect();
            if (client.isConnected()) {
                client.addDeviceDiscoveryListener(this);
                client.globalDiscovery();
            }
             while (true); // wait for discovery results
        } catch (SocketException e) {
            e.printStackTrace();
        } finally {
	        if (client != null) {
	            client.disconnect();
	        }
        }
       
    }

    @Override
    public void deviceDiscovered(OrviboDevice device) {
        if (device == null) {
            return;
        }
        System.out.println("Device discovered: " + device.getDeviceId());
     }
}

S20 Example (Assuming you know the MAC of the S20 Smart Socket)

		String mac = "XXXXXXXXXXXX";
	    OrviboClient client = null;
	        try {
            OrviboClient client = OrviboClient.getInstance();
            client.connect();
	            if (client.isConnected()) {
	                Socket socket = client.socketWithDeviceID(mac);
	                socket.find();
	                Thread.sleep(1000);
	                socket.subscribe();
	                Thread.sleep(1000);
	                socket.on();
	                Thread.sleep(5000);
	                socket.off();
	                }
	        } catch (SocketException e) {
	            e.printStackTrace();
	        } finally {
	            if (client != null) {
	                client.disconnect();
	            }
	        }
	

Please report bugs via the Issues tab, alternatively if you can fix or improve things please send me a Pull Request.