UMPC Sensor Config

用于在 GPD Pocket 3设备上配置屏幕自动旋转的 Shell 脚本。

功能特性

• 自动旋转支持: 通过配置 iio-sensor-proxy 实现屏幕自动旋转
• 多包管理器支持: 支持 apt, dnf, yum, pacman, zypper, apk
• 桌面环境检测: 自动检测 KDE/Plasma 环境并安装额外依赖 (kscreen)
• 安全备份: 自动备份现有配置文件到 /var/backups/umpc-sensor-config/
• Dry Run 模式: 使用 --dry-run 预览操作而不实际执行
• 调试日志: 通过 LOG_LEVEL 环境变量控制日志详细程度

系统要求

• Linux 系统（支持 systemd）
• KWin(Wayland)窗口合成器
• KDE Plasma桌面
• root 权限

安装

# 克隆仓库
git clone <repository-url>
cd umpc-sensor-config

# 使脚本可执行
chmod +x umpc-sensor-config.sh

使用方法

启用传感器配置

sudo ./umpc-sensor-config.sh enable

禁用传感器配置

sudo ./umpc-sensor-config.sh disable

检查当前状态

sudo ./umpc-sensor-config.sh status

查看帮助

./umpc-sensor-config.sh --help

高级选项

Dry Run 模式

预览将要执行的操作，而不实际修改系统：

sudo ./umpc-sensor-config.sh --dry-run enable

调试模式

启用详细日志输出：

sudo ./umpc-sensor-config.sh --debug enable
# 或使用环境变量
LOG_LEVEL=DEBUG sudo ./umpc-sensor-config.sh enable

测试传感器

配置完成后，使用以下命令测试传感器是否正常工作：

monitor-sensor

旋转设备，观察输出中的 orientation 变化。

项目结构

umpc-sensor-config/
├── umpc-sensor-config.sh          # 主配置脚本
├── data/                          # 配置文件
│   └── 61-gpd-pocket3-sensor-local.hwdb
├── README.md                      # 项目文档
└── LICENSE                        # MIT 许可证

工作原理

1. 安装依赖: 自动检测并安装 iio-sensor-proxy 包
2. 配置硬件数据库: 将 hwdb 文件复制到 /etc/udev/hwdb.d/
3. 更新硬件数据库: 运行 systemd-hwdb update
4. 触发 udev 规则: 为 IIO 设备应用新规则
5. 管理服务: 启用并启动 iio-sensor-proxy.service

故障排除

传感器不工作

1. 检查服务状态：

   systemctl status iio-sensor-proxy

2. 检查 IIO 设备：

   ls /sys/bus/iio/devices/

3. 手动测试传感器：

   monitor-sensor

权限问题

确保以 root 身份运行脚本：

sudo ./umpc-sensor-config.sh enable

开发

代码检查

# 使用 shellcheck 检查脚本
shellcheck umpc-sensor-config.sh

# 检查语法
bash -n umpc-sensor-config.sh

测试

# 运行所有测试
bats tests/

# 运行单个测试文件
bats tests/test_installation.bats

许可证

MIT License

致谢

• iio-sensor-proxy - IIO sensors to D-Bus proxy
• GPD Pocket 3 社区