BabyOS 移植之MCU GPIO 硬件抽象层

前言

BabyOS 是一套代码框架,好比于乐高积木,提供一些功能模块,按照相对应的使用方法可以快速搭建自己的嵌入式系统。

那么我们说一下想把它移植到别的平台如何操作?

点灯作为第一个目标,那就是移植GPIO操作。

教你看懂GPIO寄存器

GPIOx

x=A..E) 就是GPIOA,GPIOB....

基地址偏移

        可以看到偏移4个字节,就是32个bit;

举例

GPIOA_CFG

GPIOA_CFG是一个寄存器,这里面分为了GPIOA_CFGLR,GPIOA_CFGHR

GPIOA_CFGLR 

310

GPIOA_CFGHR 

310

GPIOA0..GPIOA15在 GPIOA_CFG分配关系

GPIOA0~GPIOA7 在 GPIOA_CFGLR中控制

每个pin分配了4个bit

GPIOA8~GPIOA15在 GPIOA_CFGHR中控制

每个pin分配了4个bit

容易被迷惑的表格

看表格先看表头

不然直接看内容容易被搞晕,这个32个bit怎么控制16个pin?

下面这张表格指示描述了4个bit

GPIOA_CFGLR

31~28(GPIOA7_CFG)3~0(GPIOA0_CFG)

举例

输入模式

bit1~0 IOMCy :00

浮空

bit3~2 IOFCy:01

这时候你只需要将

GPIOA_CFGLR 低四位清零 ,逻辑按位或0x04;

STM32F107


#define GPIO_REG_OFF (0x400UL)
#define GPIO_REG_BASE (0x40010800UL)

typedef struct
{
    volatile uint32_t CRL;
    volatile uint32_t CRH;
    volatile uint32_t IDR;
    volatile uint32_t ODR;
    volatile uint32_t BSRR;
    volatile uint32_t BRR;
    volatile uint32_t LCKR;
} McuGpioReg_t;

static void _GpioConfig(bHalGPIOPort_t port, bHalGPIOPin_t pin, bHalGPIODir_t dir,
                        bHalGPIOPull_t pull)
{
    uint32_t      dir_val  = 4;
    uint32_t      pull_val = 0;
    McuGpioReg_t *pGpio    = (McuGpioReg_t *)(GPIO_REG_BASE + port * GPIO_REG_OFF);

    if (!B_HAL_GPIO_ISVALID(port, pin))
    {
        return;
    }

    if (dir == B_HAL_GPIO_OUTPUT)
    {
        dir_val = (pin == B_HAL_PINAll) ? 0x33333333 : 3;
    }
    else if (pull != B_HAL_GPIO_NOPULL)
    {
        dir_val  = (pin == B_HAL_PINAll) ? 0x88888888 : 8;
        pull_val = (pin == B_HAL_PINAll) ? 0xFFFF : (0X0001 << pin);

        if (pull == B_HAL_GPIO_PULLUP)
        {
            pGpio->BSRR = pull_val;
        }
        else
        {
            pGpio->BRR = pull_val;
        }
    }

    if (pin == B_HAL_PINAll)
    {
        pGpio->CRL = dir_val;
        pGpio->CRH = dir_val;
    }
    else
    {
        if (pin < B_HAL_PIN8)
        {
            pGpio->CRL &= ~(0x0000000F << (pin * 4));
            pGpio->CRL |= (dir_val << (pin * 4));
        }
        else
        {
            pGpio->CRH &= ~(0x0000000F << (pin * 4));
            pGpio->CRH |= (dir_val << (pin * 4));
        }
    }
}

static void _GpioWritePin(bHalGPIOPort_t port, bHalGPIOPin_t pin, uint8_t s)
{
    uint32_t      cs_val = 0x00000001 << pin;
    McuGpioReg_t *pGpio  = (McuGpioReg_t *)(GPIO_REG_BASE + port * GPIO_REG_OFF);
    if (!B_HAL_GPIO_ISVALID(port, pin) || pin == B_HAL_PINAll)
    {
        return;
    }
    if (s == 0)
    {
        cs_val <<= 16;
    }
    pGpio->BSRR = cs_val;
}

static uint8_t _GpioReadPin(bHalGPIOPort_t port, bHalGPIOPin_t pin)
{
    uint32_t      id_val = 0;
    McuGpioReg_t *pGpio  = (McuGpioReg_t *)(GPIO_REG_BASE + port * GPIO_REG_OFF);
    if (!B_HAL_GPIO_ISVALID(port, pin) || pin == B_HAL_PINAll)
    {
        return 0;
    }
    id_val = pGpio->IDR;
    return ((id_val & (0x0001 << pin)) != 0);
}

static void _GpioWrite(bHalGPIOPort_t port, uint16_t dat)
{
    McuGpioReg_t *pGpio = (McuGpioReg_t *)(GPIO_REG_BASE + port * GPIO_REG_OFF);
    if (!B_HAL_GPIO_ISVALID(port, 0))
    {
        return;
    }
    pGpio->ODR = dat;
}

static uint16_t _GpioRead(bHalGPIOPort_t port)
{
    uint32_t      id_val = 0;
    McuGpioReg_t *pGpio  = (McuGpioReg_t *)(GPIO_REG_BASE + port * GPIO_REG_OFF);
    if (!B_HAL_GPIO_ISVALID(port, 0))
    {
        return 0;
    }
    id_val = pGpio->IDR;
    return (id_val & 0xffff);
}

bHalGPIODriver_t bHalGPIODriver = {
    .pGpioConfig    = _GpioConfig,
    .pGpioWritePin  = _GpioWritePin,
    .pGpioWritePort = _GpioWrite,
    .pGpioReadPin   = _GpioReadPin,
    .pGpioReadPort  = _GpioRead,
};

地址映射

首先看到的是GPIO对应的地址映射,那么我们找对应的数据手册查找GPIO寄存器地址映射为:

 #define GPIO_REG_OFF (0x400UL)  //GPIO A,B,C,D 之间的地址偏移量
#define GPIO_REG_BASE (0x40010800UL)   //GPIO 起始地址

控制寄存器

与之相对应的代码为:

static void _GpioConfig(bHalGPIOPort_t port, bHalGPIOPin_t pin, bHalGPIODir_t dir,
                        bHalGPIOPull_t pull)
{
    uint32_t      dir_val  = 4;
    uint32_t      pull_val = 0;
    McuGpioReg_t *pGpio    = (McuGpioReg_t *)(GPIO_REG_BASE + port * GPIO_REG_OFF);

    if (!B_HAL_GPIO_ISVALID(port, pin))
    {
        return;
    }

    if (dir == B_HAL_GPIO_OUTPUT)
    {
        dir_val = (pin == B_HAL_PINAll) ? 0x33333333 : 3;  //G OUT Push-pull 50mhz
    }
    else if (pull != B_HAL_GPIO_NOPULL)
    {
        // Input pull-down / pull-up
        dir_val  = (pin == B_HAL_PINAll) ? 0x88888888 : 8;    
        pull_val = (pin == B_HAL_PINAll) ? 0xFFFF : (0X0001 << pin);  //SET BIT

        if (pull == B_HAL_GPIO_PULLUP)
        {
            pGpio->BSRR = pull_val;    // pull-up
        }
        else
        {
            pGpio->BRR = pull_val;    //pull-down
        }
    }

    if (pin == B_HAL_PINAll)
    {
        pGpio->CRL = dir_val;
        pGpio->CRH = dir_val;
    }
    else
    {
        if (pin < B_HAL_PIN8)
        {
            pGpio->CRL &= ~(0x0000000F << (pin * 4));
            pGpio->CRL |= (dir_val << (pin * 4));
        }
        else
        {
            pGpio->CRH &= ~(0x0000000F << (pin * 4));
            pGpio->CRH |= (dir_val << (pin * 4));
        }
    }
}

 可以看到主要是通过逻辑判断操做 CRL,CRH,BSRR,BRR寄存器;

更直观的表格

通过上面表格可以看到,dir_val 变量赋值给CRL,CRH,配置port 对应的16个pin;

IO为输出属性时,配置的固定为最大时钟50MHZ输出;

这里,作者在IO操作上进行了精简,输入,输出;浮空,上拉,下拉

typedef enum
{
    B_HAL_GPIO_INPUT,
    B_HAL_GPIO_OUTPUT,
    B_HAL_GPIO_DIR_INVALID,
} bHalGPIODir_t;

typedef enum
{
    B_HAL_GPIO_NOPULL,
    B_HAL_GPIO_PULLUP,
    B_HAL_GPIO_PULLDOWN,
    B_HAL_GPIO_PULL_INVALID,
} bHalGPIOPull_t;

 备注:需要注意的是,在输出上/下拉的时候与PxODR register 没关系,在输入上/下拉的时候会受到PxODR register 值影响,上面代码中,使用的实现是通过BSRR与BRR,并没有直接去操作ODR寄存器。

        if (pull == B_HAL_GPIO_PULLUP)
        {
            pGpio->BSRR = pull_val;
        }
        else
        {
            pGpio->BRR = pull_val;
        }

STM32G030

#define GPIO_REG_OFF (0x400UL)
#define GPIO_REG_BASE (0x50000000UL)

typedef struct
{
    volatile uint32_t MODE;
    volatile uint32_t OTYPE;
    volatile uint32_t OSPEED;
    volatile uint32_t PUPDR;
    volatile uint32_t IDR;
    volatile uint32_t ODR;
    volatile uint32_t BSRR;
    volatile uint32_t LCKR;
    volatile uint32_t AFRL;
    volatile uint32_t AFRH;
    volatile uint32_t BRR;
} McuGpioReg_t;

void bMcuGpioConfig(bHalGPIOPort_t port, bHalGPIOPin_t pin, bHalGPIODir_t dir, bHalGPIOPull_t pull)
{
    uint32_t      mode_val   = 0;
    uint32_t      otype_val  = 0;
    uint32_t      ospeed_val = 3;
    uint32_t      pupd_val   = 0;
    McuGpioReg_t *pGpio      = (McuGpioReg_t *)(GPIO_REG_BASE + port * GPIO_REG_OFF);

    if (!B_HAL_GPIO_ISVALID(port, pin))
    {
        return;
    }

    if (dir == B_HAL_GPIO_OUTPUT)
    {
        mode_val   = (pin == B_HAL_PINAll) ? 0x55555555 : 1;
        otype_val  = (pin == B_HAL_PINAll) ? 0x00000000 : 0;
        ospeed_val = (pin == B_HAL_PINAll) ? 0xffffffff : 3;
        pupd_val   = (pin == B_HAL_PINAll) ? 0x00000000 : 0;
    }

    if (pull != B_HAL_GPIO_NOPULL)
    {
        if (pull == B_HAL_GPIO_PULLUP)
        {
            pupd_val = (pin == B_HAL_PINAll) ? 0x55555555 : 1;
        }
        else
        {
            pupd_val = (pin == B_HAL_PINAll) ? 0xAAAAAAAA : 2;
        }
    }

    if (pin == B_HAL_PINAll)
    {
        pGpio->MODE   = mode_val;
        pGpio->OTYPE  = otype_val;
        pGpio->OSPEED = ospeed_val;
        pGpio->PUPDR  = pupd_val;
    }
    else
    {
        pGpio->MODE &= ~(0x00000003 << (pin * 2));
        pGpio->MODE |= (mode_val << (pin * 2));
        pGpio->OTYPE &= ~(0x00000001 << (pin * 1));
        pGpio->OTYPE |= (otype_val << (pin * 1));
        pGpio->OSPEED &= ~(0x00000003 << (pin * 2));
        pGpio->OSPEED |= (ospeed_val << (pin * 2));
        pGpio->PUPDR &= ~(0x00000003 << (pin * 2));
        pGpio->PUPDR |= (pupd_val << (pin * 2));
    }
}

解释

入口参数可以配置:

输入输出方向

没上拉,上拉,下拉

对照表:Table 29. Port bit configuration table 很容易理解。

otype_val = 0,这里牺牲了IO的开漏输出特性。因为入口参数的限制,这里只能选择一种推挽/开漏。

B_HAL_PINAll

可以结合6.4.1;6.4.2 看出寄存器存放书序。即可理解。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值