openwebnet4j

openwebnet4j is a Java library for the Open Web Net protocol.

It enables a Java client to communicate locally with a gateway supporting the Open Web Net protocol and to control devices in a BTicino/Legrand BUS/SCS system (MyHOME_Up ®) or ZigBee wireless system (MyHOME_Play ®, now out of production).

Supported features:

• Device discovery
• Feedback (monitoring events) from BUS/SCS and ZigBee wireless network

Supported frames:

• WHO=0 Scenarios
• WHO=1 Lighting
• WHO=2 Automation
• WHO=4 Thermoregulation
• WHO=5 Alarm
• WHO=9 Auxiliary
• WHO=13 Gateway Management
• WHO=15 & 25 CEN/CEN+ scenarios
• WHO=18 Energy Management

Supported Open Web Net gateways:

• IP gateways or scenario programmers, such as: BTicino F453 / F454 / F455, MyHOMEServer1, MyHOME_Screen10, MH201 / MH202 / MH200N
• ZigBee USB Gateways, such as: BTicino 3578, also known as Legrand 088328, to connect to wireless devices

TODO

• Support numeric passwords (OPEN handshake)
• Support alphanumeric passwords (HMAC handshake)
• Support for WHO=2 Automation (shutters)
• ZigBee: check isOldFirmware and related gw bugfixes
• Add other WHOs
  • Energy
  • Thermo (standalone mode)
  • CEN/CEN+
  • Thermo (systems with 4 and 99 Central Units)
  • AUX
  • Scenarios WHO=0
• add sendHighPriority with priority queue
• extend OpenConnector.listener to multiple listeners

Dependency Management

Maven

This library is available via Maven Central repository by adding the dependency in your POM.xml:

    <dependency>
      <groupId>io.github.openwebnet4j</groupId>
      <artifactId>openwebnet4j</artifactId>
      <version>0.9.0</version>
    </dependency>

Usage example

// create BUS gateway connection with IP=192.168.1.50 and password=12345
BUSGateway myGateway = new BUSGateway("192.168.1.50", 20000, "12345");
myGateway.subscribe(this);
try {
	myGateway.connect();
	// turns light WHERE=51 ON
	Response res = myGateway.send(Lighting.requestTurnOn("51"));
	if (res.isSuccess()) {
		System.out.println("Request successful");
	}
	// requests status light WHERE=51
	myGateway.send(Lighting.requestStatus("51"));
} catch (OWNException e) {...}

Building from Source

With Maven:

mvn clean install

Disclaimer

• This library is not associated by any means with BTicino or Legrand companies
• The Open Web Net protocol is maintained and Copyright by BTicino/Legrand. The documentation of the protocol if freely accessible for developers on the Legrand developer web site
• "Open Web Net", "MyHOME_Up", "MyHome", "MyHome_Play" and "Living Now" are registered trademarks by BTicino/Legrand