ZigBee API for Java is a fork of ZB4OSGI for usage without OSGI. Changes include removal of OSGI related dependencies and refactored API.
See the API Java Doc here
ZB4OSGI: http://zb4osgi.aaloa.org/
Questions can be sent to the following email address: '[email protected]'.
You can also contact me directly: '[email protected]'.
The URL to the discussion group: https://groups.google.com/d/forum/zigbee4java
The URL to the FAQ: https://groups.google.com/d/forum/zigbee4java
This library provides API to ZigBee network through CC2531 dongle.
Example hardware that can be controlled with zigbee4java:
- Philips Hue Bulb
- Java 7
- Maven 3 and/or Gradle
- CC2531 dongle with USB serial / coordinator firmware. Flashing new firmware requires CCDEBUGGER hardware component.
- Second CC2531 dongle if you want to have cheap packet sniffer. There are probably better packet sniffers out there.
You need to buy the following items:
- http://www.ti.com/tool/cc2531emk (NOTE: Buy two if you want to use another as packet sniffer.)
- http://www.ti.com/tool/cc-debugger
- Download and install Z-STACK-HOME from http://www.ti.com/tool/z-stack
- View CCDEBUGGER user guide: http://www.ti.com/lit/ug/swru197h/swru197h.pdf
- Flash CC2531ZNP-Pro-Secure_Standard.hex with Smart RF Studio included in Z-STACK-HOME.
Serial-comm and zigbee4java dependencies can be found from the following repository for convenience.
<repositories>
<repository>
<id>bubblecloud-cloudbees-release</id>
<url>http://repository-bubblecloud.forge.cloudbees.com/release/</url>
</repository>
<repository>
<snapshots>
<enabled>false</enabled>
</snapshots>
<id>bintray-tlaukkan-bubblecloud</id>
<name>bintray</name>
<url>http://dl.bintray.com/tlaukkan/bubblecloud</url>
</repository>
</repositories>
Maven:
<dependencies>
<dependency>
<groupId>org.bubblecloud.zigbee4java</groupId>
<artifactId>zigbee-api</artifactId>
<version>2.0.10</version>
<type>pom</type>
</dependency>
<dependency>
<groupId>org.bubblecloud.zigbee4java</groupId>
<artifactId>zigbee-serial-javase</artifactId>
<version>2.0.10</version>
</dependency>
</dependencies>
Gradle:
dependencies
{
compile 'org.bubblecloud.zigbee:zigbee-api:2.0.10'
compile 'org.bubblecloud.zigbee:zigbee-serial-javase:2.0.10'
}
Maven:
git clone https://github.com/tlaukkan/zigbee4java.git zigbee4java
cd zigbee4java
mvn clean install
Gradle:
git clone https://github.com/tlaukkan/zigbee4java.git zigbee4java
cd zigbee4java
gradlew clean build
ZigBeeSerialPortImpl serialPort = new ZigBeeSerialPortImpl("/dev/ttyACM0", 38400);
ZigBeeConsole console = new ZigBeeConsole(serialPort, 4951, 11, false);
zigbeeApi.startup();
Device lamp = zigbeeApi.getZigBeeApiContext().getDevice("00:17:88:01:00:BE:51:EC/11");
Basic basic = lamp.getCluster(Basic);
String manufactureName = basic.getManufacturerName();
OnOff onOff = lamp.getCluster(OnOff.class);
onOff.on();
int onOffAttributeIndex = 0;
Reporter reporter = onOff.getAttribute(onOffAttributeIndex).getReporter();
reporter.addReportListener(reportListener);
- ZigBeeConsole.java
- Follow Google Java style: https://google.github.io/styleguide/javaguide.html
- Add unit tests for your commit if applicable / possible.
- Build before commit.
- Rebase instead of merge when pushing.
- Check that Travis CI build passes after pushing.
- Fix any issues in your commit found in Codacy analysis.
These steps require bintray account with access to zigbee4java project.
Snapshot:
mvn deploy
Release:
mvn release:prepare
mvn release:perform