CHS series(UPS, UPR, UGS, UGR)

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 )

The oCHS function is an API function that executes CHS series(UPS, UPR, UGS, UGR) processing according to the command in the argument.

Return valueetSTSOSS-ECAL status code
eSTS_FINCompleted successfully
eSTS_ERR_MINMinimum Humidity error (rlt is minimum Humidity)
eSTS_ERR_MAXMaximum Humidity error (rlt is maximum Humidity)
eSTS_ERR_HAL_ADCHAL ADC Error
eSTS_ERR_COMMAND_CODECommand selection error
eSTS_ERR_OTHERS_RUNError during execution of other components
eSTS_ERR_ADC_OBJECTAD conversion object selection error
Parameter INetCMD cmdOSS-ECAL command code
eCMD_STARTCommand to start AD conversion.
eCMD_READCommand that reads the AD conversion value, converts the AD conversion value to a characteristic Humidity, and stores the Humidity in rlt.

AD conversion value to Humidity conversion equation
Voltage value = (AD conversion value × VDD) / ( 2AD bit )
Humidity = ((voltage value – voltage offset value) / gain) + Humidity offset value (Min, Max Limit)
eCMD_START_READCommand 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.

AD conversion value to Humidity conversion equation
Voltage value = (AD conversion value × VDD) / ( 2AD bit )
Humidity = ((voltage value – voltage offset value) / gain) + Humidity offset value (Min, Max Limit)
Parameter OUTfloat32* rltHumidity 5.0 to 95.0 [%RH]

Command Correspondence Table by HAL

ArduinoArduinoeCMD_START_READ
ARMMbedeCMD_START_READ
Debian ProjectDebian(Linux)eCMD_START_READ
InfineonModusToolbox eCMD_START_READ
NXPMCUXpresso MXRT1051B_1052BeCMD_START
eCMD_READ
eCMD_START_READ
RenesasSSPeCMD_START
eCMD_READ
eCMD_START_READ
STMSTM32Cube FW_F4 eCMD_START
eCMD_READ
eCMD_START_READ
etSTS oCHS_START(void)

The oCHS_START function is an API function to start AD conversion of the CHS series(UPS, UPR, UGS, UGR).

Return valueetSTSOSS-ECAL status code
eSTS_FINCompleted successfully
eSTS_ERR_HAL_ADCHAL ADC Error
eSTS_ERR_OTHERS_RUNError during execution of other components
eSTS_ERR_ADC_OBJECTAD conversion object selection error

Function Correspondence Table by HAL

ArduinoArduino
ARMMbed
Debian ProjectDebian(Linux)
InfineonModusToolbox
NXPMCUXpresso MXRT1051B_1052BX
RenesasSSPX
STMSTM32Cube FW_F4 X
etSTS oCHS_READ( float32* rlt )

The oCHS_READ function is an API function that checks for the end of AD conversion, reads the AD conversion value, converts the AD conversion value to a characteristic Humidity, and stores the Humidity in rlt.

AD conversion value to Humidity conversion equation
Voltage value = (AD conversion value × VDD) / ( 2AD bit )
Humidity = ((voltage value – voltage offset value) / gain) + Humidity offset value (Min, Max Limit)

Return valueetSTSOSS-ECAL status code
eSTS_FINCompleted successfully
eSTS_ERR_MINMinimum Humidity error (rlt is minimum Humidity)
eSTS_ERR_MAXMaximum Humidity error (rlt is maximum Humidity)
eSTS_ERR_HAL_ADCHAL ADC Error
eSTS_ERR_TIMEOUTADC Timeout error (AUTOSAR only)
eSTS_ERR_OTHERS_RUNError during execution of other components
eSTS_ERR_ADC_OBJECTAD conversion object selection error
Parameter OUTfloat32* rltHumidity 5.0 to 95.0 [%RH]

Function Correspondence Table by HAL

ArduinoArduino
ARMMbed
Debian ProjectDebian(Linux)
InfineonModusToolbox
NXPMCUXpresso MXRT1051B_1052BX
RenesasSSPX
STMSTM32Cube FW_F4 XTime-out time HAL_MAX_DELAY
etSTS oCHS_START_READ( float32* rlt )

The oCHS_START_READ function is an API function that starts an AD conversion, waits for the AD conversion to finish, reads the AD conversion value, converts the AD conversion value to a Humidity characteristic, and stores the Humidity in rlt.

AD conversion value to Humidity conversion equation
Voltage value = (AD conversion value × VDD) / ( 2AD bit )
Humidity = ((voltage value – voltage offset value) / gain) + Humidity offset value (Min, Max Limit)

Return valueetSTSOSS-ECAL status code
eSTS_FINCompleted successfully
eSTS_ERR_MINMinimum Humidity error (rlt is minimum Humidity)
eSTS_ERR_MAXMaximum Humidity error (rlt is maximum Humidity)
eSTS_ERR_HAL_ADCHAL ADC Error
eSTS_ERR_OTHERS_RUNError during execution of other components
eSTS_ERR_ADC_OBJECTAD conversion object selection error
Parameter OUTfloat32* rltHumidity 5.0 to 95.0 [%RH]

Function Correspondence Table by HAL

ArduinoArduinoX
ARMMbedX
Debian ProjectDebian(Linux)X
InfineonModusToolbox X
NXPMCUXpresso MXRT1051B_1052BX
RenesasSSPX
STMSTM32Cube FW_F4 XTime-out time HAL_MAX_DELAY

Files

Folder*FileSummary
CHS_HALNAME_VERSION/samplesample.c (.cpp)Sample Application Program
sample.hSample Application Header
CHS_HALNAME_VERSIONoCHS.c (.cpp)OSS-ECAL Program for CHS series(UPS, UPR, UGS, UGR)
oCHS.hOSS-ECAL Header for CHS series(UPS, UPR, UGS, UGR)
CHS_ARDUINO.inoSample application programs for Arduino
oss_ecal.hOSS-ECAL Common Header (Ver 01.00.00 or later)
user_setting.c (.cpp)Const and Table of User setting
user_setting.hHeader of User setting
readme.mdReadme
OSS-ECAL Terms of Use.txtOSS-ECAL Terms of Use

* For HALNAME, please refer to HAL Support.

HAL Support List

MCU/Board
manufacturer
HALMCU*Development environment*HALNAME
ArduinoArduino 1.8.6ATmega2560
ATmega328P
Mega 2560 Rev3
Arduino Pro Mini 3.3V
ARDUINO
ARMMbed 6.17.0STM32F401RESTM32 Nucleo-64 boardsMBED
InfineonModusToolbox HAL Cat1 2.4.3CYBLE-416045-02CY8CPROTO-063-BLE PSoC 6 BLE Prototyping KitModusToolbox
NXPMCUXpresso SDK
iMXRT1051B_1052B
ksdk2_0
MIMXRT1052DVL6AIMXRT1050-EVKBiMXRT1051B1052B
RenesasSSP 2.4.0R7FS7G27H3A01CFCS7G2 SKSSP
STMSTM32Cube FW_F4 V1.27.1STM32F401RESTM32 Nucleo-64 boardsSTM32F4
Debian ProjectDebian(Linux) v2022.04TI AM335xBeagleBone Black – Rev CLinux

* 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.
This OSS-ECAL is a sample version and can be downloaded without user registration, but please accept the OSS-ECAL Terms of Use before downloading.

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

OSS-ECAL English
error: Content is protected !!