S-58LM20Aは、ABLIC製の温度センサ IC（ -55～+130℃ ）です。S-58LM20AのOSS-ECAL（電子部品抽象化レイヤのオープンソースソフトウェア：Open Source Software for Electronic Components Abstraction Layer）を提供致します。
MCUインタフェース：ADC
ご注意：実際の設計などの前には、必ず最新版Datasheetをご参照くださいますようお願いいたします。
S-58LM20A
概要
S-58LM20A シリーズは、温度変化に対してリニアな出力電圧が得られる高精度の温度センサ IC です。チップ内に温度センサ、定電流回路、オペアンプが集積されています。動作周囲温度は－55°C～＋130°Cで、従来のサーミスタなどの温度センサと比較してリニアリティが非常に優れており、温度制御に関する広範囲な応用が可能です。
特徴
- 温度精度が高い ±2.5°C（－55°C～＋130°C）
- 温度変化に対して、リニアな出力電圧が得られる
-11.77 mV/°C typ.
Ta =－30°C： 2.205 V typ.
Ta =＋30°C： 1.515 V typ.
Ta =＋130°C： 0.303 V typ. - リニアリティが優れている ±0.4％ typ. (-20°C～+80°C)
- 広い電源電圧範囲で動作可能
VDD = 2.4 V～5.5 V (-30°C～+130°C)
VDD = 2.7 V～5.5 V (-55°C～+130°C) - 消費電流が低い 4.5 μA typ.（＋25°C） 6.0 μA typ.（-55°C～+130°C）
- オペアンプを内蔵
- VSSを基準にした温度電圧出力
- 鉛フリー、Sn 100%、ハロゲンフリー
用途
- 携帯電話、無線機などの高周波回路特性の補正
- 水晶振動子の発振周波数の補正
- LCDのコントラスト補正
- アンプゲインの補正
- オートフォーカス回路の補正
- バッテリマネジメントにおける温度検知
- 充電池、ハロゲンランプなどの過熱防止
OSS-ECAL仕様
API関数
etSTS oS58LM20A( etCMD cmd, float32* rlt )
oS58LM20A関数は、引数のコマンドによってS-58LM20Aの処理を実行するAPI関数です。
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_ERR_MIN | 最小温度エラー（rltは最小温度） | ||
| eSTS_ERR_MAX | 最大温度エラー（rltは最大温度） | ||
| eSTS_ERR_HAL_ADC | HAL ADCエラー | ||
| eSTS_ERR_COMMAND_CODE | コマンド選択エラー | ||
| eSTS_ERR_OTHERS_RUN | 他のコンポーネントが処理実行中 | ||
| eSTS_ERR_HAL_OTHERS_RUN | 他のアプリケーションがHAL実行中 | ||
| eSTS_ERR_ADC_OBJECT | AD変換オブジェクト選択エラー | ||
| 引数 IN | etCMD cmd | OSS-ECALコマンドコード | |
| eCMD_START | AD変換をスタートするコマンド | ||
| eCMD_READ | AD変換値を読込み、AD変換値を温度に変換するコマンド AD変換値から温度変換式 電圧値=(AD変換値×VDD)/(2AD bit) 温度＝((電圧値-電圧オフセット値)/ゲイン係数)+温度オフセット値 (Min, Max Limit) | ||
| eCMD_START_READ | AD変換をスタートし、AD変換値を読込み、AD変換値を温度に変換するコマンド AD変換値から温度変換式 電圧値=(AD変換値×VDD)/(2AD bit) 温度＝((電圧値-電圧オフセット値)/ゲイン係数)+温度オフセット値 (Min, Max Limit) | ||
| 引数 OUT | float32* rlt | 温度 -55.0 to +130.0 [°C] |
HAL別コマンド対応表
| Arduino | eCMD_START_READ |
| ARM Mbed | eCMD_START_READ |
| Debian(Linux) | eCMD_START_READ |
| Infineon ModusToolbox | eCMD_START_READ |
| NXP MCUXpresso iMXRT1051B_1052B | eCMD_START eCMD_READ eCMD_START_READ |
| Renesas SSP | eCMD_START eCMD_READ eCMD_START_READ |
| STM STM32Cube FW_F4 | eCMD_START eCMD_READ eCMD_START_READ |
etSTS oS58LM20A_START(void)
oS58LM20A_START関数は、S-58LM20AのAD変換を開始するAPI関数です。
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_ERR_HAL_ADC | HAL ADCエラー | ||
| eSTS_ERR_OTHERS_RUN | 他のコンポーネントが処理実行中 | ||
| eSTS_ERR_HAL_OTHERS_RUN | 他のアプリケーションがHAL実行中 | ||
| eSTS_ERR_ADC_OBJECT | AD変換オブジェクト選択エラー |
HAL別関数対応表
| Arduino | – |
| ARM Mbed | – |
| Debian(Linux) | – |
| Infineon ModusToolbox | – |
| NXP MCUXpresso iMXRT1051B_1052B | X |
| Renesas SSP | X |
| STM STM32Cube FW_F4 | X |
etSTS oS58LM20A_READ( float32* rlt )
oS58LM20A_READ関数は、S-58LM20AのAD変換の終了を確認し、AD変換値を読み込み、そのAD変換値を温度に特性変換して、その温度をrltに保存するAPI関数です。
AD変換値から温度変換式
電圧値=(AD変換値×VDD)/(2AD bit)
温度＝((電圧値-電圧オフセット値)/ゲイン係数)+温度オフセット値 (Min, Max Limit)
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_ERR_MIN | 最小温度エラー（rltは最小温度） | ||
| eSTS_ERR_MAX | 最大温度エラー（rltは最大温度） | ||
| eSTS_ERR_HAL_ADC | HAL ADCエラー | ||
| eSTS_ERR_TIMEOUT | ADC Timeoutエラー（AUTOSARのみ） | ||
| eSTS_ERR_OTHERS_RUN | 他のコンポーネントが処理実行中 | ||
| eSTS_ERR_ADC_OBJECT | AD変換オブジェクト選択エラー | ||
| 引数 OUT | float32* rlt | 温度 -55.0 to +130.0 [°C] |
HAL別関数対応表
| Arduino | – | |
| ARM Mbed | – | |
| Debian(Linux) | – | |
| Infineon ModusToolbox | – | |
| NXP MCUXpresso iMXRT1051B_1052B | X | |
| Renesas SSP | X | |
| STM STM32Cube FW_F4 | X | Time-out時間 HAL_MAX_DELAY |
etSTS oS58LM20A_START_READ( float32* rlt )
oS58LM20A_START_READ関数は、S-58LM20AのAD変換を開始し、AD変換の終了を待ち、AD変換値を読み込み、そのAD変換値を温度に特性変換して、その温度をrltに保存するAPI関数です。
AD変換値から温度変換式
電圧値=(AD変換値×VDD)/(2AD bit)
温度＝((電圧値-電圧オフセット値)/ゲイン係数)+温度オフセット値 (Min, Max Limit)
| 戻り値 | etSTS | OSS-ECALステータスコード | |
| eSTS_FIN | 正常終了 | ||
| eSTS_ERR_MIN | 最小温度エラー（rltは最小温度） | ||
| eSTS_ERR_MAX | 最大温度エラー（rltは最大温度） | ||
| eSTS_ERR_HAL_ADC | HAL ADCエラー | ||
| eSTS_ERR_OTHERS_RUN | 他のコンポーネントが処理実行中 | ||
| eSTS_ERR_HAL_OTHERS_RUN | 他のアプリケーションがHAL実行中 | ||
| eSTS_ERR_ADC_OBJECT | AD変換オブジェクト選択エラー | ||
| 引数 OUT | float32* rlt | 温度 -55.0 to +130.0 [°C] |
HAL別関数対応表
| Arduino | X | |
| ARM Mbed | X | |
| Debian(Linux) | X | |
| Infineon ModusToolbox | X | |
| NXP MCUXpresso iMXRT1051B_1052B | X | |
| Renesas SSP | X | |
| STM STM32Cube FW_F4 | X | Time-out時間 HAL_MAX_DELAY |
File構成
| フォルダ* | ファイル | 概要 |
|---|---|---|
| S58LM20A_HALNAME_VERSION/sample | sample.c (.cpp) | サンプル・アプリケーション・プログラム |
| sample.h | サンプル・アプリケーション・ヘッダ | |
| S58LM20A_HALNAME_VERSION | oS58LM20A.c (.cpp) | S-58LM20A用OSS-ECALプログラム |
| oS58LM20A.h | S-58LM20A用OSS-ECALヘッダ | |
| S58LM20A_ARDUINO.ino | Arduino用サンプル・アプリケーション・プログラム | |
| oss_ecal.h | OSS-ECAL 共通ヘッダ (Ver 01.00.00以降) | |
| user_setting.c (.cpp) | ユーザ設定定数・テーブル | |
| user_setting.h | ユーザ設定ヘッダ | |
| readme.md | Readme | |
| OSS-ECAL Terms of Use.txt | OSS-ECAL利用条件 |
* HALNAMEはHAL対応表を参照してください。
HAL対応表
| HAL | MCU* | 開発環境* | HALNAME |
|---|---|---|---|
| Arduino 1.8.6 | ATmega2560 ATmega328P | Mega 2560 Rev3 Arduino Pro Mini 3.3V | ARDUINO |
| ARM Mbed 6.17.0 | STM32F401RE | 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 | MIMXRT1052DVL6A | IMXRT1050-EVKB | iMXRT1051B1052B |
| Renesas SSP 2.4.0 | R7FS7G27H3A01CFC | S7G2 SK | SSP |
| STM STM32Cube FW_F4 V1.27.1 | STM32F401RE | STM32 Nucleo-64 boards | STM32F4 |
| Debian(Linux) v2022.04 | TI AM335x | BeagleBone Black – Rev C | Linux |
* 開発時のMCUおよび開発環境。
同じHALであってもMCUや開発環境が異なると動作が合わない場合があります。
OSS-ECAL ダウンロード
OSS-ECALのダウンロードは、英語版OSS-ECALサイトからお願いいたします。なお、ダウンロードを行う際は、英語版OSS-ECALサイトにログインしてから操作してください。
組込み方法
ユーザプログラムに複数のOSS-ECAL（同じMCU機能の電子部品）を組み込む方法
ユーザプログラムに複数のOSS-ECAL（異なるMCU機能の電子部品）を組み込む方法
注意事項
サンプル版OSS-ECALは、優先順位の異なるThread（Task）や割込みで用いることを前提としていません。下記の例のような使い方はしないでください。
例）同じADCグループに各センサーが割り当てられ、優先順位が異なる処理でOSS-ECAL APIを実行すると、正しい値を取得できない場合があります。
ADC Gr0 Ch0 温度センサ AD22100A 100ms周期 Thread（優先順位低）で温度取込み
ADC Gr0 Ch1 圧力センサ MPX5999D イベント割込み（優先順位高）で圧力取込み