Temperature and humidity sensor

The SHTC3 sensor provides accurate temperature and humidity measurements. It's integrated into Inkplate 6 MOTION and can be used for environmental monitoring applications.

SHTC3 on the Inkplate 6 MOTION

The sensor allows you to retrieve temperature readings in Celsius or Fahrenheit, as well as humidity percentages. The readings must be updated manually before retrieving values.

ℹ️

The SHTC3 implementation in the Inkplate library uses this library from SparkFun:

SparkFun SHTC3 Humidity and Temperature Sensor Library

The original library which is included in the Inkplate 6 MOTION library

---

Initialization

Before reading temperature and humidity, the SHTC3 sensor must be powered on and initialized.

ℹ️

The SHTC3 sensor must be powered on via peripheralState. See this page for more details:

Peripheral basics

How to power peripherals on and off on Inkplate 6 MOTION

// Turn on the SHTC3 peripheral
inkplate.peripheralState(INKPLATE_PERIPHERAL_SHTC3, true);

// Initialize the sensor
inkplate.shtc3.begin();

inkplate.shtc3.begin()

Initializes the SHTC3 sensor and prepares it for measurement.

Returns: Returns true if initialization was successful, false otherwise.

---

Measuring temperature and humidity

The sensor needs to be polled with the update() function and then the temperature and humidity values can be read:

// Update sensor values before reading
if (inkplate.shtc3.update() == SHTC3_Status_Nominal)
{
    // If the sensor update went OK...
    
    // Read and print temperature in Celsius
    float temperature = inkplate.shtc3.toDegC();
    inkplate.printf("Temperature: %.2f C", temperature);

    // Read and print humidity percentage
    float humidity = inkplate.shtc3.toPercent();
    inkplate.printf("Humidity: %.2f%%", humidity);
}

inkplate.shtc3.update()

Forces a sensor reading update. This must be called before retrieving temperature or humidity values.

Returns: Returns an `SHTC3_Status_TypeDef` indicating success or failure. See below for a table of these values.

Status Code	Enum Value	Description
Nominal	SHTC3_Status_Nominal	The reading was successful, and data is valid.
General Error	SHTC3_Status_Error	A generic error occurred during the update.
CRC Check Failed	SHTC3_Status_CRC_Fail	The computed checksum did not match the provided value, indicating possible data corruption.
Device ID Mismatch	SHTC3_Status_ID_Fail	The sensor's ID did not match the expected format for an SHTC3 device.

inkplate.shtc3.toDegC()

Retrieves the latest measured temperature in degrees Celsius.

Returns: Returns the temperature as a float in °C.

inkplate.shtc3.toDegF()

Retrieves the latest measured temperature in degrees Fahrenheit.

Returns: Returns the temperature as a float in °F.

inkplate.shtc3.toPercent()

Retrieves the latest measured humidity percentage.

Returns: Returns the humidity as a float in %.

---

Full example

Inkplate_6_MOTION_TempSensor.ino

Full example of reading temperature and humidity from SHTC3 and printing them out on Inkplate 6 MOTION