三步点亮 USB-C 小屏：Turing Smart Screen 实时系统监控面板搭建指南-开发者社区

三步点亮 USB-C 小屏：Turing Smart Screen 实时系统监控面板搭建指南

【免费下载链接】turing-smart-screen-pythonUnofficial Python system monitor and library for small IPS USB-C displays like Turing Smart Screen / TURZX项目地址: https://gitcode.com/GitHub_Trending/tu/turing-smart-screen-python

主屏忙着干活，CPU 温度、下载速度总被忽略。turing-smart-screen-python 把闲置的 Turing Smart Screen USB-C 小屏变成副屏硬件监控面板，也能作为显示控制库嵌入自己的项目，支持 Windows、Linux 与树莓派。

项目简介

这类小屏的官方软件多仅限 Windows，显示内容也固定。本项目的做法是把不同品牌、不同硬件版本的小屏（Turing 2.1" 到 12.3"、XuanFang、WeAct 等）统一到一层抽象接口之下，同一套代码全平台运行。

它能提供两样东西：

系统监控程序：内置配置向导与数十套主题，CPU/GPU 温度、占用、内存、硬盘、网速都能上屏
显示控制库：在自己的 Python 代码里绘制文字、图片、进度条，设置旋转与亮度，部分版本还能控制背板 RGB

下图是选用内置主题后的屏上实际效果：

上手路径：三步点亮屏幕

第 1 步：获取代码与依赖（Python 3.9+）

git clone https://gitcode.com/GitHub_Trending/tu/turing-smart-screen-python cd turing-smart-screen-python pip install -r requirements.txt

第 2 步：接入小屏

用 USB-C 数据线把小屏插到电脑上。屏幕背面的 USB-C 口同时负责供电与数据传输，一根线即可。接入后它会被识别为串口（Windows 为 COM 口，Linux 形如 /dev/ttyACM*）。

第 3 步：配置并启动

python configure.py # 首次打开图形化配置 python main.py # 启动监控

配置界面中依次选择屏幕型号、尺寸、主题与传感器读取方式，点击 Save and run 即可上屏；之后日常只需运行 main.py。

使用场景

游戏与重负载时的硬件面板

场景：打游戏或跑渲染任务时，不想切回主屏看温度。效果：小屏常驻 CPU/GPU 温度、占用、SSD 温度与内存，按周期刷新。怎么实现：在 config.yaml 中将HW_SENSORS设为 AUTO（Windows 走 LibreHardwareMonitor 需管理员权限，其他系统用 Python 库），再把 stats 条目放到主题想要的位置。

闲时时间天气信息板

场景：清晨和深夜电脑空转，路过时想扫一眼时间与天气。效果：屏幕显示大号时钟、日期与天气。怎么实现：挑一套带时间、天气占位符的主题，在配置文件中填入WEATHER_API_KEY与城市经纬度，天气数据来自 OpenWeatherMap。

把小屏当自己项目的显示设备

场景：希望在自己的工具里把下载进度、自定义仪表盘输出到小屏。效果：屏幕相当于一块串口显示器，可画任意图片、文字、进度条，可设旋转与亮度，也能开关屏幕。怎么实现：引入library/lcd/模块并按屏幕选定 REVISION，示例见 simple-program.py；没有硬件也可用模拟模式（REVISION: SIMU）开发，图像会导出到本地文件预览。

个性化与进阶

更换主题：res/themes/ 下每个目录都是一套主题，含背景图 background.png 与描述元素布局的 theme.yaml
编辑主题：运行 theme-editor.py 可视化调整每个元素的位置
自定义数据源：在 library/sensors/ 中编写传感器模块，把任意数据（下载速率、室温等）做成 stats 条目，即可像 CPU 温度一样在主题里引用
常用参数：COM_PORT（AUTO 自动探测）、THEME、BRIGHTNESS（亮度）、REVISION（硬件版本）、RESET_ON_STARTUP

避坑指南

小屏无法识别：COM_PORT: AUTO时连接失败。原因：屏幕复位后串口名变化，或 REVISION 与硬件版本不符。解决：运行 tools/list-serial-ports.py 查看当前串口，手动填入配置文件并核对 REVISION。
元素错位或空白：原因：主题分辨率与物理屏幕不匹配（theme.yaml 内有 DISPLAY_SIZE）。解决：选择与屏幕尺寸对应的主题，如 3.5 英寸屏用 320x480 主题。
异常退出后屏幕卡死：现象：画面定格无响应。原因：屏幕处于半复位状态。解决：保持RESET_ON_STARTUP: true让程序启动时重置屏幕；若复位导致串口变化连不上，则改为 false。
屏幕发烫：现象：A 版高亮度下明显发热。原因：小屏无主动散热。解决：调低 BRIGHTNESS，默认值仅为 20%。

turing-smart-screen-python 用一套代码覆盖了两类需求：普通用户得到跨系统的硬件监控面板，开发者得到即接即用的屏幕控制库。手里有一块闲置 USB-C 小屏的话，无论用于监控、信息板还是自研项目副屏，都值得一试，内置主题加配置向导足以三步上屏。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考