adc.h

 
// ALLOW FORMATTING
#ifndef ADC_H
#define ADC_H
 
#include "stm32f439xx.h"
#include "stdint.h"
#include "stdbool.h"
 
// Macro definitions for pin config literals
//

#define ADC_CONFIG_DEFAULT            \
  (ADC_Config) {                      \
    .RES     = ADC_RES_12,            \
    .AWDEN   = false,                 \
    .JAWDEN  = false,                 \
    .EOCIE   = false,                 \
    .AWDIE   = false,                 \
    .JEOCIE  = false,                 \
    .SCAN    = false,                 \
    .ALIGN   = ADC_ALIGN_RIGHT,       \
    .EOCS    = ADC_EOCS_SINGLE,       \
    .DMA     = false,                 \
    .CONT    = false,                 \
    .HTR     = 0,                     \
    .LTR     = 0,                     \
    .L       = 0,                     \
    .JL      = 0,                     \
    .TSVREFE = false,                 \
    .VBATE   = true,                  \
    .ADCPRE  = ADC_ADCPRE_PCLK2_DIV2, \
  }
// clang-format off

#define ADC_CR1_CONFIG_MASK ( \
    ADC_CR1_RES               \
  | ADC_CR1_AWDEN             \
  | ADC_CR1_JAWDEN            \
  | ADC_CR1_AWDSGL            \
  | ADC_CR1_SCAN              \
  | ADC_CR1_JEOCIE            \
  | ADC_CR1_AWDIE             \
  | ADC_CR1_EOCIE             \
  | ADC_CR1_AWDCH             \
)

#define ADC_CR2_CONFIG_MASK ( \
    ADC_CR2_ALIGN             \
  | ADC_CR2_EOCS              \
  | ADC_CR2_DMA               \
  | ADC_CR2_CONT              \
)

#define ADC_SMPR2_CONFIG_MASK ( \
    ADC_SMPR2_SMP0              \
  | ADC_SMPR2_SMP1              \
  | ADC_SMPR2_SMP2              \
  | ADC_SMPR2_SMP3              \
  | ADC_SMPR2_SMP4              \
  | ADC_SMPR2_SMP5              \
  | ADC_SMPR2_SMP6              \
  | ADC_SMPR2_SMP7              \
  | ADC_SMPR2_SMP8              \
  | ADC_SMPR2_SMP9              \
)
#define ADC_SMPR1_CONFIG_MASK ( \
    ADC_SMPR1_SMP10             \
  | ADC_SMPR1_SMP11             \
  | ADC_SMPR1_SMP12             \
  | ADC_SMPR1_SMP13             \
  | ADC_SMPR1_SMP14             \
  | ADC_SMPR1_SMP15             \
  | ADC_SMPR1_SMP16             \
  | ADC_SMPR1_SMP17             \
  | ADC_SMPR1_SMP18             \
)

#define ADC_SQR3_CONFIG_MASK ( \
    ADC_SQR3_SQ1               \
  | ADC_SQR3_SQ2               \
  | ADC_SQR3_SQ3               \
  | ADC_SQR3_SQ4               \
  | ADC_SQR3_SQ5               \
  | ADC_SQR3_SQ6               \
)

#define ADC_SQR2_CONFIG_MASK ( \
    ADC_SQR2_SQ7               \
  | ADC_SQR2_SQ8               \
  | ADC_SQR2_SQ9               \
  | ADC_SQR2_SQ10              \
  | ADC_SQR2_SQ11              \
  | ADC_SQR2_SQ12              \
)

#define ADC_SQR1_CONFIG_MASK ( \
    ADC_SQR1_SQ13              \
  | ADC_SQR1_SQ14              \
  | ADC_SQR1_SQ15              \
  | ADC_SQR1_SQ16              \
  | ADC_SQR1_L                 \
)

#define ADC_JSQR_CONFIG_MASK ( \
    ADC_JSQR_JSQ1              \
  | ADC_JSQR_JSQ2              \
  | ADC_JSQR_JSQ3              \
  | ADC_JSQR_JSQ4              \
  | ADC_JSQR_JL                \
)
// clang-format on


typedef enum {
  ADC_IN0,  
  ADC_IN1,  
  ADC_IN2,  
  ADC_IN3,  
  ADC_IN4,  
  ADC_IN5,  
  ADC_IN6,  
  ADC_IN7,  
  ADC_IN8,  
  ADC_IN9,  
  ADC_IN10, 
  ADC_IN11, 
  ADC_IN12, 
  ADC_IN13, 
  ADC_IN14, 
  ADC_IN15, 
  ADC_IN16, 
  ADC_IN17, 
  ADC_IN18, 
} ADC_Channel;

typedef enum {
  ADC_RES_12, 
  ADC_RES_10, 
  ADC_RES_8,  
  ADC_RES_6,  
} ADC_Resolution;

typedef enum {
  ADC_ALIGN_RIGHT, 
  ADC_ALIGN_LEFT,  
} ADC_Align;

typedef enum {
  ADC_EOCS_SEQUENCE, 
  ADC_EOCS_SINGLE,   
} ADC_EocSelect;

typedef enum {
  ADC_SMP_3,   
  ADC_SMP_15,  
  ADC_SMP_28,  
  ADC_SMP_56,  
  ADC_SMP_84,  
  ADC_SMP_112, 
  ADC_SMP_144, 
  ADC_SMP_480, 
} ADC_SampleTime;

typedef enum {
  ADC_L1,  
  ADC_L2,  
  ADC_L3,  
  ADC_L4,  
  ADC_L5,  
  ADC_L6,  
  ADC_L7,  
  ADC_L8,  
  ADC_L9,  
  ADC_L10, 
  ADC_L11, 
  ADC_L12, 
  ADC_L13, 
  ADC_L14, 
  ADC_L15, 
  ADC_L16, 
} ADC_SequenceLength;

typedef enum {
  ADC_ADCPRE_PCLK2_DIV2, 
  ADC_ADCPRE_PCLK2_DIV4, 
  ADC_ADCPRE_PCLK2_DIV6, 
  ADC_ADCPRE_PCLK2_DIV8, 
} ADC_Prescale;

typedef enum {
  ADC_CONVERSION_REGULAR, 
  ADC_CONVERSION_INJECTED 
} ADC_ConversionType;

typedef struct {
  ADC_Resolution RES;     
  bool AWDEN;             
  bool JAWDEN;            
  bool EOCIE;             
  bool AWDIE;             
  bool JEOCIE;            
  bool AWDSGL;            
  bool SCAN;              
  ADC_Channel AWDCH;      
  ADC_Align ALIGN;        
  ADC_EocSelect EOCS;     
  bool DMA;               
  bool CONT;              
  ADC_SampleTime SMP[19]; 
  uint16_t HTR;           
  uint16_t LTR;           
  ADC_SequenceLength L;   
  ADC_Channel SQ[16];     
  ADC_SequenceLength JL;  
  ADC_Channel JSQ[4];     
  bool TSVREFE;           
  bool VBATE;             
  ADC_Prescale ADCPRE;    
} ADC_Config;

typedef struct _ADC {
  ADC_TypeDef *interface;                                             
  ADC_Config config;                                                  
  bool (*updateConfig)(struct _ADC *adc, ADC_Config *config);         
  bool (*startConversion)(struct _ADC *adc, ADC_ConversionType type); 
  uint16_t (*readData)(struct _ADC *adc);                             
} ADC_t;
 
ADC_t ADC_init(ADC_TypeDef *adc_regs, ADC_Config *config);
bool ADC_startConversion(ADC_t *adc, ADC_ConversionType type);
uint16_t ADC_readData(ADC_t *adc);
bool ADC_updateConfig(ADC_t *adc, ADC_Config *config);

#endif