In this tutorial you will need a Rasberry Pi Zero and an OLED bonnet (or some input and LED display equivalent). The Adafruit Bonnet has a 128x64 pixel OLED display, a 5-button joystick, and 2 buttons.
We will be using Java by leveraging Pi4J to access the GPIO (General Purpose I/O). What's even funky fresher is that we are going to utilize some modern microservice patterns with Micronaut. A Spring inspired full stack microservice framework designed for building lightweight applications.
Each Pi has been imaged with Raspbian Lite and has all the necessary configuration and libraries to run a Java application (you can skip Preparing your SD Card).
- Preparing your SD Card - (Optional - this will be provided to you for the Dev Day already prepared) How to create an SD card for this project.
- First Steps - Connecting to and setting up your Pi
- Securing Your Pi - Lock down your Pi
- Setup Wi-Fi - Configure your Wi-Fi
In addition to securing your Pi, you will need to generate a Personal Access Token with the following permissions enabled:
- repo
- admin:org
- notifications
- user
A Personal Access Token is an API key that let's you access Github data programatically. It will be used for the following Github integration.
Although Micronaut applications have fast startup times (~1.5s), starting a Java application on a Pi does take more time (~20s on a Pi Zero and ~8s on a Pi 3B+).
In addition Pi4J uses WiringPi under the covers (a python library for accessing the GPIO on DSM devices), and will likely not run on your local machine.
As such, start with this Micronaut Exercise and create an application from scratch with the Micronaut CLI before you start developing on your Pi's.
Once you are comfortable with how to use Micronaut it's time to put the two together!
-
Clone this seed project and checkout the
oled-bonnet-seedbranch. -
Add the same github configuration in the
application.ymlas you did in the Micronaut Warm Up. -
Read the Development Workflow and How to Use sections before you start the following exercises.
Complete the following exercises in order:
Exercise 1 - Runtime stats layout
Exercise 2 - Devlight layout
Exercise 3 - Pull Requests layout
Exercise 4 - Pull Request Detail layout
-
Implement a layout that tickles your fancy! Make a branch for your feature so that it can be easily merged.
-
Write an integration with the devlights client that changes the light in your pod when a PR you contributed to gets approved, merged, and/or closed.
-
Create a PR feedback feature that displays an alert for you to re-check a PR when a
PushEventhappens after you have requested changes on a PR.
Whoever contributes the best Pi feature(s) will win a Circuit Playground Express! Submissions will be judged by creativity, completeness, relevance, and overall awesomeness!
If you Spring chickens are becoming Micronaut fans, there is a Micronaut-Spring project worth checking out that can be used to:
- Integrate Spring components into a Micronaut application
- Run Spring applications as Micronaut applications
- Expose Micronaut beans to a Spring application