Skip to content

Latest commit

 

History

History
75 lines (57 loc) · 2.98 KB

README.md

File metadata and controls

75 lines (57 loc) · 2.98 KB
Raw

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 ®) 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

  • 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.11.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", "SCS", "MyHOME_Up", "MyHOME", "MyHOME_Play" and "Living Now" are registered trademarks by BTicino/Legrand