grpe_Magana_Brunetto/soft/PjtKEIL_StepDeb_2/Driver/DriverJeuLaser.h

346 lines
10 KiB
C
Raw Normal View History

2023-03-14 16:21:55 +01:00
/**
* Bibliotheque DriverJeuLaser (ancienne gassp72 adapt<EFBFBD>e 2021 - TR)
*
* GPIO - ADC - Sequenceur - System Timer - PWM - 72 MHz
* Modifs :
* enl<EFBFBD>vement de tout ce qui est inutile dans le .h
* ajout de fonctions GPIO dans le .c pour utilisation en ASM ou en C :
* - GPIOA_Set(char Broche), GPIOB_Set(char Broche), GPIOC_Set(char Broche)
* - GPIOA_Clear(char Broche), GPIOB_Clear(char Broche), GPIOC_Clear(char Broche)
*
* ajout d'une fonction qui impose une valeur de PWM (TIM3_CCR3)
* PWM_Set_Value_On_TIM3_C3( int Val)
* permet en ASM ou en C de fixer la valeur de PWM
* Ajout de commentaires
*/
#ifndef DRIVERJEULASER_H__
#define DRIVERJEULASER_H__
#include "stm32f10x.h"
//**********************************************************************************************************
//--------------------- CONFIGURATION CLOCK DU STM32 --------------------------------------
//**********************************************************************************************************
/**
* @brief Configure l'ensemble des horloges du uC
* @note horloge systeme (config statique a 72 MHz pour le STM32F103)
* @param None
* @retval None
*/
void CLOCK_Configure(void);
//**********************************************************************************************************
//--------------------- LES TIMERS GENERAL PURPOSE TIM1 <20> TIM 4 ------------------------------
//**********************************************************************************************************
/**
* @brief Configure un Timer TIM1 <EFBFBD> TIM4 avec une p<EFBFBD>riodicit<EFBFBD> donn<EFBFBD>e
* @note L' horloge des 4 timers a une fr<EFBFBD>quence de 72MHz
* @param *Timer = TIM1 ou TIM2 ou TIM3 ou TIM4
* @param Dur<EFBFBD>e_ticks : nombre de pas (tick) compt<EFBFBD>s <EFBFBD> 72 MHz pour faire d<EFBFBD>border le timer
* La p<EFBFBD>riode de d<EFBFBD>bordement du Timer est donc T = Dur<EFBFBD>e_ticks * Tck, avec Tck = 1/72 000 000
* @retval None
*/
void Timer_1234_Init_ff( TIM_TypeDef *Timer, u32 Duree_ticks );
/**
* Macros de base pour utiliser les timers
*/
// bloque le timer
#define Bloque_Timer(Timer) Timer->CR1=(Timer->CR1)&~(1<<0)
// Lance timer
#define Run_Timer(Timer) Timer->CR1=(Timer->CR1)|(1<<0)
/**
* @brief Associe une fonction d'interruption (callback) lors du d<EFBFBD>bordement d'un timer
* @note
* @param *Timer = TIM1 ou TIM2 ou TIM3 ou TIM4
* @param Prio : niveau de priorit<EFBFBD> de l'interruption (0 -> priorit<EFBFBD> max, 15 -> priorit<EFBFBD> min)
* @param IT_function : le nom de la fonction Callback <EFBFBD> appeler lors de l'interruption
* @retval None
*/
void Active_IT_Debordement_Timer( TIM_TypeDef *Timer, char Prio, void (*IT_function)(void) );
//*********************************************************************************************************
//--------------------- PWM TIM1 to TIM 4 ------------------------------
//*********************************************************************************************************
/**
* @brief Configure un timer en PWM
* @note
* @param *Timer = TIM1 ou TIM2 ou TIM3 ou TIM4
* @param voie : un des 4 canaux possibles 1 <EFBFBD> 4.
* @param Periode_ticks : nombre de pas (tick) compt<EFBFBD>s <EFBFBD> 72 MHz pour faire d<EFBFBD>border le timer
* La p<EFBFBD>riode de d<EFBFBD>bordement du Timer est donc T = Dur<EFBFBD>e_ticks * Tck, avec Tck = 1/72 000 000
* @retval Retourne la p<EFBFBD>riode en tick (normalement la m<EFBFBD>me que le param d'entr<EFBFBD>e sauf si PSC utilis<EFBFBD>
*/
unsigned short int PWM_Init_ff( TIM_TypeDef *Timer, char Voie, u32 Periode_ticks );
/**
* @brief Fixe une valeur de PWM, Val, en tick horloge. La rapport cyclique effectif
* est donc : rcy = Thaut_ticks / Periode_ticks
* @note sp<EFBFBD>cifique Jeu Laser, PWM li<EFBFBD>e exclusivement au TIM3, chan3
* @param Thaut_ticks : dur<EFBFBD>e de l'<EFBFBD>tat haut d'une impulsion en Ticks
* @retval None
*/
void PWM_Set_Value_TIM3_Ch3( unsigned short int Thaut_ticks);
//**********************************************************************************************************
//--------------------- LE SYSTICK TIMER, Part of Cortex M3 ------------------------------
//**********************************************************************************************************
/**
* @brief Configure le timer Systick avec une p<EFBFBD>riodicit<EFBFBD> donn<EFBFBD>e
* @note Ce timer ne peut servir qu'<EFBFBD> cr<EFBFBD>er des temporisations ou g<EFBFBD>n<EFBFBD>rer des interruption
* ce n'est pas <EFBFBD> proprement parler un p<EFBFBD>riph<EFBFBD>rique, il fait partie du Cortex M3
* Ce timer est un 24 bits
* @param Periode_ticks : nombre de pas (tick) compt<EFBFBD>s <EFBFBD> 72 MHz pour <EFBFBD>tablir la p<EFBFBD>riodicit<EFBFBD>
* La p<EFBFBD>riode de d<EFBFBD>bordement du Timer est donc T = Dur<EFBFBD>e_ticks * Tck, avec Tck = 1/72 000 000
* @retval None
*/
void Systick_Period_ff( unsigned int Periode_ticks );
/**
* @brief Associe une fonction d'interruption (callback) lors du d<EFBFBD>bordement du Systick
* @note
* @param Prio : niveau de priorit<EFBFBD> de l'interruption (0 -> priorit<EFBFBD> max, 15 -> priorit<EFBFBD> min)
* @param IT_function : le nom de la fonction Callback <EFBFBD> appeler lors de l'interruption
* @retval None
*/
void Systick_Prio_IT( char Prio, void (*Systick_function)(void) );
/**
* Macros de base pour utiliser le Systick
*/
#define SysTick_On ((SysTick->CTRL)=(SysTick->CTRL)|1<<0)
#define SysTick_Off ((SysTick->CTRL)=(SysTick->CTRL)& ~(1<<0))
#define SysTick_Enable_IT ((SysTick->CTRL)=(SysTick->CTRL)|1<<1)
#define SysTick_Disable_IT ((SysTick->CTRL)=(SysTick->CTRL)& ~(1<<1))
//**********************************************************************************************************
//--------------------- LE SYSTICK TIMER, Part of Cortex M3 ------------------------------
//**********************************************************************************************************
/**
* @brief Active l'ADC du STM32, configure la dur<EFBFBD>e de pr<EFBFBD>l<EFBFBD>vement de l'<EFBFBD>chantillon (temps
* de fermeture du switch d'acquisition
* @note
* @param ADC : pr<EFBFBD>cise de quel ADC il s'agit, ADC1 ou ADC2
* @param Duree_Ech_ticks : dir<EFBFBD>e de fermeture du switch d'<EFBFBD>chantillonnage en Tick d'horloge CPU
* exemple pour 1<EFBFBD>s on choisira 72.
* @retval Nombre de Tick r<EFBFBD>ellement pris en compte
*/
unsigned int Init_TimingADC_ActiveADC_ff( ADC_TypeDef * ADC, u32 Duree_Ech_ticks );
/**
* @brief S<EFBFBD>lectionne la voie <EFBFBD> convertir
* @note Attention, la voie va de 0 <EFBFBD> 15 et n'est pas directement li<EFBFBD> au n<EFBFBD>de GPIO
* @param ADC : pr<EFBFBD>cise de quel ADC il s'agit, ADC1 ou ADC2
* @param Voie_ADC : 1 <EFBFBD> 15
* @retval None
*/
void Single_Channel_ADC( ADC_TypeDef * ADC, char Voie_ADC );
/**
* @brief Permet lier le d<EFBFBD>clenchement au d<EFBFBD>bordement d'un timer, sp<EFBFBD>cifie <EFBFBD>galement
* la p<EFBFBD>riode de d<EFBFBD>bordement du timer
* @note pas besoin de r<EFBFBD>gler le timer avec une autre fonction d<EFBFBD>di<EFBFBD>e timer
* @param ADC : pr<EFBFBD>cise de quel ADC il s'agit, ADC1 ou ADC2
* @param Source : indique le timer qui d<EFBFBD>clenche l'ADC choix dans les define ci-dessous
* @param Periode_ticks : nombre de pas (tick) compt<EFBFBD>s <EFBFBD> 72 MHz pour faire d<EFBFBD>border le timer
* La p<EFBFBD>riode de d<EFBFBD>bordement du Timer est donc T = Dur<EFBFBD>e_ticks * Tck, avec Tck = 1/72 000 000
* @retval None
*/
// param pour Source :
#define TIM1_CC1 0
#define TIM1_CC2 1
#define TIM1_CC3 2
#define TIM2_CC2 3
#define TIM4_CC4 5
void Init_Conversion_On_Trig_Timer_ff( ADC_TypeDef * ADC, char Source, u32 Periode_ticks );
//**********************************************************************************************************
//--------------------- ANALOG INPUT ADC & DMA ------------------------------
//**********************************************************************************************************
/**
* @brief Permer de lier l'ADC <EFBFBD> un tableau en RAM pour une DMA
* @note
* @param Circ : circular. Si '0', en fin de DMA le ptr d'@ reste inchang<EFBFBD>
* si '1' le ptr d'@ se recale <EFBFBD> celle du d<EFBFBD>but.
* @param Ptr_Table_DMA : contient l'@ de d<EFBFBD>but de zone RAM <EFBFBD> <EFBFBD>crire
* @retval None
*/
void Init_ADC1_DMA1(char Circ, short int *Ptr_Table_DMA);
/**
* @brief Lance une DMA sur le nombre de points sp<EFBFBD>cifie. Les resultats seront stockes
* dans la zone de RAM <EFBFBD>crite est indiqu<EFBFBD>e lors de l'appel de la fonction Init_ADC1_DMA1
* @note
* @param NbEchDMA est le nombre d'<EFBFBD>chantillons <EFBFBD> stocker.
* @retval None
*/
void Start_DMA1( u16 NbEchDMA );
// arret DMA
#define Stop_DMA1 DMA1_Channel1->CCR =(DMA1_Channel1->CCR) &~0x1;
/**
* @brief Attend la fin d'un cycle de DMA. la duree depend de la periode d'acquisition
* et du nombre d'echantillons
* @note fonction d'attente (bloquante)
* @param None
* @retval None
*/
void Wait_On_End_Of_DMA1(void);
//**********************************************************************************************************
//--------------------- GPIO ------------------------------
//**********************************************************************************************************
/**
* @brief Initialisation d'un GPIO (A <EFBFBD> C), pin x.
* peut <EFBFBD>tre configur<EFBFBD> :
* -> Input ou output
* -> architecture technologique (push-pull, open drain...)
* @note
* @param Port : GPIOA, GPIOB, GPIOC
* @param Broche : 0 <EFBFBD> 15
* @param Sens : INPUT ou OUTPUT
* @param Techno : voir define ci dessous
* @retval 1 erreur, 0 si OK
*/
// Sens
#define INPUT 'i'
#define OUTPUT 'o'
// Techno pour pin en entr<74>e (INPUT)
#define ANALOG 0
#define INPUT_FLOATING 1
#define INPUT_PULL_DOWN_UP 2
// Techno pour pin en sortie (OUTPUT)
#define OUTPUT_PPULL 0
#define OUTPUT_OPDRAIN 1
#define ALT_PPULL 2
#define ALT_OPDRAIN 3
// Exemple :
// Port_IO_Init(GPIOB, 8, OUTPUT, OUTPUT_PPULL);
// Place le bit 8 du port B en sortie Push-pull
char GPIO_Configure(GPIO_TypeDef * Port, int Broche, int Sens, int Techno);
/**
* @brief Mise <EFBFBD> 1 d'une broche GPIO
* @note Une fonction par GPIO
* @param Broche : 0 <EFBFBD> 15
* @retval None
*/
void GPIOA_Set(char Broche);
void GPIOB_Set(char Broche);
void GPIOC_Set(char Broche);
/**
* @brief Mise <EFBFBD> 0 d'une broche GPIO
* @note Une fonction par GPIO
* @param Broche : 0 <EFBFBD> 15
* @retval None
*/
void GPIOA_Clear(char Broche);
void GPIOB_Clear(char Broche);
void GPIOC_Clear(char Broche);
#endif