FAQ

无论您是初学者还是经验丰富的开发者，都可能在使用开发板时遇到一些疑问或困难。我们希望通过这份 FAQ 文档，为您提供有关 Luckfox Pico 系列开发板的常见问题的答案，以便您能够更轻松地进行开发和实验。

1. 无法识别 MASKROM 设备

部分用户在刚收到开发板后，可能会遇到 SocToolKit 无法识别 USB 设备的情况。我们理解您可能会担心运输过程导致设备异常，但需要说明的是：出厂前所有设备均经过严格的功能质检，运输过程中的故障率极低。此类问题大多数情况下与客户自身的电脑环境、操作系统、USB 接口或线材选择有关。建议您优先从以下几个方面进行排查：

驱动安装是否成功
请确保已正确安装瑞芯微官方的驱动助手 DriverAssistant，推荐使用 Windows 10 或 Windows 11 系统，以获得更好的兼容性和稳定性。
关闭杀毒软件后再下载/运行烧录工具
某些杀毒软件可能会误报或隔离烧录工具中的关键配置文件，导致 SocToolKit 无法识别设备。下载及使用前请临时关闭杀毒软件。
更换高品质 Type-C 数据线(极为重要)
请务必使用可靠、支持数据传输的 USB Type-C 数据线。我们发现，很多用户虽然尝试更换了多根线材，但问题依旧，原因通常在于线材质量不达标。
仅靠更换多根劣质线无法有效排查问题，线的数量并不等于质量。建议优先选择开发板原装线或知名品牌的高速数据线，以确保稳定的连接质量和数据传输能力。
某些低成本线材可能仅支持充电功能，根本无法进行数据通信。
排查 USB 接口是否被其他程序占用
如电脑中运行有虚拟机、手机助手等软件，可能会占用 USB 接口资源，导致冲突。建议关闭相关程序后重试。
建议使用台式机后置 USB 接口
前置 USB 接口因需额外走线至主板，存在供电不足的风险，可能影响高功耗设备的识别和烧录稳定性。建议优先使用主板直连的后置接口。
避免使用 USB HUB（集线器）
尽管较少见，但部分 USB HUB 存在兼容性问题，可能导致烧录失败或无法识别设备。建议将设备直接连接至电脑本机的 USB 接口。

2. 镜像烧录失败

SocToolKit 烧录软件能正常识别 Maskrom 设备，下载 DownloadBin...失败。
- 答：这个烧录失败的原因也是线的问题，更换高品质 Type-C 数据线
SocToolKit 烧录软件能正常识别 Maskrom 设备，下载 env... 失败。
- 答：在虚拟机开启并进行烧录时，电脑会重新访问USB接口，此时虚拟机会弹出提示窗口，如果不点击“确定”，烧录将会失败。
- 移除 USB HUB，将下载线直接连接电脑。

3. 串口问题

开发板的调试串口采用芯片直出的 USB 转 TTL 电平信号，因此所使用的串口模块必须为支持 TTL 电平的串口转接模块。

如果在串口调试过程中出现乱码问题，建议按以下顺序排查：
确认串口模块类型是否正确（必须为 USB 转 TTL）；
检查串口调试软件的波特率、数据位、停止位等配置是否与开发板一致；
核对串口接线是否正确（TX ↔ RX，GND 对接）；
尝试更换串口模块：在确保以上设置和接线无误的前提下，若仍存在乱码，可能是当前串口模块存在兼容性或硬件故障问题。建议更换其他串口模块后再次测试。

通常情况下，开发板自身的调试串口硬件稳定可靠，问题多出在串口模块或连接方式上。

4. 内存和存储分配

用户登录开发板后，通常会查看设备资源，如运行内存和存储空间。有些细心的用户可能会发现，实际查看到的参数与官网标注的存在差异。以下通过调试串口日志进行分析：

以 Luckfox Pro Max 为例，内存分配。
```
[    0.000000] Memory: 185364K/262144K available (3879K kernel code, 390K rwdata, 1884K rodata, 200K init, 139K bss, 9196K reserved, 67584K cma-reserved)
```
- 总内存为 262144K，即 262144K÷1024=256MB
- 185364K 可用，表示系统中剩余的可用内存，88280K÷1024=181MB
- 9196K reserved 是保留内存，不能供用户空间使用
- 67584K cma-reserved 24M 是专门分配给摄像头的内存

存储空间。

 [    0.083327] spi-nand spi2.0: Winbond SPI NAND was found.
 [    0.083357] spi-nand spi2.0: 256 MiB, block size: 128 KiB, page size: 2048, OOB size: 128
 [    0.084362] 7 cmdlinepart partitions found on MTD device spi-nand0
 [    0.084377] Creating 7 MTD partitions on "spi-nand0":
 [    0.084391] 0x000000000000-0x000000040000 : "env"
 [    0.086046] 0x000000040000-0x000000080000 : "idblock"
 [    0.087560] 0x000000080000-0x000000100000 : "uboot"
 [    0.089060] 0x000000100000-0x000000500000 : "boot"
 [    0.090585] 0x000000500000-0x000002300000 : "oem"
 [    0.092290] 0x000002300000-0x000002d00000 : "userdata"
 [    0.093907] 0x000002d00000-0x00000ff00000 : "rootfs"

表示这块 SPI NAND FLASH 容量为 256 MiB

分区大小计算表

分区名	起始地址	结束地址	大小（十六进制）	大小（十进制）	转换后大小
`env`	0x000000000000	0x000000040000	0x40000	262144 Bytes	256 KB
`idblock`	0x000000040000	0x000000080000	0x40000	262144 Bytes	256 KB
`uboot`	0x000000080000	0x000000100000	0x80000	524288 Bytes	512 KB
`boot`	0x000000100000	0x000000500000	0x400000	4194304 Bytes	4 MB
`oem`	0x000000500000	0x000002300000	0x1E00000	31457280 Bytes	30 MB
`userdata`	0x000002300000	0x000002d00000	0xA00000	10485760 Bytes	10 MB
`rootfs`	0x000002d00000	0x00000ff00000	0xC200000	203843584 Bytes	194.375 MB（约）

rootfs 分区日志输出

 [    0.867750] ubi0: scanning is finished
 [    0.872937] ubi0: attached mtd6 (name "rootfs", size 210 MiB)

文件系统挂载后的大小是：210 MiB

总结：UBIFS 文件系统使用擦写块（PEB）和逻辑擦写块（LEB），其中的日志、恢复数据和擦写均衡机制会占用一定的存储空间。因此，虽然文件系统标称为 209 MiB，实际可用空间可能会小于该值。具体地，209 MiB 转换为 219.15 MB（209 × 1.048576），去除消耗的空间后，实际可用空间约为 190 MB。

5. 内存释放

在《内存与存储分配》章节中，我们已详细说明了各分区的大小及空间占用情况。用户可根据实际需求在 SDK 中进行灵活调整，并重新编译生成镜像。

Pico 系列运行内存的分配情况：

产品型号	总运行内存	摄像头占用内存	实际运行内存
Luckfox Pico	64 MB	24 MB	约 35 MB
Luckfox Pico Mini A/B	64 MB	24 MB	约 35 MB
Luckfox Pico Plus	64 MB	24 MB	约 35 MB
Luckfox Pico Pro	128 MB	66 MB	约 60 MB
Luckfox Pico Max	256 MB	66 MB	约 190 MB
Luckfox Pico Ultra B/ BW	128 MB	66 MB	约 60 MB
Luckfox Pico Ultra/Ultra W	256 MB	66 MB	约 190 MB
Luckfox Pico Pi A	256 MB	66 MB	约 190 MB
Luckfox Pico Pi B	128 MB	66 MB	约 60 MB

内存配置位于 luckfox-pico/project/cfg/BoardConfig_IPC/.mk 文件中。具体参数说明可参考《SDK 环境部署》章节中的 SDK 配置文件说明。如果不使用摄像头功能，可将内存占用由默认的 66MB 调整为 1MB，节省运行内存，修改后重新编译镜像即可生效。

6. 无法使用摄像头

最新镜像：请确保自己烧录了网盘的最新 buildroot 镜像。
检查摄像头与开发板之间的接线：请确认摄像头与开发板之间的 MIPI 或其他连接方式正确无误，接口牢固，排列顺序无误。
电脑和开发板在同一局域网下：请确保开发板与电脑处于同一局域网内，并验证电脑是否可以成功 ping 通开发板，且能够通过 SSH 远程登录开发板（此步骤也是后续视频推流的前提）。
查看 I2C 识别情况：执行命令 i2cdetect -y 4，检查是否成功识别摄像头的 I2C 地址，判断摄像头是否正常挂载。
确认 CSI 摄像头驱动是否正常工作：启用 CSI 后，检查系统中是否出现 rkipc 进程，同时确认 /userdata 目录下是否成功识别摄像头设备。

7. 系统大小和 TF 卡容量问题

7.1 系统大小和TF 卡容量不匹配

默认情况下，使用官方提供的 Buildroot 镜像（通过网盘获取）烧录至 TF 卡后，即便 TF 卡实际容量为 16GB，系统可用空间也仅为约 8GB。这是因为当前系统镜像并不支持根据 TF 卡容量自动扩展分区，镜像中的分区大小由 SDK 构建配置决定，默认设定为 8GB。若需充分利用 TF 卡空间，可通过以下两种方法扩大系统容量：

方法一：通过 SDK 调整系统分区大小（推荐用于重新构建镜像）

进入 SDK 工程目录中的配置文件路径：
```
luckfox-pico/project/cfg/BoardConfig_IPC/.mk
```
修改其中的根文件系统分区参数，一般只需调整 rootfs 分区大小即可满足大多数应用场景。
修改完成后重新编译系统镜像，烧录到 TF 卡即可。相关参数说明详见《SDK 环境部署》章节中的“SDK 配置文件说明”部分。

方法二：通过 U-Boot 手动调整分区布局（适用于无需重新构建镜像的情况）

将开发板通过串口连接到 PC，并重启设备。
在启动阶段按下 Ctrl + C，进入 U-Boot 命令行界面，提示符为：
```
=>
```

执行以下命令，手动扩展 rootfs 分区至 TF 卡剩余所有空间（不影响其他分区）：

setenv blkdevparts 'mmcblk1:32K(env),512K@32K(idblock),256K(uboot),32M(boot),512M(oem),256M(userdata),-(rootfs)'
saveenv
reset

演示：

7.2 为什么需要 8GB 以上容量的 TF 卡

镜像实际大小只有几百兆为什么要几个GB的TF卡?

虽然镜像本身仅几百兆字节，但系统启动后会根据 SDK 中设定的分区大小，自动通过脚本进行分区扩展（resize），以确保系统运行有足够的空间。
为确保系统稳定运行及后续软件安装、日志存储等使用场景，建议使用 8GB 及以上容量的 TF 卡。

8. USB 无法识别设备

适用型号：Luckfox Pico Ultra 系列和 Pico Pi 系列，这类开发板配有标准 USB-A 接口，支持外接 USB 外设，请确认以下设置是否正确：

Luckfox Pico Pi 开发板已经烧录网盘的最新系统，连接 USB 设备没有正确识别，执行 lsusb 未看到正确的设备信息。
- 硬件拨码开关已设置至正确位置（Host 模式）
- 软件中已通过 luckfox-config 切换至 Host 模式
Luckfox Pico Ultra 开发板已经烧录网盘的最新系统，连接 USB 设备没有正确识别，执行 lsusb 未看到正确的设备信息，请确认以下设置是否正确
- 软件中通过 luckfox-config 切换至 Host 模式
- 由于开发板资源和空间有限，USB A 和 USB C不能同时用，请勿使用 Type-C 接口供电，，可以使用 POE 或者是 GPIO供电

9. 除 USB-C 外支持的其他供电方式

Luckfox Pico/Pico Mini/Pico Plus/Pico Pro/Pico Max

VBUS：连接至 Type-C 接口的输入电压，推荐使用该方式进行供电
VSYS：主系统供电输入，可作为备用供电通道
两者的供电电压范围均为 4.5V ~ 5.5V，支持一定程度的电压浮动。建议优先使用 VBUS 提供稳定电源

Luckfox Pico Ultra 系列 GPIO 供电或者 POE 供电

10. RGB 屏幕分辨率不正常显示

按照教程重新烧录网盘镜像，网盘镜像默认适配720x720分辨率的屏幕，如果自己屏幕是480x480 ，等待开发板成功开机后，按一下boot按键切换分辨率。

使用modetest工具测试，详见RGB屏幕《10.2 DRM测试》

modetest -M rockchip -s 70@66:480x480
modetest -M rockchip -s 70@66:720x720

11. Luckfox Pico Ultra 系列的屏幕 LOGO 如何修改

更换LOGO直接替换luckfox-Pico/sysdrv/source/kernel/drivers/video/logo/logo_linux_clut224.ppm后重新编译烧写内核镜像即可.ppm的转换方法如下:

# 安装软件 
sudo apt-get install netpbm

# 图片转换
pngtopnm <你的png图片 >./LOGO.pnm #其他格式可以用jpegtopnm bmptopnm
pnmquant 224 ./LOGO.pnm >./LOGO224.pnm
pnmtoplainpnm ./LOGO224.pnm >LOGO.ppm

1. 无法识别 MASKROM 设备​

2. 镜像烧录失败​

3. 串口问题​

4. 内存和存储分配​

5. 内存释放​

6. 无法使用摄像头​

7. 系统大小和 TF 卡容量问题​

7.1 系统大小和TF 卡容量不匹配​

7.2 为什么需要 8GB 以上容量的 TF 卡​

8. USB 无法识别设备​

9. 除 USB-C 外支持的其他供电方式​

10. RGB 屏幕分辨率不正常显示​

11. Luckfox Pico Ultra 系列的屏幕 LOGO 如何修改​