This is an overview of the AD22100A and the OSS-ECAL offering for the AD22100A. The AD22100A is a temperatures sensor IC (-40 to +85 °C) made by Analog Devices.
MCU interface : ADC
CAUTION:Please be sure to refer to the latest version of the Datasheet prior to actual design.
AD22100A
General description
The AD22100 is a monolithic temperature sensor with on-chip signal conditioning. With a temperature range of -50°C to +150°C, it is suitable for use in many HVAC, instrumentation, and automotive applications.
The signal conditioning eliminates the need for any trimming, buffering, or linearization circuitry, greatly simplifying the system design and reducing the overall system cost.
The output voltage is proportional to the temperature x the supply voltage (ratiometric). The output swings from 0.25 V at −50°C to +4.75 V at +150°C using a single +5.0 V supply.
Due to its ratiometric nature, the AD22100 offers a costeffective solution when interfacing to an analog-to-digital converter. This is accomplished by using the ADC’s +5 V power supply as a reference to both the ADC and the AD22100 eliminating the need for and cost of a precision reference.
Feature
- 200°C temperature span
- Accuracy better than ±2% of full scale
- Linearity better than ±1% of full scale
- Temperature coefficient of 22.5 mV/°C
- Output proportional to temperature × V+
- Single-supply operation
- Reverse voltage protection
- Minimal self-heating
- High level, low impedance output
Application
- HVAC systems
- System temperature compensation
- Board level temperature sensing
- Electronic thermostats
OSS-ECAL specification
API Function
etSTS oAD22100A( etCMD cmd, float32* rlt )
The oAD22100A function is an API function that executes AD22100A 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 to 85 [°C] |
Command Correspondence Table by HAL
| Arduino | eCMD_START_READ |
| ARM Mbed | eCMD_START_READ |
| AUTOSAR | – |
| 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 oAD22100A_START(void)
The oAD22100A_START function is an API function to start AD conversion of the AD22100A.
| 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 | – |
| AUTOSAR | X |
| Debian(Linux) | – |
| Infineon ModusToolbox | – |
| NXP MCUXpresso iMXRT1051B_1052B | X |
| Renesas SSP | X |
| STM STM32Cube FW_F4 | X |
etSTS oAD22100A_READ( float32* rlt )
The oAD22100A_READ function is an API function that checks for the end of AD conversion of the AD22100A, 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 to 85 [°C] |
Function Correspondence Table by HAL
| Arduino | – | |
| ARM Mbed | – | |
| AUTOSAR | X | Time-out time ADC_TIMEOUT [us] setting |
| Debian(Linux) | – | |
| Infineon ModusToolbox | – | |
| NXP MCUXpresso iMXRT1051B_1052B | X | |
| Renesas SSP | X | |
| STM STM32Cube FW_F4 | X | Time-out time HAL_MAX_DELAY |
etSTS oAD22100A_START_READ( float32* rlt )
The oAD22100A_START_READ function is an API function that starts an AD conversion of the AD22100A, 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 to 85 [°C] |
Function Correspondence Table by HAL
| Arduino | X | |
| ARM Mbed | X | |
| AUTOSAR | – | |
| 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 |
API functions for AUTOSAR
In AUTOSAR, the ADC group and channels of the MCU may be registered to the MCAL ADC channel group for AD conversion. In such a case, use the following API functions.
etSTS oMCAL_ADC_GR_START( Adc_GroupType gr )
The oMCAL_ADC_GR_START function is an API function that initiates conversion of a ADC channel group.
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_HAL_BUSY | HAL running | ||
| Parameter IN | Adc_GroupType gr | ID value of ADC channel group |
etSTS oMCAL_ADC_GR_READ( Adc_GroupType gr, Adc_ValueGroupType* buf )
The oMCAL_ADC_GR_READ function is an API function that checks the end of ADC conversion for the ADC channel group, reads each AD conversion value, and stores each AD conversion value in buf. This function has a Timeout function and should be used with the ADC_TIMEOUT value set.
| Return value | etSTS | OSS-ECAL status code | |
| eSTS_FIN | Completed successfully | ||
| eSTS_ERR_HAL_ADC | HAL ADC Error | ||
| eSTS_ERR_TIMEOUT | ADC Timeout error (AUTOSAR only) | ||
| sSTS_ERR_PROCESS | The return value of the Adc_GetGroupStatus function is other than the following value. ADC_STREAM_COMPLETED ADC_BUSY | ||
| Parameter IN | Adc_GroupType gr | ID value of ADC channel group | |
| Parameter OUT | Adc_ValueGroupType* buf | First address of buffer of ADC channel group |
HAL Support List
| Manufacturer | SDK/IDE Tool | HAL Name | Ver | HALNAME | Support |
|---|---|---|---|---|---|
| Arduino | Arduino IDE | Arduino | 1.8.6 | ARDUINO | X |
| Arm | Keil MDK v6 | Mbed OS | 6.17.0 | MBED | X |
| Debian | – | GNU/Linux | 10.3 | Linux | X |
| Infineon | ModusToolbox | mtb-hal-cat1 | 2.4.3 | ModusToolbox | X |
| NXP | MCUXpresso SDK | SDK_2.x_EVKB-IMXRT1050 | 2.16 | iMXRT1051B1052B | X |
| NXP | PlatformSDK_S32K1_2022_02 | AUTOSAR MCAL | 4.4 | MCAL | X |
| Renesas | Synergy Software Package | HAL | 2.6.0 | SSP | X |
| STMicroelectronics | STM32Cube | STM32CubeF4 | V1.28.1 | STM32F4 | X |
Development environment
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.
| HALNAME | Manufacturer | Board | MCU | IDE |
|---|---|---|---|---|
| ARDUINO | Arduino | 1.Mega 2560 Rev3 2.Arduino Pro Mini 3.3V | ATmega2560 ATmega328P | Arduino IDE 2.3.3 |
| MBED | STMicroelectronics | STM32 Nucleo-64 boards | STM32F401RETx | Arm Keil Studio Cloud |
| Linux | BeagleBoard | BeagleBone Black | TI AM335x | – |
| ModusToolbox | Infineon | CY8CPROTO-063-BLE PSoC 6 BLE Prototyping Kit | CYBLE-416045-02 | ModusToolbox |
| iMXRT1051B1052B | NXP | IMXRT1050-EVKB | i.MX RT1050 | MCUXpresso IDE |
| MCAL | STMicroelectronics | S32K144EVB-Q100 | S32K144 | S32 Design Studio for S32 Platform |
| SSP | Renesas | S7G2 SK | R7FS7G27H3A01CFC | e² studio for Renesas Synergy |
| STM32F4 | STMicroelectronics | STM32 Nucleo-64 boards | STM32F401RETx | STM32CubeIDE |
File Structure
| Folder | File | Summary |
|---|---|---|
| AD22100A_HALNAME_010000/sample | sample.c (.cpp) | Sample application program |
| sample.h | Sample application header | |
| AD22100A_HALNAME_010000 | oAD22100A.c (.cpp) | OSS-ECAL program for AD22100A |
| oAD22100A.h | OSS-ECAL header for AD22100A | |
| oss_ecal.h | OSS-ECAL common header | |
| AD22100A_ARDUINO.ino | Sample application programs for Arduino | |
| oTypes.h | Typedef header file for AUTOSAR | |
| user_setting.c (.cpp) | User configured constants and tables | |
| user_setting.h | User configuration Header | |
| oHAL_i2c_stm32f4.c | HAL Program for STM32Cube FW_F4 | |
| oHAL_i2c_stm32f4.h | HAL Header for STM32Cube FW_F4 | |
| readme.md | Readme | |
| OSS-ECAL Terms of Use.txt | OSS-ECAL Terms of Use |
* For HALNAME, please refer to HAL Support.
OSS-ECAL Download Contact
Please login before contacting us for downloads.
To register as a new user, 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