外设驱动库开发笔记14：DS18B20温度变送器驱动

　　在一时候我们需要相对简单的检测温度信号，而DS18B20就是一款功能和应用都相对简单的温度传感器，通过单线就可以实现检测温度信号的需求。这一篇我们就来实现操作DS18B20获取温度数据的驱动。

1、功能概述

　　DS18B20是常用的数字温度传感器，其输出的是数字信号，具有体积小，硬件开销低，抗干扰能力强，精度高的特点。单总线数字式温度传感器，由于具有结构简单，不需要外接电路，可用一根I/O数据线既供电又传输数据，可由用户设置温度报警界限等特点，近年来广泛用于粮库等需要测量和控制温度的地方。

1.1、硬件描述

　　DS18B20数字温度传感器提供9-12位摄氏度温度测量数据，可编程非易失存储器设置温度监测的上限和下限，提供温度报警。器件可以工作在-55°C至+125°C范围，在-10°C至+85°C范围内测量精度为±0.5°C。此外，DS18B20还可以直接利用数据线供电 (寄生供电)，无需外部电源。DS18B20数字温度传感器提供有三种封装，其引脚定义分别如下表所示：

　　DS18B20数字温湿度传感器有一个64位ROM存储器，用于存储设备唯一的串行代码。暂存存储器包含2字节的温度寄存器，该寄存器存储温度传感器的数字输出。此外，暂存存储器提供对1字节的上、下报警触发寄存器(TH和TL)和1字节配置寄存器的访问。DS18B20数字温湿度传感器的功能框图如下图所示：

　　配置寄存器允许用户将温度-数字转换的分辨率设置为9、10、11或12位。TH、TL和配置寄存器是非易失性的(EEPROM)，因此它们将在设备断电时保留数据。

1.2、数据通讯

　　DS18B20通过1-Wire总线通信，只需要一条数据线 (和地线) 即可与处理器进行数据传输。每个DS18B20具有唯一的64位序列号，从而允许多个DS18B20挂接在同一条1-Wire总线。可以方便地采用一个微处理器控制多个分布在较大区域的DS18B20。该功能非常适合HVAC环境控制、楼宇、大型设备、机器、过程监测与控制系统内部的温度测量等应用。

　　DS18B20传感器进行的功能操作是在发送命令的基础上完成的，上电后传感器处于空闲状态，需要控制器发送命令才能完成温度转换。访问DS18B20温度传感器需要按照固定的顺序操作：

　　步骤1、初始化通讯

　　步骤2、操作ROM命令(后面跟着任何需要的数据交换)

　　步骤3、DS18B20功能命令(后面跟着任何需要的数据交换)

　　每次访问DS18B20时，遵循这个序列是非常重要的，因为如果序列中的任何步骤丢失或顺序混乱，DS18B20将不会响应。这个规则的例外是搜索ROM [F0h]和警报搜索[ECh]命令。发出这两个ROM命令后，主机必须按顺序返回步骤1。

1.2.1、通讯初始化

　　在单线总线上的所有事务都以初始化序列开始。初始化序列包括由总线主发送的复位脉冲和从服务器发送的存在脉冲。存在脉冲让总线主人知道从设备(例如DS18B20)在总线上并且准备好操作。复位和存在脉冲的时间在单线信号部分有详细说明。

1.2.2、ROM操作

　　对传感器的功能操作的次序是首先完成对芯片内部的ROM操作，有5条操作ROM的指令可用于器件识别，它们分别是：ReadROM（33H）、Match ROM（55H）、Skip ROM（CCH）、SearchROM（F0H）、Alarm Search（ECH）。具体描述如下表所示：

1.2.3、功能操作

　　实现DS18B20温度传感器操作，需在发送ROM指令之后发送功能指令。DS18B20温度传感器共有6条功能指令，分别是：温度转换指令（44H）、读暂存器指令（BEH）、写暂存器指令（4EH）、复制暂存器指令（48H）、重调EEPROM指令（B8H）、读电源供电方式指令（B4H）。具体描述见下表所示：

2、驱动设计与实现

　　我们已经了解了DS18B20温度传感器的基本情况和数据通讯的相关信息。接下来我们将基于此设计并实现DS18B20温度传感器的驱动程序。

2.1、对象定义

　　我们依然采用基于对象操作的方式来实现，在使用一个对象之前我们需要获得这个对象。同样的我们想要基于对象操作DS18B20温度传感器就需要先定义DS18B20温度传感器的对象。

2.1.1、对象的抽象

　　我们要得到DS18B20温度传感器对象，需要先分析其基本特性。一般来说，一个对象至少包含两方面的特性：属性与操作。接下来我们就来从这两个方面思考一下DS18B20温度传感器的对象。

　　先来考虑属性，作为属性肯定是用于标识或记录对象特征的东西。我们来考虑DS18B20温度传感器对象属性。每一个DS18B20温度传感器都有一个序列号，在总线上有多个DS18B20温度传感器时，是区别设备的唯一标识，所以我们将序列号作为属性。同时温度数据表示了DS18B20温度传感器当前的工作状态，所以我们也将其作为属性。

　　接着我们还需要考虑DS18B20温度传感器对象的操作问题。我们知道DS18B20温度传感器采用的是单总线通讯，既然是单总线就需要控制总线的输入输出方向，而且这对这条总线在不同的输入输出方向，我们需要读数据和写数据，而这些操作都依赖于硬件平台，所以我们将它们定义为DS18B20温度传感器对象的操作。处于时序控制的需要，我们需要延时操作函数，而在不同的软硬件平台延时操作会有差异，我们也将其作为对象的操作。

　　根据上述我们对DS18B20温度传感器的分析，我们可以定义DS18B20温度传感器的对象类型如下：

1 /* 定义DS18B20对象类型 */
2 typedef struct Ds18b20Object {
3 Uint8_t sn[6]; //Ds18b20元件序列号
4 float temperature; //温度数据
5 void (*SetBit)(Ds18b20PinValueType vBit);//写数据位到DS18B20
6 uint8_t (*GetBit)(void);//从DS18B20读取一位数据
7 void (*SetPinMode)(Ds18b20IOModeType mode);//设置DS18B20的数据引脚的输入输出模式
8 void (*Delayus)(volatile uint32_t nTime);       //延时us操作指针
9 }Ds18b20ObjectType;

2.1.2、对象初始化

　　我们知道，一个对象仅作声明是不能使用的，我们需要先对其进行初始化，所以这里我们来考虑DS18B20温度传感器对象的初始化函数。一般来说，初始化函数需要处理几个方面的问题。一是检查输入参数是否合理；二是为对象的属性赋初值；三是对对象作必要的初始化配置。据此我们设计DS18B20温度传感器对象的初始化函数如下：

 1 /*对DS18B20操作进行初始化*/
 2 Ds18b20StatusType Ds18b20Initialization(Ds18b20ObjectType *ds18b20，
 3 Ds18b20SetBitType setBit，
 4 Ds18b20GetBitType getBit，
 5 Ds18b20SetPinModeType pinDirection，
 6 Ds18b20DelayType delayus)
 7 {
 8   if((ds18b20==NULL)||(setBit==NULL)||(getBit==NULL)||(delayus==NULL))
 9   {
10     return DS18B20_InitialError;
11   }
12  
13   ds18b20->SetBit=setBit;
14   ds18b20->GetBit=getBit;
15   ds18b20->Delayus=delayus;
16  
17   if(pinDirection==NULL)
18   {
19     ds18b20->SetPinMode=SetPinModeDefault;
20   }
21   else
22   {
23     ds18b20->SetPinMode=pinDirection;
24   }
25  
26   ds18b20->temperature=0.0;
27  
28   ResetDs18b20(ds18b20);
29   if(PresenceDs18b20(ds18b20))
30   {
31     return DS18B20_NoResponse;
32   }
33  
34   GetDs18b20SerialNumber(ds18b20);
35  
36   return DS18B20_OK;
37 }

2.2、对象操作

　　我们已经完成了DS18B20温度传感器对象类型的定义和对象初始化函数的设计。得到对象并非我们的目标，我们的主要目标是获取对象的数据，接下来我们还要实现面向DS18B20温度传感器的各类操作。

2.2.1、初始化通讯

　　在单线总线上的所有事务都以初始化序列开始。初始化序列包括由主机发送的复位脉冲和从从设备（如DS18B20）发送的存在脉冲。存在脉冲让总线主机知道从设备(例如DS18B20)在总线上并且准备好操作。复位和存在脉冲的操作时序如下图：

　　其操作过程描述如下：

　　（1）先将数据线置高电平“1”。

　　（2）延时（该时间要求的不是很严格，但是尽可能的短一点）

　　（3）数据线拉到低电平“0”。

　　（4）延时750微秒（该时间的时间范围可以从480到960微秒）。

　　（5）数据线拉到高电平“1”。

　　（6）延时等待（如果初始化成功则在15到60微秒时间之内产生一个由DS18B20所返回的低电平“0”。据该状态可以来确定它的存在，但是应注意不能无限的进行等待，不然会使程序进入死循环，所以要进行超时控制）。

　　（7）若CPU读到了数据线上的低电平“0”后，还要做延时，其延时的时间从发出的高电平算起（第（5）步的时间算起）最少要480微秒。

　　（8）将数据线再次拉高到高电平“1”后结束。

 1 /*主机给从机发送复位脉冲*/
 2 static void ResetDs18b20(Ds18b20ObjectType *ds18b20)
 3 {
 4   /* 主机设置为推挽输出*/
 5   ds18b20->SetPinMode(DS18B20_Out);
 6   /* 主机至少产生480us 的低电平复位信号*/
 7   ds18b20->SetBit(DS18B20_Reset);
 8   ds18b20->Delayus(550);
 9   /* 主机在产生复位信号后，需将总线拉高*/
10   ds18b20->SetBit(DS18B20_Set);
11   /*从机接收到主机的复位信号后，会在15~60us 后给主机发一个存在脉冲*/
12   ds18b20->Delayus(15);
13 }
14  
15 /*检测从机给主机返回的存在脉冲 0：成功;1：失败*/
16 static uint8_t PresenceDs18b20(Ds18b20ObjectType *ds18b20)
17 {
18   uint8_t pulse_time = 0;
19   /* 主机设置为上拉输入*/
20   ds18b20->SetPinMode(DS18B20_In);
21  
22   /* 等待存在脉冲的到来，存在脉冲为一个60~240us 的低电平信号*/
23   /*如果存在脉冲没有来则做超时处理，从机接收到主机的复位信号后，会在15~60us 后给主机发一个存在脉冲*/
24   while( ds18b20->GetBit() && pulse_time<100 )
25   {
26     pulse_time++;
27     ds18b20->Delayus(1);
28   }
29   /* 经过100us 后，存在脉冲都还没有到来*/
30   if( pulse_time >=100 )
31     return 1;
32   else
33     pulse_time = 0;
34   /* 存在脉冲到来，且存在的时间不能超过240us*/
35   while(!ds18b20->GetBit() && (pulse_time<240))
36   {
37     pulse_time++;
38     ds18b20->Delayus(1);
39   }
40   if( pulse_time >=240 )
41   {
42     return 1;
43   }
44   else
45   {
46     return 0;
47   }
48 }

2.2.2、写操作

　　主机写DS18B20有两种类型的写时时段：“写1”时间段和“写0”时间段。总线主机使用一个写1时间段来将逻辑1写入DS18B20，而一个写0时间段来将逻辑0写入DS18B20。所有写时段必须至少60µs持续时间与个人之间的最小1µs复苏的时间写插槽。两种类型的写时间段都是由主控器将单线总线拉低来启动的。其操作时序如下图：

　　我们可以总结其操作过程如下：

　　（1）数据线先置低电平“0”。

　　（2）延时确定的时间为15微秒。

　　（3）按从低位到高位的顺序发送字节（一次只发送一位）。

　　（4）延时时间为45微秒。

　　（5）将数据线拉到高电平。

　　（6）重复上（1）到（6）的操作直到所有的字节全部发送完为止。

　　（7）最后将数据线拉高。

 1 /*向DS18B20写一个字节*/
 2 static void WriteByteToDs1820(Ds18b20ObjectType *ds18b20，uint8_t commond)
 3 {
 4   uint8_t i， testb;
 5   
 6   ds18b20->SetPinMode(DS18B20_Out);
 7   
 8   for(i=0; i<8; i++)
 9   {
10     testb = commond&0x01;
11     commond = commond>>1;
12     // 写0和写1的时间至少要大于60us
13     if (testb)
14     {
15       ds18b20->SetBit(DS18B20_Reset);
16       // 1us < 这个延时 < 15us
17       ds18b20->Delayus(10);
18       ds18b20->SetBit(DS18B20_Set);
19       ds18b20->Delayus(45);
20     }
21     else
22     {
23       ds18b20->SetBit(DS18B20_Reset);
24       // 60us < Tx 0 < 120us
25       ds18b20->Delayus(60);
26       ds18b20->SetBit(DS18B20_Set);
27       // 1us < Trec(恢复时间) < 无穷大
28     }
29     ds18b20->Delayus(2);
30   }
31 }

2.2.3、读操作

　　DS18B20只能在主机发出读时段时将数据传输给主机。因此，主控机必须在发出read Scratchpad [BEh]或read Power Supply [B4h]命令后立即生成都时间段，以便DS18B20能够提供所请求的数据。另外，在发出Convert T [44h]或Recall E2 [B8h]命令后，主机可以生成读时间段，以查看操作的状态，具体操作如下列时序图：

　　对上述描述和时序图我们可以得到相关的读操作步骤：

　　（1）将数据线拉高“1”。

　　（2）延时2微秒。

　　（3）将数据线拉低“0”。

　　（4）延时3微秒。

　　（5）将数据线拉高“1”。

　　（6）延时5微秒。

　　（7）读数据线的状态得到1个状态位，并进行数据处理。

　　（8）延时60微秒。

 1 /*从DS18B20读取一个位，返回值：1/0*/
 2 static uint8_t ReadBitFromDs18b20(Ds18b20ObjectType *ds18b20)
 3 {
 4   uint8_t data;
 5   
 6   ds18b20->SetPinMode(DS18B20_Out);
 7   ds18b20->SetBit(DS18B20_Reset);
 8   ds18b20->Delayus(2);
 9   ds18b20->SetBit(DS18B20_Set);
10   ds18b20->SetPinMode(DS18B20_In);
11   ds18b20->Delayus(12);
12   data=ds18b20->GetBit();
13   ds18b20->Delayus(50);
14   return data;
15 }

3、驱动的使用

　　我们已经设计并实现了DS18B20温度传感器的驱动程序。我们还需要基于这一驱动程序设计一个简单的应用来验证其是否正确。

3.1、声明并初始化对象

　　使用基于对象的操作我们需要先得到这个对象，所以我们先要使用前面定义的DS18B20温度传感器对象类型声明一个DS18B20温度传感器对象变量，具体操作格式如下：

　　Ds18b20ObjectType ds18b20;

　　我们虽然声明了这个对象变量，但还不能立即使用。我们还需要使用驱动中定义的初始化函数对这个变量进行初始化。这个初始化函数所需要的输入参数如下：

　　Ds18b20ObjectType *ds18b20，被初始化的对象变量

　　Ds18b20SetBitType setBit，向总线写一位操作

　　Ds18b20GetBitType getBit，从总线读一位操作

　　Ds18b20SetPinModeType pinDirection，总线输入输出模式控制

　　Ds18b20DelayType delayus，为秒延时操作

　　对于这些参数，对象变量我们已经定义了。主要的是我们需要定义几个函数，并将函数指针作为参数。这几个函数的类型如下：

 1 /*写数据位到DS18B20*/
 2 typedef void (*Ds18b20SetBitType)(Ds18b20PinValueType vBit);
 3 
 4 /*从DS18B20读取一位数据*/
 5 typedef uint8_t (*Ds18b20GetBitType)(void);
 6 
 7 /*设置DS18B20的数据引脚的输入输出模式*/
 8 typedef void (*Ds18b20SetPinModeType)(Ds18b20IOModeType mode);
 9 
10 /* 定义延时操作函数指针类型 */
11 typedef void (*Ds18b20DelayType)(volatile uint32_t nTime);

　　对于这几个函数我们根据样式定义就可以了，具体的操作可能与使用的硬件平台有关系。具体函数定义如下：

 1 //设置DS18B20引脚的输出值
 2 void Ds18b20SetPinOutValue(Ds18b20PinValueType setValue)
 3 {
 4   HAL_GPIO_WritePin(GPIOB，GPIO_PIN_11，(GPIO_PinState)setValue);
 5 }
 6  
 7 //读取引脚电平
 8 uint8_t Ds18b20ReadPinBit(void)
 9 {
10   return (uint8_t)HAL_GPIO_ReadPin(GPIOB，GPIO_PIN_11);
11 }
12  
13 //设置引脚的输入输出方向
14 void Ds18b20SetPinMode(Ds18b20IOModeType mode)
15 {
16   GPIO_InitTypeDef GPIO_InitStruct;
17   
18   GPIO_InitStruct.Pin = GPIO_PIN_11;
19   if(mode==DS18B20_In)
20   {  
21     GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
22     GPIO_InitStruct.Pull = GPIO_NOPULL;
23   }
24   else
25   {  
26     GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
27     GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
28   }  
29   HAL_GPIO_Init(GPIOB， &GPIO_InitStruct);
30 }

　　对于延时函数我们可以采用各种方法实现。我们采用的STM32平台和HAL库则可以直接使用HAL_Delay()函数。于是我们可以调用初始化函数如下：

　　Ds18b20Initialization(&ds18b20，Ds18b20SetPinOutValue，Ds18b20ReadPinBit，Ds18b20SetPinMode，Delayus);

3.2、基于对象进行操作

　　我们定义了对象变量并使用初始化函数给其作了初始化。接着我们就来考虑操作这一对象获取我们想要的数据。我们在驱动中已经将获取数据并转换为转换值的比例值，接下来我们使用这一驱动开发我们的应用实例。

1 /*获取数据值*/
2 void GetMeasureDataFromDHT11(void)
3 {
4   float temperature; //温度值
5   GetDS18b20TemperatureValue(&ds18b20);
6   temperature=ds18b20.temperature;
7 }

4、应用总结

　　我们实现了DS18B20温度传感器的驱动程序，并基于这一驱动程序设计了简单的应用程序。我们也成功获得了温度数据，充分说明我们的驱动设计是正确的。事实上，在我们的项目中多次使用DS18B20温度传感器，这一驱动也是多次被使用到，结果令人满意。

　　单总线数据传输时，会改变总线的输入输出方向。在我们的应用中，我们修改了对应GPIO引脚的输入输出模式。事实上如果我们在STM32中使用时，我们可将该引脚配置为开漏输出模式，加上总线的上拉电阻，可以在不修改GPIO的输入输出模式的情况下实现读写。

　　使用驱动时需要注意，本驱动程序只考虑了总线上只有一个DS18B20的情况。在一条总线上有多个DS18B20温度传感器时，当前的驱动程序是不能够实现操作的，需要对驱动作相应修改。

欢迎关注：