thermostat4  2.0.0.0
Main Page

Thermostat 4 click

Thermostat 4 Click is complete solution that senses the temperature of a physical system and can performs actions so that the system's temperature is maintained near a desired setpoint. It's based on Texas Instruments TMP392, a resistor programmable temperature switch that enable protection and detection of system thermal events from 30°C to 130°C.

click Product page


Click library

  • Author : MikroE Team
  • Date : jul 2020.
  • Type : SPI type

Software Support

We provide a library for the Thermostat4 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 form compilers IDE(recommended way), or downloaded from our LibStock, or found on mikroE github account.

Library Description

This library contains API for Thermostat4 Click driver.

Standard key functions :

Example key functions :

Examples Description

Thermostat 4 Click reads alert on the warm and hot channel, using standard SPI communication.

The demo application is composed of two sections :

Application Init

Initializes Driver init, Relay test and sets hysteresis on the WARM channel ( channel B ), after thet starts uploading new data.

void application_init ( void )
{
log_cfg_t log_cfg;
thermostat4_cfg_t thermostat4_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, "---- Application Init ----" );
// Click initialization.
thermostat4_cfg_setup( &thermostat4_cfg );
THERMOSTAT4_MAP_MIKROBUS( thermostat4_cfg, MIKROBUS_1 );
err_t init_flag = thermostat4_init( &thermostat4, &thermostat4_cfg );
if ( SPI_MASTER_ERROR == init_flag ) {
log_error( &logger, " Application Init Error. " );
log_info( &logger, " Please, run program again... " );
for ( ; ; );
}
log_printf( &logger, ">> R-E-L-A-Y O-N <<\r\n" );
Delay_ms( 1000 );
log_printf( &logger, ">> R-E-L-A-Y O-F-F <<\r\n" );
Delay_ms( 500 );
thermostat4_set_warm_hysteresis( &thermostat4, 0 );
thermostat4_new_cfg_upload( &thermostat4 );
}

Application Task

Reads Alert on the WARM and HOT channel.

void application_task ( void )
{
log_printf( &logger, ">> H-O-T A-L-E-R-T <<\r\n" );
} else if ( thermostat4_warm_alert_state( &thermostat4 ) == THERMOSTAT4_WARM_ALERT ) {
log_printf( &logger, ">> W-A-R-M A-L-E-R-T <<\r\n" );
} else {
log_printf( &logger, ">> T-E-M-P-E-R-A-T-U-R-E O-K <<\r\n" );
Delay_ms( 200 );
}
}

Note

The user has the option of adjusting the hysteresis for channel B via the SPI module while for channel A it is adjusted via the potentiometer.

The full application code, and ready to use projects can be installed directly form compilers IDE(recommneded) or found on LibStock page or mikroE GitHub accaunt.

Other mikroE Libraries used in the example:

  • MikroSDK.Board
  • MikroSDK.Log
  • Click.Thermostat4

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. The terminal available in all Mikroelektronika compilers, or any other terminal application of your choice, can be used to read the message.


thermostat4_new_cfg_upload
void thermostat4_new_cfg_upload(thermostat4_t *ctx)
Reset module and upload new configuration on the Warm channel.
thermostat4_hot_alert_state
uint8_t thermostat4_hot_alert_state(thermostat4_t *ctx)
Hot temperature ALERT.
thermostat4_cfg_t
Thermostat 4 Click configuration object.
Definition: thermostat4.h:133
thermostat4_relay_ctrl
void thermostat4_relay_ctrl(thermostat4_t *ctx, uint8_t state)
Relay Control.
thermostat4_cfg_setup
void thermostat4_cfg_setup(thermostat4_cfg_t *cfg)
Thermostat 4 configuration object setup function.
THERMOSTAT4_RELAY_OFF
#define THERMOSTAT4_RELAY_OFF
Definition: thermostat4.h:59
application_task
void application_task(void)
Definition: main.c:72
thermostat4_warm_alert_state
uint8_t thermostat4_warm_alert_state(thermostat4_t *ctx)
Warm temperature ALERT.
THERMOSTAT4_MAP_MIKROBUS
#define THERMOSTAT4_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: thermostat4.h:94
THERMOSTAT4_HOT_ALERT
#define THERMOSTAT4_HOT_ALERT
Definition: thermostat4.h:65
application_init
void application_init(void)
Definition: main.c:31
thermostat4_t
Thermostat 4 Click context object.
Definition: thermostat4.h:111
thermostat4_init
err_t thermostat4_init(thermostat4_t *ctx, thermostat4_cfg_t *cfg)
Thermostat 4 initialization function.
thermostat4_set_warm_hysteresis
void thermostat4_set_warm_hysteresis(thermostat4_t *ctx, uint8_t hyst_data)
Hysteresis on the Warm channel.
THERMOSTAT4_WARM_ALERT
#define THERMOSTAT4_WARM_ALERT
Definition: thermostat4.h:64
THERMOSTAT4_RELAY_ON
#define THERMOSTAT4_RELAY_ON
Thermostat 4 description setting.
Definition: thermostat4.h:58