Write a few doxygen headers

This commit is contained in:
Mario Hüttel 2020-05-05 18:19:49 +02:00
parent 60602008d4
commit 2187c1a712
2 changed files with 62 additions and 0 deletions

View File

@ -34,15 +34,35 @@
*/ */
#define ADC_PT1000_CHANNEL 2U #define ADC_PT1000_CHANNEL 2U
/**
* @brief GPIO Port the ADC converter for the PT1000 measurement is connected to
*/
#define ADC_PT1000_PORT GPIOA #define ADC_PT1000_PORT GPIOA
/**
* @brief The clock enable mask of the RCC register for ADC_PT1000_PORT
*/
#define ADC_PT1000_PORT_RCC_MASK RCC_AHB1ENR_GPIOAEN #define ADC_PT1000_PORT_RCC_MASK RCC_AHB1ENR_GPIOAEN
/**
* @brief The GPIO pin number the PT1000 analog voltage is connected to
*/
#define ADC_PT1000_PIN 2U #define ADC_PT1000_PIN 2U
/**
* @brief The cycle count the moving average filter is labeled 'instable' after startup of the measurement or changing
* the alpha value @ref ADC_PT1000_FILTER_WEIGHT
*/
#define ADC_FILTER_STARTUP_CYCLES 800U #define ADC_FILTER_STARTUP_CYCLES 800U
/**
* @brief The delay value programmed into the sample timer
*/
#define ADC_PT1000_SAMPLE_CNT_DELAY 1000U #define ADC_PT1000_SAMPLE_CNT_DELAY 1000U
/**
* @brief The amount of samples to take to prefilter the analog signal
*/
#define ADC_PT1000_DMA_AVG_SAMPLES 6U #define ADC_PT1000_DMA_AVG_SAMPLES 6U
/** /**
@ -144,8 +164,14 @@ void adc_pt1000_convert_raw_value_array_to_resistance(float *resistance_dest, fl
*/ */
enum adc_pt1000_error adc_pt1000_check_error(); enum adc_pt1000_error adc_pt1000_check_error();
/**
* @brief Clear the error status of the PT1000 measurement
*/
void adc_pt1000_clear_error(); void adc_pt1000_clear_error();
/**
* @brief Disable the PT1000 measurement
*/
void adc_pt1000_disable(); void adc_pt1000_disable();
#endif // __ADCMEAS_H__ #endif // __ADCMEAS_H__

View File

@ -21,19 +21,55 @@
#ifndef __BUTTON_H__ #ifndef __BUTTON_H__
#define __BUTTON_H__ #define __BUTTON_H__
/**
* @brief GPIO Port the button is connected to
*/
#define BUTTON_PORT GPIOD #define BUTTON_PORT GPIOD
/**
* @brief The RCC clock mask for @ref BUTTON_PORT
*/
#define BUTTON_RCC_MASK RCC_AHB1ENR_GPIODEN #define BUTTON_RCC_MASK RCC_AHB1ENR_GPIODEN
/**
* @brief The GPIO pin number the button is connected to
*/
#define BUTTON_PIN 4 #define BUTTON_PIN 4
/**
* @brief The time in ms the button has to stay pressed to be detected as a short press
*/
#define BUTTON_SHORT_ON_TIME_MS 50UL #define BUTTON_SHORT_ON_TIME_MS 50UL
/**
* @brief Time in ms the button has to be pressed to be counted as a long press
*/
#define BUTTON_LONG_ON_TIME_MS 400UL #define BUTTON_LONG_ON_TIME_MS 400UL
#if BUTTON_LONG_ON_TIME_MS <= BUTTON_SHORT_ON_TIME_MS
#error "Button BUTTON_SHORT_ON_TIME_MS time has to be shorter than BUTTON_LONG_ON_TIME_MS"
#endif
/**
* @brief States the puhsbutton of the rotary encoder can be in
*/
enum button_state {BUTTON_IDLE = 0, BUTTON_SHORT_RELEASED, BUTTON_LONG_RELEASED, BUTTON_SHORT, BUTTON_LONG}; enum button_state {BUTTON_IDLE = 0, BUTTON_SHORT_RELEASED, BUTTON_LONG_RELEASED, BUTTON_SHORT, BUTTON_LONG};
/**
* @brief Init the push button
*/
void button_init(); void button_init();
/**
* @brief read if a push button event occured
* @return Button event
*/
enum button_state button_read_event(); enum button_state button_read_event();
/**
* @brief button_deinit
*/
void button_deinit(); void button_deinit();