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/sample | sample.c (.cpp) | サンプル・アプリケーション・プログラム |
sample.h | サンプル・アプリケーション・ヘッダ | |
HDC1080_HALNAME | oHDC1080.c (.cpp) | HDC1080用OSS-ECALプログラム |
oHDC1080.h | HDC1080用OSS-ECALヘッダ | |
oss_ecal.h | OSS-ECAL 共通ヘッダ (Ver 01.01.00以降) | |
user_setting.c (.cpp) | ユーザ設定定数・テーブル | |
user_setting.h | ユーザ設定ヘッダ | |
oHAL_i2c_stm32f4.c | STM32Cube FW_F4用HALプログラム | |
oHAL_i2c_stm32f4.h | STM32Cube FW_F4用HALヘッダ | |
readme.md | Readme | |
OSS-ECAL Terms of Use.txt | OSS-ECAL利用条件 |
* HALNAMEはHAL対応表を参照してください。
HAL対応表
MCU/Board メーカ | HAL | MCU* | 開発環境* | HALNAME |
---|---|---|---|---|
Arduino | Arduino 1.8.6 | ATmega2560 ATmega328P | Mega 2560 Rev3 Arduino Pro Mini 3.3V | ARDUINO |
ARM | Mbed 6.17.0 | STM32F401RETx | STM32 Nucleo-64 boards | MBED |
Infineon | ModusToolbox HAL Cat1 2.4.3 | CYBLE-416045-02 | CY8CPROTO-063-BLE PSoC 6 BLE Prototyping Kit | ModusToolbox |
NXP | MCUXpresso SDK iMXRT1051B_1052B ksdk2_0 | CYBLE-416045-02 | IMXRT1050-EVKB | iMXRT1051B1052B |
Renesas | SSP 2.4.0 | R7FS7G27H3A01CFC | S7G2 SK | SSP |
STM | STM32Cube FW_F4 V1.27.1 | STM32F401RETx | STM32 Nucleo-64 boards | STM32F4 |
* 開発時のMCUおよび開発環境。
同じHALであってもMCUや開発環境が異なると動作が合わない場合があります。
OSS-ECAL ダウンロード
ログインしてからダウンロードを行ってください。新規のユーザ登録は、こちらから行ってください。
HAL | ダウンロード OSS-ECAL Ver |
---|---|
Arduino 1.8.6 | |
Mbed 6.17.0 | |
ModusToolbox HAL Cat1 2.4.3 | |
MCUXpresso SDK iMXRT1051B_1052B ksdk2_0 | |
SSP 2.4.0 | |
STM32Cube FW_F4 V1.27.1 |
Microsoft Edgeで「ABC.zipを安全にダウンロードすることはできません」と警告が出た場合
Fileダウンロードできない場合、お問合せから型番およびHALの種類をご連絡ください。メール添付でお送りいたします。
組込み方法
ユーザプログラムに複数のOSS-ECAL(同じMCU機能の電子部品)を組み込む方法