| title |
|---|
Plug-ins |
The goal of Pi4J V.2 is to provide a solid base with all required "minimal functionality" while at the same time, promote third-party development and extensibility, thus enabling developers to build and maintain their extensions outside of the Pi4J core projects codebase.
This will enable us to deliver a stable, fully tested framework as the number of features inside of Pi4J can be limited and support for specific I/O hardware can be provided with an extension for Pi4J.
More info about how this extensibility is achieved:
- Extensible I/O hardware PROVIDERS: things like GPIO expanders, I2C bus expanders, GertBoard, add-on hardware shields, etc.
- Extensible SBC platforms PLATFORMS: the core project may only support Raspberry Pi, but the platform and libraries should be written to allow a third party to create plugins for alternate hardware platforms/boards.
- Extensible plugins.
Plugins are extensible service modules that interact with or augment the Pi4J infrastructure. The most common plugins are I/O Providers and Platforms. Other plugin examples could be a web app to view/control the Pi4J runtime state/status, some third-party observer to the Pi4J runtime state/status,...
Plugins are implemented as Java modules using Service Provider Interfaces (SPI).
Plugins must declare their pluggable interface in their "module-info.java" config file. Example from the Raspberry plugin:
module com.pi4j.plugin.raspberrypi {
requires com.pi4j;
exports com.pi4j.plugin.raspberrypi;
exports com.pi4j.plugin.raspberrypi.platform;
exports com.pi4j.plugin.raspberrypi.provider.gpio.digital;
exports com.pi4j.plugin.raspberrypi.provider.pwm;
exports com.pi4j.plugin.raspberrypi.provider.serial;
exports com.pi4j.plugin.raspberrypi.provider.spi;
exports com.pi4j.plugin.raspberrypi.provider.i2c;
provides com.pi4j.extension.Plugin with RaspberryPiPlugin;
}ServiceLoader overview by Piotr Mińkowski.
