ST HTS221 digital Humidity Sensor

Driver for the ST HTS221 digital Humidity Sensor. More...

Detailed Description

Driver for the ST HTS221 digital Humidity Sensor.

This driver provides [S]ensor [A]ctuator [U]ber [L]ayer capabilities.

Files
file	hts221_params.h
	Default configuration for ST HTS221 devices.
file	hts221_regs.h
	Register definitions for ST HTS221 devices.
file	hts221.h
	Interface definition for the ST HTS221 driver.

Data Structures
struct	hts221_params_t
	Parameters needed for device initialization. More...
struct	hts221_t
	Device descriptor for HTS221 sensors. More...

Macros
#define	HTS221_I2C_ADDRESS   (0x5F)
	Default I2C bus address (7 Bit) of HTS221 devices.

Enumerations
enum	{ HTS221_OK = 0 , HTS221_ERROR , HTS221_NOBUS , HTS221_NODEV }
	Return values and error codes. More...

Functions
int	hts221_init (hts221_t *dev, const hts221_params_t *params)
	Initialize the given HTS221 device.
int	hts221_reboot (const hts221_t *dev)
	Reboot device and reload base configuration.
int	hts221_one_shot (const hts221_t *dev)
	Set device to one shot measurement.
int	hts221_set_rate (const hts221_t *dev, const uint8_t rate)
	Set device to continuous measurements.
int	hts221_power_on (const hts221_t *dev)
	Set device to active.
int	hts221_power_off (const hts221_t *dev)
	Set device to power down.
int	hts221_get_state (const hts221_t *dev)
	Set device to power down.
int	hts221_read_humidity (const hts221_t *dev, uint16_t *val)
	Reading humidity and temperature.
int	hts221_read_temperature (const hts221_t *dev, int16_t *val)
	Reading humidity and temperature.

Macro Definition Documentation

HTS221_I2C_ADDRESS

#define HTS221_I2C_ADDRESS   (0x5F)

Default I2C bus address (7 Bit) of HTS221 devices.

Definition at line 39 of file hts221.h.

Enumeration Type Documentation

anonymous enum

anonymous enum

Return values and error codes.

Definition at line 54 of file hts221.h.

Function Documentation

hts221_get_state()

int hts221_get_state

(

const hts221_t *

dev

)

Set device to power down.

Parameters

[in]

dev

device descriptor of sensor

Returns

>=0 on success

-HTS221_NOBUS on error

hts221_init()

int hts221_init	(	hts221_t *	dev,
		const hts221_params_t *	params
	)

Initialize the given HTS221 device.

Parameters

[out]	dev	device descriptor of sensor to initialize
[in]	params	configuration parameters

Returns

HTS221_OK on success

HTS221_NOBUS if initialization of I2C bus fails

HTS221_NODEV if no HTS221 device found on bus

hts221_one_shot()

int hts221_one_shot

(

const hts221_t *

dev

)

Set device to one shot measurement.

Parameters

[in]

dev

device descriptor of sensor

Returns

0 on success, or error otherwise

hts221_power_off()

int hts221_power_off

(

const hts221_t *

dev

)

Set device to power down.

Parameters

[in]

dev

device descriptor of sensor

Returns

0 on success, or error otherwise

hts221_power_on()

int hts221_power_on

(

const hts221_t *

dev

)

Set device to active.

Parameters

[in]

dev

device descriptor of sensor

Returns

0 on success, or error otherwise

hts221_read_humidity()

int hts221_read_humidity	(	const hts221_t *	dev,
		uint16_t *	val
	)

Reading humidity and temperature.

Parameters

[in]	dev	device descriptor of sensor
[out]	val	humidity [in 10 * percent relative]

Returns

0 on success, or error otherwise

hts221_read_temperature()

int hts221_read_temperature	(	const hts221_t *	dev,
		int16_t *	val
	)

Reading humidity and temperature.

Parameters

[in]	dev	device descriptor of sensor
[out]	val	temperature [in 100 * degree centigrade]

Returns

0 on success, or error otherwise

hts221_reboot()

int hts221_reboot

(

const hts221_t *

dev

)

Reboot device and reload base configuration.

Parameters

[in]

dev

device descriptor of sensor

Returns

0 on success, or error otherwise

hts221_set_rate()

int hts221_set_rate	(	const hts221_t *	dev,
		const uint8_t	rate
	)

Set device to continuous measurements.

Parameters

[in]	dev	device descriptor of sensor
[in]	rate	conversion rate for continuous mode

Returns

0 on success, or error otherwise