跳到主要内容

luckfox-config 配置

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 配置。
    xxx

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

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

2.3.2 UART 配置​

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

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

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

2.3.3 I2C 配置​

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

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

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

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

  5. 当触摸屏被使能时，无法配置 I2C3；当 CSI 被使能时，无法配置 I2C4。

2.3.4 SPI 配置​

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

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

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

2.3.5 CSI 配置​

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

  2. 使用 Luckfox Pico Pi 系列时建议开机后配置一次 CSI，防止影响后续其他配置。

  3. 如果有其他 I2C4 引脚被使用，无法配置 CSI ，防止 CSI 配置的使能和禁用影响 I2C4 正在运行的任务。
    xxx

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

2.4.6 USB 配置​

  1. 进入 Advanced Options -> USB 界面，配置 USB 的模式为 peirpheral 或 host。
    xxx
  • 注意： USB 配置需要重启后才能生效