外设驱动库开发笔记12：TSEV01CL55红外温度传感器驱动

有时候我们需要检测一些无法直接接触的器件的温度。为了实现这一需求，我们通常会选择红外温度传感器来实现这一功能。考虑到复用的问题，我们一般会将操作元器件的代码抽象为驱动函数以备调用。这里我们就来设计并实现TSEV01CL55红外温度传感器的驱动。

1、功能概述

TSEV01CL55是一种基于红外辐射检测的无接触测温系统。TSEV01CL55在前端装有红外传感器(热电堆)。

1.1、硬件描述

TSEV01CL55适用于需要非接触式温度测量的广泛应用场合。TSEV01CL55红外温度传感器测温时，热堆传感器必须指向所要测量的目标对象。TSEV01CL55红外温度传感器的引脚定义如下：

TSEV01CL55红外温度传感器测温基本工作原理是：用热电堆传感器探测红外辐射，该传感器将入射辐射转换成模拟电压；用热敏电阻测定传感器温度。根据测到的目标温度和环境温度数据进一步的进行模拟信号处理和调理，使用处理单元计算环境温度和物体温度。

1.2、通讯接口

TSEV01CL55红外温度传感器对外通讯采用数字输出总线(I2C)。通过I2C总线和响应的操作命令就可以得到物体温度和环境温度数据。这两个值都是以百分之一的度数传输的。相关的操作命令如下：

TSEV01CL55红外温度传感器测温有一定的范围限制，当环境或物体温度超过指定温度范围时，温度输出显示以下数据：

TSEV01CL55红外温度传感器的I2C硬件模块在SCL“锁存”问题上进行了更改。修改后的I2C模块不再下拉SCL命令主程序等待数据的计算。因此，主设备必须增加等待时间，以确保从设备能够组织数据。对于标准数据传输(比如读取温度)，1ms的时间足够从设备组织数据。对于需要更多时间的操作(如读取/写入EEPROM)，应该留取足够的时间等待从设备处理数据。

向TSEV01CL55红外温度传感器写命令时序如下：

从TSEV01CL55红外温度传感器读数据时序如下：

上述时序图是读取目标温度的时序图。其它数据的读写过程类似，在此不再赘述。

2、驱动设计与实现

我们已经了解了TSEV01CL55红外温度传感器的基本情况。接下来我们将设计并实现TSEV01CL55红外温度传感器的通用驱动程序。

2.1、对象定义

在使用一个对象之前我们需要获得一个对象。同样的我们想要TSEV01CL55红外温度传感器对象就需要先定义TSEV01CL55红外温度传感器的对象。如何得到TSEV01CL55红外温度传感器的对象呢？接下来我们就来考虑这个问题。

2.1.1、对象的抽象

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

先来考虑属性，作为属性肯定是用于标识或记录对象特征的东西。我们来考虑TSEV01CL55红外温度传感器对象属性。作为I2C通讯从设备，在总线上唯一区别不同设备的就是设备地址。所以我们将I2C设备地址作为对象的一个属性。TSEV01CL55红外温度传感器所检测的环境温度和目标温度虽然不能唯一标识TSEV01CL55红外温度传感器对象，但可以记录当前的状态所以我们将其作为对象的属性。

接着我们还需要考虑TSEV01CL55红外温度传感器对象的操作问题。对于I2C通讯设备，我们需要向设备写命令，同时也要从设备接收数据，但不论是接收数据还是发送命令都依赖于硬件接口和相关的硬件平台，所以我们将写命令和收数据作为TSEV01CL55红外温度传感器对象的两个操作。此外，操作过程中我们需要时序操作，而延时操作都依赖于具体的平台，所以我们将延时操作作为TSEV01CL55红外温度传感器对象的一个操作。

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

//定义TSEV01CL55红外温度传感器对象类型
typedef struct HLPTObject{uint8_t devAddress;           //对象的地址float tempObject;             //对象温度值float tempAmbient;            //环境温度void (*Delayms)(volatile uint32_t nTime);       //延时操作指针void (*Receive)(struct HLPTObject *hlpt，uint8_t *rData，uint16_t rSize);          //接收数据操作指针void (*Transmit)(struct HLPTObject *hlpt，uint8_t *wData，uint16_t wSize);        //发送数据操作指针
}HLPTObjectType;

2.1.2、对象初始化

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

/* 红外温度传感器对象初始化 */
void HLPTInitialization(HLPTObjectType *hlpt，         //初始化的对象变量uint8_t address，              //设备I2C地址HLPTReceive receive，          //接收函数指针HLPTTransmit transmit，        //发送函数指针HLPTDelayms delayms            //毫秒延时函数指针)
{if((hlpt==NULL)||(receive==NULL)||(transmit==NULL)||(delayms==NULL)){return;}hlpt->Receive=receive;hlpt->Transmit=transmit;hlpt->Delayms=delayms;hlpt->tempObject=0.0;hlpt->tempAmbient=0.0;if(address>0x00){hlpt->devAddress=address;}else{hlpt->devAddress=HLPTSlaveAddress;}
}

2.2、对象操作

我们已经完成了TSEV01CL55红外温度传感器对象类型的定义和对象初始化函数的设计。但我们的主要目标是获取对象的信息，接下来我们还要实现面向TSEV01CL55红外温度传感器的各类操作。

面向TSEV01CL55红外温度传感器的操作比较简单，最主要的就是读取温度数据，包括环境温度和目标温度。所以我们开发获取面向TSEV01CL55红外温度传感器数据的操作如下：

/* 读取数据 */
static uint16_t ReadDataFromHLPT(HLPTObjectType *hlpt，uint8_t cmd)
{uint8_t data[2];uint16_t tempCode;hlpt->Transmit(hlpt，cmd，1);hlpt->Delayms(1);hlpt->Receive(hlpt，data，2);tempCode=(data[0]<<8)+data[1];return tempCode;
}

3、驱动的使用

我们已经设计并实现了TSEV01CL55红外温度传感器的驱动程序，接下来我们将考虑设计一个简单的应用来验证这一驱动。

3.1、声明并初始化对象

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

HLPTObjectType hlpt;

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

HLPTObjectType *hlpt，初始化的对象变量

uint8_t address，设备I2C地址

HLPTReceive receive，接收函数指针

HLPTTransmit transmit，发送函数指针

HLPTDelayms delayms，毫秒延时函数指针

对于这些参数，对象变量我们已经定义了。而设备地址，根据实际情况输入就好了。主要的是我们需要定义几个函数，并将函数指针作为参数。这几个函数的类型如下：

/*延时操作指针类型*/
typedef void (*HLPTDelayms)(volatile uint32_t nTime);/*接收数据操作指针类型*/
typedef void (*HLPTReceive)(struct HLPTObject *hlpt，uint8_t *rData，uint16_t rSize);/*发送数据操作指针类型*/
typedef void (*HLPTTransmit)(struct HLPTObject *hlpt，uint8_t *wData，uint16_t wSize);

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

/*从TSEV01CL55接收数据*/
static void ReceiveFromHLPT(HLPTObjectType *sht，uint8_t *rData，uint16_t rSize)
{HAL_I2C_Master_Receive(&hlpti2c， sht->devAddress，rData， rSize， 1000);
}/*向TSEV01CL55传送数据*/
static void TransmitToHLPT(HLPTObjectType *sht，uint8_t *tData，uint16_t tSize)
{HAL_I2C_Master_Transmit(&hlpti2c，sht->devAddress，tData，tSize，1000);
}

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

HLPTInitialization(&hlpt，0x54，ReceiveFromHLPT，TransmitToHLPT，HAL_Delay);

3.2、基于对象进行操作

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

/*读取温度值*/
void GetTemperatureData(void)
{float tempObject;float tempAmbient;GetHLPTemperature(&hlpt);tempObject=hlpt.tempObject;tempAmbient=hlpt.tempAmbient;
}