temphum19  2.0.0.0
Main Page

TempHum 19 click

PRVIH_PAR_RECENICA_SA_PRODUCT_PAGE_DA_ISPRATE_CELINU

[click Product page](CLICK_PRODUCT_PAGE_LINK)


Click library

  • Author : Stefan Filipovic
  • Date : Nov 2021.
  • Type : I2C type

Software Support

We provide a library for the TempHum 19 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 19 Click driver.

Standard key functions :

Example key functions :

  • temphum19_restart_chip This function restarts the chip by toggling the EN pin state.
  • temphum19_set_mode_reg This function programs the mode register with a desired mode value, and stores it to the ctx->detection_mode variable.
    err_t temphum19_set_mode_reg ( temphum19_t *ctx, uint8_t mode );
  • temphum19_read_data This function reads temperature and humidity raw data and converts them to Celsius and Percents respectfully.
    err_t temphum19_read_data ( temphum19_t *ctx, float *temperature, float *humidity );

Example Description

This example demonstrates the use of Temp & Hum 19 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;
temphum19_cfg_t temphum19_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
temphum19_cfg_setup( &temphum19_cfg );
TEMPHUM19_MAP_MIKROBUS( temphum19_cfg, MIKROBUS_1 );
if ( I2C_MASTER_ERROR == temphum19_init( &temphum19, &temphum19_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
if ( TEMPHUM19_ERROR == temphum19_default_cfg ( &temphum19 ) )
{
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.

void application_task ( void )
{
float temperature, humidity;
if ( TEMPHUM19_OK == temphum19_read_data ( &temphum19, &temperature, &humidity ) )
{
log_printf ( &logger, " Temperature: %.1f 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.TempHum19

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.


temphum19_read_data
err_t temphum19_read_data(temphum19_t *ctx, float *temperature, float *humidity)
TempHum 19 read data function.
temphum19_default_cfg
err_t temphum19_default_cfg(temphum19_t *ctx)
TempHum 19 default configuration function.
temphum19_cfg_t
TempHum 19 Click configuration object.
Definition: temphum19.h:164
temphum19_restart_chip
void temphum19_restart_chip(temphum19_t *ctx)
TempHum 19 restart chip function.
TEMPHUM19_ERROR
@ TEMPHUM19_ERROR
Definition: temphum19.h:182
application_task
void application_task(void)
Definition: main.c:65
TEMPHUM19_OK
@ TEMPHUM19_OK
Definition: temphum19.h:181
temphum19_set_mode_reg
err_t temphum19_set_mode_reg(temphum19_t *ctx, uint8_t mode)
TempHum 19 set mode function.
temphum19_cfg_setup
void temphum19_cfg_setup(temphum19_cfg_t *cfg)
TempHum 19 configuration object setup function.
temphum19_init
err_t temphum19_init(temphum19_t *ctx, temphum19_cfg_t *cfg)
TempHum 19 initialization function.
application_init
void application_init(void)
Definition: main.c:29
temphum19_t
TempHum 19 Click context object.
Definition: temphum19.h:143
TEMPHUM19_MAP_MIKROBUS
#define TEMPHUM19_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: temphum19.h:130