Welcome to Pi4J!
This project is intended to provide a friendly object-oriented I/O API and implementation libraries for Java Programmers to access the full I/O capabilities of the Raspberry Pi platform. This project abstracts the low-level native integration and interrupt monitoring to enable Java programmers to focus on implementing their application business logic.
News / Announcements
- 2016-07-26
-
Version 1.1 has been released and is now available for download. (Downloads | Installation)
New Feature Highlights:
- Added support for Raspberry Pi 3 - Model B
- Added support for Raspberry Pi Zero
- Added support for BananaPi platform
- Added support for BananaPro platform
- Added support for Odroid C1/C1+
- Added support for Odroid XU4
- Updated to Java 7 runtime
- Added support for enabling non-privileged GPIO access via the Pi4J APIs (no 'sudo' required)
(see: Pi4J GPIO Non-Privileged Access) - Added optimizations for GPIO state change latency
- Added cross-compiler support in Maven build
- Added new Serial JNI implementation to support advanced serial configuration/operations
In addition to maintenance and bug fixes, the 1.1 release includes a completely overhauled Serial communication API and implementation. Please note that to add these serial API enhancements some APIs required breaking changes where they may no longer be backwards compatible with prior versions.
New development and bug fixes will now be provided via the 1.2-SNAPSHOT builds and the latest development codebase is now maintained in the 'master' branch.
Project Status
Please note that this project is continually under development but has been very stable for several years. The functionality is very stable but improvements and bug fixes are continually committed into the 'master' branch in the Pi4J GitHub repository and SNAPSHOT builds are published in the Sonatype OSS repository.
You are welcome to start using and integrating this library in your project. Please provide any feedback good, bad or ugly. (Well maybe keep the ugly feedback to a minimum.)
Visit the Downloads page to download the latest Pi4J library builds.
Supported Hardware
- Raspberry Pi - Model A
- Raspberry Pi - Model B (Revision 1)
- Raspberry Pi - Model B (Revision 2)
- Raspberry Pi - Model A+
- Raspberry Pi - Model B+
- Raspberry Pi - Compute Module
- Raspberry Pi 2 - Model B
- Raspberry Pi 3 - Model B
- Raspberry Pi Zero
- LeMaker BananaPi
- LeMaker BananaPro
- Odroid C1/C1+
- Odroid XU4
Features
- Export & unexport GPIO pins
- Configure GPIO pin direction
- Configure GPIO pin edge detection
- Control/write GPIO pin states
- Pulse GPIO pin state
- Read GPIO pin states
- Listen for GPIO pin state changes (interrupt-based; not polling)
- Automatically set GPIO states on program termination (GPIO shutdown)
- Triggers for automation based on pin state changes
- Send & receive data via RS232 serial communication
- I2C Communication
- SPI Communication
- Extensible GPIO Provider interface to add GPIO capacity via expansion boards
- Access system information and network information from the Raspberry Pi
- Wrapper classes for direct access to WiringPi Library from Java
Getting Started
The simplest method to install Pi4J on your RaspberryPi is to execute the following command directly on your RaspberryPi.
curl -s get.pi4j.com | sudo bash
To get started using the Pi4J library, please see the following pages: