Acceleration & Tilt Tracking Solution

/*
 * Solution Name: Acceleration & Tilt Tracking Solution
 *
 * Description:
 * This embedded application continuously monitors motion data using the Accel
 * 32 Click and detects tilt motion using the Tilt 5 Click, logging real-time
 * sensor readings via UART.
 *
 * The system utilizes the following Click boards:
 *   - Accel 32 Click: Measures acceleration on the X, Y, and Z axes and
 *     monitors temperature changes.
 *   - Tilt 5 Click: Detects tilt motion using a ball switch sensor and reports 
 *     state transitions between "ACTIVE" and "IDLE."
 *
 * The `application_init` function initializes both Click boards, configures
 * them for proper operation, and sets up the UART logger for debugging.
 *
 * The `application_task` function reads accelerometer and temperature data
 * from the Accel 32 Click and logs it via UART. It also continuously monitors
 * the tilt state using the Tilt 5 Click, logging any detected motion.
 *
 * Hardware Setup:
 *   - MIKROBUS_1: Accel 32 Click (Motion and temperature monitoring)
 *   - MIKROBUS_2: Tilt 5 Click (Tilt detection)
 *
 * Key Features:
 *   - Real-time acceleration measurement (X, Y, Z) and temperature
 *     monitoring.
 *   - Tilt detection with active and idle state logging.
 *   - UART-based 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 "tilt5.h"
#include "accel32.h"

// ------------------------------------------------------------------ VARIABLES
static log_t logger;    /**< Log driver object. */
static tilt5_t tilt5;   /**< Tilt 5 Click driver object. */
static accel32_t accel32;   /**< Accel 32 Click driver object. */

// ------------------------------------------------------ APPLICATION FUNCTIONS
void application_init ( void )
{
    log_cfg_t log_cfg;  /**< Logger config object. */
    tilt5_cfg_t tilt5_cfg;  /**< Click config object. */
    accel32_cfg_t accel32_cfg;  /**< Click config object. */

    /** 
     * Logger initialization.
     * Default baud rate: 115200
     * Default log level: LOG_LEVEL_DEBUG
     * @note If USB_UART_RX and USB_UART_TX 
     * are defined as HAL_PIN_NC, you will 
     * need to define them manually for log to work. 
     * See @b LOG_MAP_USB_UART macro definition for detailed explanation.
     */
    LOG_MAP_USB_UART( log_cfg );
    log_init( &logger, &log_cfg );
    log_info( &logger, " Application Init " );

    // Accel 32 Click initialization.
    accel32_cfg_setup( &accel32_cfg );
    ACCEL32_MAP_MIKROBUS( accel32_cfg, MIKROBUS_1 );
    if ( SPI_MASTER_ERROR == accel32_init( &accel32, &accel32_cfg ) )
    {
        log_error( &logger, " Communication init." );
        for ( ; ; );
    }

    if ( ACCEL32_ERROR == accel32_default_cfg ( &accel32 ) )
    {
        log_error( &logger, " Default configuration." );
        for ( ; ; );
    }

    // Tilt 5 Click initialization.
    tilt5_cfg_setup( &tilt5_cfg );
    TILT5_MAP_MIKROBUS( tilt5_cfg, MIKROBUS_2 );
    if ( DIGITAL_OUT_UNSUPPORTED_PIN == tilt5_init( &tilt5, &tilt5_cfg ) ) 
    {
        log_error( &logger, " Communication init." );
        for ( ; ; );
    }

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

void application_task ( void )
{
    accel32_data_t meas_data;

    if ( ACCEL32_OK == accel32_get_data ( &accel32, &meas_data ) )
    {
        log_printf( &logger, " Accel X: %.3f g\r\n", meas_data.accel.x );
        log_printf( &logger, " Accel Y: %.3f g\r\n", meas_data.accel.y );
        log_printf( &logger, " Accel Z: %.3f g\r\n", meas_data.accel.z );
        log_printf( &logger, " Temperature: %.1f degC\r\n",
                             meas_data.temperature );
        Delay_ms ( 100 );
    }

    uint8_t state = tilt5_get_out_pin ( &tilt5 );
    if ( TILT5_STATE_ACTIVE == state ) {
        log_printf( &logger, "Tilt state: ACTIVE\r\n" );
    } else {
        log_printf( &logger, "Tilt state: IDLE\r\n" );
    }
    Delay_ms ( 100 );
}

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