NXP iMX7 M4核心PWM驱动开发

By Toradex秦海

1). 简介

在早先的一篇文章已经介绍过基于NXP iMX7 异构多核架构进行开发调试，本文就延续这一篇文章的介绍，以PWM功能为示例着重介绍在iMX7 多核架构里面的M4核心上面开发驱动的方式。

 

而本文所演示的ARM平台同样来自于Toradex 基于NXP iMX7 ARM处理器的Colibri iMX7 ARM嵌入式平台。

 

2. 准备

a). Colibri iMX7S ARM核心版配合Colibri Evaluation Board，分别连接A7核心默认调试串口UART1（载板X27）和M4核心默认调试串口UART2（载板X25上）到开发主机方便调试，另外由于iMX7S只支持一个USB接口，需要通过载板X30连接一个USB Hub后来扩展键盘鼠标外设。更多关于Colibri iMX7的说明请参考Datasheet和Linux开发上手指南。

 

b). Colibri iMX7 A7核心系统使用Toradex官方发布的Embedded Linux，更新方法请参考这里。

 

c). 另外，由于本文演示示例使用到了载板上面PWM驱动LED和按键资源，需要连接如下：

X10 SODIMM-28 -> X21 LED1

X10 SODIMM-133 -> X21 SW6

 

d). SEGGER J-Link 仿真器，USB一端连接开发主机，JTAG一端连接载板X13。

 

 

3). Colibri iMX7 M4核心FreeRTOS基本资料

a). Colibri iMX7 架构基本说明请参考如下：

   https://developer.toradex.cn/knowledge-base/freertos-on-the-cortex-m4-of-a-colibri-imx7

 

b). 本示例中M4核心运行FreeRTOS v8系统，相关的源代码和sample程序请从下面git下载：

http://git.toradex.cn/cgit/freertos-toradex.git/

 

c). 基本的SDK配置和编译请参考如下：

https://developer.toradex.cn/knowledge-base/freertos-on-the-cortex-m4-of-a-colibri-imx7#Linux_support

 

d). 编译好的M4 firmware如何在Colibri iMX7上面加载运行请参考如下：

https://developer.toradex.cn/knowledge-base/freertos-on-the-cortex-m4-of-a-colibri-imx7#Running_a_Firmware_on_CortexM4

 

e). 几个自带的sample代码简单说明请参考如下：

https://developer.toradex.com/knowledge-base/freertos-on-the-cortex-m4-of-a-colibri-imx7#Examples

 

 

4). Colibri iMX7 M4核心FreeRTOS PWM驱动开发

a). 在上一章节中提到的iMX7 M4 FreeRTOS源代码中，已经包含了一些接口的驱动示例，比如GPIO，UART，I2C，Flexcan等，但并没有包含PWM部分，因此我们需要手动添加PWM驱动。

 

b). 首先我们要找到提供iMX7芯片核心寄存器定义的macro code文件，获取PWM相关寄存器定义以及做细微调整。

./ 文件为 platform/devices/MCIMX7D/include/MCIMX7D_M4.h

这个文件是整个iMX7 M4 FreeRTOS代码最核心的文件之一，里面定义了所有芯片寄存器macro code，具体的寄存器功能说明需要参照 NXP iMX7 Reference Manual文档。

./ 在这个文件里面，如下 ”PWM Peripheral Access Layer”开始的部分定义了PWM相关的寄存器，是最关键的部分。

-----------------------------

   -- PWM Peripheral Access Layer

…

/** PWM - Register Layout Typedef */

typedef struct {

  __IO  uint32_t PWMCR;                                  /**< PWM Control Register, offset: 0x0 */

  __IO  uint32_t PWMSR;                                  /**< PWM Status Register, offset: 0x4 */

  __IO  uint32_t PWMIR;                                  /**< PWM Interrupt Register, offset: 0x8 */

  __IO  uint32_t PWMSAR;                                 /**< PWM Sample Register, offset: 0xC */

  __IO  uint32_t PWMPR;                                  /**< PWM Period Register, offset: 0x10 */

  __I   uint32_t PWMCNR;                                 /**< PWM Counter Register, offset: 0x14 */

} PWM_Type, *PWM_MemMapPtr;

…

-----------------------------

./ 在这里，为了后面PWM驱动配置方便，我们做了如下patch

https://github.com/simonqin09/iMX7_M4_PWM_Driver/blob/master/MCIMX7D_M4.patch

 

c). 然后是关于CCM（Clock Control Module）驱动配置头文件，添加PWM所需要的clock源

./ 文件为 - platform/drivers/inc/ccm_imx7d.h

 

./ 如下patch，增加PWM所需clock gate

https://github.com/simonqin09/iMX7_M4_PWM_Driver/blob/master/ccm_imx7d.patch

 

d). 接下来就是在 ”plaftform/drivers/inc” 和 ”platform/drivers/src” 下分别增加PWM驱动头文件 ”pwm_imx.h” 和源文件 ”pwm_imx.c”，完成PWM相关基本寄存器的读写操作等基本功能函数的实现。

./ pwm_imx.h 文件代码如下

https://github.com/simonqin09/iMX7_M4_PWM_Driver/blob/master/pwm_imx.h

 

./ pwm_imx.c 文件代码如下

https://github.com/simonqin09/iMX7_M4_PWM_Driver/blob/master/pwm_imx.c

 

 

5). Colibri iMX7 M4核心FreeRTOS PWM驱动应用示例

a). 在上面章节基本驱动配置好之后，我们就可以调用驱动进行示例开发了。本文就简单演示通过一个GPIO按键来动态调整PWM输出占空比的示例。本示例所使用的GPIO Key为examples里面已经配置的 ” BOARD_GPIO_KEY_CONFIG”，PWM使用为PWM2。

 

b). 首先进入 “examples/imx7_colibri_m4” 目录，对几个基本文件进行修改适配

./ board.h – 这个文件定义了当前examples下所有示例所涉及到的接口，中断，clock等定义，因此需要将PWM2相关定义添加进来，如下面patch。

https://github.com/simonqin09/iMX7_M4_PWM_Driver/blob/master/board.patch

 

./ pin_mux.h 和pin_mux.c – 定义了除了GPIO之外的所有示例所涉及的接口功能的对应管脚的Pin Mux配置，这里我们将PWM2的管脚配置添加进来，如下面patch。GPIO管脚的Pin Mux配置在gpio_pins.h/gpio_pins.c 中定义。

https://github.com/simonqin09/iMX7_M4_PWM_Driver/blob/master/pin_mux.patch

 

c). 然后再创建 ”pwm_imx” 目录，为了方便，可以复制同一目录下的 gpio_imx目录后进行修改。

./ hardware_init.c – 硬件初始化，board，GPIO/PWM RDC/Clock 等，代码如下

https://github.com/simonqin09/iMX7_M4_PWM_Driver/blob/master/pwm_imx/hardware_init.c

 

./ main.c – 主程序文件，包含三个子程序和main主程序，三个子程序分别负责GPIO初始化，GPIO Key按键响应处理以及PWM中断Handler，main主程序完成了对GPIO和PWM初始化配置后，在每次按键的时候将PWM输出占空比从25%-50%-75%之间循环，具体代码如下：

https://github.com/simonqin09/iMX7_M4_PWM_Driver/blob/master/pwm_imx/main.c

 

./ 最后修改 “armgcc/CMakeLists.txt” 文件，将所有新创建的文件包含进去，然后进行编译，具体内容如下：

https://github.com/simonqin09/iMX7_M4_PWM_Driver/blob/master/pwm_imx/armgcc/CMakeLists.txt

 

./ 对iMX7 M4 FreeRTOS代码进行debug的方法请参考这里，本文就不再赘述。

 

 

6). Colibri iMX7 M4 PWM驱动示例部署

a). 在部署之前，首先需要确保将本文所使用的 PWM2 从 iMX7 A7 核心 Linux device tree中disable，以免发生资源冲突。有两种方法如下：

./ 参考这里下载A7 Linux kernel源代码，再参考这里修改device tree后重新编译部署。

 

./ 可以直接在uboot中通过 ”fdt_fixup” 环境变量来临时禁止某个外设

-----------------------------

/* read device tree file and print details */

# ubi part ubi

# ubi read ${fdt_addr_r} dtb

# fdt addr ${fdt_addr_r}

# fdt list

/* find PWM2 related setting */

# fdt list /soc/aips-bus@30400000/pwm@30670000

/* set fdt_fixup variable with UARTB and PWM2 disable */

# setenv fdt_fixup ‘fdt addr ${fdt_addr_r} && fdt rm /soc/aips-bus@30800000/spba-bus@30800000/serial@30890000 && fdt rm /soc/aips-bus@30400000/pwm@30670000’

-----------------------------

 

b). 然后就可以参考上面的相关文档或者之前的文章进行加载M4 firmware运行了

./ 程序开始运行，如下示波器测量数据所示，PWM2输出周期为500ms（周期来自main主函数文件里面的配置），占空比为25%，从LED等可以看到亮的时间比灭的时间较短。

       

 

./ 然后按动载板按键 SW6一次，PWM2 输出周期不变，占空比会变成50%。

 

./ 再次按动载板按键 SW6一次，PWM2 输出周期不变，占空比会变成75%。

 

./ 以后每次按键都会循环上述过程。

 

 

7). 总结

如上述示例，iMX7 M4 核心可以非常方便的开发外设驱动并进行调用，尤其是基于FreeRTOS，相对于直接配置寄存器就更直观写，代码也更具备灵活性和重用性。