XGP V3 Screen

NLnet XiGuaPi V3 TFT 屏幕控制程序，支持 Web 配置界面。

项目来源

• 原始项目: zzzz0317/xgp-v3-screen
• 原始作者: zzzz0317
• 许可证: GPL-3.0

改造内容

本项目在原始版本基础上进行了以下改造：

1. 集成硬件驱动

• ✅ 内置 kmod-fb-tft-gc9307 驱动源码，无需单独安装
• ✅ 使用标准 Linux framebuffer API
• ✅ 支持通过配置指定 framebuffer 设备路径
• ✅ 编译时自动构建驱动和应用两个包

2. 新增 LuCI Web 控制界面

• ✅ 集成到 OpenWrt 管理界面（服务 → XGP Screen）
• ✅ 支持配置项：
  • 启用/禁用屏幕（同时控制背光）
  • 切换动画类型（10种动画效果）
  • 默认停留时间
  • 跳过启动/闪屏画面
  • 每个页面独立配置（启用、停留时间、显示顺序）
  • Framebuffer 设备选择
  • 流量监控接口配置和手动清零

3. 屏幕切换动画

支持以下动画效果：

配置值	效果
none	无动画
fade	淡入淡出
slide_up	向上滑动（默认）
slide_down	向下滑动
slide_left	向左滑动
slide_right	向右滑动
over_up	从下往上覆盖
over_down	从上往下覆盖
over_left	从右往左覆盖
over_right	从左往右覆盖

4. 修复 Modem IP 显示问题

• ✅ 支持 wwan* 和 rmnet_mhi* 两种接口类型

5. 防止控制台日志干扰

• ✅ 启动时自动禁用 framebuffer 控制台输出
• ✅ 降低内核打印级别，防止设备插拔日志显示在屏幕上

6. 屏幕管理优化

• ✅ 移除硬编码的屏幕切换逻辑
• ✅ 由配置文件统一管理屏幕切换
• ✅ 关闭屏幕时自动关闭背光并清空显示

7. 新增流量监控页面

• ✅ 实时显示WAN接口上传/下载流量统计
• ✅ 支持自定义监控接口列表（eth1, wwan, wan, pppoe等）
• ✅ 支持前缀匹配，灵活配置移动网络接口
• ✅ 自动累加多个WAN接口流量（支持双WAN场景）
• ✅ 数据持久化存储（/etc/xgp_screen_traffic.dat）
• ✅ 每日零点自动重置当日统计
• ✅ 手动清零功能（LuCI界面或命令行）
• ✅ 智能单位转换（B/KB/MB/GB自动选择）
• ✅ 每2秒自动刷新数据

项目结构

xgp-v3-screen/
├── Makefile                    # OpenWrt 包构建文件（包含驱动和应用）
├── kmod-fb-tft-gc9307/        # GC9307 驱动源码
│   ├── src/
│   │   ├── fb_gc9307.c
│   │   ├── fbtft.h
│   │   └── Makefile
│   └── LICENSE-DRIVER
├── files/
│   ├── modem_info.py          # Modem 信息获取脚本
│   ├── xgp_screen.config      # 默认 UCI 配置
│   ├── uci-defaults-xgp-screen # UCI 初始化脚本
│   └── zz_xgp_screen.init     # procd 服务脚本
├── luasrc/                     # LuCI 应用
│   ├── controller/
│   │   └── xgp_screen.lua
│   └── model/cbi/
│       └── xgp_screen.lua
└── src/
    ├── main.c                  # 主程序
    ├── screen_config.c/h       # 配置解析模块
    ├── screen_manager.c/h      # 屏幕管理器
    └── ui/                     # LVGL UI 文件

编译安装

前置条件

确保您的 OpenWrt 编译环境已经选择了以下内核模块：

make menuconfig
# 进入: Kernel modules → Video Support → kmod-fb-tft
# 确保 kmod-fb-tft 已选中（驱动依赖此包）

1. 放置源码

# 将项目放入 OpenWrt 的 package 目录
cp -r xgp-v3-screen ~/openwrt/package/

2. 选择包

make menuconfig
# 进入 Utilities → xgp-v3-screen

3. 编译

make package/xgp-v3-screen/compile -j$(nproc)

编译完成后会生成两个包：

• kmod-fb-tft-gc9307-*.apk - GC9307 LCD 驱动（内核模块）
• xgp-v3-screen-*.apk - 屏幕控制程序（依赖驱动包）

4. 安装

# APK 包管理器 (ImmortalWrt 25.x)
# 驱动会作为依赖自动安装
apk add --allow-untrusted xgp-v3-screen-*.apk

# OPKG 包管理器 (OpenWrt)
opkg install xgp-v3-screen-*.ipk

配置文件

配置文件位置: /etc/config/xgp_screen

config screen 'main'
    option enabled '1'
    option fb_device ''
    option scroll_type 'slide_up'
    option default_delay '5000'
    option skip_boot '0'
    option skip_splash '0'

config traffic 'settings'
    list interfaces 'eth1'
    list interfaces 'wwan0'
    list interfaces 'wwan0_1'
    option reset '0'

config page 'system_info'
    option enabled '1'
    option delay '5000'
    option order '1'

config page 'system_status'
    option enabled '1'
    option delay '5000'
    option order '2'

config page 'traffic'
    option enabled '1'
    option delay '5000'
    option order '6'

# ... 更多页面配置

流量统计功能

支持的接口类型：

• 有线WAN: eth1
• 移动网络: wwan0, wwan0_1, wwan1 等
• PPPoE拨号: pppoe-wan
• 通用WAN: wan, wan6

配置示例：

# 添加监控接口
uci add_list xgp_screen.settings.interfaces='eth1'
uci add_list xgp_screen.settings.interfaces='wwan'
uci commit xgp_screen

# 手动清零流量统计
uci set xgp_screen.settings.reset='1'
uci commit xgp_screen
/etc/init.d/zz_xgp_screen restart

# 清零后标志会自动重置为0

数据存储：

• 位置: /etc/xgp_screen_traffic.dat
• 格式: 二进制格式，包含总流量和当日流量
• 更新频率: 每2秒
• 重置时间: 每日00:00自动重置当日统计

## 依赖

**编译依赖：**
- OpenWrt 编译环境
- `kmod-fb-tft` - Linux framebuffer TFT 驱动框架（必须先在内核中选中）

**运行时依赖：**
- `python3` - Modem 信息获取
- `libpthread` - 多线程支持
- `libstdcpp` - C++ 标准库
- `luci-base` - LuCI 基础框架
- `kmod-fb-tft` - 会自动安装
- `kmod-fb-tft-gc9307` - GC9307 LCD framebuffer 驱动（已集成，自动编译和安装）

## 服务管理

```bash
# 启动
/etc/init.d/zz_xgp_screen start

# 停止
/etc/init.d/zz_xgp_screen stop

# 重启
/etc/init.d/zz_xgp_screen restart

# 查看状态
ps | grep zz_xgp_screen

许可证

GPL-3.0-only

致谢

• 原始项目作者 zzzz0317
  • xgp-v3-screen - 屏幕控制程序
  • kmod-fb-tft-gc9307 - GC9307 驱动
• LVGL - 嵌入式图形库