rpi4b-temp-humidity/src/util.h

/*
 * util.h - Utility functions
 * Copyright (C) 2024  Alexander Rosenberg
 *
 * This program is free software: you can redistribute it and/or modify it under
 * the terms of the GNU General Public License as published by the Free Software
 * Foundation, either version 3 of the License, or (at your option) any later
 * version. See the LICENSE file for more information.
 */
#ifndef INCLUDED_UTIL_H
#define INCLUDED_UTIL_H

#include <stdlib.h>
#include <stdint.h>
#include <stdio.h>
#include <time.h>
#include <stdbool.h>
#include <sys/types.h>
#include <libgpio.h>
#include <sqlite3.h>

typedef struct {
    char *config_path; // path to config file
    bool strict_config; // exit if unknown config options is found
    bool verbose; // be more verbose

    char *gpio_path; // path of GPIO device file to use
    gpio_pin_t en_pin;
    gpio_pin_t rs_pin;
    gpio_pin_t rw_pin;
    gpio_pin_t data_pins[8];
    char *database_location; // location of sqlite3 database
    char *temp_key; // sysctl key for temperature
    char *humid_key; // sysctl key for humidity
    char *fail_key; // sysctl key for number of fails
    uint32_t fail_limit; // limit for number of failures before exit
    uint32_t refresh_time; // time between temp and humid refresh

    // menu navigation pins
    gpio_pin_t up_pin;
    gpio_pin_t down_pin;
    gpio_pin_t back_pin;
    gpio_pin_t sel_pin;
} Options;
extern Options GLOBAL_OPTS;

/*
 * Cleanup an Options struct.
 */
void cleanup_options(Options *opts);

/*
 * Like malloc(3), except that if allocation fails, an error will be written to
 * standard error and abort(3) called
 */
void *malloc_checked(size_t n);

/*
 * Like realloc(3), except that if allocation fails, an error will be written to
 * standard error and abort(3) called
 */
void *realloc_checked(void *old_ptr, size_t n);

/*
 * Like strdup(3), except that if allocation fails, an error will be written to
 * standard error and abort(3) called
 */
void *strdup_checked(const char *str);

/*
 * Like free(3), but do nothing if P is NULL.
 */
#define FREE_CHECKED(p) if (p) {free(p);}

/*
 * Call fprintf(3) to stderr only if verbose mode was enabled.
 */
#define LOG_VERBOSE(...) if (GLOBAL_OPTS.verbose) {fprintf(stderr, __VA_ARGS__);}

/*
 * Return: the number of days in month M. 1 is January. Y is the year.
 */
int days_in_month(int m, int y);

/*
 * Initialize SQL queries used by this file.
 */
void initialize_util_queries(sqlite3 *db);

/*
 * Cleanup SQL queries used by this file.
 */
void cleanup_util_queries(void);

typedef struct {
    int64_t utc;
    int utc_year;
    int utc_month;
    int utc_day;
    int64_t local;
    int local_year;
    int local_month;
    int local_day;
} UtilDate;

/*
 * Return the START of the first and END of the last PERIOD (ex. week) of DB.
 * Return: false if an error occurred, true otherwise.
 */
bool get_database_limits(sqlite3 *db, const char *period, UtilDate *start,
                         UtilDate *end);

#endif