告别命令行：用NanoPi NEO和1.69寸屏打造你的迷你桌面终端（基于Framebuffer）

用NanoPi NEO打造迷你终端1.69寸屏的Framebuffer创意实践在创客的世界里总有些令人兴奋的项目能将看似普通的硬件组合变成实用又有趣的工具。今天我们要探讨的就是如何将NanoPi NEO这块信用卡大小的开发板与1.69寸的ST7789V2驱动屏幕结合打造一个完全独立运行的迷你信息终端。这个终端不需要HDMI显示器也不需要SSH连接它本身就是个完整的显示系统可以实时展示服务器状态、智能家居数据或者任何你想监控的信息。1. 硬件准备与环境搭建1.1 选择合适的硬件组合NanoPi NEO以其小巧的体积和完整的Linux系统支持成为这个项目的理想选择。搭配中景园的1.69寸LCD屏幕ST7789V2驱动这个组合既经济实惠又足够强大。屏幕的240×280分辨率对于显示文本和简单图形界面绰绰有余。所需硬件清单NanoPi NEO开发板H3处理器版本中景园1.69寸LCD屏幕ST7789V2驱动芯片杜邦线若干5V电源适配器可选3D打印外壳或自制亚克力外壳1.2 引脚连接与物理组装屏幕与NanoPi NEO的连接相对简单主要使用SPI接口。以下是具体的引脚对应关系屏幕引脚NanoPi NEO引脚功能说明GNDGND地线VCC3.3V电源SCLPC2SPI时钟SDAPC0SPI数据RESPG11复位DCPA1数据/命令选择CSPC3片选BLKPA0背光控制提示连接时务必确认电源极性正确错误的连接可能会损坏屏幕或开发板。1.3 开发环境配置为了编译内核模块和驱动我们需要搭建交叉编译环境。友善之臂官方提供了完整的工具链# 下载交叉编译工具链 wget http://wiki.friendlyarm.com/download/linux/toolchain/arm-linux-gnueabihf-gcc-4.9.3.tar.xz tar xvf arm-linux-gnueabihf-gcc-4.9.3.tar.xz # 下载Linux内核源码 git clone https://github.com/friendlyarm/linux.git -b sunxi-4.14.y --depth 12. 内核驱动配置与编译2.1 设备树修改要让内核识别我们的屏幕需要修改设备树文件。找到linux/arch/arm/boot/dts/sun8i-h3-nanopi.dtsi在spi0节点下添加屏幕配置spi0 { status okay; pinctrl-names default; pinctrl-0 spi0_pins spi0_cs_pins; pitft: pitft0 { compatible sitronix,st7789v; reg 0; status okay; spi-max-frequency 96000000; rotate 90; fps 33; buswidth 8; dc-gpios pio 0 1 GPIO_ACTIVE_HIGH; /* PA1 */ reset-gpios pio 6 11 GPIO_ACTIVE_HIGH; /* PG11 */ led-gpios pio 0 0 GPIO_ACTIVE_LOW; /* PA0 */ debug 0x0; }; };2.2 内核配置与编译进入内核源码目录启用ST7789V驱动make menuconfig ARCHarm CROSS_COMPILEarm-linux-gnueabihf-导航至Device Drivers → Staging drivers → Support for small TFT LCD display modules → FB driver for the ST7789V LCD Controller编译内核和模块make zImage dtbs modules ARCHarm CROSS_COMPILEarm-linux-gnueabihf-2.3 部署新内核将编译好的内核和设备树文件拷贝到NanoPi NEO上scp arch/arm/boot/zImage root[板子IP]:/boot scp arch/arm/boot/dts/sun8i-h3-nanopi-neo.dtb root[板子IP]:/boot重启后屏幕应该会显示Linux控制台输出。3. Framebuffer基础应用3.1 验证Framebuffer工作首先确认framebuffer设备已正确创建ls /dev/fb*通常会是/dev/fb0。我们可以用简单的工具测试显示# 安装fbiframebuffer image viewer apt-get install fbi # 显示一张测试图片 fbi -noverbose -a test.jpg3.2 基本文本显示对于终端应用我们可以直接重定向控制台输出到我们的屏幕con2fbmap 1 0这个命令将tty1的控制台输出映射到fb0我们的屏幕。现在屏幕应该显示Linux登录提示。3.3 自定义信息显示创建一个简单的shell脚本定期显示系统信息#!/bin/bash while true; do clear /dev/fb0 echo CPU温度: $(cat /sys/class/thermal/thermal_zone0/temp) /dev/fb0 echo IP地址: $(hostname -I) /dev/fb0 echo 内存使用: $(free -m | awk NR2{printf %.1f%%, $3*100/$2}) /dev/fb0 sleep 5 done4. 高级显示技巧与实用脚本4.1 使用Python进行图形绘制Python的pygame库可以直接操作framebuffer实现更复杂的显示效果。首先安装所需库apt-get install python3-pygame然后创建一个简单的状态显示器#!/usr/bin/python3 import pygame import time import os # 初始化pygame pygame.init() # 设置显示表面为framebuffer os.environ[SDL_FBDEV] /dev/fb0 os.environ[SDL_VIDEODRIVER] fbcon # 创建显示表面 size (pygame.display.Info().current_w, pygame.display.Info().current_h) screen pygame.display.set_mode(size, pygame.FULLSCREEN) # 字体设置 font pygame.font.Font(None, 24) def get_cpu_temp(): with open(/sys/class/thermal/thermal_zone0/temp, r) as f: temp int(f.read()) / 1000 return temp def get_mem_usage(): with open(/proc/meminfo, r) as f: lines f.readlines() total int(lines[0].split()[1]) free int(lines[1].split()[1]) used total - free return (used / total) * 100 while True: # 获取系统信息 cpu_temp get_cpu_temp() mem_usage get_mem_usage() ip_addr os.popen(hostname -I).read().strip() # 清屏 screen.fill((0, 0, 0)) # 绘制信息 temp_text font.render(fCPU温度: {cpu_temp:.1f}°C, True, (255, 255, 255)) mem_text font.render(f内存使用: {mem_usage:.1f}%, True, (255, 255, 255)) ip_text font.render(fIP地址: {ip_addr}, True, (255, 255, 255)) screen.blit(temp_text, (10, 10)) screen.blit(mem_text, (10, 40)) screen.blit(ip_text, (10, 70)) pygame.display.flip() time.sleep(1)4.2 创建简易菜单系统对于更复杂的交互我们可以实现一个简单的菜单系统#!/usr/bin/python3 import pygame import os import subprocess # 初始化 pygame.init() os.environ[SDL_FBDEV] /dev/fb0 os.environ[SDL_VIDEODRIVER] fbcon size (240, 280) screen pygame.display.set_mode(size, pygame.FULLSCREEN) font pygame.font.Font(None, 24) # 菜单项 menu_items [ 系统状态, 网络信息, 重启系统, 关机 ] current_selection 0 def draw_menu(): screen.fill((0, 0, 0)) for i, item in enumerate(menu_items): color (255, 255, 255) if i ! current_selection else (255, 255, 0) text font.render(item, True, color) screen.blit(text, (20, 20 i * 30)) pygame.display.flip() def show_system_status(): screen.fill((0, 0, 0)) cpu_temp subprocess.getoutput(cat /sys/class/thermal/thermal_zone0/temp) cpu_temp f{int(cpu_temp)/1000:.1f}°C mem_usage subprocess.getoutput(free -m | awk NR2{printf \%.1f%%\, $3*100/$2}) font_large pygame.font.Font(None, 32) temp_text font_large.render(fCPU: {cpu_temp}, True, (255, 255, 255)) mem_text font_large.render(f内存: {mem_usage}, True, (255, 255, 255)) screen.blit(temp_text, (20, 50)) screen.blit(mem_text, (20, 100)) back_text font.render(按B键返回, True, (255, 255, 255)) screen.blit(back_text, (20, 200)) pygame.display.flip() while True: for event in pygame.event.get(): if event.type pygame.KEYDOWN: if event.key pygame.K_b: return running True draw_menu() while running: for event in pygame.event.get(): if event.type pygame.KEYDOWN: if event.key pygame.K_DOWN: current_selection (current_selection 1) % len(menu_items) draw_menu() elif event.key pygame.K_UP: current_selection (current_selection - 1) % len(menu_items) draw_menu() elif event.key pygame.K_RETURN: if current_selection 0: # 系统状态 show_system_status() draw_menu() elif current_selection 3: # 关机 os.system(poweroff) running False elif event.key pygame.K_q: running False5. 项目优化与实用技巧5.1 降低系统资源占用作为常驻终端我们需要尽量减少资源占用# 关闭不需要的服务 systemctl disable --now avahi-daemon systemctl disable --now triggerhappy systemctl disable --now console-setup # 使用轻量级init系统如runit apt-get install runit5.2 自动启动显示脚本创建systemd服务让我们的显示脚本开机自动运行# /etc/systemd/system/miniterm.service [Unit] DescriptionMini Terminal Display Afternetwork.target [Service] ExecStart/usr/local/bin/miniterm.py Restartalways Userroot [Install] WantedBymulti-user.target然后启用服务systemctl enable miniterm.service systemctl start miniterm.service5.3 物理按钮集成为增强交互性可以添加几个物理按钮连接到GPIO用于菜单导航# 在Python脚本中添加GPIO检测 import RPi.GPIO as GPIO GPIO.setmode(GPIO.BCM) GPIO.setup(17, GPIO.IN, pull_up_downGPIO.PUD_UP) # 上 GPIO.setup(22, GPIO.IN, pull_up_downGPIO.PUD_UP) # 下 GPIO.setup(27, GPIO.IN, pull_up_downGPIO.PUD_UP) # 选择 while running: if GPIO.input(17) False: # 上 current_selection (current_selection - 1) % len(menu_items) draw_menu() time.sleep(0.2) elif GPIO.input(22) False: # 下 current_selection (current_selection 1) % len(menu_items) draw_menu() time.sleep(0.2) elif GPIO.input(27) False: # 选择 # 处理选择逻辑 time.sleep(0.2)5.4 外壳设计与电源管理为了让项目更加完整可以考虑3D打印或激光切割一个外壳将屏幕和开发板整合在一起添加锂电池和充电电路实现便携使用使用PWM控制屏幕背光根据环境光线自动调节亮度# 控制背光亮度的示例 echo 50 /sys/class/backlight/backlight/brightness