A controller for the display and fan of the Raspberry Pi Waveshare PoE HAT written in Rust 🦀

Last update: Nov 27, 2023

Overview

🦀🍇 RustBerry-PoE-Monitor

RustBerry-PoE-Monitor is a Rust-based monitoring and control tool for the Raspberry Pi, specifically designed for use with the Waveshare PoE HAT (B).

This tool provides real-time monitoring of your Raspberry Pi's system statistics, including IP address, memory usage, CPU load, and more, displayed on the PoE HAT's OLED display. Additionally, it offers fan control to maintain optimal operating temperatures.

📖 Table of Contents

🦀🍇 RustBerry-PoE-Monitor

🌟 Features

Minimal resource usage
Developed in Rust for memory safety 🦀
Display real-time system statistics (IP address, memory, CPU usage, etc.) on the PoE HAT's OLED screen 📊
Automatic fan control based on the CPU temperature 🌡️

📦 Installation

Easy Installation

Run the following command to install:

curl -sSL https://raw.githubusercontent.com/jackra1n/RustBerry-PoE-Monitor/main/install.sh | sudo bash

And that's it!

Manual Installation

Check out the wiki page to learn how to install manually.

📝 Configuration

To change the fan on/off temperature, you can add temp-on and temp-off arguments to the application. If you installed the application using the install script, you can edit the systemd service file to change the arguments.

sudo nano /etc/systemd/system/rustberry-poe-monitor.service

Change the ExecStart line to the following:

ExecStart=/usr/local/bin/rustberry-poe-monitor --temp-on 60 --temp-off 50

??️ Building

Prerequisites

For building for Rasberry Pi I'm using cross

Building for Raspberry Pi

 cross build --target=aarch64-unknown-linux-gnu --release

🏃‍♂️ Running

Just run the binary file

./rustberry-poe-monitor

You might also like...

Lemurs - A lightweight TUI display/login manager written in Rust 🐒

Lemurs 🐒 A TUI Display/Login Manager written in Rust WIP: Whilst the project is working and installable, there are still a lot of bugs and limitation

136 Jan 1, 2023

A Windows virtual display driver written in Rust (works with VR, etc)

Virtual Display Driver This is a Windows driver made in Rust which creates a virtual desktop. It has many uses, such as: A private virtual desktop for

28 Sep 19, 2023

A simple program that provides DBus interface to control display temperature and brightness under wayland without flickering

wl-gammarelay-rs Like wl-gammarelay, but written in rust, runs on a single thread, has three times less SLOC and uses DBus (for simplicity). Dbus inte

33 Nov 23, 2022

Rust command line utility to quickly display useful secrets in a Kubernetes namespace

kube-secrets This is a command line utility for quickly looking at secrets in a Kubernetes namespace that are typically looked at by humans. It specif

8 Feb 10, 2022

Rust crate that allows you to display status & progress information in a terminal

status-line This crate allows you to display status & progress information in a terminal This crate handles the problem of displaying a small amount o

20 Dec 27, 2022

CLI app to display list of trending anime, music charts or recommend anime to watch or song to listen to.

Description Anitrendz is a cli app that uses data from the anitiop api to list the top anime and songs or recommend a random anime to watch or song to

9 Jun 11, 2022

Display ZFS datasets' I/O in real time

ztop Display ZFS datasets' I/O in real time Overview ztop is like top, but for ZFS datasets. It displays the real-time activity for datasets. The buil

40 Nov 23, 2022

Display financial Data on The Terminal

tuinance Tuinance is a performant TUI program to display financial data, written completely in Rust. All data is gathered through the Yahoo Finance AP

10 May 31, 2022

Display a random Shiba from your terminal whenever you feel the need to. Because why not?

Shiba CLI Command-line interface (CLI) to display a random Shiba Inu whenever needed, by just running shiba on your terminal. How To Use • How Does It

17 Sep 25, 2022

Releases(1.0.1)

1.0.1(Nov 21, 2023)
This is the first main release!

It now has all features I wanted to implement. Changes from 0.3.0:

Configure fan on and off temperatures using CLI

Add more logs and error handling

Add installation manual

Source code(tar.gz)
Source code(zip)
rustberry-poe-monitor(7.41 MB)
0.3.0(Nov 21, 2023)

Use new font PC Senior
Source code(tar.gz)
Source code(zip)
rustberry-poe-monitor(5.28 MB)
0.2.0(Nov 19, 2023)

This version has a lot of code cleanups and initial implementation for fan control. For now its not possible yet to set the fan on and off temperatures and the default values are set to on=60, off=50.

The next release should include the ability to configure the temperatures as well as better installation instructions.
Source code(tar.gz)
Source code(zip)
rustberry-poe-monitor(5.28 MB)
0.1.0(Nov 16, 2023)

Initial working release

There are still things to improve but im pretty convinced this can be used without problems. Fan control not implemented yet

Less than 3MB RAM usage and ~0.2% CPU usage
Source code(tar.gz)
Source code(zip)
rustberry-poe-monitor(5.27 MB)