Si70xx - RHT Sensor#

Silicon Labs Si7006/13/20/21 Relative Humidity and Temperature Sensor I2C driver.

Si70xx example code#

Basic example for relative humidity and temperature measurement using an Si7021 sensor:

#include "sl_i2cspm_instances.h"
#include "sl_si70xx.h"

int main( void )
{

  ...

  int32_t temp_data;
  uint32_t rh_data;

  sl_si70xx_init(sl_i2cspm_sensor, SI7021_ADDR);
  sl_si70xx_measure_rh_and_temp(sl_i2cspm_sensor, SI7021_ADDR, &rh_data, &temp_data);

  ...

}

Sensor Defines#

#define

SI7006_ADDR 0X40

I2C device address for Si7006.

#define

SI7013_ADDR 0x41

I2C device address for Si7013.

#define

SI7020_ADDR 0X40

I2C device address for Si7020.

#define

SI7021_ADDR 0x40

I2C device address for Si7021.

#define

SI7006_DEVICE_ID 0x06

Device ID value for Si7006.

#define

SI7013_DEVICE_ID 0x0D

Device ID value for Si7013.

#define

SI7020_DEVICE_ID 0x14

Device ID value for Si7020.

#define

SI7021_DEVICE_ID 0x15

Device ID value for Si7021.

Functions#

sl_status_t

sl_si70xx_init(sl_i2cspm_t *i2cspm, uint8_t addr)

Initialize the Si70xx sensor.

bool

sl_si70xx_present(sl_i2cspm_t *i2cspm, uint8_t addr, uint8_t *device_id)

Check whether an Si7006/13/20/21 is present on the I2C bus or not.

sl_status_t

sl_si70xx_measure_rh_and_temp(sl_i2cspm_t *i2cspm, uint8_t addr, uint32_t *rhData, int32_t *tData)

Measure relative humidity and temperature from an Si7006/13/20/21 sensor.

sl_status_t

sl_si70xx_get_firmware_revision(sl_i2cspm_t *i2cspm, uint8_t addr, uint8_t *fwRev)

Read Firmware Revision from an Si7006/13/20/21 sensor.

sl_status_t

sl_si70xx_read_rh_and_temp(sl_i2cspm_t *i2cspm, uint8_t addr, uint32_t *rhData, int32_t *tData)

Read relative humidity and temperature from an Si7006/13/20/21 sensor.

sl_status_t

sl_si70xx_start_no_hold_measure_rh_and_temp(sl_i2cspm_t *i2cspm, uint8_t addr)

Start a no hold measurement of relative humidity and temperature from an Si7006/13/20/21 sensor.

sl_status_t

sl_si7013_measure_analog_voltage(sl_i2cspm_t *i2cspm, uint8_t addr, int32_t *vData)

Measure the analog voltage or thermistor temperature from the Si7013 sensor.

Sensor Defines Documentation#

SI7006_ADDR#

#define SI7006_ADDR

Value:

0X40

I2C device address for Si7006.

Definition at line 78 of file hardware/driver/si70xx/inc/sl_si70xx.h

SI7013_ADDR#

#define SI7013_ADDR

Value:

0x41

I2C device address for Si7013.

Definition at line 80 of file hardware/driver/si70xx/inc/sl_si70xx.h

SI7020_ADDR#

#define SI7020_ADDR

Value:

0X40

I2C device address for Si7020.

Definition at line 82 of file hardware/driver/si70xx/inc/sl_si70xx.h

SI7021_ADDR#

#define SI7021_ADDR

Value:

0x40

I2C device address for Si7021.

Definition at line 84 of file hardware/driver/si70xx/inc/sl_si70xx.h

SI7006_DEVICE_ID#

#define SI7006_DEVICE_ID

Value:

0x06

Device ID value for Si7006.

Definition at line 87 of file hardware/driver/si70xx/inc/sl_si70xx.h

SI7013_DEVICE_ID#

#define SI7013_DEVICE_ID

Value:

0x0D

Device ID value for Si7013.

Definition at line 89 of file hardware/driver/si70xx/inc/sl_si70xx.h

SI7020_DEVICE_ID#

#define SI7020_DEVICE_ID

Value:

0x14

Device ID value for Si7020.

Definition at line 91 of file hardware/driver/si70xx/inc/sl_si70xx.h

SI7021_DEVICE_ID#

#define SI7021_DEVICE_ID

Value:

0x15

Device ID value for Si7021.

Definition at line 93 of file hardware/driver/si70xx/inc/sl_si70xx.h

Function Documentation#

sl_si70xx_init#

sl_status_t sl_si70xx_init (sl_i2cspm_t * i2cspm, uint8_t addr)

Initialize the Si70xx sensor.

Parameters

[in]	i2cspm	The I2C peripheral to use.
[in]	addr	The I2C address to probe.

Definition at line 107 of file hardware/driver/si70xx/inc/sl_si70xx.h

sl_si70xx_present#

bool sl_si70xx_present (sl_i2cspm_t * i2cspm, uint8_t addr, uint8_t * device_id)

Check whether an Si7006/13/20/21 is present on the I2C bus or not.

Parameters

[in]	i2cspm	The I2C peripheral to use.
[in]	addr	The I2C address to probe.
[out]	device_id	Write device ID from SNB_3 if device responds. Pass in NULL to discard. Should be 0x0D for Si7013, 0x14 for Si7020 or 0x15 for Si7021

Definition at line 122 of file hardware/driver/si70xx/inc/sl_si70xx.h

sl_si70xx_measure_rh_and_temp#

sl_status_t sl_si70xx_measure_rh_and_temp (sl_i2cspm_t * i2cspm, uint8_t addr, uint32_t * rhData, int32_t * tData)

Measure relative humidity and temperature from an Si7006/13/20/21 sensor.

Parameters

[in]	i2cspm	The I2C peripheral to use.
[in]	addr	The I2C address of the sensor.
[out]	rhData	The relative humidity in percent (multiplied by 1000).
[out]	tData	The temperature in milliCelsius.

Definition at line 138 of file hardware/driver/si70xx/inc/sl_si70xx.h

sl_si70xx_get_firmware_revision#

sl_status_t sl_si70xx_get_firmware_revision (sl_i2cspm_t * i2cspm, uint8_t addr, uint8_t * fwRev)

Read Firmware Revision from an Si7006/13/20/21 sensor.

Parameters

[in]	i2cspm	The I2C peripheral to use.
[in]	addr	The I2C address of the sensor.
[out]	fwRev	The internal firmware revision. 0xFF === 1.0

Definition at line 153 of file hardware/driver/si70xx/inc/sl_si70xx.h

sl_si70xx_read_rh_and_temp#

sl_status_t sl_si70xx_read_rh_and_temp (sl_i2cspm_t * i2cspm, uint8_t addr, uint32_t * rhData, int32_t * tData)

Read relative humidity and temperature from an Si7006/13/20/21 sensor.

Parameters

[in]	i2cspm	The I2C peripheral to use.
[in]	addr	The I2C address of the sensor.
[out]	rhData	The relative humidity in percent (multiplied by 1000).
[out]	tData	The temperature in milliCelsius.

Definition at line 169 of file hardware/driver/si70xx/inc/sl_si70xx.h

sl_si70xx_start_no_hold_measure_rh_and_temp#

sl_status_t sl_si70xx_start_no_hold_measure_rh_and_temp (sl_i2cspm_t * i2cspm, uint8_t addr)

Start a no hold measurement of relative humidity and temperature from an Si7006/13/20/21 sensor.

Parameters

[in]	i2cspm	The I2C peripheral to use.
[in]	addr	The I2C address of the sensor.

Definition at line 182 of file hardware/driver/si70xx/inc/sl_si70xx.h

sl_si7013_measure_analog_voltage#

sl_status_t sl_si7013_measure_analog_voltage (sl_i2cspm_t * i2cspm, uint8_t addr, int32_t * vData)

Measure the analog voltage or thermistor temperature from the Si7013 sensor.

Parameters

[in]	i2cspm	The I2C peripheral to use.
[in]	addr	The I2C address of the sensor.
[out]	vData	The data read from the sensor.

Note

Analog voltage measurement only supported by Si7013

Definition at line 198 of file hardware/driver/si70xx/inc/sl_si70xx.h