网络
Q1: WiFi 连接提示 “An application wants access to the keyring "Default keyring", but it is locked” 输入密钥问题？
- 首次 WiFi 连接会产生 keyring，将密码设为空可避免。已出现时删除密钥环文件：
rm -rf ~/.local/share/keyrings
- Ubuntu Desktop 使用 Keyring 管理 WiFi 密码，首次创建密钥环时会弹窗要求设置密钥环密码。设置的密钥环密码与 WiFi 密码不同，后续每次连接 WiFi 都需要输入密钥环密码
- 执行 rm -rf ~/.local/share/keyrings` 删除所有密钥环文件 → 重新连接 WiFi → 当弹出密钥环设置弹窗时，密钥环密码留空 → 点击"继续"，后续不再弹出密码框
Q2: WiFi / 蓝牙驱动加载脚本在哪里？
/usr/bin/wifibt-init.sh、/usr/bin/wifibt-util.sh；SDK 固件目录：external/rkwifibt/firmware/wifibt-init.sh 负责在系统启动时初始化 WiFi/蓝牙模块（加载固件、设置 BT 地址、启动 RFKILL 等）；wifibt-util.sh 提供命令行工具函数，如 bt_pcba_test、wifi_pcba_test 等诊断功能- SDK 中的 WiFi/BT 固件存放于
external/rkwifibt/firmware/ 目录下，不同模组（AP6255 / AP6275 / AIC8800 等）有对应的固件 bin 文件；Linux 系统中的 /lib/firmware/ 目录下也会拷贝一份
Q3: 蓝牙无法启动，提示 tx timeout？
- 执行
/usr/bin/bt_pcba_test；蓝牙初始化早于图形化界面时会出现此问题
- 蓝牙模块通过 UART 与主控通信，ttyS 设备驱动加载时序问题可能导致蓝牙初始化时 UART 尚未就绪，握手超时报错
Q4: WiFi 模块日志过多，如何关闭？
- 可执行 dmesg -n1 命令将内核日志级别调低，关闭 WiFi 模块的频繁日志打印
- 执行
dmesg -n 1 将控制台日志级别设为 1（仅显示 kernel panic），级别范围 0~7，数值越小日志越少；临时生效，重启后恢复
- 永久关闭可在
/etc/sysctl.conf 中添加 kernel.printk = 1 4 1 7（第一个数字控制台日志级别，设为 1 仅显示致命错误）；或者编辑 /etc/systemd/system/systemd-logind.service.d/ 中的日志配置
Q5: WiFi 频繁断连或信号弱？
- 检查天线是否安装牢固，天线不要贴近主板金属区域；
iwconfig wlan0 查看信号质量（Link Quality > 70% 为佳）；检查信道干扰，更换 5GHz 频段（如路由器支持）可减少干扰；固件天线接口有 MAIN 和 AUX 标注，确保天线接在 MAIN 口
- 主板上的 WiFi 模块天线接口通常标注 ANT；天线最好伸出机壳外，远离金属面板和大面积铺铜区域；天线线缆不要打结或过度弯折
- 用手机在同一位置测 WiFi 信号对比，如果手机信号正常但主板信号差，说明主板天线或 WiFi 模块硬件可能有问题；尝试重新插拔天线连接器