rsetup
Rsetup 使用指南
简介
rsetup 是一个适用于 Radxa OS 的系统配置工具，提供了友好的 TUI（文本用户界面）来管理系统设置、硬件配置和网络连接等功能。
启动 rsetup
要启动 rsetup，请在终端中执行以下命令：
rsetup
或从系统菜单中找到 rsetup 应用启动。
rsetup 运行时需要管理员权限，请确保你拥有 sudo 权限。
如果以普通用户身份启动，系统会自动提示使用 pkexec 或 sudo 提权。
下面列出的选项仅供参考，请以实际程序输出为准。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select an option below: │
│ │
│ System Maintenance │
│ Hardware │
│ Overlays │
│ Connectivity │
│ User Settings │
│ Localization │
│ Common Tasks │
│ About │
│ │
│ <Ok> <Cancel> │
│ │
└──────────────────────────────────────────────────────────────────────────────┘
界面操作
基本操作
你可以使用下列按键进行操作：
- 上下键 (
Up/Down): 在菜单项之间切换，当前选中的项目会高亮显示 - Tab 键: 在菜单区域和命令区域之间切换
- 左右键 (
Left/Right): 在<Ok>和<Cancel>命令之间切换 - Enter 键: 执行当前选中的命令或菜单项
- Space 键: 选择选项（用于多选框
[ ]或单选框( )） - Esc 键: 返回到上一级菜单
使用 Up 和 Down 键来切换选项。当前选中的项目会高亮显示。
使用 Tab 键来切换菜单区域和命令区域。
使用 Left 和 Right 键来切换 <Ok> 和 <Cancel> 命令。使用 Enter 键来执行选中的命令。
当命令没有被选中时按下 Enter 键，会立即执行 <Ok> 命令。
使用 Space 键选择选项。选项会包含 [ ] （多项选择）或 ( ) （单项选择）前缀来显示当前的选择状态。
使用 Enter 键不会选择选项。它会直接执行 <Ok> 命令。
使用 Esc 键回到前一个菜单。
System Maintenance
本菜单包含以下选项：
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ System Maintenance │
│ │
│ System Update │
│ Change APT Sources │
│ Change default boot target │
│ Update Bootloader │
│ Update SPI Bootloader │
│ Update eMMC Boot partition │
│ Sleep / Hibernate Control │
│ │
│ <Ok> <Cancel> │
│ │
└──────────────────────────────────────────────────────────────────────────────┘
Change APT Sources
此功能允许你切换 Radxa 和 Debian/Ubuntu 的软件源镜像，以获得更快的下载速度。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ APT Sources │
│ │
│ Select Radxa mirror │
│ Select Debian/Ubuntu mirror │
│ Restore official sources │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
支持的镜像站包括：
-
Radxa 镜像：
-
Debian/Ubuntu 镜像：
选择 Radxa 镜像
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Select Radxa mirror: │
│ │
│ https://mirrors.aghost.cn/radxa-deb │
│ https://mirrors.cqu.edu.cn/radxa-deb │
│ https://mirrors.lzu.edu.cn/radxa-deb │
│ https://mirrors.hust.edu.cn/radxa-deb │
│ https://mirrors.sdu.edu.cn/radxa-deb │
│ https://mirror.nju.edu.cn/radxa-deb │
│ https://mirror.nyist.edu.cn/radxa-deb │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
选择 Debian/Ubuntu 镜像
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Select Debian/Ubuntu mirror: │
│ │
│ https://mirrors.ustc.edu.cn │
│ https://mirrors.tuna.tsinghua.edu.cn │
│ https://mirrors.cqu.edu.cn │
│ https://mirrors.lzu.edu.cn │
│ https://mirrors.hust.edu.cn │
│ https://mirrors.sdu.edu.cn │
│ https://mirror.nju.edu.cn │
│ https://mirror.nyist.edu.cn │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
操作步骤：
- 选择
Select Radxa mirror或Select Debian/Ubuntu mirror - 从列表中选择合适的镜像站
- 确认后系统会自动更新源配置文件
- 如需恢复官方源，选择
Restore official sources
System Update
请不要使用 apt-get upgrade 命令更新系统，这会导致系统更新不完全，从而导致功能异常或缺失，甚至系统无法启动。
应使用 rsetup 更新系统。
本选项会更新你的系统中安装的软件包到最新状态。
由于 RadxaOS 提供了一些和上游 Debian 有所冲突的软件包，为了保证系统一致性，建议通过此方式进行系统更新。
Change default boot target
设置系统默认启动到命令行界面或图形界面：
- multi-user.target: 命令行界面（CLI）
- graphical.target: 图形界面（桌面环境）
Update Bootloader
本选项会更新根文件系统所在磁盘上的启动器。
Update SPI Bootloader
本选项会更新 SPI Flash 上的启动器。
Update eMMC Boot Bootloader
本选项会更新 eMMC Boot 分区上的启动器。
Sleep / Hibernate Control
- Enable Sleep / Hibernate: 启用系统休眠功能
- Disable Sleep / Hibernate: 禁用系统休眠功能
更改后建议重启系统以使设置生效。
Hardware
在这个菜单上可以修改一些外围设备，下面是对它们的介绍。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Manage on-board hardware │
│ │
│ Video capture devices │
│ GPIO LEDs │
│ RGB LEDs │
│ Thermal governor │
│ Configure DSI display mirroring │
│ 40-pin GPIO │
│ USB OTG services │
│ │
│ <Ok> <Cancel> │
│ │
└──────────────────────────────────────────────────────────────────────────────┘
Video capture devices
如果你有连接一个视频设备，这个选项可以帮助你测试该设备。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Select video capture device: │
│ │
│ video0 │
│ video1 │
│ video2 │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
选择设备后，会显示测试选项：
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select the test case: │
│ │
│ Show live video │
│ Capture a picture │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
功能说明：
- Show live video: 实时显示摄像头画面（需要图形界面环境）
- Capture a picture: 捕获一张图片并保存到
/tmp目录
GPIO LEDs
在这个选项上，你可以改变板子上的电源 LED 和用户 LED 的状态（有时只有一个）。
LED 设置
LED 设置
一些产品会有用户可控制的板载 LED。它们可以通过 rsetup 管理：
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
| Below are the available LEDs and their triggers. |
| Select any to update their trigger. |
| |
| [ ] user-led1 [default-on] |
| [ ] user-led2 [heartbeat] |
| |
| <Ok> <Cancel> |
| |
└──────────────────────────────────────────────────────────────────────────────┘
结尾处 '[]' 里面的内容是当前的LED触发器，可以大致理解为 LED 状态。
在瑞莎产品的默认设置中，电源 LED 通常有 default-on 触发器，而状态 LED 通常有 heartbeat 触发器。
改变 LED 灯触发状态
通过以下步骤来改变灯光状态：
- 使用
up或down键，将高亮显示的选择条移动到你要编辑的 LED 状态； - 使用
Space键确认您的选择，随后，在开头的[]会出现*。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
| Below are the available LEDs and their triggers. |
| Select any to update their trigger. |
| |
| [*] user-led1 [default-on] |
| [ ] user-led2 [heartbeat] |
| |
| <Ok> <Cancel> |
| |
└──────────────────────────────────────────────────────────────────────────────┘
- 按
Enter键，进入触发器选择菜单：
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select the new trigger: │
│ │
│ ( ) none │
│ ( ) rfkill-any │
│ ( ) rfkill-none ▒ │
│ ( ) kbd-scrolllock ▒ │
│ ( ) kbd-numlock ▒ │
│ ( ) kbd-capslock ▒ │
│ ( ) kbd-kanalock ▒ │
│ ( ) kbd-shiftlock ▒ │
│ ( ) kbd-altgrlock ▒ │
│ ( ) kbd-ctrllock ▒ │
│ ( ) kbd-altlock ▒ │
│ ( ) kbd-shiftllock ▒ │
│ ( ) kbd-shiftrlock ▒ │
│ ( ) kbd-ctrlllock ▒ │
│ ( ) kbd-ctrlrlock ▒ │
│ ( ) disk-activity │
│ (and more) │
│ │
│ <Ok> <Cancel> │
│ │
└──────────────────────────────────────────────────────────────────────────────┘
- 像第二步一样，使用
up或down方向键选择你喜欢的，并按Space确认，*会出现在()中。 - 按
Space键保存你的选择并应用它。 - 第 5 步之后，你的 LED 状态将立即改变。
你也可以在界面中选择 LED 并设置触发器：
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Below are the available LEDs and their triggers. │
│ Select any to update their trigger. │
│ │
│ [ ] pwr-led [heartbeat] │
│ [ ] user-led [none] │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
选择 LED 后，可以设置触发器：
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select the new trigger: │
│ │
│ ( ) none │
│ ( ) heartbeat │
│ ( ) timer │
│ ( ) default-on │
│ ( ) mmc0 │
│ ( ) mmc1 │
│ ( ) netdev │
│ ( ) pattern │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
RGB LEDs
控制板载的 RGB LED，可以设置不同灯光效果。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Below are the available LEDs. │
│ Select any to update their pattern. │
│ │
│ [ ] rgb-led0 │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
选择 RGB LED 后，可以选择预设模式：
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select the LED pattern: │
│ │
│ ( ) Breath │
│ ( ) Rainbow │
│ ( ) Solid color │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
Thermal governor
该模块用于调整风扇和其他温度选项。
一般来说，当使用直流风扇或不使用风扇时，选择 power_allocator，当使用 PWM 风扇时，选择 step_wise。
注意：如果你将风扇直接连接到 GPIO 的 5V 和 GND 引脚上，它将不受控制且一直工作。
Configure DSI display mirroring
在同时使用 HDMI 显示器和 DSI 显示器时，如果 DSI 显示器有一些问题，启用这个选项会有所帮助。
USB OTG services
用于开启 OTG 端口的设备功能配置：
# `*.*` 为对应的 USB 控制器
radxa-adbd@*.* # 配置为 ADB 设备
radxa-ecm@*.* # 配置为 ECM 设备（不推荐）
radxa-ncm@*.* # 配置为 NCM 设备（推荐）
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Below are the available UDC functions. │
│ Select any to update their status. │
│ │
│ [ ] [email protected] │
│ [ ] [email protected] │
│ [ ] [email protected] │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
40-pin GPIO
配置 40 针 GPIO 排针的功能。
Overlays
该选项用于配置设备树 Overlays。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Manage overlays │
│ │
│ Manage device tree overlays │
│ Install 3rd party overlay │
│ Reset overlays configuration │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
Manage device tree overlays
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Below are the overlays compatible with your hardware. │
│ Press Space to select. │
│ │
│ [ ] Enable UART2-M0 ▒ │
│ [ ] Enable UART4-M2 ▒ │
│ [*] Enable I2C1-M0 ▒ │
│ [ ] Enable SPI3-M1 ▒ │
│ [ ] Enable PCIe2x1l2 ▒ │
│ [*] Enable PWM1-M1 ▒ │
│ [ ] Radxa Camera 4K ▒ │
│ [ ] Radxa Display 8 HD ▒ │
│ [ ] Radxa Display 10 FHD ▒ │
│ [ ] Disable LED ▒ │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
设备树配置
安装第三方 Overlay
安装第三方 Overlay
设备树 Overlays 使得用一个内核支持多个硬件配置成为可能，而且不需要明确地加载或屏蔽内核模块。
你可以使用 rsetup 来管理 overlays。
rsetup 的 Install 3rd party overlay 功能既可安装设备树 overlay 文件（DTBO）也可安装源码（DTS）。
官方设备树覆盖文件仓库 radxa/overlays 的预编译文件可以从此下载。
获取 radxa/overlays 源码
git clone https://github.com/radxa/overlays.git
cd overlays
使用 rsetup 加载 overlay
在 rsetup 的主界面选择 Overlays:
Configure Device Tree Overlay
Manage overlays
View overlay info
Install 3rd party overlay"
Reset overlays
<Ok> <Cancel>
然后， 选择 Install 3rd party overlay:
Configure Device Tree Overlay
Manage overlays
View overlay info
Install 3rd party overlay
Reset overlays
<Ok> <Cancel>
以下为瑞芯微 SOC 设备树覆盖文件源码的路径:
arch/arm64/boot/dts/rockchip/overlays/*.dts
如果 SOC 厂商为晶晨需要更换以上路径里的 rockchip 为 amlogic。
然后选择你需要加载的 overlay，选择之后退出 rsetup，最后重启。
可以使用 cat /boot/extlinux/extlinux.conf 检查参数
添加 LED
添加 LED
Radxa 发售的单板计算机或者计算模块一般默认情况下拥有两个 LED： 一颗电源灯（软件不可修改）和一颗系统心跳灯。 是否想拥有像 PC 一样的硬盘状态灯或者网口状态灯，那就跟着教程来做吧！ 以 Radxa 5B 为例，需要根据使用的 GPIO 修改设备树覆写文件（DTBO）。
- 硬件连接
GPIO3_C1(PIN11)(3.3V) <----> 电阻 (根据 LED 的数据手册选择大小) <----> LED正极 <----> LED负极 <----> GND(PIN9)
- 编写设备树覆写文件（DTBO）
nano ~/user_led3.dts
以下为文件内容：
可使用的触发器有：none rc-feedback rfkill-any rfkill-none kbd-scrolllock kbd-numlock kbd-capslock kbd-kanalock kbd-shiftlock kbd-altgrlock kbd-ctrllock kbd-altlock kbd-shiftllock kbd-shiftrlock kbd-ctrlllock kbd-ctrlrlock tcpm-source-psy-4-0022-online disk-activity disk-read disk-write ide-disk mtd nand-disk cpu cpu0 cpu1 cpu2 cpu3 cpu4 cpu5 cpu6 cpu7 panic mmc2 mmc1 mmc0 default-on heartbeat pattern timer rfkill1 phy0rx phy0tx phy0assoc phy0radio rfkill2 rfkill3
/dts-v1/;
/plugin/;
#include <dt-bindings/gpio/gpio.h>
#include <dt-bindings/pinctrl/rockchip.h>
/ {
fragment@0 {
target-path = "/"; /* 要修改的主 dts 节点 */
__overlay__ { /* 再此花括号内添加或修改内容 */
custom-leds{ /* 添加 custom-leds 节点 */
compatible = "gpio-leds";
status = "okay";
microsd-led { /* 添加 microsd-led 节点 */
gpios = <&gpio3 RK_PC1 GPIO_ACTIVE_HIGH>; /* 将 GPIO3_C1 注册为 microsd-led 的使能引脚，默认使能为电平拉高。 */
linux,default-trigger = "mmc1"; /* 设置默认触发器为 mmc1(SD Card) */
};
};
};
};
};
- 加载 DTBO
rsetup
# 按照以下选项进入加载设备树覆写文件（DTBO）界面
# Overlays -> Install 3rd party overlay
- 选择 user_led3.dts
- 重启
sudo reboot
重启后即可看见 LED 灯会跟着硬盘状态闪动。
将 Pin8 和 Pin10 配置为 GPIO
将 PIN 8 和 PIN 10 配置为 GPIO
默认情况下 UART2_M0 接口为 FIQ 调试串口，可输出 DDR Init、U-Boot、Linux Kernel 等日志用于调试。所以如非必要可以使用其他串口，不建议取消此配置。
- 禁用 FIQ-Debugger
rsetup
# 按照以下选项进入设备树管理界面
# Overlays -> Manage overlays
勾选 Disable FIQ Debugger
勾选后选择 OK， 然后退出 rsetup， 重启系统后， PIN 8 && PIN 10 就能作为普通 GPIO 使用了。
将 UART2_M0 配置为普通串口
将 UART2_M0 配置为普通串口
默认情况下 UART2_M0 接口为 FIQ 调试串口，可输出 DDR Init、U-Boot、Linux Kernel 等日志用于调试。所以如非必要可以使用其他串口，不建议取消此配置。
- 启用 UART2_M0
rsetup
# 按照以下选项进入设备树管理界面
# Overlays -> Manage overlays
勾选 Enable UART2-M0
勾选后选择 OK，然后退出 rsetup。
- 修改 Linux 启动参数
跟随Linux 启动参数的操作，删除 /etc/kernel/cmdline 文件所有 ttyFIQ0 和 ttyS2 相关的 console 参数，如 "console=ttyFIQ0,1500000n8"
Connectivity
该选项与网络设置类似。
选择 Network 选项后，会启动 nmtui（NetworkManager Text User Interface），提供完整的网络管理功能：
┌─────────────────────────────────────────────────────────────────────────────┐
│ NetworkManager TUI │
│ │
│ Please select an option │
│ │
│ Edit a connection │
│ Activate a connection │
│ Set system hostname │
│ │
│ Quit │
│ │
│ <OK> │
└─────────────────────────────────────────────────────────────────────────────┘
网络管理功能：
Edit a connection（编辑连接）
- 添加新的网络连接（Wi-Fi、以太网、VPN 等）
- 编辑现有连接的配置
- 删除不需要的连接
- 配置 IP 地址（静态/DHCP）
- 设置 DNS 服务器
Activate a connection（激活连接）
- 查看可用的网络连接
- 连接到 Wi-Fi 网络
- 激活或停用网络接口
- 查看连接状态
Set system hostname（设置主机名）
- 修改系统主机名
Wi-Fi 配置步骤
- 选择
Activate a connection - 选择你的 Wi-Fi 网络（会显示可用的 SSID 列表）
- 输入 Wi-Fi 密码
- 等待连接成功
有线网络配置
- 选择
Edit a connection - 选择以太网接口
- 配置 IP 地址模式：
- Automatic (DHCP): 自动获取 IP 地址
- Manual: 手动配置静态 IP
- 使用
Tab键在不同选项间切换 - 使用
Enter键确认选择 - 使用
Esc键返回上一级菜单 - NetworkManager 配置通常会立即生效，无需重启
User Settings
Password
修改当前用户的密码。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please enter the new password for radxa: │
│ │
│ ********________________________________________________________ │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
操作步骤：
- 输入新密码（密码输入时会显示为
*） - 确认新密码
- 如果两次输入不一致，会提示重新输入
- 密码至少应包含 8 个字符
- 建议使用字母、数字和特殊字符的组合
- 请记住新密码，忘记密码可能导致无法登录系统
Hostname
修改当前的主机名称。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please enter the new hostname: │
│ │
│ radxa-rock-5b___________________________________________________ │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
Configure auto login
若是 rsetup 选项无 Configure auto login 选项，请使用 rsetup 工具的 System -> System Update 选项更新并重启系统。
设置 TTY 终端与桌面管理器的自动登陆配置。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select the service(s) you want to enable auto login: │
│ │
│ [ ] [email protected] │
│ [ ] sddm.service │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
支持的登录管理器：
- getty@tty*.service: TTY 终端自动登录（命令行界面）
- serial-getty@*.service: 串口终端自动登录
- SDDM: KDE Plasma 桌面管理器
- GDM: GNOME 桌面管理器
- LightDM: 轻量级桌面管理器
启用自动登录会降低系统安全性，任何人都可以直接访问系统。仅在个人设备或测试环境中使用。
Localization
在这个选项中，你可以改变 Timezone Locale Keybaed layout Wi-Fi Country.
Timezone
设置系统时区。选择此选项后会启动 dpkg-reconfigure tzdata。
下面是 tzdata 的典型界面示意：
┌──────────────────────────────────┤ Configuring tzdata ├──────────────────────┐
│ │
│ Please select the geographic area in which you live. │
│ │
│ Geographic area: │
│ │
│ Africa │
│ America │
│ Asia ▒ │
│ Europe ▒ │
│ Etc ▒ │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
常用时区：
- Asia/Shanghai: 中国标准时间（UTC+8）
- UTC: 协调世界时
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select your timezone: │
│ │
│ ( ) America/New_York │
│ ( ) Asia/Shanghai │
│ ( ) Europe/London │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
Locale
配置系统语言和区域设置。选择此选项后会启动 dpkg-reconfigure locales。
下面是 locales 的典型界面示意：
┌──────────────────────────────────┤ Configuring locales ├────────────────────┐
│ Locales to be generated: │
│ │
│ [ ] en_AG UTF-8 ▒ │
│ [ ] en_GB.UTF-8 ▒ │
│ [*] en_US.UTF-8 ▒ │
│ [ ] zh_CN.UTF-8 ▒ │
│ [ ] zh_TW.UTF-8 ▒ │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
推荐的 locale 设置：
- en_US.UTF-8: 英语（美国），通用性好
- zh_CN.UTF-8: 简体中文
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select your locale: │
│ │
│ ( ) en_US.UTF-8 │
│ ( ) zh_CN.UTF-8 │
│ ( ) fr_FR.UTF-8 │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
Keybaed layout
配置键盘布局。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select your keyboard layout: │
│ │
│ ( ) US │
│ ( ) UK │
│ ( ) FR │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
Wi-Fi Country
设置 Wi-Fi 国家代码以符合当地法规。
为什么需要设置 Wi-Fi 国家代码？
- 不同国家/地区的 Wi-Fi 频道和功率限制不同
- 设置正确的国家代码可以：
- 确保使用合法的 Wi-Fi 频道
- 避免违反当地无线电法规
- 获得更好的 Wi-Fi 性能与稳定性
设置错误的国家代码可能导致：
- 无法连接到某些 Wi-Fi 网络
- Wi-Fi 信号变弱
- 违反当地法律法规
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select your Wi-Fi country code: │
│ │
│ ( ) US │
│ ( ) CN │
│ ( ) FR │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
Common Tasks
常用任务菜单提供了一些快捷操作，方便用户快速完成常见配置任务。
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select all tasks you want to perform: │
│ │
│ [ ] Install Baota Panel │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
可用任务（正常模式）
在正常模式下，Common Tasks 以多选列表形式显示，可以一次选择多个任务批量执行。
Install Baota Panel
安装宝塔面板（Linux 服务器管理面板）。
可用任务（DEBUG 模式）
在 DEBUG 模式下，会显示独立的任务菜单：
┌──────────────────────────────────┤ RSETUP ├──────────────────────────────────┐
│ Please select an option below: │
│ │
│ Baota Panel │
│ │
│ <Ok> <Cancel> │
└──────────────────────────────────────────────────────────────────────────────┘
执行流程：
- 使用
Space键选择要执行的任务 - 选择
<Ok>确认 - 系统会显示即将执行的任务列表
- 再次确认后开始执行
- 任务执行完成后，会显示相关信息
- 按
Enter键继续
- 某些任务需要网络连接才能完成
- 任务执行过程中请勿中断
- 执行完成后请记录重要信息（如端口号、密码等）
About
这里是 rsetup 的相关信息。
故障排除
rsetup 启动失败
问题: 运行 rsetup 后无法启动或提示权限错误
解决方案:
- 确保使用
sudo rsetup或系统会自动提权 - 检查终端是否支持当前的 TERM 类型，如果不支持尝试使用
export TERM=xterm-256color设置环境变量 - 尝试在不同的终端模拟器中运行
更新失败
问题: 系统更新过程中出现错误
解决方案:
- 检查网络连接是否正常
- 尝试更换 APT 源镜像
- 检查系统时间是否正确（可能导致 HTTPS 证书验证失败）
- 查看错误信息，必要时在社区寻求帮助
Overlay 配置后无法启动
问题: 启用某个 overlay 后系统无法启动
解决方案:
- 通过串口或 SSH 连接到系统（如果可能）
- 编辑
/boot/config.txt或/boot/uEnv.txt，移除或注释掉问题的 overlay - 重启系统
- 如果无法通过软件方式修复，可能需要从 SD 卡启动并修改配置文件
最佳实践
- 定期更新: 使用
System Update定期更新系统，保持软件包为最新状态 - 谨慎配置启动器: 除非必要，不要随意更新或擦除启动器
- 测试 Overlay: 启用新的 overlay 前，先了解其功能和可能的影响
- 备份重要数据: 在进行重大配置更改前，备份重要数据
- 记录更改: 记录你所做的配置更改，便于故障排除