README.md

🦀🍇 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
  • 📖 Table of Contents
  • 🌟 Features
  • 📦 Installation
    • Easy Installation
    • Manual Installation
  • 📝 Configuration
  • 🛠️ Building
    • Prerequisites
    • Building for Raspberry Pi
  • 🏃‍♂️ Running

🌟 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://rustberry.jackra1n.com/install | 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

Links

• Waveshare PoE HAT (B)
• raspi-poe-mon - python implementation and original idea for the display layout
• PCSenior - Font used for the display
• cross - Rust tool for building cross-platform binaries