CV184x 外围设备驱动使用手册

修订记录

Revision	Date	Description
1.0.0	2025/03/12	Initial version
1.0.1	2025/07/08	Add CVI_PINMUX_Operation_Guide
1.0.2	2026/04/28	Update PWM/ADC/I2C/SPI/GPIO/UART/Watchdog operation guides

目录

• 1. 声明
• 2. Ethernet 操作指南
  • 2.1. 操作示例
  • 2.2. IPv6说明
  • 2.3. IEEE 802.3x流控功能
    • 2.3.1. 流控功能描述
    • 2.3.2. 流控功能配置
    • 2.3.3. ethtool配置接口流控功能
• 3. USB操作指南
  • 3.1. 操作准备
  • 3.2. Uboot操作过程
    • 3.2.1. Uboot下USB Host配置
    • 3.2.2. Uboot下U盘
  • 3.3. linux Host
    • 3.3.1. USB 2.0 Host 操作过程
  • 3.4. linux Device
    • 3.4.1. 操作准备
    • 3.4.2. 切换 switch GPIO
    • 3.4.3. Device 作为存储设备的操作指南
    • 3.4.4. Device 作为终端设备的操作指南
    • 3.4.5. Device 作为 ADB 设备的操作指南
    • 3.4.6. Device 作为 RNDIS 设备的操作指南
  • 3.5. 操作中需注意问题
• 4. SD/MMC 卡操作指南
  • 4.1. 操作准备
  • 4.2. 操作过程
  • 4.3. 操作示例
    • 4.3.1. U-Boot 下操作 SD 卡
    • 4.3.2. Linux 下操作 SD 卡
  • 4.4. 操作中需要注意的问题
• 5. I2C 操作指南
  • 5.1. 操作准备
    • 5.1.1. 切换引脚（将引脚复用到 I2C 功能）
  • 5.2. 操作过程
  • 5.3. 接口速率设置说明
  • 5.4. I2C 读写命令示例（i2c-tools）
  • 5.5. GPIO 模拟 I2C（以 I2C-2 为例）
  • 5.6. I2C Recovery 配置说明
  • 5.7. 内核态 I2C 读写程序示例
  • 5.8. 用户态 I2C 读写程序示例
• 6. SPI 操作指南
  • 6.1. 操作准备
    • 6.1.1. 使能内核 SPI 与 DMA 配置
    • 6.1.2. 在设备树中将 SPI1 使能
    • 6.1.3. SPI1 引脚切换
  • 6.2. 操作过程
  • 6.3. SPI 环回测试
  • 6.4. 操作示例
  • 6.5. 内核态 SPI 读写程序示例
  • 6.6. 用户态 SPI 读写程序示例
• 7. GPIO操作指南
  • 7.1. 操作准备
  • 7.2. 操作流程
  • 7.3. 操作示例
    • 7.3.1. GPIO命令行操作示例
    • 7.3.2. 内核态GPIO操作示例
      • 7.3.2.1. 头文件与宏定义
      • 7.3.2.2. 中断回调函数
      • 7.3.2.3. 模块初始化（GPIO 读写 + 中断注册）
      • 7.3.2.4. 模块卸载（资源释放）
      • 7.3.2.5. 模块声明
    • 7.3.3. 用户态GPIO操作示例
• 8. UART 操作指南
  • 8.1. 操作准备
    • 8.1.1. 内核要求
    • 8.1.2. 设备树中使能 UART
    • 8.1.3. UART 使用 DMA 时的设备树配置
    • 8.1.4. 引脚复用
  • 8.2. 操作流程
    • 8.2.1. UART 环回测试
    • 8.2.2. UART 串口通信（终端收发）
  • 8.3. UART 扩展操作（常用 / 排障 / 高级）
    • 8.3.1. 常用扩展操作（基础功能补充）
    • 8.3.2. 排障类操作（解决串口异常）
    • 8.3.3. 高级配置操作（适配特殊场景）
    • 8.3.4. UART 扩展操作小结
  • 8.4. UART 特定波特率输出（以 3M 为例）
  • 8.5. 用户态程序开发示例
• 9. Watchdog 操作指南
  • 9.1. 操作准备
  • 9.2. 操作流程
  • 9.3. 操作示例
    • 9.3.1. 打开 Watchdog 并立即喂狗
    • 9.3.2. 设置超时时间
    • 9.3.3. 喂狗（Keepalive）
    • 9.3.4. 获取当前超时时间
    • 9.3.5. 获取剩余时间
    • 9.3.6. 关闭 Watchdog（Magic Close）
    • 9.3.7. 完整用户态程序示例
    • 9.3.8. 命令行快速示例
• 10. PWM 操作指南
  • 10.1. 操作准备
  • 10.2. 操作流程
  • 10.3. 操作示例
    • 10.3.1. 命令行操作示例
    • 10.3.2. 最高与最低频率操作示例
    • 10.3.3. 用户态程序示例
    • 10.3.4. 运行方式说明
• 11. ADC 操作指南
  • 11.1. 操作准备
  • 11.2. 操作流程
  • 11.3. 操作示例
    • 11.3.1. 读取 SARADC0 通道 1 并换算电压
    • 11.3.2. SARADC0 通道 3 与 RTC_SARADC0 通道 10 读取示例
    • 11.3.3. 内核态 ADC 读写示例
    • 11.3.4. 用户态 ADC 读写示例
• 12. CVI PINMUX 操作指南
  • 12.1. 操作准备
  • 12.2. 操作流程
    • 12.2.1. U-Boot 下 Pinmux 配置
    • 12.2.2. 内核下 Pinmux 配置（cvi_pinmux 工具）
  • 12.3. ephy 引脚切换为 GPIO 或 SPI
    • 12.3.1. 切换为 GPIO
    • 12.3.2. 切换为 SPI
• 13. DMA 操作指南
  • 13.1. dev-to-mem操作指南
    • 13.1.1. 内核要求
    • 13.1.2. 驱动说明
  • 13.2. mem-to-mem操作指南
    • 13.2.1. 配置并打开内核 menuconfig
    • 13.2.2. 编译内核（含模块）
    • 13.2.3. 加载与设备节点
  • 13.3. 用户态测试
    • 13.3.1. 完整测试代码
    • 13.3.2. 编译说明
    • 13.3.3. 测试内容说明
  • 13.4. ioctl 接口
  • 13.5. 如何验证为 DMA mem-to-mem
    • 13.5.1. 看内核日志
    • 13.5.2. 看 CPU 占用
• 14. 温控策略与测试操作指南
  • 14.1. 操作准备
  • 14.2. 操作流程
    • 14.2.1. 查看 CPU/TPU 时钟
    • 14.2.2. 查看当前温度
    • 14.2.3. 温控策略（与 trip 对应关系）
    • 14.2.4. 迟滞（hysteresis）说明
  • 14.3. 操作示例
    • 14.3.1. 模拟温度测试步骤
    • 14.3.2. 基线
    • 14.3.3. 模拟到 90°C（应进入第一档降频）
    • 14.3.4. 模拟到 100°C（应进入第二档降频）
    • 14.3.5. 模拟降到 95°C（有迟滞，频率应保持第二档不变）
    • 14.3.6. 模拟降到 94°C（低于迟滞退档边界，应升回第一档或高档，视策略而定）
    • 14.3.7. 模拟到 120°C（触发 critical，强制关机）
    • 14.3.8. 在设备树中修改温控阈值、关机温度与迟滞
    • 14.3.9. 板级覆盖示例
  • 14.4. 相关文件索引