CHS 系列 (UPS, UPR, UGS, UGR)

CHS 系列 (UPS, UPR, UGS, UGR)的概述以及CHS 系列用OSS-ECAL的提供情况。CHS 系列是 TDK 公司生产的湿度传感器IC（湿度范围为 5%RH 至 95%RH）。
MCU interface : ADC

注意: 本资源的原始语言为英语。翻译仅为方便起见提供概要，可能使用了机器翻译，我们对翻译的准确性和合理性不作任何保证。此外，在进行实际设计等操作前，请务必参考最新版本的Datasheet。

CHS 系列

概述

在湿度传感器方面，TDK提供有使用自行开发的高分子材料的高精度湿度传感器器件，以及通过独特电路设计技术实现电路一体型的湿度传感器集成产品。湿度传感器器件是采用了自行开发的高分子材料，实现高灵敏度、高精度的电阻变化型湿度传感器器件。其拥有±5%RH的高精度、高灵敏度、小型、高响应、低磁滞特性等特点。湿度传感器集成产品为电路一体型小型产品，由于是DC电源驱动/DC电压输出，因此使用简单，控制方便。螺丝固定型产品可简单安装在检测部位。
其拥有湿度检测范围广(5~95(%)RH)、湿度检测精度高(±3%RH~±7%RH)以及低磁滞特性等特点。
可广泛用于打印机、冰箱(外部/蔬菜室湿度管理)、空调(室内湿度管理)、植物工厂用空调设备等用途。

特点

湿度范围从5%RH到95%RH均可测量。
高精度。特别是，CHS-UPR和-UPS的标称精度为±3%RH或更低。
温度特性在宽范围内保持平稳。
在湿度敏感特性方面几乎没有滞后现象。
紧凑型设计，可安装在任何位置，且具有卓越的成本效益。
低电流消耗。
直流1伏输出显示100%相对湿度，相对湿度可直接通过电压表读取。
一体化结构集成了所有必要的电路，只需连接电源（5 V）即可正常工作。

用途

冰箱（防凝露）
空调（室内湿度控制）
PPC、LBP（画质管理）
工业用电子湿度测量仪、植物工厂用空调设备等

OSS-ECAL规格

API 函数

OSS-ECAL API 函数基本上被假定为周期性Thread (TASK) 的函数调用。

etSTS oCHS_START(void)

oCHS_START 函数是用于启动 CHS 的 AD 转换的 API 函数。

返回值	etSTS	OSS-ECAL status code
		eSTS_FIN	成功完成
		eSTS_ERR_HAL_ADC	HAL ADC 错误
		eSTS_ERR_OTHERS_RUN	其他组件正在执行程序
		eSTS_ERR_HAL_OTHERS_RUN	其他应用程序正在运行 HAL (STM32F4)
		eSTS_ERR_ADC_OBJECT	ADC 对象选择错误

etSTS oCHS_READ( float32* rlt )

oCHS_READ 函数是一个 API 函数，用于检测 CHS 的 AD 转换是否结束，读取 AD 转换值，将 AD 转换值转换为特征湿度，并将湿度存储在 rlt 中。

模数转换值到湿度转换方程
Voltage value = (AD conversion value × VDD) / ( 2^{AD bit} )
Humidity = ((voltage value – voltage offset value) / gain) + Humidity offset value (Min, Max Limit)

返回值	etSTS	OSS-ECAL status code
		eSTS_FIN	成功完成
		eSTS_ERR_MIN	最低湿度error（rlt为最低湿度）
		eSTS_ERR_MAX	最高湿度error（rlt为最高湿度）
		eSTS_ERR_HAL_ADC	HAL ADC 错误 (STM32F4 Timeout)
		eSTS_ERR_OTHERS_RUN	其他组件正在执行程序
		eSTS_ERR_ADC_OBJECT	ADC 对象选择错误
参数 OUT	float32* rlt	湿度 5%RH 至 95%RH

etSTS oCHS_START_READ( float32* rlt )

oCHS_START_READ 函数是一个 API 函数，用于启动 CHS 的 AD 转换，等待 AD 转换完成，读取 AD 转换值，将 AD 转换值转换为湿度特性，并将湿度存储在 rlt 中。

返回值	etSTS	OSS-ECAL status code
		eSTS_FIN	成功完成
		eSTS_ERR_MIN	最低湿度error（rlt为最低湿度）
		eSTS_ERR_MAX	最高湿度error（rlt为最高湿度）
		eSTS_ERR_HAL_ADC	HAL ADC 错误 (STM32F4 Timeout)
		eSTS_ERR_OTHERS_RUN	其他组件正在执行程序
		eSTS_ERR_HAL_OTHERS_RUN	其他应用程序正在运行 HAL (STM32F4)
		eSTS_ERR_ADC_OBJECT	ADC 对象选择错误
参数 OUT	float32* rlt	湿度 5%RH 至 95%RH

HAL 支持列表

OSS-ECAL 的 HAL 支持如下。请注意，即使使用相同的 HAL，不同的版本、MCU 和开发环境也可能无法协同工作。该列表正在按顺序扩展。

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
Renesas	Synergy Software Package	HAL	2.6.0	SSP	X
STMicroelectronics	STM32Cube	STM32CubeF4	V1.28.1	STM32F4	X

HAL 功能对应表

HALNAME	oCHS_START	oCHS_READ	oCHS_START_READ
ARDUINO	–	–	X
MBED	–	–	X
Linux	–	–	X
ModusToolbox	–	–	X
iMXRT1051B1052B	X	X	X
SSP	X	X	X
STM32F4	X	X Time-out time: HAL_MAX_DELAY	X Time-out time: HAL_MAX_DELAY

开发环境

OSS-ECAL 开发过程中的 MCU 和开发环境如下。

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
SSP	Renesas	S7G2 SK	R7FS7G27H3A01CFC	e² studio for Renesas Synergy
STM32F4	STMicroelectronics	STM32 Nucleo-64 boards	STM32F401RETx	STM32CubeIDE

文件结构

Folder*	File	Summary
CHS_HALNAME_010000/sample	sample.c (.cpp)	Sample application program
	sample.h	Sample application header
CHS_HALNAME_010000	oCHS.c (.cpp)	OSS-ECAL program for CHS series
	oCHS.h	OSS-ECAL header for CHS series
	oss_ecal.h	OSS-ECAL common header
	CHS_ARDUINO.ino	Sample application programs for Arduino
	user_setting.c (.cpp)	User configured constants and tables
	user_setting.h	User configuration Header
	readme.md	Readme
	OSS-ECAL Terms of Use.txt	OSS-ECAL Terms of Use