Skip to content

Latest commit

 

History

History
166 lines (137 loc) · 8.64 KB

README.md

File metadata and controls

166 lines (137 loc) · 8.64 KB

Pi4J :: Java I/O Library for Raspberry Pi

Build Status Maven Central

PROJECT INFORMATION

Project website: http://www.pi4j.com/
Project discussion group: https://groups.google.com/forum/#!forum/pi4j
Project issues list: https://github.com/Pi4J/pi4j/issues

Release builds are available from

Snapshot builds are available from

Copyright (C) 2012-2015 Pi4J

LICENSE

Licensed under the GNU LGPLv3 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.gnu.org/licenses/lgpl.txt

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

FUTURE PLANS

RELEASES

2015-08-30 :: 1.0.1-SNAPSHOT

  • Minor updates.
  • Update ListenGpioExample.java; simplified infinite loop statement.
  • Update BlinkGpioExample.java; simplified infinite loop statement.
  • Fixes clear methods of LCDBase.java.
  • Update MCP3008Pin.java; incorrect pin number assignments.
  • Fix pins.contains() calls that received the vararg array "pin" instead of a "p" instance variable.

2015-04-18 :: 1.0

  • Released under GNU LGPLv3 license.
  • Added support for RaspberryPi v2 Model B
  • Added support for RaspberryPi Model A+
  • Added support for RaspberryPi Model B+
  • Added support for RaspberryPi Compute Module
  • Added support for debounce logic on digital input pin events
  • Added support for Button component interface
  • Added support for Pibrella device
  • Added support for SPI modes
  • Added support for building pi4j-native project directly on the Pi (using maven)
  • Added easy install/uninstall scripts (get.pi4j.com)
  • Added APT package and repository support (repository.pi4j.com)
  • Simplified native library loader to find embedded hard-float native lib
  • Fixed JDK8 build errors.
  • Removed support (and complicated builds) for soft-float ABI
  • Updated documentation in preparation for 1.0 release
  • Cleaned up build
  • Enhancements Added: https://github.com/Pi4J/pi4j/issues?q=label%3Aenhancement+is%3Aclosed+milestone%3A%22RELEASE+1.0%22+
  • Bugs/Defects Fixed: https://github.com/Pi4J/pi4j/issues?q=label%3Abug+is%3Aclosed+milestone%3A%22RELEASE+1.0%22+

2013-03-17 :: 0.0.5

  • Added support for PCF8574 GpioProvider
  • Added sample code for using PCF8574 GpioProvider
  • Fixed issue where hard-float ABI was not detected properly when using Oracle JDK 8 early access edition. Pi4J#26
  • Added support for Motor and Stepper motor component interfaces.
  • Added GPIO based stepper motor implementation and sample program.
  • Added support for Motion sensor component interface.
  • Added GPIO based motion sensor implementation.
  • Added LCD component interface
  • Added GPIO based 4/8 bit LCD display component implementation and sample program.
  • Added GPIO based 4/8 bit LCD WiringPi example program
  • Added support for a GpioController.shutdown() method to cleanup terminate all Pi4J threads and executors. Pi4J#9
  • Added support for a user-definable ExecutorServiceFactory to allow user program to provide the implementation for executor service instances and managed thread pools.
    Pi4J#10
  • Fixed 'java.util.concurrent.RejectedExecutionException' issue where there were not enough default thread in the pool for concurrent tasks. Pi4J#31
  • Fixed issue where SerialDataMonitorThread was not shutting down on program exit. Pi4J#33
  • Fixed issue where hard-float ABI was not detected properly when using Oracle JDK 8 early access edition. Pi4J#26
  • Added support for exceptions on serial port access methods. Pi4J#8
  • Fixed issue where process streams were not being closed properly Pi4J#35
  • Fixed issue where serial.write(byte[]) was throwing java.lang.StringIndexOutOfBoundsException Pi4J#37
  • Added additional system information API methods to access memory, frequency, CPU temperature, voltage, and board model data. Pi4J#30
  • Fixed MCP23008 and MCP23017 getState() return values
  • Added support for MCP23S17 GpioProvider
  • Added support for Pi-Face GpioProvider
  • Added support for Pi-Face Device Interface
  • Added MCP23S17GpioExample sample code
  • Added PiFaceExample sample code
  • Added WiringPiSPIExample sample code
  • Added LED component interface and GpioLEDCompoment impl
  • Added GpioSwitchCompoment impl

2012-12-16 :: 0.0.4

  • Added support for building a Pi4J .deb installer package for Debian/Raspian Linux distribution. (BETA)
  • Modified NetworkInfo static methods to permit empty array return values when a network property cannot be obtained. Pi4J#3
  • Fixed issue in newer Raspberry Pi 512mb firmware where Pi4J was not compiled against latest wiringPi library and thus not detecting the hardware properly. Pi4J#3
  • Fixed defect where Pi4J library prevented consuming program from exiting properly. Pi4J#4 Pi4J#6
  • Added support for MCP23008 GPIO Provider using I2C bus.
  • Added support for MCP23017 GPIO Provider using I2C bus.
  • Modified build script to support concurrent soft-float and hard-float native library builds
  • Modified build script to include pulling wiringPi sources and compiling when building native library
  • Added power controller device interface, base impl, and reference impl
  • Added GpioController.provisionXXXPin methods that allow name to be optional
  • Relocated project downloads location to google code site; github deprecated downloads.
  • Added Google Groups discussion forum to project docs.
  • Added getTag() and setTag() to GpioPin interface and impl.
  • Added TemperatureConversion utility.
  • Added optional blocking argument to GpioPin pulse method to support blocking pulse invocations

2012-10-22 :: 0.0.3-SNAPSHOT

  • Refactored Gpio interfaces to permit extensible GpioProviders for add-on devices.
  • Refactored Gpio interfaces to separate digital, analog, and PWM types of input and output pins.
  • Added support for analog GPIO pins (interfaces, methods and events).
  • Added Olimex AVR-IO-M16 GpioProvider to serve as an example of extending a new GpioProvider for GPIO expansion.
  • Added Olimex AVR-IO-M16 sources for ARV micro-controller.
  • Removed setDirection() from GpioPin; embedded this functionality into existing setMode() method. Eliminating duplication.
  • Removed old test programs from pi4j-core and moved wiringPi examples to pi4j-example project.
  • Added support for I2C communication.
  • Added blink() methods for GPIO pins

2012-09-23 :: 0.0.2-SNAPSHOT

  • Refactored Gpio interface to permit methods using Pin argument to function without requiring a GpioPin to first be provisioned
  • Added OSGi manifest
  • Optimized GPIO interrupt thread handling to only be created if GpioPin listeners or triggers have been registered.
  • Now disabling/stopping GPIO interrupt native thread monitoring if all GpioPin listeners or triggers are unregistered.
  • Added additional convenience methods in GpioPin interface for evaluating state, direction, resistance, mode, etc.
  • There were two Gpio classes; renamed one to GpioController to avoid confusion.
  • Added OSGi service project to export Pi4J GPIO as an OSGi service.

2012-09-19 :: 0.0.1-SNAPSHOT

  • Initial ALPHA release