Micro2020/assignment_2/src/NUCLEO_F401RE.h

/*!
 * \file
 *    NUCLEO_F401RE.h
 * \brief
 *    Nucleo F401RE port file. This file contain the implementation of driver
 *    calls for F401RE board.
 *
 *  Created on: May 23, 2020
 *      Author: Christos Choutouridis AEM: 8997
 *      email : <cchoutou@ece.auth.gr>
 */

#ifndef NUCLEO_F401RE_H_
#define NUCLEO_F401RE_H_

#include <stm32f4xx.h>
#include <stm32f4xx_hal.h>
#include <core_cm4.h>

/*
 * ========= Data types ========
 */

//! Driver status return type
typedef enum {
   LLD_OK = 0,    //!< Indicate successful operation
   LLD_ERROR      //!< Indicate Error
}LLD_Status_en;

typedef  uint8_t              din_t;
//typedef  int                  adc_t;

#define  OFF                  (0)
#define  ON                   (!OFF)
#ifndef  FALSE
#define  FALSE                (0)
#endif
#ifndef  TRUE
#define  TRUE                 (!FALSE)
#endif


/*
 * =============== System ===============
 */
#if defined ( __GNUC__ ) && !defined (__CC_ARM)
#include <sys/types.h>
#endif
#include <limits.h>

/*
 * Also defined in types.h
 */
#ifndef  _CLOCK_T_
#define  _CLOCK_T_   unsigned long     /* clock() */
typedef _CLOCK_T_ clock_t;             /*!< CPU time type */
#endif
#ifndef _TIME_T_
#define  _TIME_T_ long                 /* time() */
typedef _TIME_T_ time_t;               /*!< date/time in unix secs past 1-Jan-70 type for 68 years*/
#endif


/*
 * Helper macros
 */
#define _CLOCK_T_MAX_VALUE_            (ULONG_MAX) //!< Helper macro for maximum signed CPU time calculations

/*!
 *  Calculate the positive time difference of _t2_ and _t1_, where
 *  _t1_, _t2_ are clock_t values
 *  \note
 *    _t2_ event comes is AFTER _t1_
 *
 *  ex:
 *  0   1   2   3   4   5   6   7   8   9
 *      ^                       ^
 *      |                       |
 *      a                       b
 *
 * if : t1=a, t2=b      then  dt = b-a             = t2 - t1
 * if : t1=b, t2=a      then  dt = 9 - (b-a) + 1   = UMAX - (t1-t2) + 1
 *
 */
#define _CLOCK_DIFF(_t2_, _t1_)     ( ((_t2_)>(_t1_)) ? ((_t2_)-(_t1_)) : (_CLOCK_T_MAX_VALUE_ - ((_t1_) - (_t2_)) + 1) )

/*
 * CPU time macros
 */
#define  msec2CPUtime(_ms_)      (((_ms_) * get_freq()) / 1000)
#define  sec2CPUtime(_s_)        ((_s_) * get_freq())

#define  CPUtime2msec(_t_)       (((_t_) * 1000) / get_freq())
#define  CPUtime2sec(_t_)        ((_t_) / get_freq())

HAL_StatusTypeDef HAL_SysTick_Init(clock_t sf);

clock_t HAL_SelectSysTickFreq (clock_t sf);
clock_t HAL_GetSysTickFreq (void);
int HAL_SetSysTickFreq (clock_t sf);

/*
 * OS like Functionalities
 */
clock_t get_freq (void);
int set_freq (clock_t sf);

clock_t clock (void);
clock_t setclock (clock_t c);

time_t time (time_t *timer);
int settime (const time_t *t);


/*
 * ============== Cycle count ==============
 */
LLD_Status_en CYCLE_Init (void);
clock_t CYCLE_Get (void);

/*
 * =============== Digital I/O ===============
 * BTN  -- PC13
 * LED  -- PA5 (SB42 is in place) [SB29: PB13]
 */
LLD_Status_en Port_Init (void);

uint8_t BTN (void);
void LED (uint8_t on);


/*
 * ============= Board Init ==============
 */
LLD_Status_en LLD_Init (clock_t sys_freq);

#endif /* NUCLEO_F401RE_H_ */