外設驅動庫開發筆記21:BME680環境傳感器驅動

環境傳感器是一類我們很常用的傳感器。它可以方便我們獲取壓力、溫度、溼度以及空氣質量等數據。在這一篇中,我們將分析BME680環境傳感器的功能,並設計和實現BME680環境傳感器的驅動。

1、功能概述

BME680是一款專爲移動應用和可穿戴設備開發的集成環境傳感器,其尺寸和低功耗是關鍵要求。

1.1、硬件接口

BME680由一個8針金屬蓋3.0 x 3.0 x0.93mm³LGA封裝組成,旨在根據特定的工作模式,長期穩定性和高EMC穩健性進行優化消耗。可以選擇採用I2C接口或者SPI接口。其管腳排布如下圖:

BME680環境傳感器可以選擇使用I2C接口或者SPI接口,在不同的接口模式及下各個引腳的定義及功能有一些差別。其具體分配及定義如下所示:

從上表中我們可以知道當CSB引腳接高電平VDDIO時,採用的是I2C接口。此時I2C的設備地址的最後一位由SDO引腳的電平決定。所以設備地址計7位爲0x760x77,計8位則是0xEC0xEE

CSB引腳用作片選信號時,則使用SPI接口。SPI接口支持模式0CPOL=0CPHA=0)和模式3CPOL=1CPHA=1)。同時支持3SPI4SPI。控制字節的最高位爲0時表示寫,爲1時表示讀。

1.2、內置傳感器

BME680擴展了博世現有的環境傳感器系列,首次集成了高線性度和高精度的氣體,壓力,溼度和溫度傳感器。

1.2.1、氣體傳感器

BME680內的氣體傳感器可以檢測各種氣體,以測量個人健康的空氣質量。BME680可檢測到的氣體包括油漆(如甲醛),油漆,脫漆劑,清潔用品,傢俱等的揮發性有機化合物(VOC)。大氣質量傳感器的特性參數如下:

BME680採用了博世軟件環境羣組解決方案。該解決方案使用智能算術方法將空氣質量索引(IAQ)作爲輸出。該指標將IAQ劃分爲0500的索引數值用以指示IAQ,具體劃分如下所示:

1.2.2、溼度傳感器

BME680集成了溼度傳感器用於外部環境中溼度數據的採集。溼度傳感器的性能參數如下:

1.2.3、壓力傳感器

BME680集成有大氣壓力傳感器用於檢測外部環境的絕對壓力。壓力傳感器的性能參數如下:

1.2.4、溫度傳感器

BME680也集成了溫度傳感器用以檢測溫度數據,溫度數據除了指示環境溫度外,同時用於壓力和溼度的補償計算。溫度傳感器的性能參數如下:

1.3、數據存儲結構

BME680採用特定的存儲器區域來存儲控制及數據信息。存儲的數據包括測量數據、控制信息以及校準數據。

對於溫度傳感器,包括3個校準參數和一個ADC測量數據,其測量數據和校準數據的存儲結構及地址如下:

對於壓力傳感器,包括10個計算校準數據和一個ADC轉換數據,其測量數據的校準數據存儲結構及地址如下:

對於溼度傳感器,包括7個計算校準數據和一個ADC轉換數據,其測量數據的校準數據存儲結構及地址如下:

大氣質量傳感器,包括3個計算校準數據、一個加熱器範圍存儲數據、一個加熱器電阻校準因子存儲數據、氣體ADC測量數據、氣體範圍數據以及範圍轉換錯誤,其測量數據的校準數據存儲結構及地址如下:

BME680環境傳感器寄存器都是8位的,所有的操作均通過對寄存器的讀寫來實現。全部控制寄存器及數據寄存器的結構和地址如下:

這裏我們需要說明一下,BME680的存儲器地址範圍是0x00~0xFF,在I2C接口通訊時,通訊採用的是8位寄存器地址正好符合對應的尋址範圍。但是採用SPI接口通訊時,寄存器地址的最高爲被用於區分讀寫操作,所以地址只有7位,存儲空間被分爲2頁。具體如下:

所以在使用SPI接口時需要分辨是哪一頁。當前操作的是哪一頁由Status寄存器來決定。

2、驅動設計與實現

我們對BME680環境傳感器的基本情況已經有了整體瞭解,接下來我們將爲BME680環境傳感器設計並實現驅動程序。

2.1、對象定義

我們依然是採用基於對象的操作。所以我們需要定義對象,所以我們需要抽象出對象類型,並對我們想要操作的對象進行初始化。

2.1.1、對象抽象

對於一個對象來說,一般包括有屬性和操作兩方面的內容。接下來我們就從這兩個方面分析BME680環境傳感器的對象。

我們需要從BME680對象抽象出其屬性,這些屬性能夠定義一個對象的特點並將其與其它對象區別開來。BME680支持SPI通訊和I2C通訊,所以我們將通訊端口作爲屬性以規定對象的通訊方式。在使用I2C時,設備有地址以區別不同的設備,所以我們將I2C設備地址也定義爲屬性。每臺BME680都有一個ID用以區別於其它設備,所以我們將它定義爲對象的屬性。還有配置寄存器、測量控制寄存器、溼度控制寄存器、氣體控制寄存器都記錄了設備的配置狀態,所以我們也將它們作爲屬性。每臺設備都有特定的校準數據,這些校準數據每次數據檢測都是需要的,所以我們用屬性將它們記錄下來。還有測量數據,它們標識了設備當前的工作狀態,所以我們將它們也作爲屬性。

接下來我們分析BME680的操作。首先來講,我們肯定要與BME680交互,但我們對BME680的讀寫依賴於具體的硬件平臺,所以我們將它們作爲對象的操作。在進行相關操作時,我們需要控制時序,則需要使用延時操作,但延時處理總是依賴於具體的軟硬件平臺,所以我們將延時處理作爲對象的操作。而使用SPI時,沒有設備地址但有片選信號,如何操作片選信號依賴於硬件平臺,我們將對片選的操作定義爲對象的操作函數。

根據上述的分析,我們可以得到BME680環境傳感器的對象類型如下:

/*定義BME680操作對象*/
typedef struct BME680Object{
       uint8_t chipID;       //芯片ID
       uint8_t bmeAddress;         //I2C通訊時的設備地址
       uint8_t memeryPage;       //用於在SPI接口時記錄當前所處的內存頁
       uint8_t config;                         //配置寄存器
       uint8_t ctrlMeas;                 //測量控制寄存器
       uint8_t ctrlHumi;              //溼度測量控制寄存器
       uint8_t ctrlGas0;               //氣體控制寄存器0
       uint8_t ctrlGas1;               //氣體控制寄存器1
       uint8_t resHeat;
       uint8_t gasWait;
      
       BME680PortType port;                                              //接口選擇
       BME680CalibParamType caliPara;   //校準參數

#if BME680_COMPENSATION_SELECTED > (0)
       int32_t temperature;         //溫度值
       int32_t pressure;                      //壓力值
       int32_t humidity;                     //溼度值
       int32_t gasResistence;      //大氣質量電阻值
       int32_t iaq;                                      //空氣質量水平
#else
       float temperature;             //溫度值
       float pressure;                          //壓力值
       float humidity;                         //溼度值
       float gasResistence;   //大氣質量電阻值
       float iaq;                                          //空氣質量水平
#endif

       void (*Read)(struct BME680Object *bme,uint8_t regAddress,uint8_t *rData,uint16_t rSize);       //讀數據操作指針
       void (*Write)(struct BME680Object *bme,uint8_t regAddress,uint8_t command);    //謝數據操作指針
       void (*Delayms)(volatile uint32_t nTime);       //延時操作指針
       void (*ChipSelect)(BME680CSType cs);    //使用SPI接口時,片選操作
}BME680ObjectType;

片選操作有一點需要注意,如果片選信號在硬件電路上固定有效時,可以將NULL給它,同樣在SPI接口時也需要將NULL給它。

2.1.2、對象初始化函數

一個對象必須對其進行初始化纔可使用。初始化對象主要有四個方面的內容:檢查對象賦值的合法性;屬性賦初值;爲對象操作指定函數指針;對象所指向設備的初始配置。據此我們可以編寫BME680環境傳感器的初始化函數如下:

/*實現BME680初始化配置*/
void BME680Initialization(BME680ObjectType *bme,       //BMP280對象
                          uint8_t bmeAddress,         //I2C接口是設備地址
                          BME680PortType port,    //接口選擇
                          BME680IIRFilterType filter,                //過濾器
                          BME680SPI3wUseType spi3W_en,   //3線SPI控制
                          BME680TempSampleType osrs_t,       //溫度精度
                          BME680PresSampleType osrs_p,         //壓力精度
                          BME680SPI3wIntType spi3wint_en,//3線SPI中斷控制
                          BME680HumiSampleType osrs_h,       //溼度精度
                          BME680GasRunType run_gas,      //氣體運行設置
                          BME680HeaterSPType nb_conv,  //加熱器設定點選擇
                          BME680HeaterOffType heat_off, //加熱器關閉
                          uint16_t duration,      //TPHG測量循環週期,ms單位
                          uint8_t tempTarget,   //加熱器的目標溫度
                          BME680Read Read,  //讀數據操作指針
                          BME680Write Write,       //寫數據操作指針
                          BME680Delayms Delayms,           //延時操作指針
                          BME680ChipSelect ChipSelect     //片選操作指針
                          )
{
       uint8_t try_count = 5;
       uint8_t regValue=0;
      
       if((bme==NULL)||(Read==NULL)||(Write==NULL)||(Delayms==NULL))
       {
              return;
       }
       bme->Read=Read;
       bme->Write=Write;
       bme->Delayms=Delayms;
      
       bme->port=port;
       if(bme->port==BME680_I2C)
       {
              if((bmeAddress==0xEC)||(bmeAddress==0xEE))
              {
                     bme->bmeAddress=bmeAddress;
              }
              else if((bmeAddress==0x76)||(bmeAddress==0x77))
              {
                     bme->bmeAddress=(bmeAddress<<1);
              }
              else
              {
                     return;
              }
              bme->ChipSelect=NULL;
       }
       else
       {
              if(ChipSelect!=NULL)
              {
                     bme->ChipSelect=ChipSelect;
              }
              else
              {
                     bme->ChipSelect=BME680ChipSelectDefault;
              }
       }
      
       bme->chipID=0x00;
       bme->pressure=0.0;
       bme->temperature=25.0;
       bme->humidity=0.0;
       bme->bmeAddress=0x00;
       bme->caliPara.t_fine=0;
             
       if(!ObjectIsValid(bme))
       {
             return;
       }
    
       while(try_count--)
       {
             ReadBME680Register(bme,REG_BME680_ID,&regValue,1);
             bme->chipID=regValue;
             if(0x61==bme->chipID)
             {
                   BME680SoftReset(bme);
     
                   break;
             }
       }
 
       if(try_count)
       {
              uint8_t waitTime;
              waitTime=CalcProfileDuration(bme,duration,osrs_t,osrs_p,osrs_h);
             
              //控制寄存器配置
              ConfigControlRegister(bme,filter,spi3W_en,osrs_t,osrs_p,spi3wint_en,osrs_h,run_gas,nb_conv,heat_off,waitTime,tempTarget);
             
             //讀取校準值
             GetBME680CalibrationData(bme);
       }
}

2.2、對象操作

每一個對象都有操作,我們使用對象的目的當然是通過操作對象來獲取我們需要的數據。所以開發驅動時,對象的操作纔是我們主要的工作內容。在這裏對BME680的操作就是對其寄存器的操作。

2.2.1、寫寄存器操作

我們已經說過了,對BME680的操作都是通過讀寫寄存器實現的。這裏我們先來看寫寄存器。在I2C接口方式下,寫寄存器操作是在從站地址的最後一位來識別的,再加上要寫的寄存器地址和數據來實現的,這也是I2C協議的標準做法。其時序圖如下所示:

而在SPI接口方式下,由於SPI並未有設備地址,也不存在用從還在那地址最後爲來標記讀寫的模式。通常一些設備需要定義操作碼來實現讀寫區分,但BME680採取了將寄存器地址的最高位置零表示爲寫。之所以可以這樣定義,是因爲BME680寄存器地址分配的特殊性決定的。改變寄存器地址的最高位也能區分不同的寄存器,絕不會重複。在SPI接口方式下,寫寄存器的時序圖如下所示:

根據上述描述和時序圖,我們可以實現寫BME680環境傳感器寄存器的程序。

/* 向BME680寄存器寫一個字節 */
static void WriteBME680Register(BME680ObjectType *bme,uint8_t regAddress,uint8_t command)
{
       if(ObjectIsValid(bme))
       {
              if(bme->port==BME680_SPI)
              {
                     bme->ChipSelect(BME680CS_Enable);
                     bme->Delayms(1);
                     SetMemeryPageNumber(bme,regAddress);
                     regAddress&=0x7F;
                     bme->Delayms(1);
                     bme->Write(bme,regAddress,command);
                     bme->Delayms(1);
                     bme->ChipSelect(BME680CS_Disable);
              }
              else
              {
                     bme->Write(bme,regAddress,command);
              }
       }
}

2.2.2、讀寄存器操作

讀寄存器的處理方式與寫寄存器是類似。在I2C接口方式下,將從站地址的最低位置1來表示讀。在I2C接口方式下,讀寄存器的時序圖如下所示:

而在SPI接口方式下,通過將寄存器地址的最改爲置1來標識爲讀操作。事實上,所有寄存器地址的最高爲都是1,所以在讀操作時實際不需要做處理。在SPI接口方式下,讀寄存器的時序圖如下所示:

根據上述描述和時序圖,我們可以實現讀BME680環境傳感器寄存器的程序。

/*從BME680寄存器讀取數據*/
static uint8_t ReadBME680Register(BME680ObjectType *bme,uint8_t regAddress,uint8_t *rDatas,uint16_t rSize)
{
      uint8_t bmeError=0xFF;
 
      if(ObjectIsValid(bme))
      {
              if(bme->port==BME680_SPI)
              {
                     bme->ChipSelect(BME680CS_Enable);
                     bme->Delayms(1);
                     SetMemeryPageNumber(bme,regAddress);
                     regAddress |= 0x80;
                     bme->Delayms(1);
                     bme->Read(bme,regAddress,rDatas,rSize);
                     bme->Delayms(1);
                     bme->ChipSelect(BME680CS_Disable);
              }
              else
              {
                     bme->Read(bme,regAddress,rDatas,rSize);
              }
             
              bmeError=0x00;
      }

      return bmeError;
}

3、驅動的使用

上一節我們設計並實現了BME680環境傳感器的驅動程序,但這個驅動設計的是否合理還不確定,所以我們來設計一個簡單的應用驗證BME680環境傳感器的驅動。

3.1、聲明並初始化對象

使用基於對象的操作我們需要先得到這個對象,所以我們先要使用前面定義的BME680環境傳感器對象類型聲明一個BME680環境傳感器對象變量,具體操作格式如下:

BME680ObjectType bme680;

聲明瞭這個對象變量並不能立即使用,我們還需要使用驅動中定義的初始化函數對這個變量進行初始化。這個初始化函數所需要的輸入參數如下:

BME680ObjectType *bmeBMP680對象

uint8_t bmeAddressI2C接口是設備地址

BME680PortType port,接口選擇

BME680IIRFilterType filter,過濾器

BME680SPI3wUseType spi3W_en3SPI控制

BME680TempSampleType osrs_t,溫度精度

BME680PresSampleType osrs_p,壓力精度

BME680SPI3wIntType spi3wint_en3SPI中斷控制

BME680HumiSampleType osrs_h,溼度精度

BME680GasRunType run_gas,氣體運行設置

BME680HeaterSPType nb_conv,加熱器設定點選擇

BME680HeaterOffType heat_off,加熱器關閉

uint16_t durationTPHG測量循環週期,ms單位

uint8_t tempTarget,加熱器的目標溫度

BME680Read Read,讀數據操作指針

BME680Write Write,寫數據操作指針

BME680Delayms Delayms,延時操作指針

BME680ChipSelect ChipSelect,片選操作指針

對於這些參數,對象變量我們已經定義了。其他的參數基本都是配置參數,我們根據實際使用需求選擇輸入就好了。主要的是我們需要定義幾個函數,並將函數指針作爲參數。這幾個函數的類型如下:

/* 定義讀數據操作函數指針類型 */
typedef void (*BME680Read)(struct BME680Object *bme,uint8_t regAddress,uint8_t *rData,uint16_t rSize);
/* 定義寫數據操作函數指針類型 */
typedef void (*BME680Write)(struct BME680Object *bme,uint8_t regAddress,uint8_t command);
/* 定義延時操作函數指針類型 */
typedef  void (*BME680Delayms)(volatile uint32_t nTime);
/* 定義使用SPI接口時,片選操作函數指針類型 */
typedef  void (*BME680ChipSelect)(BME680CSType cs);

對於這幾個函數我們根據樣式定義就可以了,具體的操作可能與使用的硬件平臺有關係。若採用的SPI接口則需注意片選操作,片選操作函數用於多設備需要軟件操作時,如採用硬件片選可以傳入NULL即可。同樣如果採用的是I2C接口,則片選可以傳入NULL即可。具體函數定義如下:

/*讀BME680寄存器值*/
static void ReadDataFromBME680(BME680ObjectType *bme680,uint8_t regAddress,uint8_t *rData,uint16_t rSize)
{
  HAL_I2C_Master_Transmit(&bme680hi2c, bme680->bmeAddress,&regAddress,1,1000);
 
  HAL_I2C_Master_Receive(&bme680hi2c, bme680->bmeAddress+1,rData, rSize, 1000);
}

/*寫BME680寄存器值*/
static void WriteDataToBME680(BME680ObjectType *bme680,uint8_t regAddress,uint8_t command)
{
  uint8_t pData[2];
 
  pData[0]=regAddress;
  pData[1]=command;
 
  HAL_I2C_Master_Transmit(&bme680hi2c,bme680->bmeAddress, pData, 2,1000);
}

對於延時函數我們可以採用各種方法實現。我們採用的STM32平臺和HAL庫則可以直接使用HAL_Delay()函數。於是我們可以調用初始化函數如下:

BME680Initialization(&bme680,  //BME280對象
                     0xEC,           //I2C接口是設備地址
                     BME680_I2C,    //接口選擇
                     BME680_IIR_FILTER_COEFF_X127,      //過濾器
                     BME680_SPI3W_DISABLE,        //3線SPI控制
                     BME680_TEMP_SAMPLE_X16, //溫度精度
                     BME680_PRES_SAMPLE_X16,          //壓力精度
                     BME680_SPI3W_INT_DISABLE,       ///3線SPI中斷使能
                     BME680_HUMI_SAMPLE_X16,         //溼度精度
                     BME680_GAS_RUN_ENABLE,//氣體運行設置
                     BME680_HEATER_SP0,//加熱器設定點選擇
                     BME680_HEATER_DISABLE,//加熱器關閉
                     20,//TPHG測量循環週期,ms單位
                     200,//加熱器的目標溫度
                     ReadDataFromBME680,  //讀數據操作指針
                     WriteDataToBME680,     //寫數據操作指針
                     HAL_Delay,                     //延時操作指針
                     NULL                                //片選操作指針
                     );

3.2、基於對象進行操作

我們定義了對象變量並使用初始化函數給其作了初始化。接着我們就來考慮操作這一對象獲取我們想要的數據。我們在驅動中已經將獲取數據並轉換爲轉換值的比例值,接下來我們使用這一驅動開發我們的應用實例。

/*獲取環境數據*/
void BME680GetEnvironmentalData(void)
{
       float pressure;                //壓力值
       float temperature;             //溫度值
       float humidity;                //溼度值
       float gasResistance;           //氣體電阻
      
       GetBME680Measure(&bme680);

       pressure=bme680.pressure;
       temperature=bme680.temperature;
       humidity=bme680.humidity;
       gasResistance=bme680.gasResistence;
}

4、應用總結

我們設計並實現了BME680環境傳感器的驅動程序,並基於這一驅動程序設計了簡單的應用。我們獲得了BME680檢測的全部環境數據,結果也是令我們滿意的,這說明我們的驅動設計是正確的。

在使用驅動時需注意,採用SPI接口的器件需要考慮片選操作的問題。如果片選信號是通過硬件電路來實現的,我們在初始化時給其傳遞NULL值。如果是軟件操作片選則傳遞我們編寫的片選操作函數。而如果採用I2C接口,那麼在初始化時也應傳遞NULL值。

BME680環境傳感器支持SPII2C兩種接口,而且SPI也支持3線和4線模式,但我們在測試應用中只使用了I2C接口,SPI接口還有待測試。BME680環境傳感器在使用SPI接口時,支持SPI模式0CPOL=CPHA=0)和模式3CPOL=CPHA=1)。而在使用I2C接口時,支持標準模式、快速模式以及高速模式。而且在使用I2C接口時,SDO引腳必須接高電平或低電平,以確定設備地址。

BME680環境傳感器有2種工作模式:休眠模式和強制模式。在設備上電後就進入休眠模式,在這種模式下設備不執行測量工作。一旦啓動強制模式則執行一遍TPHG循環檢測。模式設定的具體定義如下:

對於BME680環境傳感器有一個測量範圍寄存器,這個寄存器的值對應兩組計算常數,這下常數用於測量值的計算,具體如下:

總的來說對BME680環境傳感器的讀寫操作本身並不複雜,但其計算與修正關係卻相對複雜,特別是氣體質量數據更應注意。

源碼下載:https://github.com/foxclever/ExPeriphDriver

歡迎關注:

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章