temphum21  2.0.0.0
Main Page

TempHum 21 Click

Temp&Hum 21 Click is a compact add-on board representing temperature and humidity sensing solution. This board features the HIH8130-021-001, a highly accurate, fully-calibrated digital humidity and temperature sensor from Honeywell Sensing and Productivity Solutions. This sensor, characterized by its high accuracy (±2% RH and ±0.5°C over a wide operating temperature range) and high resolution, provides factory-calibrated 14-bit data to the host controller with a configurable I2C interface. It also comes with alarm features with selectable alarm thresholds by an MCU or externally.

Click Product page


Click library

  • Author : Stefan Filipovic
  • Date : Jun 2022.
  • Type : I2C type

Software Support

We provide a library for the TempHum 21 Click as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.

Package can be downloaded/installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Library Description

This library contains API for TempHum 21 Click driver.

Standard key functions :

Example key functions :

  • temphum21_read_measurement This function requests measurement and waits for a measurement to complete and after that reads temperature in Celsius and relative humidity in percents.
    err_t temphum21_read_measurement ( temphum21_t *ctx, float *temperature, float *humidity );
  • temphum21_get_all_pin This function returns the alarm low (ALL) pin logic state.
  • temphum21_get_alh_pin This function returns the alarm high (ALH) pin logic state.

Example Description

This example demonstrates the use of Temp & Hum 21 Click board by reading the temperature and humidity data.

The demo application is composed of two sections :

Application Init

Initializes the driver and performs the Click default configuration.

void application_init ( void )
{
log_cfg_t log_cfg;
temphum21_cfg_t temphum21_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
temphum21_cfg_setup( &temphum21_cfg );
TEMPHUM21_MAP_MIKROBUS( temphum21_cfg, MIKROBUS_1 );
if ( I2C_MASTER_ERROR == temphum21_init( &temphum21, &temphum21_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
if ( TEMPHUM21_ERROR == temphum21_default_cfg ( &temphum21 ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}

Application Task

Reads the temperature (Celsius) and humidity (Percents) data and displays the results on the USB UART approximately once per second.

It also checks if any alarm is detected on the humidity measurement.

void application_task ( void )
{
float temperature = 0;
float humidity = 0;
if ( TEMPHUM21_STATUS_NORMAL_OP == temphum21_read_measurement ( &temphum21, &temperature, &humidity ) )
{
if ( temphum21_get_all_pin ( &temphum21 ) )
{
log_info ( &logger, " Alarm LOW detected " );
}
else if ( temphum21_get_alh_pin ( &temphum21 ) )
{
log_info ( &logger, " Alarm HIGH detected " );
}
log_printf ( &logger, " Temperature: %.2f C\r\n", temperature );
log_printf ( &logger, " Humidity: %.2f %%\r\n\n", humidity );
Delay_ms ( 1000 );
}
}

The full application code, and ready to use projects can be installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Other Mikroe Libraries used in the example:

  • MikroSDK.Board
  • MikroSDK.Log
  • Click.TempHum21

Additional notes and informations

Depending on the development board you are using, you may need USB UART Click, USB UART 2 Click or RS232 Click to connect to your PC, for development systems with no UART to USB interface available on the board. UART terminal is available in all MikroElektronika compilers.


temphum21_cfg_setup
void temphum21_cfg_setup(temphum21_cfg_t *cfg)
TempHum 21 configuration object setup function.
temphum21_read_measurement
err_t temphum21_read_measurement(temphum21_t *ctx, float *temperature, float *humidity)
TempHum 21 read measurement function.
temphum21_cfg_t
TempHum 21 Click configuration object.
Definition: temphum21.h:191
temphum21_get_alh_pin
uint8_t temphum21_get_alh_pin(temphum21_t *ctx)
TempHum 21 get alh pin function.
application_task
void application_task(void)
Definition: main.c:66
TEMPHUM21_MAP_MIKROBUS
#define TEMPHUM21_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: temphum21.h:155
temphum21_get_all_pin
uint8_t temphum21_get_all_pin(temphum21_t *ctx)
TempHum 21 get all pin function.
temphum21_init
err_t temphum21_init(temphum21_t *ctx, temphum21_cfg_t *cfg)
TempHum 21 initialization function.
application_init
void application_init(void)
Definition: main.c:30
TEMPHUM21_STATUS_NORMAL_OP
#define TEMPHUM21_STATUS_NORMAL_OP
TempHum 21 status/diagnostic/response bits.
Definition: temphum21.h:100
TEMPHUM21_ERROR
@ TEMPHUM21_ERROR
Definition: temphum21.h:211
temphum21_default_cfg
err_t temphum21_default_cfg(temphum21_t *ctx)
TempHum 21 default configuration function.
temphum21_t
TempHum 21 Click context object.
Definition: temphum21.h:170