log.h

#pragma once
 
/************************************************************************************************
 * @file   log.h
 *
 * @brief  Header file for the logging library used to debug all modules
 *
 * @date   2024-11-02
 * @author Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
#include <stdio.h>
#include <stdlib.h>
 
/* Inter-component Headers */
#include "FreeRTOS.h"
#include "task.h"
 
/* Intra-component Headers */
#include "ms_semaphore.h"
#include "tasks.h"
#include "uart.h"
 
#define MAX_LOG_SIZE (size_t)200
#define LOG_TIMEOUT_MS 10
 
#define UARTPORT UART_PORT_1
#define TX_PIN 6
#define RX_PIN 7
 
#ifndef IN_ORDER_LOGS
#define IN_ORDER_LOGS 1
#endif
 
typedef enum {
  LOG_LEVEL_DEBUG = 0, 
  LOG_LEVEL_WARN,      
  LOG_LEVEL_CRITICAL,  
  NUM_LOG_LEVELS,      
} LogLevel;
 
extern char g_log_buffer[MAX_LOG_SIZE];
extern Mutex s_log_mutex;
extern UartSettings log_uart_settings;
 
#define LOG_DEBUG(fmt, ...) LOG(LOG_LEVEL_DEBUG, fmt, ##__VA_ARGS__)
#define LOG_WARN(fmt, ...) LOG(LOG_LEVEL_WARN, fmt, ##__VA_ARGS__)
#define LOG_CRITICAL(fmt, ...) LOG(LOG_LEVEL_CRITICAL, fmt, ##__VA_ARGS__)
 
#define log_init() \
  { uart_init(UART_PORT_1, &log_uart_settings); }
 
#ifdef MS_PLATFORM_X86
#define LOG(level, fmt, ...) printf("[%u] %s:%u: " fmt, (level), __FILE__, __LINE__, ##__VA_ARGS__)
#else
#define LOG(level, fmt, ...)                                                                                                            \
  do {                                                                                                                                  \
    if (xTaskGetSchedulerState() == taskSCHEDULER_RUNNING) {                                                                            \
      size_t msg_size = (size_t)snprintf(g_log_buffer, MAX_LOG_SIZE, "\r[%u] %s:%u: " fmt, (level), __FILE__, __LINE__, ##__VA_ARGS__); \
      uart_tx(UART_PORT_1, (uint8_t *)g_log_buffer, msg_size);                                                                          \
    }                                                                                                                                   \
  } while (0)
#endif