Turing Smart Screen Python 智能显示屏配置指南：从部署到个性化的完整路径

Turing Smart Screen Python 是一个开源项目，提供 Python 系统监控程序和抽象库，专为小型 IPS USB-C 显示屏设计，支持 Turing Smart Screen 和 XuanFang 等多种型号。它能将显示屏用作系统监控器，也可在 Python 项目中控制显示内容，是硬件爱好者和开发人员的实用工具，可实现 Python 系统监控与智能显示屏驱动的高效结合。

一、系统部署

1.1 环境准备要求

确保系统满足以下条件：

• 操作系统：支持 macOS、Windows、Linux（包括树莓派）
• Python 版本：Python 3.9 或更高版本
• 权限：具备安装 Python 包和运行程序的足够权限

获取项目代码：

git clone https://gitcode.com/GitHub_Trending/tu/turing-smart-screen-python
cd turing-smart-screen-python

1.2 依赖安装与验证

进入项目目录后，安装必要的依赖包：

pip install -r requirements.txt

二、基础配置

2.1 配置文件参数详解

项目核心配置文件为 config.yaml，关键配置项如下：

显示屏型号设置：

• REVISION: A - Turing 3.5 英寸和 UsbPCMonitor 3.5/5 英寸
• REVISION: B - Xuanfang 3.5 英寸（包括旗舰版）
• REVISION: C - Turing 2.1/2.8/5/8.8 英寸
• REVISION: D - Kipye Qiye 智能显示屏 3.5 英寸

主题选择：

• THEME: 3.5inchTheme2 - 使用预设主题，主题文件位于 res/themes 目录

2.2 首次运行与功能验证

完成配置后，运行系统监控器：

python main.py

若配置正确，将显示类似下图的系统监控界面：

三、核心功能解析

3.1 硬件适配与传感器选择

根据操作系统选择合适的硬件传感器读取方式：

• PYTHON：使用 Python 库读取硬件传感器（支持所有操作系统）
• LHM：使用 LibreHardwareMonitor 库（仅限 Windows，需管理员权限）
• AUTO：自动选择最佳方式

3.2 关键配置项说明

• BRIGHTNESS: 20 - 建议初始设置为 20%，避免显示屏过热
• ETH: "" - 以太网卡名称
• WLO: "" - WiFi 卡名称
• RESET_ON_STARTUP: true - 启动时重置显示屏（频繁断开连接时可设为 false）

四、个性化与扩展

4.1 主题选择与应用

项目提供丰富预设主题，位于 res/themes 目录，以下为部分主题效果：


4.2 自定义主题创建

使用主题编辑器创建个性化主题，支持：

• 背景图片、文字样式、进度条等元素自定义
• 适配不同显示屏尺寸
• 动态数据展示配置

4.3 天气数据集成

若需显示天气信息：

1. 注册 OpenWeatherMap 获取免费 API 密钥
2. 设置所在位置经纬度坐标
3. 选择温度单位（公制 - °C、英制 - °F、标准 - °K）

五、问题解决与优化

5.1 常见问题索引

• COM 端口自动检测失败：手动指定 COM 端口（Windows: COM3，Linux: /dev/ttyACM0）
• 显示屏频繁断开连接：将 RESET_ON_STARTUP 设置为 false
• 传感器数据读取异常：检查传感器选择模式，Windows 系统推荐使用 LHM 模式

5.2 性能优化建议

• 合理设置数据刷新间隔，平衡实时性与资源占用
• 根据硬件性能调整显示复杂度，低配置设备建议使用简约主题
• 使用模拟显示模式（--simulate）进行开发测试，避免频繁硬件操作

配置验证清单

• [ ] Python 3.9+ 已安装
• [ ] 项目依赖包通过 pip install -r requirements.txt 安装完成
• [ ] config.yaml 中显示屏型号（REVISION）配置正确
• [ ] 主题选择与显示屏尺寸匹配
• [ ] 硬件传感器设置符合操作系统要求
• [ ] 运行 python main.py 无报错，显示屏正常显示