luckfox-config 配置

Luckfox Pico, Luckfox Pico Plus, Luckfox Pico Mini A, Luckfox Pico Mini B

Luckfox Pico 的引脚具有多种复用功能，根据实际项目的需求往往需要对设备树进行调整。本节会在编译阶段和系统运行阶段介绍 Luckfox Pico 引脚复用配置的两种方法，通过了解可以灵活地配置 Luckfox-Pico 引脚接口的功能。

1. 介绍

luckfox-config 是 Luckfox Pico 根文件系统的一个工具，可以在 Luckfox Pico 上快速配置设备功能。利用动态设备树机制和 fdt 工具可以在不重新编译 dtb 完成大部分的设备配置工作。

• 终端支持

系统类型	Buildroot
串口	支持
SSH	支持
ADB	无法使用方向键

• 功能

系统类型	Buildroot
GPIO	支持
PWM	支持
UART	支持
I2C	支持
SPI	支持
FBTFT	仅支持 Luckfox Pico / Plus / Pro / Max
RGB	仅支持 Luckfox Pico Ultra / Ultra W
TouchScreen	仅支持 Luckfox Pico Ultra / Ultra W
USB	支持
CSI	支持

2. luckfox-config 配置

注意：luckfox-config 的配置基于默认的设备树文件，如果在编译镜像时已经对设备树进行了调整，可能会导致部分功能无法正常使用。

2.1 结构

• luckfox-config 动态设备树配置工具，可以进行图形化交互配置
• /etc/luckfox.cfg 存储配置信息，用户可进行自定义编辑，每次进入根文件系统都会加载其中的配置项
• luckfox-config Pin diagram 用于临时存储系统的配置的关键信息，可以让用户直观了解此时引脚的配置状态

2.2 基本使用方法

1. 在开发板终端运行以下命令以打开图形化配置界面：

   luckfox-config

• 效果如下：

2. 键盘上的↑、↓键进行菜单项目的选择，enter键进入，←、→键或者Tab进行 OK和 cancel 按钮的选择，Esc键取消返回，空格键为选择定选项，任何更改都将在重新启动后生效。注意：ADB登录无法使用 方向键和 Tab，只能使用数字选择选项，enter确认。

3. 查看配置情况。引脚使能功能后会被标记“*”号进入锁定状态，如果新使能的接口包含被锁定的引脚将无法继续，可以在 luckfox-config 的 about 菜单或使用命令查看当前引脚的锁定状态 。

    luckfox-config show

• 如果引脚复用的功能在pin diagram中没有说明会直接标记对应的 GPIO
• Luckfox Pico Ultra 系列由于 I2C4 与 CSI 摄像头共用，CSI 接口默认开启且 pinctrl-0 中配置了引出的 I2C4 引脚，所以首次开机时会同时标记I2C4所有引脚和RGB引脚

4. 配置保存

常用引脚复用（比如：PWM UART I2C SPI）在配置后立刻生效，驱动不支持动态检测的设备（比如：FBTFT RGB 触摸屏 CSI等）在配置后需要重启才能生效。

注意： 需要重启生效的设置采用的是直接修改 dtb 的方式，在 luckfox.cfg 中的 ENABLE 状态仅作记录，仅修改 luckfox.cfg 在配置加载时不会真正起作用。 5. 配置加载

    luckfox-config load

注意： 配置加载在根文件系统启动阶段会自动执行，根据 /etc/luckfox.cfg 中的配置信息创建 dtboverlay 节点写入配置，正常不需要执行该命令。

2.3 常用配置

2.3.1 PWM 配置

1. 进入 Advanced Options -> PWM 界面，luckfox-config 会显示支持的所有的 PWM 配置。

2. 选中计划配置的选项，选中 enable 使能，选中 disable 禁用，如果需要取消配置可以使用方向键选中 Cancel 退回上一个界面。

3. 如果该引脚已经被复用为其他功能并标记，选中 enable 使能会显示提示信息，需要禁用冲突的配置才能成功使能。

2.3.2 UART 配置

1. 进入 Advanced Options -> UART 界面，luckfox-config 会显示支持的所有的 UART 配置。

2. 选中计划配置的选项，选中 enable 使能，选中 disable 禁用，如果需要取消配置可以使用方向键选中 Cancel 退回上一个界面。
3. 如果需要配置的引脚被复用为其他功能并标记，选中 enable 使能会显示提示信息，需要禁用冲突的配置才能成功使能。

2.3.3 I2C 配置

1. 进入 Advanced Options -> I2C 界面，luckfox-config 会显示支持的所有的 I2C 配置。

2. 选中计划配置的选项，选中 enable 使能，选中 disable 禁用，如果需要取消配置可以使用方向键选中 Cancel 退回上一个界面，如果选中 enable 使能会进入速率配置界面。

3. 在 Luckfox Pico Ultra 系统中，如果使能了 CSI 将无法配置 I2C4，如果使能了触摸屏将无法配置 I2C3。

4. 如果需要配置的引脚被复用为其他功能并标记，选中 enable 使能会显示提示信息，需要禁用冲突的配置才能成功使能。
5. 当触摸屏被使能时，无法配置 I2C3；当 CSI 被使能时，无法配置 I2C4。

2.3.4 SPI 配置

1. 进入 Advanced Options -> SPI 界面，luckfox-config 会显示支持的所有的 SPI 配置。

2. 选中计划配置的选项，选中 enable 使能，选中 disable 禁用，如果需要取消配置可以使用方向键选中 Cancel 退回上一个界面，如果选中 enable 使能会进入速率配置界面和引脚组合使能界面，可以根据具体需求来判断是否使能 CS 引脚或 MISO 引脚。

3. 如果需要配置的引脚被复用为其他功能并标记，选中 enable 使能会显示提示信息，需要禁用冲突的配置才能成功使能。

2.3.5 CSI 配置

1. 进入 Advanced Options -> CSI 界面，选中 enable 使能，选中 disable 禁用。

2. 使用 Luckfox Pico Pi 系列时建议开机后配置一次 CSI，防止影响后续其他配置。
3. 如果有其他 I2C4 引脚被使用，无法配置 CSI ，防止 CSI 配置的使能和禁用影响 I2C4 正在运行的任务。

• 注意： CSI 配置需要重启后才能生效

2.4.6 USB 配置

1. 进入 Advanced Options -> USB 界面，配置 USB 的模式为 peirpheral 或 host。

• 注意： USB 配置需要重启后才能生效