HDC1080

HDC1080は、Texas Instruments製の温度および湿度センサIC(-40~+125℃、0.0~100.0%RH)です。HDC1080のOSS-ECAL(電子部品抽象化レイヤのオープンソースソフトウェア:Open Source Software for Electronic Components Abstraction Layer)を提供致します。
MCUインタフェース:I2C

ご注意:このリソースの元の言語は英語です。 翻訳は概要を便宜的に提供するもので、機械翻訳を使用していることがあり、私たちは翻訳の正確性および妥当性につきましては一切保証いたしません。 また、実際の設計などの前には、必ず最新版Datasheetをご参照くださいますようお願いいたします。

HDC1080

概要

HDC1080は温度センサーを内蔵したデジタル湿度センサーで、非常に低い消費電力で優れた測定精度を提供します。HDC1080は幅広い電源範囲で動作し、一般的なアプリケーションの幅広い範囲で、競合ソリューションに代わる低コスト、低消費電力を実現します。湿度および温度センサーは工場校正済みです。

特徴
  • 相対湿度精度 ±2% (typical)
  • 温度制度 ±0.2°C (typical)
  • 高湿度下での優れた安定性
  • 14ビット測定分解能
  • 100 nA スリープモード電流
  • 平均供給電流:
    710nA@1sps、11ビットRH測定
    1.3μA@1sps、11ビットRHおよび温度測定
  • 電源電圧 2.7 V~5.5 V
  • 小型3mm x 3mmのデバイス・フットプリント
  • I2Cインタフェース
用途
  • HVAC
  • スマートサーモスタットとルームモニター
  • 白物家電
  • プリンター
  • ハンドヘルドメーター
  • Medical Devices
  • ワイヤレスセンサー (TIDA: 00374, 00484, 00524)

OSS-ECAL仕様

API関数

etSTS oHDC1080( etCMD cmd, uint16 cfg, stHDC1080_O* rlt )

戻り値
引数 IN

引数 OUT

etSTS
etCMD cmd
uint16 cfg
stHDC1080_O* rlt

OSS-ECALステータスコード
OSS-ECALコマンドコード
Configuration register (Pointer 0x02) 設定データ
HDC1080からの受信データ

etCMD
eCMD_WRITE_CFG


機能 :
Configuration Register (Pointer Register 0x02) にcfgの値を書き込むコマンド

処理 :
1. 計測時間を計算する。
2. Configuration Register (Pointer Register 0x02) にcfgの値を書き込む

コマンドAPI関数:
etSTS oHDC1080_WRITE_CFG( uint16 cfg )

戻り値:
eSTS_FIN
eSTS_ERR_HAL_I2C
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT


備考:
cfgの設定は、Datasheet “Configuration Register Description”を参照してください。
計測時間は次の時間を切り上げた値。
温度 11bit変換 3.65ms, 14bit変換 6.35ms
湿度 8bit変換 2.50ms, 11bit変換 3.65ms, 14bit変換 6.5ms

eCMD_READ_TEMP

機能 :
Temperature Registerの値を読み込んで温度に変換し、rlt.temperatureに保存するコマンド

処理 :
1. Pointer Registerに0x00を書き込む
2. 計測時間が経過するまで待機する(待機中は戻り値eSTS_EXE)
3. Temperature Registerの値を読み込む
4. Temperature Registerの読み出し値を温度に変換する
温度=(読み出し値/ゲイン係数)+温度オフセット値 (Min, Max Limit)
5. rlt.temperatureに温度を保存する

コマンドAPI関数:
etSTS oHDC1080_READ_TEMP( stHDC1080_O* rlt )

戻り値:
eSTS_FIN
eSTS_EXE
eSTS_ERR_MIN
eSTS_ERR_MAX
eSTS_ERR_HAL_I2C
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT


備考:
計測時間の計測は、本API関数をコールするThread周期から計算するので、THREAD_OSS_ECAL_PERIOD[ms]にThread周期を設定してください。

eCMD_READ_HUMI

機能 :
Humidity Registerの値を読み込んで湿度に変換し、rlt.humidityに保存するコマンド

処理 :
1. Pointer Registerに0x01を書き込む
2. 計測時間が経過するまで待機する(待機中は戻り値eSTS_EXE)
3. Humidity Registerの値を読み込む
4. Humidity Registerの読み込んだ値を湿度に変換する
湿度=読み込んだ値/ゲイン係数 (Min, Max Limit)
5. rlt.humidityに湿度を保存する

コマンドAPI関数:
etSTS oHDC1080_READ_TEMP( stHDC1080_O* rlt )

戻り値:
eSTS_FIN
eSTS_EXE
eSTS_ERR_MIN
eSTS_ERR_MAX
eSTS_ERR_HAL_I2C
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT


備考:
計測時間の計測は、本API関数をコールするThread周期から計算するので、THREAD_OSS_ECAL_PERIOD[ms]にThread周期を設定してください。

eCMD_READ_TEMP_HUMI

機能 :
Humidity RegisterおよびTemperature Registerの値を読み込んでて温度および湿度に変換し、rlt.temperatureおよびrlt.humidityに保存するコマンド

処理:
1. Pointer Registerに0x00を書き込む
2. 計測時間が経過するまで待機する(待機中は戻り値eSTS_EXE)
3. Temperature Registerの値とHumidity Registerの値を読み込む
4. Temperature Registerの読み込んだ値を温度に変換する
温度=(読み込んだ値/ゲイン係数)+温度オフセット値 (Min, Max Limit)
5. Humidity Registerの読み込んだ値を湿度に変換する
湿度=読み込んだ値/ゲイン係数 (Min, Max Limit)
6. rlt.temperatureに温度を保存する
7. rlt.humidityに湿度を保存する

コマンドAPI関数:
etSTS oHDC1080_READ_TEMP_HUMI( stHDC1080_O* rlt )

戻り値:
eSTS_FIN
eSTS_EXE
eSTS_ERR_MIN
eSTS_ERR_MAX
eSTS_ERR_HAL_I2C
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT


備考:
計測時間の計測は、本API関数をコールするThread周期から計算するので、THREAD_OSS_ECAL_PERIOD[ms]にThread周期を設定してください。

eCMD_READ_SERI_ID

機能 :
Serial IDの値を読み出し、rlt.serialIDに保存するコマンド

処理:
1. Pointer Registerに0xFBを書き込む
2. Serial ID ( First )を読み込む
3. Pointer Registerに0xFCを書き込む
4. Serial ID ( Mid )を読み込む
5. Pointer Registerに0xFDを書き込む
6. Serial ID ( Last )を読み込む
7. rlt.serialIDに読み出した値を保存する

コマンドAPI関数:
etSTS oHDC1080_READ_SERI_ID( stHDC1080_O* rlt )

戻り値:
eSTS_FIN
eSTS_ERR_HAL_I2C
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT


備考:
本API関数は、処理完了するまで関数内で待機します。

eCMD_READ_CFG

機能 :
Configuration Registerを読み込んだ、rlt.configに保存するコマンド

処理:
1. Pointer Registerに0x02を書き込む
2. Configuration Registerを読み込む
3. rlt.configに読み出した値を保存する

コマンドAPI関数:
etSTS oHDC1080_READ_CFG( stHDC1080_O* rlt )

戻り値:
eSTS_FIN
eSTS_ERR_HAL_I2C
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT


備考:
Datasheet “Configuration Register Description”を参照してください。

eCMD_DIAG_DEVI_ID

機能 :
DeviceID Registerの値と0x1050の比較結果を戻り値として返すコマンド

処理:
1. Pointer Registerに0xFFを書き込む
2. DeviceID Registerを読み込む
3. 読み出した値と0x1050の比較結果を戻り値として返す
True … eSTS_FIN
False … eSTS_ERR_DIAG

コマンドAPI関数:
etSTS oHDC1080_DIAG_DEVI_ID( void )

戻り値:
eSTS_FIN
eSTS_ERR_DIAG
eSTS_ERR_HAL_I2C
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT

備考:

eCMD_DIAG_MANU_ID

機能 :
ManufacturerID Registerの値と0x5449の比較結果を戻り値として返すコマンド

処理:
1. Pointer Registerに0xFEを書き込む
2. ManufacturerID Register を読み込む
3. 読み出した値と0x5449の比較結果を戻り値として返す
True … eSTS_FIN
False … eSTS_ERR_DIAG

コマンドAPI関数:
etSTS oHDC1080_DIAG_MANU_ID( void )

戻り値:
eSTS_FIN
eSTS_ERR_DIAG
eSTS_ERR_HAL_I2C
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_I2C_OBJECT


備考:

stHDC1080_O
float32 temperature
float32 humidity
uint16 config
uint64 serialID


HDC1080 Register 0x00 Temperature to float TEMPERATURE[degrees Celsius]
HDC1080 Register 0x01 Humidity to float HUMIDITY[%RH]
HDC1080 Register 0x02 Configuration
HDC1080 Register 0xFB~0xFD Serial ID (First, Mid, Last)

File構成
フォルダ*ファイル概要
HDC1080_HALNAME/samplesample.c (.cpp)サンプル・アプリケーション・プログラム
sample.hサンプル・アプリケーション・ヘッダ
HDC1080_HALNAMEoHDC1080.c (.cpp)HDC1080用OSS-ECALプログラム
oHDC1080.hHDC1080用OSS-ECALヘッダ
oss_ecal.hOSS-ECAL 共通ヘッダ (Ver 01.01.00以降)
user_setting.c (.cpp)ユーザ設定定数・テーブル
user_setting.hユーザ設定ヘッダ
oHAL_i2c_stm32f4.cSTM32Cube FW_F4用HALプログラム
oHAL_i2c_stm32f4.hSTM32Cube FW_F4用HALヘッダ
readme.mdReadme
OSS-ECAL Terms of Use.txtOSS-ECAL利用条件

* HALNAMEはHAL対応表を参照してください。

HAL対応表
MCU/Board
メーカ
HALMCU*開発環境*HALNAME
ArduinoArduino 1.8.6ATmega2560
ATmega328P
Mega 2560 Rev3
Arduino Pro Mini 3.3V
ARDUINO
ARMMbed 6.17.0STM32F401RETxSTM32 Nucleo-64 boardsMBED
InfineonModusToolbox HAL Cat1 2.4.3CYBLE-416045-02CY8CPROTO-063-BLE PSoC 6 BLE Prototyping KitModusToolbox
NXPMCUXpresso SDK
iMXRT1051B_1052B
ksdk2_0
CYBLE-416045-02IMXRT1050-EVKBiMXRT1051B1052B
RenesasSSP 2.4.0R7FS7G27H3A01CFCS7G2 SKSSP
STMSTM32Cube FW_F4 V1.27.1STM32F401RETxSTM32 Nucleo-64 boardsSTM32F4
Debian ProjectDebian(Linux) v2022.04TI AM335xBeagleBone Black – Rev CLinux

* 開発時のMCUおよび開発環境。
  同じHALであってもMCUや開発環境が異なると動作が合わない場合があります。

OSS-ECAL ダウンロード

ログインしてからダウンロードを行ってください。新規のユーザ登録は、こちらから行ってください。
本OSS-ECALは、サンプル版なのでユーザ登録せずにダウンロードできますが、OSS-ECAL利用条件は承諾後にダウンロードしてください。

Fileダウンロードできない場合、お問合せから型番およびHALの種類をご連絡ください。メール添付でお送りいたします。

組込み方法

ユーザプログラムにOSS-ECALを組み込む方法

ユーザプログラムに複数のOSS-ECAL(同じMCU機能の電子部品)を組み込む方法

ユーザプログラムに複数のOSS-ECAL(異なるMCU機能の電子部品)を組み込む方法

ユーザプログラムに複数同じ電子部品を組み込む方法

電子部品の入れ替えによるユーザプログラムへの影響低減方法

OSS-ECAL Japanese
error: コンテンツは保護されている