STLM20 Grade9(STLM20DD9F) is a temperatures sensor IC (-40 °C to +85 °C) made by STMicroelectronics. This posting will provide the OSS-ECAL(Open Source Software for Electronic Components Abstraction Layer) for STLM20 Grade9.
MCU interface : ADC
For Datasheet, please search by model number from here as instructed by STMicroelectronics.
CAUTION:Please be sure to refer to the latest version of the Datasheet prior to actual design.
STLM20 Grade 9(STLM20DD9F)
General description
The STLM20 is a precision analog output temperature sensor for low current applications where maximizing battery life is important. It operates over a –55 °C to 130 °C (grade 7) or –40 °C to 85 °C (grade 9) temperature range. The power supply operating range is 2.4 V to 5.5 V. The maximum temperature accuracy of the STLM20 is ± 1.5 °C (±0.5 °C typ) at an ambient temperature of 25 °C and VCC of 2.7 V. The temperature error increases linearly and reaches a maximum of ±2.5 °C at the temperature range extremes. The temperature range is affected by the power supply voltage. For the temperature grade 7 device, a power supply voltage of 2.7 V to 5.5 V, the temperature range extremes are +130 °C and –55 °C (decreasing the power supply voltage from 2.7 V to 2.4 V changes the low end of the operating temperature range from –55 °C to –30 °C, while the positive remains at +130 °C).
The STLM20 has a maximum quiescent supply current of 8 µA. Therefore, self-heating is negligible.
Feature
- Precision analog voltage output temperature sensor
- ±1.5 °C maximum temperature accuracy at 25 °C (±0.5 °C typical)
- Ultra-low quiescent supply current:4.8 µA (typ) and 8.0 µA (max)
- Operating voltage range: 2.4 V to 5.5 V
- Operating temperature range:
-55 °C to 130 °C (grade 7)
-40 °C to 85 °C (grade 9) - SOT323-5L 5-lead package
- UDFN-4L 4-lead package
Application
- Smartphones
- Multimedia PDA devices
- GPS devices
- Portable medical instruments
- Voltage-controlled crystal oscillator temperature monitors
- RF power transistor monitor
OSS-ECAL specification
API Function
etSTS oSTLM20DD9F( etCMD cmd, float32* rlt )
The oSTLM20DD9F function is an API function that executes STLM20 Grade 9(STLM20DD9F) processing according to the command in the argument.
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_ERR_MIN | Minimum temperature error (rlt is minimum temperature) | ||
| eSTS_ERR_MAX | Maximum temperature error (rlt is maximum temperature) | ||
| eSTS_ERR_HAL_ADC | HAL ADC Error | ||
| eSTS_ERR_COMMAND_CODE | Command selection error | ||
| eSTS_ERR_OTHERS_RUN | Other components are executing the process | ||
| eSTS_ERR_HAL_OTHERS_RUN | Other application is running HAL | ||
| eSTS_ERR_ADC_OBJECT | AD conversion object selection error | ||
| Parameter IN | etCMD cmd | OSS-ECAL command code | |
| eCMD_START | Command to start AD conversion. | ||
| eCMD_READ | Command that reads the AD conversion value, converts the AD conversion value to a characteristic Temperature, and stores the Temperature in rlt. AD conversion value to temperature conversion equation Voltage value = (AD conversion value × VDD) / ( 2AD bit ) Temperature = ((voltage value – voltage offset value) / gain) + Temperature offset value (Min, Max Limit) | ||
| eCMD_START_READ | Command that starts AD conversion, waits for AD conversion to finish, reads out the AD conversion value, converts the AD conversion value to a characteristic Temperature, and stores the Temperature in rlt. AD conversion value to temperature conversion equation Voltage value = (AD conversion value × VDD) / ( 2AD bit ) Temperature = ((voltage value – voltage offset value) / gain) + Temperature offset value (Min, Max Limit) | ||
| Parameter OUT | float32* rlt | Temperature -40.0 to +85.0 [°C] |
Command Correspondence Table by 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 oSTLM20DD9F_START(void)
The oSTLM20DD9F_START function is an API function to start AD conversion of the STLM20 Grade 9(STLM20DD9F).
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_ERR_HAL_ADC | HAL ADC Error | ||
| eSTS_ERR_OTHERS_RUN | Other components are executing the process | ||
| eSTS_ERR_HAL_OTHERS_RUN | Other application is running HAL | ||
| eSTS_ERR_ADC_OBJECT | AD conversion object selection error |
Function Correspondence Table by HAL
| Arduino | – |
| ARM Mbed | – |
| Debian(Linux) | – |
| Infineon ModusToolbox | – |
| NXP MCUXpresso iMXRT1051B_1052B | X |
| Renesas SSP | X |
| STM STM32Cube FW_F4 | X |
etSTS oSTLM20DD9F_READ( float32* rlt )
The oSTLM20DD9F_READ function is an API function that checks for the end of AD conversion of the STLM20 Grade 9(STLM20DD9F), reads the AD conversion value, converts the AD conversion value to a characteristic temperature, and stores the temperature in rlt.
AD conversion value to temperature conversion equation
Voltage value = (AD conversion value × VDD) / ( 2AD bit )
Temperature = ((voltage value – voltage offset value) / gain) + Temperature offset value (Min, Max Limit)
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_ERR_MIN | Minimum temperature error (rlt is minimum temperature) | ||
| eSTS_ERR_MAX | Maximum temperature error (rlt is maximum temperature) | ||
| eSTS_ERR_HAL_ADC | HAL ADC Error | ||
| eSTS_ERR_TIMEOUT | ADC Timeout error (AUTOSAR only) | ||
| eSTS_ERR_OTHERS_RUN | Other components are executing the process | ||
| eSTS_ERR_ADC_OBJECT | AD conversion object selection error | ||
| Parameter OUT | float32* rlt | Temperature -40.0 to +85.0 [°C] |
Function Correspondence Table by HAL
| Arduino | – | |
| ARM Mbed | – | |
| Debian(Linux) | – | |
| Infineon ModusToolbox | – | |
| NXP MCUXpresso iMXRT1051B_1052B | X | |
| Renesas SSP | X | |
| STM STM32Cube FW_F4 | X | Time-out time HAL_MAX_DELAY |
etSTS oSTLM20DD9F_START_READ( float32* rlt )
The oSTLM20DD9F_START_READ function is an API function that starts an AD conversion of the STLM20 Grade 9(STLM20DD9F), waits for the AD conversion to finish, reads the AD conversion value, converts the AD conversion value to a temperature characteristic, and stores the temperature in rlt.
AD conversion value to temperature conversion equation
Voltage value = (AD conversion value × VDD) / ( 2AD bit )
Temperature = ((voltage value – voltage offset value) / gain) + Temperature offset value (Min, Max Limit)
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_ERR_MIN | Minimum temperature error (rlt is minimum temperature) | ||
| eSTS_ERR_MAX | Maximum temperature error (rlt is maximum temperature) | ||
| eSTS_ERR_HAL_ADC | HAL ADC Error | ||
| eSTS_ERR_OTHERS_RUN | Other components are executing the process | ||
| eSTS_ERR_HAL_OTHERS_RUN | Other application is running HAL | ||
| eSTS_ERR_ADC_OBJECT | AD conversion object selection error | ||
| Parameter OUT | float32* rlt | Temperature -40.0 to +85.0 [°C] |
Function Correspondence Table by 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 time HAL_MAX_DELAY |
Files
| Folder* | File | Summary |
|---|---|---|
| STLM20DD9F_HALNAME_VERSION/sample | sample.c (.cpp) | Sample Application Program |
| sample.h | Sample Application Header | |
| STLM20DD9F_HALNAME_VERSION | oSTLM20DD9F.c (.cpp) | OSS-ECAL Program for STLM20 Grade 9(STLM20DD9F) |
| oSTLM20DD9F.h | OSS-ECAL Header for STLM20 Grade 9(STLM20DD9F) | |
| STLM20DD9F_ARDUINO.ino | Sample application programs for Arduino | |
| oss_ecal.h | OSS-ECAL Common Header (Ver 01.00.00 or later) | |
| user_setting.c (.cpp) | Const and Table of User setting | |
| user_setting.h | Header of User setting | |
| readme.md | Readme | |
| OSS-ECAL Terms of Use.txt | OSS-ECAL Terms of Use |
* For HALNAME, please refer to HAL Support.
HAL Support List
| HAL | MCU* | Development environment* | 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 and development environment at the time of development. Even if the same HAL is used, different MCUs and development environments may not work together.
OSS-ECAL Download
Please login before downloading. To register as a new user, please click here.
Built-in How to
How to incorporate OSS-ECAL into user programs
How to incorporate multiple OSS-ECALs in a user program (same MCU function)
How to incorporate multiple OSS-ECALs in a user program (different MCU function)
How to incorporate multiple identical electronic components into a user program
How to reduce the impact on user programs by replacing electronic components
CAUTION
The sample version of OSS-ECAL is not intended to be used with Threads (Tasks) or interrupts of different priority. Please do not use it as in the example below.
Example: If each sensor is assigned to the same ADC group and the OSS-ECAL API is executed in processes with different priorities, correct values may not be obtained.
ADC Gr0 Ch0 Temperature sensor AD22100A 100ms cycle Thread (low priority) to take in temperature
ADC Gr0 Ch1 Pressure sensor MPX5999D Event interrupts (high priority) to take pressure