本帖最后由 zc123 于 2019-6-4 09:24 编辑

虽然我也讨厌HAL库的雍肿，效率低，但你这是实现stm32f10x.h这个头文件的在封装而已，HAL库实现的是接口API和软件逻辑，这才是主要功能，类似USART，RCC，ETH模块，它是实现初始化，读写接口的，中断响应，状态读取/清除这整套API应用的，你的封装思路是没有这部分逻辑的，其实你的思路和寄存器操作一样的，库和寄存器的使用这方面争论已经持续很久，我是认为没比较的理由，因为设计的目的都不一样，库是为了脱离硬件的封装，寄存器则为了更高的效率，没有任何可比性。
你的优势就是和直接的寄存器操作的比较，大部分情况比直接包含stm32f10x.h更直观。但是实际上按照你的API，脱离寄存器文档是不可能，因为涉及位的操作，特别是多位的操作，不去查文档，单靠命名并不能完全解决问题，我的建议是需要先理清楚这个是否是伪需求，不然花了大量时间并不值得，而且这里面大部分是替换的工作量，核心的就位操作或者位域的知识。

本帖最后由 warship 于 2019-6-3 12:36 编辑

总体说明：

    利用本文件，可以比较方便、高效精准地以位段方式访问寄存器，结合多BIT访问、寄存器直接访问等方式，能够最终完全抛开库函数。

     一、以外设原有名称为基础，在外设名称前面加前缀b, 与库函数区分的同时，指示这用作bitband操作。

     二、进一步强化助记，将部分具体寄存器名称弱化,比如某外设有多个控制寄存器CR1、CR2、CR3，则统一省略为CR，不必记忆是第几个CR。
尝试对于常用的外设如RCC，进一步根据功能进行了改造，比如将所有使能时钟控制归纳成bRCC_ENABLE_XXX（其中XXX为外设名），
便于记忆，不用再考虑某外设挂在哪条具体总线上等细节，相当于进行了一个小小的二次封装。

     三、BIT位的名称尽量采用原名称，以便对照查阅芯片数据手册。寄存器地址偏移量按一般用户手册以十六进制填充。

     四、考虑到位操作的优势在精准高效地对位进行操作，这也是编写此文件的出发点。但考虑到两位以上的组合操作也无法避免，
并且直接访问寄存器某几位也比较麻烦, 这里采用带参的宏定义制定了统一的访问格式.

     五、对于一般没有位定义、通常整字访问的寄存器，仍可沿用传统的寄存器方式，这里也尝试定义了形如wBKP_DR1的宏指令方式对其进行访问，
即：wRTC_ALRH的效果等同于寄存器直接访问的RTC->ALRH；
而对于有多个同类外设时，对于外设某寄存器整体的读写，则引入类似如下的宏定义，
                        pTIM(bTIM3)->PSC        前缀“p”表示这是一个指向结构体的指针，等效于寄存器直接访问的TIM3->DR1
但引入带参宏定义的好处是，实现了与访问多组外设单BIT位或多BIT位时形参的统一，便于移植（详见6楼的描述）

本帖最后由 warship 于 2019-6-3 12:34 编辑

编程使用的统一格式
单BIT位访问方式：
                bRCC_ENABLE_RTC=1或0;                                                                                    //唯一外设
                bTIM_CR_DIR（bTIM2)=1或0;                                                                             //多组外设
                bGPIO_BRR(bGPIOA,n)=1或0;                                                                              //多组外设多个端口
                也可读，或者用于逻辑判断，EX：if(!bRCC_ENABLE_RTC)

多BIT位访问方式：
                SET_RCC_PLLMUL(a);(设置PLL倍频值为a)                    写                                      //唯一外设
                val=GET_RCC_PLLMUL;(获取PLL倍频设置值)                读

                SET_SPI_CR_BR(bSPI2,a);        (设置bSPI2接口的速率值为a)        写                        //多组外设
                val=GET_SPI_CR_BR(bSPI1);(获取bSPI1x接口的速率值)               读

寄存器整体访问方式：
              一般仍沿用寄存器直接访问方式不变：如BKP->DR1

本帖最后由 warship 于 2019-6-3 12:30 编辑

简化宏定义、便于代码移植   
     为减少宏定义的工作量，对于多个同类的外设，尤其是两个以上，如定时器、通信串口等，避免大量类似的宏定义
使用带参数的宏，形如bCR_CEN(bTIM1),其中bTIM1为基址宏

以b开头的基址宏定义（如bTIM1）的值，其原始本质就是一个u32的数值，所以
当有需要，想将它也作为一个可变参数时，可以定义形参的类型为u32
比如：想写一个设置任意SPI接口速率的函数
可编写如下函数：
        void SET_SPIx_SPEED(u32 MySPIx_Base, u8 SPI_SPEED)
        {
                SET_SPI_CR_BR(MySPIx_Base,SPI_SPEED);//设置SPI速率
        }
        调用时，入口参数MySPIx_Base分别使用bSPI1、bSPI2或bSPI3就可作用于不同的SPI口
   另外，在编程需要时，可用
((SPI_TypeDef *)MySPIx_Base)->DR; 取代SPIx->DR;
((SPI_TypeDef *)bSPI1)->DR;                          取代SPI1->DR;

在进一步地增加了宏定义 #define pSPI(bSPIx)                                ((SPI_TypeDef *)bSPIx)
之后，使得上两句可简写为：pSPI(bSPI1)->DR; //前缀“p”表示这是一个指向结构体的指针。
接近了寄存器编程的风格，也就是说，对于寄存器整体的访问，
除了仍可沿用原有的SPI1->DR外，也可以使用带参的宏定义方式：pSPI(bSPI1)->DR
使用者可以视情任意选择其一，但使用后者的好处是使得bSPIx成了与单BIT、多BIT访问时统一的参数，便于移植
比如：下列函数即向串口发送一个字符，如果移植时，只须替换bURT1为bURT2就可以从串口1改成串口2
void USART_SendData(u8 ch)
{
  pURT(bURT1)->DR  = ch ;
  while ( bURT_SR_TXE(bURT1) ==0 );
}
对比一下，如果第一句仍沿用传统的寄存器访问风格，则移植的时候就需要修改两种符号：
void USART_SendData(u8 ch)
{
  USART1->DR  = ch ;
  while ( bURT_SR_TXE(bURT1) ==0 );
}
后者比前者需要增加的工作量：还须将USART1改成USART2
而且，前者还可以很容易地写成向任意串口发送字符的通用函数：
void USART_SendData(u32 bURTx, u8 ch)
{
  pURT(bURTx)->DR  = ch ;
  while ( bURT_SR_TXE(bURTx) ==0 );
}