[Tutorial] How to get your NanoHatOLED to work with DietPi

Community Tutorials
1

Hello, I would like to continue the work of @Phillski, @maarten and @Fatguy5150 described on the original post which has already been closed.

It is 2025 2026 and DietPi is based on Buster Bookworm Trixie with kernel 4.x 6.x.

oled_en_02
oled_en_02443×423 40 KB

Some modifications were necessary on the latest NanoHatOLED github repository which is already based on Python3.8.

I have removed everything not related to the NanoHatOLED and merged all the modifications from @maarten and @Fatguy5150 described in the original post.

  • DietPi or PiHole Logo on boot
  • 30 Seconds sleep to avoid OLED Burn-in
  • Start-up script on var/lib/dietpi/postboot.d/
  • Latest PiHole 6.x API integration (api.php has been removed)

How to install

  1. Enable i2c (add to armbianEnv.txt): overlays=i2c0 usbhost1 usbhost2
  2. Download NanoHatOLED.tar.gz and copy it on ~/
  3. apt-get install git build-essential
  4. Add board information on /etc/sys_info. The below is an example of a NanoPi NEO1.4. If you have a different board, find the _platform & _board_id information here ~/NanoHatOLED/BakeBit/WiringNP/wiringPi/boardtype_friendlyelec.c and the _chipid here nano /proc/cpuinfo. For example, NanoPi NEO Air issunxi_platform: Sun8iw7p1. and sunxi_board_id: 2(0). NanoPI NEO2 sunxi_platform: Allwinnersun50iw2Family and sunxi_board_id: 1(0)Everything else is kindda irrelevant.

/etc/sys_info

sunxi_platform    : Allwinnersun8iFamily
sunxi_secure      : normal
sunxi_chipid      : 2c21020e786746240000540000000000
sunxi_chiptype    : 00000042
sunxi_batchno     : 1
sunxi_board_id    : 1(0)
  1. tar -pxvzf NanoHatOLED.tar.gz && cd NanoHatOLED && ./install.sh

Troubleshooting:

  • Check that after reboot, the binary ./NanoHatOLED is running inhtop
  • Check you have a nice reading of all IO when executing command gpio readall
  • Check that i2c is enabled by executing command sudo i2cdetect -y 0
  • Finally, check for some errors on the below logs
    /tmp/nanoled-python.log or /tmp/nanohat-oled.log

Notes:

  • No need for those libraries anymore libfreetype6-dev libjpeg-dev luma.oled
  • the flag --break-system-packages is used for the -pip libraries to install them on the system level

Currently not working:

  • gpio readall as it needs the output ‘Family’ from nano /proc/cpuinfo and upstream Trixie shows less info in cpuinfo output.

*edit1: DietPi is Based on Bookworm.
*edit2: Added PiHole 6.x API integration
*edit3: You can off course run the FriendlyELEC ROM directly instead of using DietPi.
*edit4: Added Fix for GCC v14 errors. Need to add the below flags to CFLAGS to every Makefile
-Wno-error=implicit-function-declaration -Wno-error=return-mismatch

NanoHatOLED.tar.gz (448.5 KB)

1 Like
[Tutorial] How to get your NanoHatOLED to work
3

as far as I can see, you update the original post at [Tutorial] How to get your NanoHatOLED to work - #47 by NanoDiet

4

You think I can be able to attache the source code here?

5

how many lines your script has?

6

Same as maarten‘s but modified to work with DietPi Trixie and gcc v14

7

you should be able to attach the archive same way

8

Hello, I can only attached .jpg and .png. Thank you.

9

I see, wich format you like to add? I could allow this for a moment.

10

Hello, NanoHatOLED.tar.gz

11

I added gz as allowed file type. can you check pls

12

it worked. coudl you also allow me more than two links on the post? I need 3 more: Latest PiHole API, upstream confirmation removing info from cpuinfo and the attachement count as link.

13

I promote you to level 1 user (from 0), can you check again

1 Like