CHS series（UPS, UPR, UGS, UGR） is a Humidity sensor IC (5%RH to 95%RH) made by TDK. This posting will provide the OSS-ECAL(Open Source Software for Electronic Components Abstraction Layer) for CHS series.
MCU interface : ADC
CAUTION:The original language of this resource is Japanese. The translations are provided as a convenience and may be machine-translated, and we make no warranties as to the accuracy or adequacy of the translations. Please refer to the latest version of the Datasheet prior to actual design, etc.
CHS series(UPS, UPR, UGS, UGR)
General description
TDK supplies high-precision humidity sensor elements made of our proprietary high-polymer materials and circuit-integrated humidity sensor assemblies based on our proprietary circuit design technology. The humidity sensor element is a high-sensitivity, high-precision, resistance-change type humidity sensor element made of our originally developed polymer material. It features high accuracy of ±5%RH, high sensitivity, compact size, high response, and low hysteresis characteristics. The humidity sensor assembly is a compact product with an integrated circuit, and its DC power supply drive and DC voltage output make it easy to use and control. The screw-mount type can be easily installed at the detection point. It features a wide humidity detection range (5 to 95(%)RH), high humidity detection accuracy (±3%RH to ±7%RH), and low hysteresis characteristics. It can be used for a wide range of applications such as printers, refrigerators (humidity control for outside storage/vegetable compartment), air conditioners (humidity control inside the room), and air conditioning equipment for plant factories.
Feature
- A wide range of humidity from 5 to 95(%)RH can be measured
- High accuracy. In particular, the nominal accuracy of CHS-UPR and -UPS is ±3(%)RH or less
- Temperature characteristics are flat over a wide range
- There is almost no hysteresis in moisture sensitivity characteristics
- Compact, can be installed in any location, and offers excellent cost performance
- Low current consumption
- DC.1V output displays 100(%)RH, and the relative humidity can be read directly by the voltmeter
- All-in-one construction integrates all necessary circuits and operates by simply connecting a power supply (5 V)
Application
- Refrigerator (condensation prevention)
- Air conditioning (indoor humidity control)
- PPC, LBP (image quality control)
- Industrial electronic humidity meters, air conditioning equipment for plant factories, etc.
OSS-ECAL specification
API Function
etSTS oCHS( etCMD cmd, float32* rlt )
Return value
Parameter IN
Parameter OUT
etSTS
etCMD cmd
float32* rlt
OSS-ECAL status code
OSS-ECAL command code
Humidity 5 to 95 [%]
etCMD
eCMD_START
Feature :
Command to start AD conversion.
Process :
1. AD conversion start.
Command API function :
etSTS oCHS_START( void )
Return value :
eSTS_FIN
eSTS_ERR_HAL_ADC
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_ADC_OBJECT
NOTE :
Arduino, Mbeb, ModusToolbox not supported.
eCMD_READ
Feature :
Command that reads the AD conversion value, converts the AD conversion value to a characteristic Humidity, and stores the Humidity in rlt.
Process :
1. Read AD conversion value.
2. Convert AD conversion value to Humidity.
Voltage value = (AD conversion value × VDD) / ( 2AD bit )
Humidity = ((voltage value – voltage offset value) / gain) + Humidity offset value (Min, Max Limit)
3. Store Humidity to rlt.
Command API function :
etSTS oCHS_READ( float32* rlt )
Return value :
eSTS_FIN
eSTS_ERR_MIN
eSTS_ERR_MAX
eSTS_ERR_HAL_ADC
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_ADC_OBJECT
NOTE :
Please execute this API function after starting AD conversion.
Arduino, Mbeb, ModusToolbox not supported.
eCMD_START_READ
Feature :
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 Humidity, and stores the Humidity in rlt.
Process :
1. Read AD conversion value.
2. Wait until AD conversion is completed.
3. Read AD conversion value.
4. Convert AD conversion value to Humidity.
Voltage value = (AD conversion value × VDD) / (2AD bit )
Humidity = ((voltage value – voltage offset value) / gain) + Humidity offset value (Min, Max Limit)
5. Store Humidity to rlt.
Command API function :
etSTS oCHS_START_READ( float32* rlt )
Return value :
eSTS_FIN
eSTS_ERR_MIN
eSTS_ERR_MAX
eSTS_ERR_HAL_ADC
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_ADC_OBJECT
NOTE :
Files
| Folder* | File | summary |
|---|---|---|
| CHS_HALNAME/sample | sample.c (.cpp) | Sample Application Program |
| | sample.h | Sample Application Header |
| CHS_HALNAME | oCHS.c (.cpp) | OSS-ECAL Program for CHS series |
| | oCHS.h | OSS-ECAL Header for CHS series |
| | 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
| MCU/Board manufacturer | HAL | MCU* | Development environment* | 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 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.
| HAL | Download 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 |
If you get “ABC.zip was blocked because this type of file can harm your device.” in Microsoft Edge.
If you are unable to download the File, please contact us and let us know the model number and HAL type. We will send you the file as an email attachment.
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