OLED System Info Display for Home Assistant

Share your Projects!
,
1

If you’re running Home Assistant on a Raspberry Pi tucked away somewhere, you’ve probably experienced the annoyance of not knowing its IP address when you need it, or having to SSH in just to reboot it safely.

This add-on connects a small $3 SSD1306 OLED display to your Pi’s GPIO and shows:

  • Hostname and IP address
  • CPU usage
  • Memory usage

There’s also a physical button that wakes the display, and if you hold it long enough, lets you trigger a safe reboot or shutdown — no SSH or web interface needed.

What you need:

  • A Raspberry Pi (Zero through 5, all supported)
  • A 128x32 SSD1306 I2C OLED display
  • A push button + a couple resistors
  • About 15 minutes of wiring

It’s great for headless setups, or if you just want your Home Assistant box to feel a bit more “finished” with a status display. The add-on integrates with the Supervisor API, so reboot/shutdown commands work properly through HA.

Based on the original project by leelooauto, packaged as a proper Home Assistant add-on with one-click install.

Repo: GitHub - PhyberApex/home-assistant-add-on-repo: Repository of my Add-ons

Based on this: GitHub - leelooauto/system_info

Happy to answer questions or take feedback.

2

Will this work with a 128x64 SH1106 display?

3

Right now it does not. However if you are interested I can take a look to make it work. I dont have one to test tho.

4

Hey! Nice work! I have searched how to use that SSD1306 with HA! https://www.waveshare.com/wiki/PoE_HAT_(B)#Working_with_Raspberry_Pi and found your work! Really great!

I just would like to ask you to add the CPU Temperature, is it possible?

5

Sure thing. I’ll take a look tomorrow on how to properly add CPU temp. Any recommendation? Or do you just want it additionally?

~Cheers

6

WOW that’s great! :smiley: Personally for me only the CPU Temp is important. So a big temp might be good to see it clearly.

Actually i also just see that on the OLED. Did i something wrong? I guess i dont have the button you have noted in your add on. It might be always high on the HAT.

image
image1062×1099 88.1 KB

Can the button be an option? And to have an always on mode?

s6-rc: info: service s6rc-oneshot-runner: starting
s6-rc: info: service s6rc-oneshot-runner successfully started
s6-rc: info: service fix-attrs: starting
s6-rc: info: service fix-attrs successfully started
s6-rc: info: service legacy-cont-init: starting
s6-rc: info: service legacy-cont-init successfully started
s6-rc: info: service legacy-services: starting
s6-rc: info: service legacy-services successfully started
[20:57:01] INFO: Starting OLED System Info Display...
[20:57:01] INFO: Scanning I2C bus...
     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
00:                         -- -- -- -- -- -- -- -- 
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
20: 20 -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
30: -- -- -- -- -- -- -- -- -- -- -- -- 3c -- -- -- 
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
70: -- -- -- -- -- -- -- --                         
[20:57:02] INFO: Board: RASPBERRY_PI_4B, Chip: BCM2711
[20:57:02] INFO: Starting OLED display script...
[20:57:02] Initializing OLED System Info Display
[20:57:02] Configuring GPIO - Button: GPIO20, LED: GPIO23
[20:57:02] GPIO configured successfully
[20:57:02] Initializing I2C and OLED display
[20:57:03] OLED display initialized
[20:57:03] Status LED turned on
[20:57:03] Displaying startup message
[20:57:08] Entering main loop
[20:57:08] BUTTON: Pressed
[20:57:08] Display activated
[20:57:13] MENU: Entering REBOOT state
[20:57:19] MENU: Entering SHUTDOWN state
7

Here is also a good project for the HAT with SSD1306

It might provide some examples for the screen.

8

I’ll look into making it possible to have a switch to get your config (always on, CPU temp) or something more configurable tomorrow! Thanks for using and your input!

~Cheers

9

appreciate this! Awesome :slight_smile:

10

Alright, pushed an update that should cover everything from this thread!

CPU Temp: added it two ways — a compact reading on the normal info screen (CPU:25% MEM:45% 24C), and since you said only the temp really matters to you, a dedicated big centered temperature screen too.

Button optional / always-on: found the actual bug in your log — with no button wired, GPIO20 was floating and getting misread as a held press, walking straight into the shutdown sequence. Set enable_button: false in the config and it’ll never touch that pin at all — display just runs always-on instead, cycling between the info screen and the big temp screen every few seconds. No more surprise shutdowns.

Fan control: also added, opt-in via enable_fan_control (off by default since not everyone has this HAT). Turns out the fan isn’t GPIO at all — it’s an I2C IO-expander at address 0x20 (you can actually see it in your own i2cdetect log next to the OLED’s 3c!). Thresholds are configurable (fan_temp_on/fan_temp_off, default 60°C/50°C) — credit to klamann/raspi-poe-mon and jackra1n/RustBerry-PoE-Monitor for the reference, that fan protocol wasn’t documented anywhere else I could find.

Threw in a couple bonus options too: flip_display for orientation, and show_hostname/show_ip/show_cpu/show_memory/show_temperature if you want to hide anything.

All defaults preserve existing behavior, so nothing changes unless you touch the config.

~Cheers

11

WOW! It works like a charm and you have added so many features now! Awsome

image
image1008×1088 216 KB