Temperature Monitor With RGB Feedback Solution

/*
 * Solution Name: Temp Monitor with RGB Feedback Solution
 *
 * Description:
 * This embedded application visually reports temperature data using the
 * Temp&Hum 25 Click and simultaneously displays the numeric readings on the
 * 7x10 G Click and triggers colorful LED sequences on the 2x2 RGB Click 
 * while waiting for the temperature readings to be finished for enhanced
 * feedback. The solution allows users to monitor environmental conditions with
 * both visual indicators and UART-based logging.
 *
 * The system utilizes the following Click boards:
 *   - Temp&Hum 25 Click: Measures ambient temperature and humidity using a 
 *     high-accuracy sensor with continuous sampling mode.
 *   - 7x10 G Click: Displays the current temperature in a scrolling number
 *     format across a dot matrix LED panel.
 *   - 2x2 RGB Click: Cycles through red, green, blue, and white animations across 
 *     all LEDs for dynamic visual feedback tied to environmental updates.
 *
 * The `application_init` function initializes all three Click boards and starts 
 * the temperature and humidity measurement in continuous mode. It also retrieves 
 * and logs the serial number of the Temp&Hum 25 sensor.
 *
 * The `application_task` function reads temperature and humidity values from the 
 * Temp&Hum 25 Click, displays the temperature on the 7x10 G Click, and cycles through 
 * color patterns on the 2x2 RGB Click, while logging each step via UART. The RGB LED 
 * animation acts as a visual heartbeat indicating the application is actively polling 
 * sensor data and functioning properly.
 *
 * Hardware Setup:
 *   - MIKROBUS_1: 7x10 G Click (Temperature display on dot matrix)
 *   - MIKROBUS_2: Temp&Hum 25 Click (Environmental sensing)
 *   - MIKROBUS_3: 2x2 RGB Click (LED animation for visual feedback)
 *
 * Key Features:
 *   - Real-time environmental monitoring with temperature and humidity data.
 *   - Temperature scrolling display on a high-contrast 7x10 dot matrix panel.
 *   - RGB LED sequences for clear and aesthetic feedback on each read cycle.
 *   - UART logging for debugging and sensor data visualization.
 *
 * Development Environment:
 *   - [NECTO Studio](https://www.mikroe.com/necto)
 *   - [mikroSDK v2.0](https://www.mikroe.com/mikrosdk) framework
 *   - MIKROE [Click boards](https://www.mikroe.com/click-boards) Add-ons
 *
 * Author: Branko Jaksic
 * Date: April, 2025
 */

// ------------------------------------------------------------------- INCLUDES
#include "log.h"
#include "board.h"
#include "c7x10g.h"
#include "c2x2rgb.h"
#include "temphum25.h"

// --------------------------------------------------------------- LOCAL MACROS
#define DEMO_LED_CURRENT    600

// ------------------------------------------------------------------ VARIABLES
static log_t logger;
static c7x10g_t c7x10g;
static c2x2rgb_t c2x2rgb;
static temphum25_t temphum25;

// ------------------------------------------------------ APPLICATION FUNCTIONS
void application_init ( void ) {
    c7x10g_cfg_t c7x10g_cfg;  /**< Click config object. */
    c2x2rgb_cfg_t c2x2rgb_cfg;  /**< Click config object. */
    temphum25_cfg_t temphum25_cfg;  /**< Click config object. */

    // 7x10 G Click initialization.
    c7x10g_cfg_setup( &c7x10g_cfg );
    C7X10G_MAP_MIKROBUS( c7x10g_cfg, MIKROBUS_1 );
    c7x10g_init( &c7x10g, &c7x10g_cfg );

    // Temp&Hum 25 Click initialization.
    temphum25_cfg_setup( &temphum25_cfg );
    TEMPHUM25_MAP_MIKROBUS( temphum25_cfg, MIKROBUS_1 );
    if ( I2C_MASTER_ERROR == temphum25_init( &temphum25, &temphum25_cfg ) ) 
    {
        log_error( &logger, " Communication init." );
        for ( ; ; );
    }
    temphum25_reset_device ( &temphum25 );
    uint32_t serial_num = 0;
    if ( TEMPHUM25_OK == temphum25_read_serial_num ( &temphum25, &serial_num ) )
    {
        log_printf ( &logger, " Serial number: 0x%.8LX\r\n", serial_num );
    }
    temphum25_start_measurement ( &temphum25, TEMPHUM25_CMD_MEAS_CONT_REP_HIGH_MPS_1 );

    // 2x2 RGB Click initialization.
    c2x2rgb_cfg_setup( &c2x2rgb_cfg );
    C2X2RGB_MAP_MIKROBUS( c2x2rgb_cfg, MIKROBUS_3 );
    if ( I2C_MASTER_ERROR == c2x2rgb_init( &c2x2rgb, &c2x2rgb_cfg ) ) 
    {
        log_error( &logger, " Communication init." );
        for ( ; ; );
    }
    if ( C2X2RGB_ERROR == c2x2rgb_default_cfg ( &c2x2rgb ) )
    {
        log_error( &logger, " Default configuration." );
        for ( ; ; );
    }

    log_info( &logger, " Application Task " );
}

void application_task ( void ) {
    float temperature = 0;
    float humidity = 0;

    // Switch I2C communication to Temp & Hum 25 Click.
    i2c_master_set_slave_address(&temphum25.i2c, temphum25.slave_address);

    if ( TEMPHUM25_OK == temphum25_read_measurement ( &temphum25, &temperature, &humidity ) )
    {
        log_printf ( &logger, " Temperature: %.2f degC\r\n", temperature );
        log_printf ( &logger, " Humidity: %.2f %%RH\r\n\n", humidity );
        Delay_ms ( 1000 );
    }

    c7x10g_draw_number( &c7x10g, temperature, C7X10G_DISPLAY_DELAY_150MS );
    Delay_ms ( 10 );

    // Switch I2C communication to 2x2 RGB Click.
    i2c_master_set_slave_address(&c2x2rgb.i2c, c2x2rgb.slave_address);

    log_printf( &logger, "\r\nRED: " );
    for ( uint8_t led_pos = C2X2RGB_SET_LD1; led_pos <= C2X2RGB_SET_LD4; led_pos++ )
    {
        if ( C2X2RGB_OK == c2x2rgb_set_rgb_led( &c2x2rgb, led_pos, DEMO_LED_CURRENT,
                                                                   C2X2RGB_LED_CURRENT_OFF, 
                                                                   C2X2RGB_LED_CURRENT_OFF ) )
        {
            log_printf( &logger, "LD%d ", ( uint16_t ) led_pos );
        }
        Delay_ms ( 200 );
    }

    log_printf( &logger, "\r\nGREEN: " );
    for ( uint8_t led_pos = C2X2RGB_SET_LD1; led_pos <= C2X2RGB_SET_LD4; led_pos++ )
    {
        if ( C2X2RGB_OK == c2x2rgb_set_rgb_led( &c2x2rgb, led_pos, C2X2RGB_LED_CURRENT_OFF, 
                                                                   DEMO_LED_CURRENT, 
                                                                   C2X2RGB_LED_CURRENT_OFF ) )
        {
            log_printf( &logger, "LD%d ", ( uint16_t ) led_pos );
        }
        Delay_ms ( 200 );
    }

    log_printf( &logger, "\r\nBLUE: " );
    for ( uint8_t led_pos = C2X2RGB_SET_LD1; led_pos <= C2X2RGB_SET_LD4; led_pos++ )
    {
        if ( C2X2RGB_OK == c2x2rgb_set_rgb_led( &c2x2rgb, led_pos, C2X2RGB_LED_CURRENT_OFF, 
                                                                   C2X2RGB_LED_CURRENT_OFF, 
                                                                   DEMO_LED_CURRENT ) )
        {
            log_printf( &logger, "LD%d ", ( uint16_t ) led_pos );
        }
        Delay_ms ( 200 );
    }

    log_printf( &logger, "\r\nWHITE: " );
    for ( uint8_t led_pos = C2X2RGB_SET_LD1; led_pos <= C2X2RGB_SET_LD4; led_pos++ )
    {
        if ( C2X2RGB_OK == c2x2rgb_set_rgb_led( &c2x2rgb, led_pos, DEMO_LED_CURRENT, 
                                                                   DEMO_LED_CURRENT, 
                                                                   DEMO_LED_CURRENT ) )
        {
            log_printf( &logger, "LD%d ", ( uint16_t ) led_pos );
        }
        Delay_ms ( 200 );
    }
    log_printf( &logger, "\r\n----------------" );
}

int main ( void ) 
{
    /* Do not remove this line or clock might not be set correctly. */
    #ifdef PREINIT_SUPPORTED
    preinit();
    #endif
    
    application_init( );
    
    for ( ; ; ) 
    {
        application_task( );
    }

    return 0;
}

// ------------------------------------------------------------------------ END