esp-open-rtos/examples/sht3x/README.md
Gunar Schorcht 803931f2e2 Driver for Sensirion SHT3x sensor added
This is a driver for Sensirion SHT3x temperature and humidity sensors
connected via I2C.

This commit is a rebasing and contains some interface changes based on
the review from @ourairquality.
2017-10-12 15:42:38 +02:00

2.2 KiB

SHT3x Driver Examples

These examples references two addtional drivers i2c and sht3x, which are provided in the ../../extras folder.

If you plan to use one or both of this drivers in your own projects, please check the main development pages for updated versions or reported issues.

Hardware setup

There are examples for only one sensor and examples for two sensors.

To run examples with one sensor, just use GPIO5 (SCL) and GPIO4 (SDA) to connect to the SHT3x sensor's I2C interface.

 +------------------------+     +--------+
 | ESP8266  Bus 0         |     | SHT3x  |
 |          GPIO 5 (SCL)  >---- > SCL    |
 |          GPIO 4 (SDA)  ------- SDA    |
 |                        |     +--------+
 +------------------------+

If you want to run examples with two sensors, you could do this with only one bus and different I2C addresses or with two buses and the same or different I2C addresses. In later case, use GPIO14 (SCL) and GPIO12 (SDA) for the second bus to connect to the second SHT3x sensor's I2C interface.

 +------------------------+     +----------+
 | ESP8266  Bus 0         |     | SHT3x_1  |
 |          GPIO 5 (SCL)  >-----> SCL      |
 |          GPIO 4 (SDA)  ------- SDA      |
 |                        |     +----------+
 |          Bus 1         |     | SHT3x_2  |
 |          GPIO 14 (SCL) >-----> SCL      |
 |          GPIO 12 (SDA) ------- SDA      |
 +------------------------+     +----------+

Example description

Examples show how to use the driver in single shot as well as in periodic mode.

sht3x_one_sensor

The simple example show how to use the driver with one SHT3x sensor. It demonstrates two different user task implementations, one in single shot mode and one in periodic mode. In addition, it shows both approaches for the implementation of waiting for measurement results, one as busy waiting and one as passive waiting using vTaskDelay.

sht3x_two_sensors

This simple example shows how to use the driver for two sensors. As with the example sht3x_one_sensor, it uses two different user task implementations and waiting approaches, in this example one for each of the tasks.