TheI2CBusAndTheSHT30TemperatureAndHumiditySensor < IoT_Course

Tags: view all tags

---+ Exercise 5: The !I2C bus and the SHT30 Temperature and Humidity Sensor
---++ Introduction

While the DHT11 uses a proprietary protocol the SHT30 make use of a standardized protocol: the !I2C protocol, invented by Philips at the beginning of the 1980's. To get you going with !I2C please have a look at https://learn.sparkfun.com/tutorials/i2c/all where the protocol is nicely described.
---++ Exercise 1: !I2C Bus Scan

!I2C is supported by a [[https://docs.micropython.org/en/latest/library/machine.I2C.html][driver in the MicroPython]] binary.

The ESP32 has 2 hardware !I2C interfaces (bus 0 and bus 1) with GPIO 21 connected to SDA and GPIO 22 connected to SCL of bus1.

Write a script that scans the !I2C bus and prints all available !I2C addresses in the following form:

<img alt="i2cscan.png" height="530" src="%ATTACHURL%/i2cscan.png" title="i2cscan.png" width="566" />

In the example above only the SHT30 with its address B: 0x45 is connected to the !I2C bus.

---++ Exercise 2: Read out the SHT30

First of all let's have a look at the [[https://www.sensirion.com/en/download-center/humidity-sensors/digital-humidity-sensors-for-various-applications/][SHT30 documentation]].

<img alt="sht30-1.png" height="386" src="%ATTACHURL%/sht30-1.png" title="sht30-1.png" width="327" />

The most interesting documents are<br /><br />
   * <a href="https://www.sensirion.com/fileadmin/user_upload/customers/sensirion/Dokumente/2_Humidity_Sensors/Datasheets/Sensirion_Humidity_Sensors_SHT3x_Datasheet_digital.pdf" target="_blank" title="Datasheet Humidity Sensor SHT3x Digital">Datasheet Humidity Sensor SHT3x Digital</a>
   * [[https://sensirion.com/media/documents/A419127A/6163F5FE/Sensirion_AppNotes_Humidity_Sensors_at_a_Glance.pdf][Humidity at a glance]]
   * [[https://github.com/Sensirion/python-i2c-sht][sht3x sample code]]
---++ Using a driver from github

This time we are going to be lazy (?) and just use a pure Python driver written by 'Roberto Sánchez which you can find on github at https://github.com/rsc1975/micropython-sht30/blob/master/sht30.py.

Clone the sht30 repository:

git clone https://github.com/rsc1975/micropython-sht30.git

Upload the driver to the ESP32 /lib directory:

_ampy put sht30.py /lib/sht30.py_

Now you can import the class with:

_from sht30 import SHT30_

Once this is done you can try the examples from the repository README.md.

I will give no further explication on how to use the driver other than what is given in the README.md file. Please read the source code and find out yourself which methods are implemented and how to use the driver. Does it work out of the box or do we have to make some modifications? Do you find bugs? Try the code snippets given in the README.md file and make sure they do work.
---++ Exercise 3: Can you do better? (Bonus point)

Sensirion provides a driver written in C for the STM32-Discovery board (<a href="https://www.sensirion.com/fileadmin/user_upload/customers/sensirion/Dokumente/2_Humidity_Sensors/Software/Sensirion_Humidity_Sensors_Software_SHT3x_Sample_Code.zip" target="_blank" title="Sample Code Humidity Sensor SHT3x">Sample Code Humidity Sensor SHT3x)</a>. Can you port this driver to the ESP32 and translate it into Python? Make a list of all functions the SHT30 provides and mark down, which of them are accessible by Sanchez’ driver. Can you write a driver that implements all functions the SHT30 provides?

Solving this exercise requires quite some effort but you will learn how to read and analyze a data sheet and how to convert its information into working code. Finally you can integrate your code into !MicroPython and make it available to others.

The exercise sheet in odt format:

%ATTACHURL%exercise_5.odt

-- %USERSIG{UliRaich - 2020-05-14}%

---++ Comments

%COMMENT%

Attachments

Topic attachments
I	Attachment	History	Action	Size	Date	Who
pdf	SHT30Datasheet.pdf	r1	manage	919.8 K	2020-05-14 - 15:18	UliRaich
pdf	Sensirion_Humidity_Sensors_SHT3x_Application_Note_Alert_Mode_DIS.pdf	r1	manage	334.6 K	2020-05-21 - 21:08	UliRaich
odt	exercise_5.odt	r1	manage	231.9 K	2020-08-09 - 08:54	UliRaich
png	i2cscan.png	r1	manage	40.4 K	2020-05-14 - 15:01	UliRaich
png	sht30-1.png	r1	manage	168.2 K	2020-05-17 - 18:59	UliRaich
txt	sht30.py.txt	r1	manage	6.5 K	2020-05-14 - 15:29	UliRaich

Topic revision: r13 - 2022-06-16 - UliRaich