跳到主要内容

7.5.13.2 Port 开发指南

基本概述​

Port 整体分为对外接口和"Low Level Driver(LLD)"两大部分，这里只介绍用户接口开发部分。

Port_Func 模块​

地瓜 MCU 系统提供针对功能整体配置的 Port_Func 模块。

在 McalCdd 的路径中，定义了 Port_Func 模块的对外接口：

# Driver source code:
McalCdd/Port/inc/Port_Func.h
McalCdd/Port/src/Port_Func.c

在 Config 目录下，定义了 MCU 提供的外设的 PIN 的具体 PinCtrl 配置。

# PIN definition source code:
Config/McalCdd/gen_s100_sip_B_mcu1/Port/inc/Port_FuncCfg.h
Config/McalCdd/gen_s100_sip_B_mcu1/Port/src/Port_FuncCfg.c
# PIN definition source code:
Config/McalCdd/gen_s600_md_mcu1/Port/inc/Port_FuncCfg.h
Config/McalCdd/gen_s600_md_mcu1/Port/src/Port_FuncCfg.c

PinCtrl 配置说明​

在配置头文件中，提供了方便定义 PIN 属性的宏：

Config/McalCdd/gen_s100_sip_B_mcu1/Port/inc/Port_FuncCfg.h

Config/McalCdd/gen_s600_md_mcu1/Port/inc/Port_FuncCfg.h

#define PORT_FUNC_MCU_PIN(Pin_Idx, Pin_Name, Pin_Func, Schmitt, Input_En, SlewRate, Pull_Type, Drive_Strength) { \
	(uint8)(Pin_Idx), /**< Pin Id */ \
	(Pin_Name), /**< Pin name */ \
	(boolean)(TRUE), /**< IsUsed */ \
	{ \
		(boolean)(TRUE), /**< ModeChang */ \
		(boolean)(Schmitt), /**< Schmitt Trigger */ \
		(boolean)(Input_En), /**< Input Enable*/ \
		(boolean)(FALSE), /**< Is Used GPIO */ \
		(boolean)(FALSE), /**< Direciton change allowed */ \
		(Pin_Func), /**< Pin Function */ \
		(SlewRate), /**< Slew Rate */ \
		(Pull_Type), /**< Pin Pull Type */ \
		(Drive_Strength), /**< Pin Drive Strength */ \
		(PORT_PIN_DIR_IN), /**< GPIO Direction */ \
		(PORT_PIN_LEVEL_LOW) /**< GPIO Output Value */ \
	} \
}

...


#define PORT_FUNC_AON_PIN(Pin_Idx, Pin_Name, Pin_Func, Schmitt, Input_En, SlewRate, Pull_Type, Drive_Strength) { \
	(uint8)((Pin_Idx) + (S100_PORT_MCU_PIN_NUM)), /**< Pin Id Converted */ \
	(Pin_Name), /**< Pin name */ \
	(boolean)(TRUE), /**< IsUsed */ \
	{ \
		(boolean)(TRUE), /**< ModeChang */ \
		(boolean)(Schmitt), /**< Schmitt Trigger */ \
		(boolean)(Input_En), /**< Input Enable*/ \
		(boolean)(FALSE), /**< Is Used GPIO */ \
		(boolean)(FALSE), /**< Direciton change allowed */ \
		(Pin_Func), /**< Pin Function */ \
		(SlewRate), /**< Slew Rate */ \
		(Pull_Type), /**< Pin Pull Type */ \
		(Drive_Strength), /**< Pin Drive Strength */ \
		(PORT_PIN_DIR_IN), /**< GPIO Direction */ \
		(PORT_PIN_LEVEL_LOW) /**< GPIO Output Value */ \
	} \
}

...

地瓜根据各个功能的实际情况，提供了一套默认的 PIN 属性定义，客户可以根据自己的实际需求进行修改：

Config/McalCdd/gen_s100_sip_B_mcu1/Port/src/Port_FuncCfg.c

Config/McalCdd/gen_s600_md_mcu1/Port/src/Port_FuncCfg.c

Port 模块​

Port 模块是地瓜 MCU 底层的 PinCtrl 模块，一般用户使用 Port_Func 模块对需要使用的外设进行功能的初始化配置即可。以下部分属于进阶 Port 开发的内容，部分功能仅在商业版代码开放。

Pin 初始状态配置​

MCU0在启动时，会调度Port_Init()接口对 MCU 的所有 PIN 进行初始状态配置，MCU1在启动时默认不会再次Port_Init()接口。

注意

不建议用户在 MCU1二次调度Port_Init()接口，二次初始化 PIN 状态可能会导致 S100 SIP 的供电等基础功能异常。

在Port_PBcfg.c中定义了各个 pin 的初始状态，示例如下：

Config/McalCdd/gen_s100_sip_B/Port/src/Port_PBCfg.c

...
    /* Pin Id,  Pin name,      IsUsed,        ModeChang,    SchmittTriger,  InputEnable,     IsUsedGpio,     DirChang,   PinMode,    Config Type,        Pull Type,       Drive Strength,         GpioDir,           GpioData*/
    {(uint8)51, "EMAC2_TX_CLK", (boolean)TRUE, {(boolean)TRUE, (boolean)FALSE, (boolean)TRUE, (boolean)TRUE, (boolean)TRUE, GPIO, PORT_PIN_CONFIG_TYPE0, PORT_PULL_NONE, PORT_DRIVE_STRENGTH_5, PORT_PIN_DIR_IN, PORT_PIN_LEVEL_LOW}},
...

Config/McalCdd/gen_s600_md_mcu1/Port/src/Port_PBcfg.c

...
    /* Pin Id,  Pin name,      IsUsed,        ModeChang,    SchmittTriger,  InputEnable,     IsUsedGpio,    DirChang,   PinMode,    Config Type,        Pull Type,       Drive Strength,         GpioDir,           GpioData*/
    {(uint8)0, "PPS_IN0", (boolean)TRUE, {(boolean)TRUE, (boolean)TRUE, (boolean)TRUE, (boolean)FALSE, (boolean)FALSE, PPS_IN0_FUNC0, PORT_PIN_CONFIG_TYPE0, PORT_PULL_NONE, PORT_DRIVE_DEFAULT, PORT_PIN_DIR_IN, PORT_PIN_LEVEL_LOW}},
...

代码分为两行：

  • 第一行“注释行”标注了代码行每一个参数所代表的含义；
  • 第二行“代码行”定义了每一根 PIN 的状态，下面介绍几个重点配置：
    • PinMode：定义了 PIN 的具体功能，功能定义可以参考对应平台的Port_PBcfg.h
    • Config Type：定义了 PIN 的 SlewRate 控制，具体定义，商业版可以参考Port/Inc/Port_Lld.h，社区版可以参考：Include/Port_Lld.h
    • IsUsed：定义 Port 模块是否会在初始化时对该 PIN 进行配置；
    • ModeChange：定义了调度 Port 模块（不包括 Port_Func 模块）API 时，是否允许该 PIN 的功能在 Runtime 被修改；
    • IsUsedGpio：定义 Port 模块是否会在初始化时对该 PIN 进行 GPIO 的方向及输出配置；

客户可以根据需要自行定义 PIN 的初始状态。

最后于 更新