thermostat5 2.1.0.0
Loading...
Searching...
No Matches
Main Page

Thermostat 5 Click

‍Thermostat 5 Click is a compact add-on board designed for precise temperature monitoring and control of external devices. This board features the MCP6022 operational amplifier and MCP3221 A/D converter, both from Microchip, ensuring accurate signal processing. The board features an NTC connector for temperature sensing, a dual-mode signal processing option (analog or digital) selectable via the V SEL jumper, and a high-current J1031C3VDC.15S SPDT relay for external load control. The relay supports up to 2A loads, with an orange LED indicating its active status, while the board operates with 3.3V or 5V logic levels.

Click Product page


Click library

  • Author : Nenad Filipovic
  • Date : Feb 2024.
  • Type : ADC/I2C type

Software Support

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

Standard key functions :

Example key functions :

  • thermostat5_set_relay This function controls the relay by setting the state of the ON (PWM) pin.
    void thermostat5_set_relay ( thermostat5_t *ctx, uint8_t state );
    void thermostat5_set_relay(thermostat5_t *ctx, uint8_t state)
    Thermostat 5 set relay function.
  • thermostat5_get_temperature This function reads and calculates temperature in degrees Celsius [degC] using NTC thermistors.
    err_t thermostat5_get_temperature ( thermostat5_t *ctx, float *temperature );
    err_t thermostat5_get_temperature(thermostat5_t *ctx, float *temperature)
    Thermostat 5 get temperature function.
  • thermostat5_read_voltage This function sets the voltage reference for Thermostat 5 Click driver.
    err_t thermostat5_read_voltage ( thermostat5_t *ctx, float *voltage );
    err_t thermostat5_read_voltage(thermostat5_t *ctx, float *voltage)
    Thermostat 5 read voltage level function.

Example Description

‍This library contains API for the Thermostat 5 Click driver for temperature measurement and relay control.

The demo application is composed of two sections :

Application Init

‍The initialization of the I2C or ADC module and log UART set the relay to an OFF state.

void application_init ( void )
{
log_cfg_t log_cfg;
thermostat5_cfg_t thermostat5_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
thermostat5_cfg_setup( &thermostat5_cfg );
THERMOSTAT5_MAP_MIKROBUS( thermostat5_cfg, MIKROBUS_1 );
err_t init_flag = thermostat5_init( &thermostat5, &thermostat5_cfg );
if ( ( ADC_ERROR == init_flag ) || ( I2C_MASTER_ERROR == init_flag ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
Delay_ms ( 100 );
}
#define THERMOSTAT5_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition thermostat5.h:117
#define THERMOSTAT5_RELAY_OFF
Thermostat 5 relay states.
Definition thermostat5.h:83
void application_init(void)
Definition main.c:40

Application Task

‍The demo application measures temperature in degrees Celsius. If the temperature increases above 30 degrees Celsius, the relay will turn ON, otherwise it will turn OFF. Results are being sent to the UART Terminal, where you can track their changes.

void application_task ( void )
{
float temperature = 0;
if ( THERMOSTAT5_OK == thermostat5_get_temperature( &thermostat5, &temperature ) )
{
log_printf( &logger, " Temperatur : %.2f [degC]\r\n", temperature );
if ( THERMOSTAT5_TEMPERATURE_LIMIT < temperature )
{
log_printf( &logger, " Relay: ON\r\n" );
}
else
{
log_printf( &logger, " Relay: OFF\r\n" );
}
Delay_ms ( 1000 );
}
}
#define THERMOSTAT5_RELAY_ON
Definition thermostat5.h:84
void application_task(void)
Definition main.c:73
#define THERMOSTAT5_TEMPERATURE_LIMIT
Definition main.c:35
@ THERMOSTAT5_OK
Definition thermostat5.h:181

Note

‍For temperature measurement, we used Semitec 103AT-2 NTC Thermistors.

  • Beta parameter: 3435 K
  • Resistance: 10 kOhms
  • Tolerance: 1 %

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.Thermostat5

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.