【代码解析】嵌入式单总线分层架构设计

来源：网络素材

1.前言
onewire(单总线) 是DALLAS公司推出的外围串行扩展总线技术总线，顾名思义，它是采用一根信号线进行通信，既传输时钟信号又传输数据，而且能够进行双向通信，具有节省I/O口线、资源结构简单、成本低廉、便于总线扩展和维护等诸多优点。
常用到单总线的器件，一般是温度传感器、EEPROM、唯一序列号芯片等，如DS18B20、DS2431。
在使用单总线时，往往很少CPU会提供硬件单总线，几乎都是根据单总线标准的时序图，通过普通IO翻转模拟实现单总线。而在模式实现时序图的过程中，需要根据CPU时钟频率等条件进行时序时间计算，如果更换CPU后，需要重新计算时序时间，如果时序代码和器件外设控制代码集成在一起，则代码改动比较大。
或者同一CPU需要模拟多根单总线时，传统的“复制”方式使得程序显得累赘，还增加ROM占用空间。因此，可以利用“函数指针”的方式，将时序部分抽象出来，达到“复用”代码的效果，减少重复代码编写。
2.onewire 抽象
2.1 onewire 结构体
onewire结构体主要是对与CPU底层相关的操作抽象分离，调用时只需将该结构体地址（指针）作为函数入口参数，通过该指针实现对底层函数的回调。该结构体我们命名为“struct ops_onewire_dev”，其原型如下：
structops_onewire_dev
{
void (*set_sdo)(int8_t state);
    uint8_t (*get_sdo)(void);
    void (*delayus)(uint32_t us);
};
其中：1）set_sdo：IO输出1bit，包括时钟和数据。2）get_sdo：IO输入1bit，包括时钟和数据。3）delayus：时序延时函数，根据CPU频率进行计算。
2.2 onewire 对外接口
externuint8_tops_onewire_reset(struct ops_onewire_dev *onewire);
externintops_onewire_read(struct ops_onewire_dev *onewire,void *buff,int size);
externintops_onewire_write(struct ops_onewire_dev *onewire,void *buff,int size);
1）分别为复位函数、读函数、写函数。2）入口首参数为“struct ops_onewire_dev”结构体指针，此部分就是硬件层相关，需要后期初始化的. 3）其余入口参数易于理解，读/写缓存及数据大小。
2.3 onewire 抽象接口实现
分别实现上述三者函数接口。
2.3.1 复位函数
复位函数，在单总线初始化外设器件时需要用到，用于判断总线与器件是否通信上，类似“握手”的动作。如图，为DS18B20的复位时序图，以下与单总线相关的时序图，都是以DS18B20为例，因为此芯片为单总线应用的经典。
根据时序图，实现复位函数。
/**
  * @brief  单总线复位时序
  * @param  onewire 总线结构体指针
  * @retval 成功返回0
*/
uint8_tops_onewire_reset(struct ops_onewire_dev *onewire)
{
uint8_t ret = 0;

 onewire->set_sdo(1);
 onewire->delayus(50);
 onewire->set_sdo(0);
 onewire->delayus(500);
 onewire->set_sdo(1);
 onewire->delayus(40);
 ret = onewire->get_sdo();
 onewire->delayus(500);
 onewire->set_sdo(1);
return ret;
}
2.3.2 读函数
读函数即以该函数，通过单总线从外设上读取数据，至于代码的实现，完全是时序图的实现，无特殊难点。先实现单字节读函数，再通过调用单字节读函数实现多字节读函数。
/**
  * @brief  单总线读取一字节数据
  * @param  onewire 总线结构体指针
  * @retval 返回读取的数据
*/
staticcharops_onewire_read_byte(struct ops_onewire_dev *onewire)
{
char data = 0;
uint8_t i;

for(i=8;i>0;i--)
 {
  data >>= 1;
  onewire->set_sdo(0);
  onewire->delayus(5);
  onewire->set_sdo(1);
  onewire->delayus(5);
if(onewire->get_sdo())
   data |= 0x80;
else
   data &= 0x7f;
  onewire->delayus(65);
  onewire->set_sdo(1);
 }
return data;
}

/**
  * @brief  读取多字节
  * @param  onewire 总线结构体指针
  * @param  buff 存放数据缓存
  * @param  size 数据大小
  * @retval 返回读取到的数据大小
*/
intops_onewire_read(struct ops_onewire_dev *onewire,void *buff,int size)
{
int i;
char *p = (char*)buff; 
for(i=0;i
  p[i++]=ops_onewire_read_byte(onewire);
return i;
}
2.3.3 写函数
写函数与读函数同理，即以该函数，通过单总线往外设写入数据，至于代码的实现，完全是时序图的实现，无特殊难点。先实现单字节写函数，再通过调用单字节写函数实现多字节写函数。
/**
  * @brief  单总线写一字节
  * @param  onewire 总线结构体指针
  * @param  data 待写数据
  * @retval 返回读取的数据
*/
staticintops_onewire_write_byte(struct ops_onewire_dev *onewire,char data)
{
uint8_t i;

for(i=8;i>0;i--)
 {
  onewire->set_sdo(0);
  onewire->delayus(5);
if(data&0x01)
   onewire->set_sdo(1);
else
   onewire->set_sdo(0);
  onewire->delayus(65);
  onewire->set_sdo(1);
  onewire->delayus(2);
  data >>= 1;
 }
return0;
}

/**
  * @brief  写多字节
  * @param  onewire 总线结构体指针
  * @param  buff 代写数据地址
  * @param  size 数据大小
  * @retval 写入数据大小
*/
intops_onewire_write(struct ops_onewire_dev *onewire,void *buff,int size)
{
int i;
char *p = (char*)buff;
for(i=0;i
 {
if(ops_onewire_write_byte(onewire,p[i]) != 0)
break;
 }
return i;
}
至此，onewire（单总线）抽象化完成，此部分代码与硬件层分离，亦可单独作为一个模块，移植到不同平台CPU时，也几乎无需改动。剩下部分工作则是实现“struct ops_onewire_dev”中的函数指针原型，即可使用一根单总线。
3.onewire 抽象应用
以STM32F1为例，实现上述抽象接口。
3.1 “struct ops_onewire_dev” 实现
此部分即是与硬件相关部分，不同CPU平台改动该部分即可，如从51单片机移植到STM32上。下面涉及到的IO宏，是对应IO的宏定义，如“ONEWIRE1_PORT”、“ONEWIRE1_PIN”，实际使用的是PC13 IO口。
3.1.1 IO输出
staticvoidgpio_set_sdo(int8_t state)
{
    if (state)
  GPIO_SetBits(ONEWIRE1_PORT,ONEWIRE1_PIN); 
    else
  GPIO_ResetBits(ONEWIRE1_PORT,ONEWIRE1_PIN); 
}
3.1.2 IO输入
staticuint8_tgpio_get_sdo(void)
{
    return (GPIO_ReadInputDataBit(ONEWIRE1_PORT,ONEWIRE1_PIN));
}
3.1.3 延时函数
staticvoidgpio_delayus(uint32_t us)
{
#if 1  /* 不用系统延时时，开启 */
    volatileint32_t i;

    for (; us > 0; us--)
    {
     i = 30;  //mini 17
        while(i--);
    }
#else
  delayus(us);
#endif
}
3.1 onewire 总线初始化
3.1.1 onewire 抽象相关
第一步：定义一个“struct ops_onewire_dev”结构体类型变量（全局）——onewire1_dev。
structops_onewire_devonewire1_dev;
第二步：实例化“onewire1_dev”中的函数指针。
onewire1_dev.get_sdo = gpio_get_sdo;
onewire1_dev.set_sdo = gpio_set_sdo;
onewire1_dev.delayus = gpio_delayus;
第三步：使用时，通过传入“onewire1_dev”地址（指针）即可。
3.1.2 onewire 基础相关
初始基础部分，与使用的CPU硬件相关，如时钟、IO方向等。
/**
  * @brief  初始化单总线
  * @param  none
  * @retval none
*/
voidstm32f1xx_onewire1_init(void)
{
 GPIO_InitTypeDef GPIO_InitStructure;          
 RCC_APB2PeriphClockCmd(ONEWIRE1_RCC,ENABLE);  

 GPIO_InitStructure.GPIO_Pin = ONEWIRE1_PIN;
   GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_OD;
   GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;      
   GPIO_Init(ONEWIRE1_PORT, &GPIO_InitStructure);             
 ONEWIRE1_PORT->BSRR = ONEWIRE1_PIN;      

/* device init */
 onewire1_dev.get_sdo = gpio_get_sdo;
 onewire1_dev.set_sdo = gpio_set_sdo;
 onewire1_dev.delayus = gpio_delayus;
}
4.onewire 使用
经过前面的步骤后，我们已经通过IO口翻转，模拟实现了一根单总线——“onewire1_dev”，以DS18B20为例，调用第一部分中三者接口，实现对DS18B20的操作。
4.1 DS18B20操作
对于DS18B20，不陌生，即是温度传感器，不多赘述，使用的功能主要是作为温度检测，另外还有其内部的唯一序列号会作为同一总线上挂多个DS18B20时的“地址”识别。亦可把DS18B20的唯一序列号作为模块、产品、通信总线等的唯一标识使用。因此，代码也是主要实现这两个功能。
#include"onewire_hw.h"
#include"ds18b20.h"

staticuint8_tds18b20_start(void)
{    
char reg;
    ops_onewire_reset(&onewire1_dev);     
      
 reg = 0xcc; /* 跳过ROM */
 ops_onewire_write(&onewire1_dev,®,1);
 reg = 0x44; /* 温度转换指令 */
 ops_onewire_write(&onewire1_dev,®,1);        
return0;
}

/**
  * @brief  读取温度
  * @param  none
  * @retval 温度值，浮点型
*/
floatds18b20_readtemp(void)
{
    uint8_t  tl,th,sign;
uint16_t reg_temp; 
char reg;
float temp;

 ds18b20_start();
 ops_onewire_reset(&onewire1_dev); 
 reg = 0xcc;
 ops_onewire_write(&onewire1_dev,®,1); /* 跳过ROM */
 reg = 0xbe;
 ops_onewire_write(&onewire1_dev,®,1); /* 读取RAM */
 ops_onewire_read(&onewire1_dev,&tl,1);  /* 低8位数据 */
 ops_onewire_read(&onewire1_dev,&th,1);   /* 高8位数据 */
if(th > 7)
 {/* - */
  th = ~th;
  tl = ~tl + 1; 
  sign = 0;             
 }
else
 {/* + */
  sign = 1;   
 }  
 reg_temp = (th<<8) | tl;
 temp = reg_temp * 0.0625f; 
if(sign)
 {
return temp;       
 }
else
 {
return -temp;   
 }
}

/**
  * @brief  读唯一序列号
  * @param  rom 返回序列号缓存
  * @retval none
*/
voidds18b20_readrom(char *rom)
{
uint8_t i;
char reg;

 ops_onewire_reset(&onewire1_dev);
 reg = 0x33;
 ops_onewire_write(&onewire1_dev,®,1);
for (i = 0;i < 8;i++)
 {
  ops_onewire_read(&onewire1_dev,&rom[i],1);  
 } 
}
至此，完成单总线的抽象分层使用。
5.源码
https://github.com/Prry/drivers-for-mcu

版权声明：本文来源网络，免费传达知识，版权归原作者所有。如涉及作品版权问题，请联系我进行删除。

‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧  END  ‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧
关注我的微信公众号，回复“星球”加入知识星球，有问必答。

点击“阅读原文”查看知识星球详情，欢迎点分享、收藏、点赞、在看。