难道写单片机寄存器头文件很难吗强迫症的你是不是也自己写(不用官方的头文件自己定义头文件统一规范一般写单片机程序还都是要看寄存器用户手册的)

     (不用官方的头文件自己定义头文件统一规范一般写单片机程序还都是要看寄存器用户手册的)

做单片机开发久了，发现用的单片机也多，现在每个厂家都提供对应的库以方便加快客户的开发。但是总是有那么一些人，不习惯用官方的库，因为厂家太多，每家写代码的规范都不一样，A厂的单片机是一个规范，B厂的单片机可能又是一个规范，C厂的又会是其他的规范，这样看起来就有点头大了。对于我们这种习惯了使用寄存器开发的老鸟，我有时候就干脆不用官方的头文件，自己定义头文件，统一规范。又由于一般写单片机程序还都是要看寄存器用户手册的，于是干脆自己动手写头文件吧，而且我发现自己定义寄存器相关头文件，可以更加深刻的了解单片机。

下面以MM32L0xx系列单片机的UART模块为例进行介绍。

首先我们根据寄存器用户手册的UART模块的寄存器概况，定义一个UART类型struct UartType，然后定义好模块访问指针pstUart1和pstUart1 如下：

MM32L0xx系列单片机UART寄存器概览

/**MM32L0xx串口硬件寄存器定义*/struct UartType{ __IO uint32_t vuiTdr; __I uint32_t vuiRdr; __I uint32_t vuiCsr; __I uint32_t vuiIsr; __IO uint32_t vuiIer; __O uint32_t vuiIcr; __IO uint32_t vuiGcr; __IO uint32_t vuiCcr; __IO uint32_t vuiBrr; __IO uint32_t vuiFra;// __IO uint32_t vuiRxAddr;// __IO uint32_t vuiRxMask;// __IO uint32_t vuiScr;};/** 操作MM32L0xx串口硬件的指针*/#define pstUart1 ((struct UartType *) DE_Uart1BaseAddress)#define pstUart2 ((struct UartType *) DE_Uart2BaseAddress)

UART模块类型定义

结构体里的vuiTdr就对应手册里的UART发送寄存器UART_TDR，我这里有个习惯就是，寄存器的相关定义我都在变量名前面加字母v,阅读代码的时候就可以很清楚的知道这是一个寄存器。然后后面的ui表示unsigned int,用来表示这是一个32位宽的变量。后面跟的Tdr就是表示寄存器UART_TDR了，我这里是习惯将首字母大写。这也是我的一个习惯，寄存器名首字母大写，查看的时候可以很清楚的知道是什么寄存器，寄存器名前面的vui指出了这是一个32位的寄存器。这样看一个变量名就可以很清楚的知道这个变量的相关属性和含义。

后面再根据实际的寄存器中的位，写出对应位的宏定义，这里以UART通用控制寄存器（UART_CCR）为例进行介绍。

MM32L0xx系列单片机UART通用控制寄存器（UART_CCR）

首先我们看校验使能位PEN，我们可以做这样的定义#define DE_UartCcrPen (1ul)，这里又来介绍我的一个习惯，我习惯宏定义的时候在其前面加DE_前缀来表明这是一个宏定义，这个也是方便在查阅代码的时候一眼就发现这是一个宏，对于一个很久之前写的代码做修改，通常只要看到宏的地方肯定是可以修改的地方。DE_后面跟着Uart表示这是一个和UART串口相关的宏定义，后面的Ccr就表示这是UART的通用控制寄存器UART_CCR,再后面的Pen，就表示手册里的校验使能位PEN。最后的（1ul）表示这个位在位0的位置，加ul表示这个位是一个32位寄存器中的位，当然这里也可以写成（1ul<<0）。同样的写法定义好其他位的宏定义如下：

/** MM32L0xx串口通用控制寄存器位定义*/#define DE_UartCcrPen (1ul)#define DE_UartCcrPsel (1ul << 1)#define DE_UartCcrSpb (1ul << 2)#define DE_UartCcrBrk (1ul << 3)#define DE_UartCcrChar (3ul << 4)

UART的通用控制寄存器UART_CCR字段位定义

这里再说下这个CHAR字段，这个字段表示了UART的数据位宽，占了2个位，这样我们就可以写成(3ul << 4)。对于这种，我们可以配置这2位来指定串口的数据位是5位还是6位，或者7位，8位。这样就相当于一个配置参数，我们怎么配置呢。请看下面：

/** 串口数据位宽配置参数*/#define DE_UartCcrChar5Bit (0ul)#define DE_UartCcrChar6Bit (1ul << 4)#define DE_UartCcrChar7Bit (2ul << 4)#define DE_UartCcrChar8Bit (3ul << 4)

串口数据位宽配置参数定义

看到上面的定义是不是很一目了然。

那么串口用的时候怎么用呢，我就实现了下面的串口配置的方法：

/**  * @brief  串口配置并使能,先打开串口时钟，复位串口后再配置  * @note   要先配置好使用串口的引脚复用，再调用此函数初始化配置串口，串口才能正常使用,在没有复用串口引脚前，串口引脚数据会乱码  * @param  [in] pstUart 要初始化的串口对应的硬件地址指针  * @arg    pstUart1, pstUart2  * @param  [in] uiBaudRate 要配置的波特率(分配置整数和小数部分)  * @param  [in] ucDataBits 要配置的数据位  * @arg    DE_UartCcrChar5Bit, DE_UartCcrChar6Bit, DE_UartCcrChar7Bit, DE_UartCcrChar8Bit  * @param  [in] ucStopBits 要配置的停止位  * @arg    DE_UartCcrSpb1Bit, DE_UartCcrSpb2Bit  * @param  [in] ucParity 要配置的校验  * @arg    DE_UartCcrPenNone, DE_UartCcrPenOdd, DE_UartCcrPenEven  * @param  [in] uiMode 要配置的串口模式,可以是可选参数的或组合  * @arg    DE_UartGcrDmamode, DE_UartGcrRxen, DE_UartGcrTxen  * @param  [in] ucFlowControl 要配置的硬件流控  * @arg    DE_UartGcrAutoflowerDisable, DE_UartGcrAutoflowerEnable  * @retval None  */void vUartConfig(struct UartType * pstUart,uint32_t uiBaudRate,uint32_t uiDataBits,\	uint32_t uiStopBits,uint32_t uiParity,uint32_t uiMode,uint32_t uiFlowControl)；

串口配置函数功能使用说明

这里的函数功能使用说明是参考Doxygen注释规范来写的，可以通过软件自动生成帮助手册。然后针对对应的参数，我还加入了可选参数列表到注释中。比如我们要使用串口1进行波特率为115200bps,8位数据位，一个停止位，无校验位，无流控的配置，可以调用下面的代码。

vUartConfig(pstUart1,(uint32_t)115200ul,DE_UartCcrChar8Bit,DE_UartCcrSpb1Bit,DE_UartCcrPenNone,(DE_UartGcrRxen | DE_UartGcrTxen),DE_UartGcrAutoflowerDisable);

看这个代码就可以很清楚的知道串口的配置，这里函数前加的v表示void，表示这个函数是一个无返回数据类型的一个函数。

下面是我个使用规范的一些示例，仅供参考：

变量定义示例：char cName = 'a’;int iNum = 0;short sNum = 0;long lNum = 0;unsigned char ucCode = 0xff;unsigned int uiLength = 66666;unsigned short usLength = 300;unsigned long ulLength = 7777777;char * pcName = 0;int * piNum = 0;short * psNum = 0;long * plNum = 0;unsigned char * pucCode = 0;unsigned int * puiLength = 0;unsigned short * pusLength = 0;unsigned long * pulLength = 0;const char ccName = 'a’;const int ciNum = 0;const short csNum = 0;const long clNum = 0;const unsigned char cucCode = 0xff;const unsigned int cuiLength = 66666;const unsigned short cusLength = 300;const unsigned long culLength = 7777777;const char * cpcName = 0;const int * cpiNum = 0;const short * cpsNum = 0;const long * cplNum = 0;const unsigned char * cpucCode = 0;const unsigned int * cpuiLength = 0;const unsigned short * cpusLength = 0;const unsigned long * cpulLength = 0;char * const pccName = 0;int * const picNum = 0;short * const pscNum = 0;long * const plcNum = 0;unsigned char * const puccCode = 0;unsigned int * const puicLength = 0;unsigned short * const puscLength = 0;unsigned long * const pulcLength = 0;宏定义示例，所有宏定义前面加DE_#define DE_PictureWide#define DE_OpenIo()