ArkOS系统根分区空间占满问题排查与Rust编译环境配置指南

问题现象与分析

在RG503设备上运行最新版ArkOS系统时，用户发现根分区(/)空间被完全占满，导致无法正常安装RVGL游戏。通过df -h命令检查发现9.9G的根分区已使用9.8G，使用率达到100%。

空间占用排查方法

专业的Linux系统管理员通常会使用以下方法排查空间占用问题：

1. 使用du命令深度分析：

   sudo du -xm / | sort -rn > usage.txt
   

   这个命令会递归计算每个目录的大小(-x确保不跨越文件系统边界，-m以MB为单位显示)，然后按大小降序排序，结果输出到usage.txt文件中。

2. 重点检查隐藏目录： 在Linux系统中，以点(.)开头的目录和文件是隐藏的，容易被忽略。特别是用户主目录下的隐藏文件夹，如/root/.xxx。

问题根源定位

经过详细排查，发现/root/.rvgl目录占用了4GB空间。这是由于RVGL游戏安装脚本错误地将游戏文件安装到了根分区而非预期的roms分区导致的。

解决方案

1. 清理无效文件：

   rm -rf /root/.rvgl
   

   删除错误安装的游戏文件，释放根分区空间。

2. 重新安装游戏： 确保后续安装操作将游戏文件正确安装到/roms分区。

Rust编译环境配置问题

在后续尝试为RG503添加静音功能时，用户遇到了Rust编译环境问题。这是由于ArkOS系统中Ubuntu仓库提供的rustc版本过旧导致的。

正确配置Rust环境的步骤：

1. 移除旧版Rust：

   sudo apt remove -y rustc
   

2. 使用rustup安装最新Rust工具链：

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

   在安装过程中选择"minimal"配置档以获得精简安装。

3. 激活环境变量：

   source "$HOME/.cargo/env"
   

设备按键映射原理

在ArkOS系统中，设备按键通过evtest工具可以检测到具体的键值映射。对于RG503设备，retrogame_joypad控制器支持以下按键事件：

• 基本按键：BTN_SOUTH(A)、BTN_EAST(B)、BTN_NORTH(X)、BTN_WEST(Y)
• 肩键：BTN_TL(L1)、BTN_TR(R1)、BTN_TL2(L2)、BTN_TR2(R2)
• 功能键：BTN_SELECT、BTN_START、BTN_MODE
• 摇杆按键：BTN_THUMBL(L3)、BTN_THUMBR(R3)
• 方向键：BTN_DPAD_UP/DOWN/LEFT/RIGHT

了解这些底层按键映射对于开发自定义功能至关重要。例如，可以通过组合BTN_THUMBL和BTN_THUMBR(即L3+R3)来实现静音功能。

总结

本文通过一个实际案例，详细介绍了Linux嵌入式系统中空间占满问题的排查方法，Rust编译环境的正确配置方式，以及设备按键映射的基本原理。这些知识对于ArkOS系统的维护和功能扩展都具有重要参考价值。系统管理员和开发者应该掌握这些基础技能，以便更好地维护和定制自己的游戏系统。