OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [freertos-6.1.1/] [Demo/] [ARM7_STR75x_GCC/] [STLibrary/] [src/] [75x_adc.c] - Blame information for rev 577

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 577 jeremybenn 
/******************** (C) COPYRIGHT 2006 STMicroelectronics ********************
2 
* File Name          : 75x_adc.c
3 
* Author             : MCD Application Team
4 
* Date First Issued  : 03/10/2006
5 
* Description        : This file provides all the ADC software functions.
6 
********************************************************************************
7 
* History:
8 
* 07/17/2006 : V1.0
9 
* 03/10/2006 : V0.1
10 
********************************************************************************
11 
* THE PRESENT SOFTWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
12 
* WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE TIME.
13 
* AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY DIRECT,
14 
* INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING FROM THE
15 
* CONTENT OF SUCH SOFTWARE AND/OR THE USE MADE BY CUSTOMERS OF THE CODING
16 
* INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
17 
*******************************************************************************/
18 
 
19 
/* Includes ------------------------------------------------------------------*/
20 
#include "75x_adc.h"
21 
#include "75x_mrcc.h"
22 
 
23 
/* Private typedef -----------------------------------------------------------*/
24 
/* Private define ------------------------------------------------------------*/
25 
/* Private macro -------------------------------------------------------------*/
26 
/* Private variables ---------------------------------------------------------*/
27 
 
28 
/* Mask for Power Down Mode */
29 
#define ADC_PowerDown_Enable  0x8000
30 
#define ADC_PowerDown_Disable 0x7FFF
31 
 
32 
/* Mask for Watchdog Thresholds Enable */
33 
#define ADC_AnalogWatchdog_Enable  0x8000
34 
#define ADC_AnalogWatchdog_Disable 0x7FFF
35 
 
36 
/* Mask for Injected conversion start */
37 
#define ADC_Injec_ConversionStart  0x8000
38 
 
39 
/* DMA enable */
40 
#define ADC_DMA_ExtEnable_Mask  0x4000
41 
 
42 
/* Injected start trigger enable */
43 
#define ADC_Injec_ExtTrigger_Enable   0x4000
44 
 
45 
/* ADC Masks */
46 
#define ADC_DMAFirstEnabledChannel_Mask  0x000F
47 
#define ADC_DataRegisterOffset           0x0050
48 
#define ADC_FirstChannel_Mask            0xFFF0
49 
#define ADC_ChannelNumber_Mask           0xFC3F
50 
#define ADC_Threshold_Mask               0xFC00
51 
#define ADC_AnalogWatchdogChannel_Mask   0xC3FF
52 
#define ADC_Prescalers_Mask              0x7F18
53 
#define ADC_SPEN_Mask                    0x8000
54 
#define ADC_FallingEdge_Mask             0xEFFF
55 
#define ADC_LowLevel_Mask                0x4000
56 
#define ADC_HighLevel_Mask               0xDFFF
57 
#define ADC_Calibration_Mask             0x0002
58 
 
59 
/* Private function prototypes -----------------------------------------------*/
60 
/* Private functions ---------------------------------------------------------*/
61 
 
62 
/*******************************************************************************
63 
* Function Name  : ADC_DeInit
64 
* Description    : Deinitializes the ADC peripheral registers to their default
65 
*                  reset values.
66 
* Input          : None.
67 
* Output         : None
68 
* Return         : None.
69 
*******************************************************************************/
70 
void ADC_DeInit(void)
71 
{
72 
  /* Reset the ADC registers values*/
73 
  MRCC_PeripheralSWResetConfig(MRCC_Peripheral_ADC,ENABLE);
74 
  MRCC_PeripheralSWResetConfig(MRCC_Peripheral_ADC,DISABLE);
75 
}
76 
 
77 
/*******************************************************************************
78 
* Function Name  : ADC_Init
79 
* Description    : Initializes the ADC  peripheral according to the specified
80 
*                  parameters in the ADC_InitStruct.
81 
* Input          : - ADC_InitStruct: pointer to an ADC_InitTypeDef structure that
82 
                   contains the configuration information for the ADC peripheral.
83 
* Output         : None
84 
* Return         : None
85 
*******************************************************************************/
86 
void ADC_Init(ADC_InitTypeDef* ADC_InitStruct)
87 
{
88 
  /* Configure the conversion mode */
89 
  if(ADC_InitStruct->ADC_ConversionMode == ADC_ConversionMode_Scan)
90 
  {
91 
    /* Set the scan conversion mode */
92 
    ADC->CLR2 |= ADC_ConversionMode_Scan;
93 
  }
94 
  else
95 
  {
96 
    /* Set the one-shot conversion mode */
97 
    ADC->CLR2 &= ADC_ConversionMode_OneShot;
98 
  }
99 
 
100 
  /* Configure the external start conversion trigger */
101 
  switch(ADC_InitStruct->ADC_ExtTrigger)
102 
  {
103 
    case ADC_ExtTrigger_HighLevel:
104 
      /* Start conversion on High level of the external trigger (TIM0) */
105 
      ADC->CLR0 &= ADC_HighLevel_Mask;
106 
      ADC->CLR0 |= ADC_ExtTrigger_HighLevel;
107 
      break;
108 
 
109 
    case ADC_ExtTrigger_LowLevel:
110 
      /* Start conversion on low level of the external trigger (TIM0) */
111 
      ADC->CLR0 &= ADC_ExtTrigger_LowLevel;
112 
      ADC->CLR0 |= ADC_LowLevel_Mask;
113 
      break;
114 
 
115 
    case ADC_ExtTrigger_RisingEdge:
116 
      /* Start conversion on rising edge of the external trigger (TIM0) */
117 
      ADC->CLR0 |= ADC_ExtTrigger_RisingEdge;
118 
      break;
119 
 
120 
    case ADC_ExtTrigger_FallingEdge:
121 
      /* Start conversion on falling edge of the external trigger (TIM0) */
122 
      ADC->CLR0 &= ADC_FallingEdge_Mask;
123 
      ADC->CLR0 |= ADC_ExtTrigger_FallingEdge;
124 
      break;
125 
 
126 
    case ADC_ExtTrigger_Disable:
127 
      /* Disable the external trigger and start the conversion by software */
128 
      ADC->CLR0 &= ADC_ExtTrigger_Disable;
129 
      break;
130 
 
131 
    default:
132 
      break;
133 
  }
134 
 
135 
  /* Configure the auto clock off feature */
136 
  if (ADC_InitStruct->ADC_AutoClockOff == ADC_AutoClockOff_Enable)
137 
  {
138 
    /* Enable the auto clock off feature */
139 
    ADC->CLR4 |= ADC_AutoClockOff_Enable;
140 
  }
141 
  else
142 
  {
143 
    /* Disable the auto clock off feature */
144 
    ADC->CLR4 &= ADC_AutoClockOff_Disable;
145 
  }
146 
 
147 
  /* Clear conversion prescaler CNVP[2:0], sampling prescaler SMPP[2:0] bits
148 
     and Sample prescaler enable SPEN bit */
149 
  ADC->CLR1 &= ADC_Prescalers_Mask;
150 
  /* Set conversion prescaler value (sampling and conversion prescalers are equal
151 
     while SPEN bit is reset */
152 
  ADC->CLR1 |= (ADC_InitStruct->ADC_ConversionPrescaler<<5);
153 
 
154 
  /* In case ADC_SamplingPrescaler member is different from the conversion one */
155 
  if(ADC_InitStruct->ADC_SamplingPrescaler != ADC_InitStruct->ADC_ConversionPrescaler)
156 
  {
157 
    /* Set the sampling prescaler value */
158 
    ADC->CLR1 |= ADC_InitStruct->ADC_SamplingPrescaler;
159 
    /* Set SPEN bit (sampling and conversion prescalers are different */
160 
    ADC->CLR1 = (ADC->CLR1 | ADC_SPEN_Mask);
161 
  }
162 
 
163 
  /* Clear first channel to be converted FCH[3:0] bits */
164 
  ADC->CLR2 &= ADC_FirstChannel_Mask;
165 
  /* Set the first channel to be converted */
166 
  ADC->CLR2 |= ADC_InitStruct->ADC_FirstChannel;
167 
  /* Clear number of channels to be converted NCH[3:0] bits */
168 
  ADC->CLR2 &= ADC_ChannelNumber_Mask;
169 
  /* Set the number of channels to be converted */
170 
  ADC->CLR2 |= ((ADC_InitStruct->ADC_ChannelNumber)-1<<6);
171 
}
172 
 
173 
/*******************************************************************************
174 
* Function Name  : ADC_StructInit
175 
* Description    : Fills each ADC_InitStruct member with its default value.
176 
* Input          : - ADC_InitStruct: pointer to an ADC_InitTypeDef structure
177 
                     which will be initialized.
178 
* Output         : None
179 
* Return         : None.
180 
*******************************************************************************/
181 
void ADC_StructInit(ADC_InitTypeDef* ADC_InitStruct)
182 
{
183 
  /* Initialize the ADC_ConversionMode member */
184 
  ADC_InitStruct->ADC_ConversionMode = ADC_ConversionMode_OneShot;
185 
 
186 
  /* Initialize the ADC_ExtTrigger member */
187 
  ADC_InitStruct->ADC_ExtTrigger = ADC_ExtTrigger_Disable;
188 
 
189 
  /* Initialize the ADC_AutoClockOff member */
190 
  ADC_InitStruct->ADC_AutoClockOff = ADC_AutoClockOff_Disable;
191 
 
192 
  /* Initialize the ADC_SamplingPrescaler member */
193 
  ADC_InitStruct->ADC_SamplingPrescaler = 0;
194 
 
195 
  /* Initialize the ADC_ConversionPrescaler member */
196 
  ADC_InitStruct->ADC_ConversionPrescaler = 0;
197 
 
198 
  /* Initialize the ADC_FirstChannel member */
199 
  ADC_InitStruct->ADC_FirstChannel = ADC_CHANNEL0;
200 
 
201 
  /* Initialize the ADC_ChannelNumber member */
202 
  ADC_InitStruct->ADC_ChannelNumber = 1;
203 
 }
204 
 
205 
/*******************************************************************************
206 
* Function Name  : ADC_StartCalibration
207 
* Description    : Starts the ADC Calibration. Calibration average enabled/disabled.
208 
* Input          : - ADC_CalibAverage: Enables or disables ADC calibration average.
209 
*                    This parameter can be one of the following values:
210 
*                         - ADC_CalibAverage_Enable:  enable calibration average
211 
*                         - ADC_CalibAverage_Disable: disable calibration average
212 
* Output         : None
213 
* Return         : None
214 
*******************************************************************************/
215 
void ADC_StartCalibration(u16 ADC_CalibAverage)
216 
{
217 
  if (ADC_CalibAverage == ADC_CalibAverage_Enable)
218 
  {
219 
    /* Enable ADC Calibration Average */
220 
    ADC->CLR4 &= ADC_CalibAverage_Enable;
221 
  }
222 
  else
223 
  {
224 
    /* Disable ADC Calibration Average */
225 
    ADC->CLR4 |= ADC_CalibAverage_Disable;
226 
  }
227 
 
228 
  /* Start Calibration */
229 
  ADC->CLR0 |= ADC_Calibration_ON;
230 
}
231 
 
232 
/*******************************************************************************
233 
* Function Name  : ADC_GetCalibrationStatus
234 
* Description    : Get the ADC Calibration Status.
235 
* Input          : None
236 
* Output         : None
237 
* Return         : The NewState of the ADC calibration (SET or RESET).
238 
*******************************************************************************/
239 
FlagStatus ADC_GetCalibrationStatus(void)
240 
{
241 
  /* Check the status of the ADC calibration */
242 
  if((ADC->CLR0 & ADC_Calibration_Mask) != RESET)
243 
  {
244 
    /* Return SET if ADC Calibration is on going */
245 
    return SET;
246 
  }
247 
  else
248 
  {
249 
    /* Return RESET if ADC Calibration is finished */
250 
    return RESET;
251 
  }
252 
}
253 
 
254 
/*******************************************************************************
255 
* Function Name  : ADC_ConversionCmd
256 
* Description    : Starts or stops the ADC conversion.
257 
* Input          : - ADC_Conversion: specifies the ADC command to apply.
258 
*                    This parameter can be one of the following values:
259 
*                         - ADC_Conversion_Start: start conversion
260 
*                         - ADC_Conversion_Stop:  stop conversion
261 
* Output         : None
262 
* Return         : None
263 
*******************************************************************************/
264 
void ADC_ConversionCmd (u16 ADC_Conversion)
265 
{
266 
  if (ADC_Conversion == ADC_Conversion_Start)
267 
  {
268 
    /* Start the ADC Conversion */
269 
    ADC->CLR0 |= ADC_Conversion_Start;
270 
  }
271 
  else
272 
  {
273 
    /* Stop the ADC Conversion */
274 
    ADC->CLR0 &= ADC_Conversion_Stop;
275 
  }
276 
}
277 
 
278 
/*******************************************************************************
279 
* Function Name  : ADC_GetSTARTBitStatus
280 
* Description    : Gets the ADC START/STOP bit Status.
281 
* Input          : None
282 
* Output         : None
283 
* Return         : The NewState of the ADC START/STOP bit (SET or RESET).
284 
*******************************************************************************/
285 
FlagStatus ADC_GetSTARTBitStatus(void)
286 
{
287 
  /* Check the status of the ADC START/STOP bit */
288 
  if((ADC->CLR0 & ADC_Conversion_Start) != RESET)
289 
  {
290 
    /* Return SET if ADC Conversion is started */
291 
    return SET;
292 
  }
293 
  else
294 
  {
295 
    /* Return RESET if ADC Conversion is stopped */
296 
    return RESET;
297 
  }
298 
}
299 
 
300 
/*******************************************************************************
301 
* Function Name  : ADC_Cmd
302 
* Description    : Enables the ADC peripheral or puts it in power down mode.
303 
*                  - NewState: new state of the ADC peripheral.
304 
*                    This parameter can be: ENABLE or DISABLE.
305 
* Output         : None
306 
* Return         : None.
307 
*******************************************************************************/
308 
void ADC_Cmd(FunctionalState NewState)
309 
{
310 
  if (NewState == DISABLE)
311 
  {
312 
    /* Enable ADC Power Down Mode */
313 
    ADC->CLR4 |= ADC_PowerDown_Enable;
314 
  }
315 
  else
316 
  {
317 
    /* Disable ADC Power Down Mode */
318 
    ADC->CLR4 &= ADC_PowerDown_Disable;
319 
  }
320 
}
321 
 
322 
/*******************************************************************************
323 
* Function Name  : ADC_AutoClockOffConfig
324 
* Description    : Enables or disables the Auto clock off feature.
325 
*                  - NewState: new state of the Auto clock off feature. This
326 
*                    parameter can be: ENABLE or DISABLE.
327 
* Output         : None
328 
* Return         : None.
329 
*******************************************************************************/
330 
void ADC_AutoClockOffConfig(FunctionalState NewState)
331 
{
332 
  if (NewState == ENABLE)
333 
  {
334 
    /* Enable ADC Auto Clock Off */
335 
    ADC->CLR4 |= ADC_AutoClockOff_Enable;
336 
  }
337 
  else
338 
  {
339 
    /* Disable ADC Auto Clock Off */
340 
    ADC->CLR4 &= ADC_AutoClockOff_Disable;
341 
  }
342 
}
343 
 
344 
/*******************************************************************************
345 
* Function Name  : ADC_AnalogWatchdogConfig
346 
* Description    : Configures the analog input channel to be used for the selected
347 
*                  Analog Watchdog and defines its corresponding High and Low
348 
*                  threshold values.
349 
* Input          : - ADC_AnalogWatchdog: specifies the analog watchdog which will
350 
*                    be affected to the desired converted channel. This parameter
351 
*                    can be one of the following values:
352 
*                     - ADC_AnalogWatchdog0: select analog watchdog 0
353 
*                     - ADC_AnalogWatchdog1: select analog watchdog 1
354 
*                     - ADC_AnalogWatchdog2: select analog watchdog 2
355 
*                     - ADC_AnalogWatchdog3: select analog watchdog 3
356 
*                  - ADC_CHANNEL: specifies the channel linked to the selected
357 
*                    analog watchdog. This parameter can be ADC_CHANNELx where x
358 
*                    can be (0..15)
359 
*                  - LowThreshold: Low Threshold for the selected Analog watchdog
360 
*                  - HighThreshold: High Threshold for the selected Analog watchdog
361 
* Output         : None
362 
* Return         : None
363 
*******************************************************************************/
364 
void ADC_AnalogWatchdogConfig(u16 ADC_AnalogWatchdog, u8 ADC_CHANNEL,
365 
                              u16 LowThreshold, u16 HighThreshold)
366 
{
367 
  switch (ADC_AnalogWatchdog)
368 
  {
369 
    /* Set the selected channel and their corresponding High and Low thresholds */
370 
    case ADC_AnalogWatchdog0 :
371 
      ADC->TRA0 = (ADC->TRA0 & ADC_AnalogWatchdogChannel_Mask) | ((u16) ADC_CHANNEL<<10);
372 
      ADC->TRA0 = (ADC->TRA0 & ADC_Threshold_Mask) |  HighThreshold;
373 
      ADC->TRB0 = (ADC->TRB0 & ADC_Threshold_Mask) |  LowThreshold;
374 
      break;
375 
 
376 
    case ADC_AnalogWatchdog1 :
377 
      ADC->TRA1 = (ADC->TRA1 & ADC_AnalogWatchdogChannel_Mask) | ((u16) ADC_CHANNEL<<10);
378 
      ADC->TRA1 = (ADC->TRA1 & ADC_Threshold_Mask) |  HighThreshold;
379 
      ADC->TRB1 = (ADC->TRB1 & ADC_Threshold_Mask) |  LowThreshold;
380 
      break;
381 
 
382 
    case ADC_AnalogWatchdog2 :
383 
      ADC->TRA2 = (ADC->TRA2 & ADC_AnalogWatchdogChannel_Mask) | ((u16) ADC_CHANNEL<<10);
384 
      ADC->TRA2 = (ADC->TRA2 & ADC_Threshold_Mask) |  HighThreshold;
385 
      ADC->TRB2 = (ADC->TRB2 & ADC_Threshold_Mask) |  LowThreshold;
386 
      break;
387 
 
388 
    case ADC_AnalogWatchdog3 :
389 
      ADC->TRA3 = (ADC->TRA3 & ADC_AnalogWatchdogChannel_Mask) | ((u16) ADC_CHANNEL<<10);
390 
      ADC->TRA3 = (ADC->TRA3 & ADC_Threshold_Mask) |  HighThreshold;
391 
      ADC->TRB3 = (ADC->TRB3 & ADC_Threshold_Mask) |  LowThreshold;
392 
      break;
393 
 
394 
    default:
395 
      break;
396 
  }
397 
}
398 
 
399 
/*******************************************************************************
400 
* Function Name  : ADC_AnalogWatchdogCmd
401 
* Description    : Enables or disables the selected analog Watchdog.
402 
* Input          : - ADC_AnalogWatchdog: specifies the analog watchdog to be
403 
*                    enabled or disabled. This parameter can be one of the
404 
*                    following values:
405 
*                     - ADC_AnalogWatchdog0: select analog watchdog 0
406 
*                     - ADC_AnalogWatchdog1: select analog watchdog 1
407 
*                     - ADC_AnalogWatchdog2: select analog watchdog 2
408 
*                     - ADC_AnalogWatchdog3: select analog watchdog 3
409 
*                  - NewState: new state of the specified analog watchdog.
410 
*                    This parameter can be: ENABLE or DISABLE.
411 
* Output         : None
412 
* Return         : None.
413 
*******************************************************************************/
414 
void ADC_AnalogWatchdogCmd(u16 ADC_AnalogWatchdog, FunctionalState NewState)
415 
{
416 
  if (NewState == ENABLE)
417 
  {
418 
    /* Enable the selected ADC AnalogWatchdogx */
419 
    switch (ADC_AnalogWatchdog)
420 
    {
421 
      case ADC_AnalogWatchdog0 :
422 
        ADC->TRB0 |= ADC_AnalogWatchdog_Enable;
423 
        break;
424 
 
425 
      case ADC_AnalogWatchdog1 :
426 
        ADC->TRB1 |= ADC_AnalogWatchdog_Enable;
427 
        break;
428 
 
429 
      case ADC_AnalogWatchdog2 :
430 
        ADC->TRB2 |= ADC_AnalogWatchdog_Enable;
431 
        break;
432 
 
433 
      case ADC_AnalogWatchdog3 :
434 
        ADC->TRB3 |= ADC_AnalogWatchdog_Enable;
435 
        break;
436 
 
437 
      default:
438 
        break;
439 
    }
440 
  }
441 
  else
442 
  {
443 
    /* Disable the selected ADC AnalogWatchdogx */
444 
    switch (ADC_AnalogWatchdog)
445 
    {
446 
      case ADC_AnalogWatchdog0 :
447 
        ADC->TRB0 &= ADC_AnalogWatchdog_Disable;
448 
        break;
449 
 
450 
      case ADC_AnalogWatchdog1 :
451 
        ADC->TRB1 &= ADC_AnalogWatchdog_Disable;
452 
        break;
453 
 
454 
      case ADC_AnalogWatchdog2 :
455 
        ADC->TRB2 &= ADC_AnalogWatchdog_Disable;
456 
        break;
457 
 
458 
      case ADC_AnalogWatchdog3 :
459 
        ADC->TRB3 &= ADC_AnalogWatchdog_Disable;
460 
        break;
461 
 
462 
      default:
463 
        break;
464 
    }
465 
  }
466 
}
467 
 
468 
/*******************************************************************************
469 
* Function Name  : ADC_GetAnalogWatchdogResult
470 
* Description    : Returns the comparison result of the selected analog watchdog.
471 
* Input          : - ADC_AnalogWatchdog: specifies the analog watchdog channel
472 
*                    which its comparison result will be returned. This parameter
473 
*                    can be one of the following values:
474 
*                     - ADC_AnalogWatchdog0: select analog watchdog 0
475 
*                     - ADC_AnalogWatchdog1: select analog watchdog 1
476 
*                     - ADC_AnalogWatchdog2: select analog watchdog 2
477 
*                     - ADC_AnalogWatchdog3: select analog watchdog 3
478 
* Output         : None
479 
* Return         : The analog watchdog comparaison result value
480 
*******************************************************************************/
481 
u16 ADC_GetAnalogWatchdogResult(u16 ADC_AnalogWatchdog)
482 
{
483 
  /* Return the selected ADC AnalogWatchdogx comparaison result */
484 
  switch(ADC_AnalogWatchdog)
485 
  {
486 
    case ADC_AnalogWatchdog0 :
487 
      return ((ADC->PBR & ADC_AnalogWatchdog)>>4);
488 
 
489 
    case ADC_AnalogWatchdog1 :
490 
      return ((ADC->PBR & ADC_AnalogWatchdog)>>6);
491 
 
492 
    case ADC_AnalogWatchdog2 :
493 
      return ((ADC->PBR & ADC_AnalogWatchdog)>>8);
494 
 
495 
    case ADC_AnalogWatchdog3 :
496 
      return ((ADC->PBR & ADC_AnalogWatchdog)>>10);
497 
 
498 
    default : return (0xFF);  /* if a wrong value of ADC_AnalogWatchdog is selected */
499 
  }
500 
}
501 
 
502 
/*******************************************************************************
503 
* Function Name  : ADC_InjectedConversionConfig
504 
* Description    : Configures the start trigger level for the injected channels
505 
*                  and the injected analog input channels to be converted.
506 
* Input          : - ADC_Injec_ExtTrigger: specifies the start trigger level.
507 
*                    This parameter can be one of the following values:
508 
*                         - ADC_Injec_ExtTrigger_Disable : external trigger disabled
509 
*                         - ADC_Injec_ExtTrigger_RisingEdge: external trigger
510 
*                           configured as rising edge of PWM Timer TRGO signal
511 
*                         - ADC_Injec_ExtTrigger_FallingEdge: external trigger
512 
*                           configured as falling edge of PWM Timer TRGO signal
513 
*                  - FirstChannel: specifies the first injected channel to be
514 
*                    converted.
515 
*                    This parameter can be ADC_CHANNELx  where x can be (0..15).
516 
*                  - ChannelNumber: specifies the Number of the injected channels
517 
*                    to be converted. This parameter can be a  value from 1 to 16.
518 
* Output         : None
519 
* Return         : None
520 
*******************************************************************************/
521 
void ADC_InjectedConversionConfig(u16 ADC_Injec_ExtTrigger, u8 FirstChannel, u8 ChannelNumber)
522 
{
523 
  /* Configure the external start injected conversion trigger */
524 
  switch (ADC_Injec_ExtTrigger)
525 
  {
526 
    case ADC_Injec_ExtTrigger_Disable  :
527 
      /* Disable the external trigger and start the injected conversion by software */
528 
      ADC->CLR3 &= ADC_Injec_ExtTrigger_Disable ;
529 
      break;
530 
    case ADC_Injec_ExtTrigger_RisingEdge :
531 
      /* Start injected conversion on rising edge of the external trigger (PWM) */
532 
      ADC->CLR3 |= ADC_Injec_ExtTrigger_RisingEdge;
533 
      break;
534 
    case ADC_Injec_ExtTrigger_FallingEdge :
535 
      /* Start injected conversion on falling edge of the external trigger (PWM) */
536 
      ADC->CLR3 |= ADC_Injec_ExtTrigger_Enable;
537 
      ADC->CLR3 &= ADC_Injec_ExtTrigger_FallingEdge;
538 
      break;
539 
 
540 
    default:
541 
      break;
542 
  }
543 
 
544 
  /* Clear first injected channel to be converted JFCH[3:0] bits */
545 
  ADC->CLR3 &= ADC_FirstChannel_Mask;
546 
  /* Set the first injected channel to be converted */
547 
  ADC->CLR3 |= FirstChannel;
548 
  /* Clear number of injected channels to be converted JNCH[3:0] bits */
549 
  ADC->CLR3 &= ADC_ChannelNumber_Mask;
550 
  /* Set the number of injected channels to be converted */
551 
  ADC->CLR3 |= ((ChannelNumber-1)<<6);
552 
}
553 
 
554 
/*******************************************************************************
555 
* Function Name  : ADC_StartInjectedConversion
556 
* Description    : Starts by software the conversion of the injected input channels.
557 
* Input          : None
558 
* Output         : None
559 
* Return         : None
560 
*******************************************************************************/
561 
void ADC_StartInjectedConversion(void)
562 
{
563 
  /* Start the injected ADC Conversion */
564 
  ADC->CLR3 |= ADC_Injec_ConversionStart;
565 
}
566 
 
567 
/*******************************************************************************
568 
* Function Name  : ADC_GetConversionValue
569 
* Description    : Reads the conversion result from the appropriate data register.
570 
* Input          : - ADC_CHANNEL :specifies the ADC channel which its conversion
571 
*                    value have to be returned. This parameter can be ADC_CHANNELx
572 
*                    where x can be (0..15) to select channelx
573 
* Output         : None
574 
* Return         : The returned value holds the conversion result of the selected
575 
*                  channel.
576 
*******************************************************************************/
577 
u16 ADC_GetConversionValue(u8 ADC_CHANNEL)
578 
{
579 
  /* Return the conversion result of the selected channel */
580 
  return *((u16 *)(ADC_BASE + ((ADC_CHANNEL<<2) + ADC_DataRegisterOffset)));
581 
}
582 
 
583 
/*******************************************************************************
584 
* Function Name  : ADC_ITConfig
585 
* Description    : Enables or disables the specified ADC interrupts.
586 
* Input          : - ADC_IT: specifies the ADC interrupts to be enabled or disabled.
587 
*                    This parameter can be any combination of the following values:
588 
*                         - ADC_IT_ECH:  End of chain conversion interrupt
589 
*                         - ADC_IT_EOC:  End of channel conversion interrupt
590 
*                         - ADC_IT_JECH: Injected end of chain conversion interrupt
591 
*                         - ADC_IT_JEOC: Injected end of channel conversion interrupt
592 
*                         - ADC_IT_AnalogWatchdog0_LowThreshold:
593 
*                                        Analog Watchdog 0 LowThreshold interrupt
594 
*                         - ADC_IT_AnalogWatchdog0_HighThreshold:
595 
*                                        Analog Watchdog 0 HighThreshold interrupt
596 
*                         - ADC_IT_AnalogWatchdog1_LowThreshold:
597 
*                                        Analog Watchdog 1 LowThreshold interrupt
598 
*                         - ADC_IT_AnalogWatchdog1_HighThreshold:
599 
*                                        Analog Watchdog 1 HighThreshold interrupt
600 
*                         - ADC_IT_AnalogWatchdog2_LowThreshold:
601 
*                                        Analog Watchdog 2 LowThreshold interrupt
602 
*                         - ADC_IT_AnalogWatchdog2_HighThreshold:
603 
*                                        Analog Watchdog 2 HighThreshold interrupt
604 
*                         - ADC_IT_AnalogWatchdog3_LowThreshold:
605 
*                                        Analog Watchdog 3 LowThreshold interrupt
606 
*                         - ADC_IT_AnalogWatchdog3_HighThreshold:
607 
*                                         Analog Watchdog 5 HighThreshold interrupt
608 
*                         - ADC_IT_ALL:  All interrupts
609 
*                  - NewState: new state of the specified ADC interrupts.
610 
*                    This parameter can be: ENABLE or DISABLE.
611 
* Output         : None
612 
* Return         : None
613 
*******************************************************************************/
614 
void ADC_ITConfig(u16 ADC_IT, FunctionalState NewState)
615 
{
616 
  if (NewState == ENABLE)
617 
  {
618 
    /* Enable the selected ADC interrupts */
619 
    ADC->IMR |= ADC_IT;
620 
  }
621 
  else
622 
  {
623 
    /* Disable the selected ADC interrupts */
624 
    ADC->IMR &= ~ADC_IT;
625 
  }
626 
}
627 
 
628 
/*******************************************************************************
629 
* Function Name  : ADC_DMAConfig
630 
* Description    : Configures the ADC’s DMA interface.
631 
* Input          : - ADC_DMA_CHANNEL: specifies the channels to be enabled or
632 
*                    disabled for DMA transfer. This parameter can be any
633 
*                    combination of ADC_DMA_CHANNELx where x can be (0..15).
634 
*                  - NewState: new state of the specified ADC DMA channels.
635 
*                    This parameter can be: ENABLE or DISABLE.
636 
* Output         : None
637 
* Return         : None
638 
*******************************************************************************/
639 
void ADC_DMAConfig(u16 ADC_DMA_CHANNEL, FunctionalState NewState)
640 
{
641 
  if(NewState == ENABLE)
642 
  {
643 
    /* Enable DMA for the selected channels */
644 
    ADC->DMAR |= ADC_DMA_CHANNEL ;
645 
  }
646 
  else
647 
  {
648 
    /* Disable DMA for the selected channels */
649 
    ADC->DMAR &= ~ADC_DMA_CHANNEL;
650 
  }
651 
}
652 
 
653 
/*******************************************************************************
654 
* Function Name  : ADC_DMACmd
655 
* Description    : Enable or disable the DMA transfer for the ADC.
656 
* Input          : - ADC_DMA: specifies the DMA command. This parameter can be
657 
*                    one of the following values:
658 
*                         - ADC_DMA_Disable: disable the DMA capability
659 
*                         - ADC_DMA_Enable: enabled by setting the global
660 
*                           enable bit
661 
*                         - ADC_DMA_ExtTrigger_HighLevel: enabled by detection of
662 
*                           high level of TIM2 OC2 signal
663 
*                         - ADC_DMA_ExtTrigger_LowLevel: enabled by detection of
664 
*                           low level of TIM2 OC2 signal
665 
* Output         : None
666 
* Return         : None
667 
*******************************************************************************/
668 
void ADC_DMACmd(u16 ADC_DMA)
669 
{
670 
  /* Configure the DMA external trigger enable */
671 
  switch (ADC_DMA)
672 
  {
673 
    case ADC_DMA_Disable :
674 
      /* Disable DMA transfer */
675 
      ADC->DMAE &= ADC_DMA_Disable;
676 
      break;
677 
 
678 
    case ADC_DMA_Enable :
679 
      /* Enable DMA transfer */
680 
      ADC->DMAE |= ADC_DMA_Enable;
681 
      break;
682 
 
683 
    case ADC_DMA_ExtTrigger_HighLevel :
684 
      /* Enable DMA transfer on high level of the external trigger (TIM2) */
685 
      ADC->DMAE &= ADC_DMA_Disable;
686 
      ADC->DMAE |= ADC_DMA_ExtTrigger_HighLevel;
687 
      break;
688 
 
689 
    case ADC_DMA_ExtTrigger_LowLevel :
690 
      /* Enable DMA transfer on low level of the external trigger (TIM2) */
691 
      ADC->DMAE |= ADC_DMA_ExtEnable_Mask;
692 
      ADC->DMAE &= ADC_DMA_ExtTrigger_LowLevel;
693 
      break;
694 
 
695 
    default:
696 
      break;
697 
  }
698 
}
699 
 
700 
/*******************************************************************************
701 
* Function Name  : ADC_GetDMAFirstEnabledChannel
702 
* Description    : Gets the first DMA-enabled channel configured at the time that
703 
*                  DMA was last globally enabled.
704 
* Input          : None
705 
* Output         : None
706 
* Return         : The first DMA enabled channel
707 
*******************************************************************************/
708 
u16 ADC_GetDMAFirstEnabledChannel(void)
709 
{
710 
  /* Return the DMA first enabled channel */
711 
  return (ADC->DMAE & ADC_DMAFirstEnabledChannel_Mask);
712 
}
713 
 
714 
/*******************************************************************************
715 
* Function Name  : ADC_GetFlagStatus
716 
* Description    : Checks whether the specified ADC flag is set or not.
717 
* Input          : - ADC_FLAG: specifies the ADC flag to check. This parameter
718 
*                    can be one of the following values:
719 
*                         - ADC_FLAG_ECH:  End of chain conversion Flag
720 
*                         - ADC_FLAG_EOC:  End of channel conversion Flag
721 
*                         - ADC_FLAG_JECH: End of injected chain conversion Flag
722 
*                         - ADC_FLAG_JEOC: End of injected channel conversion Flag
723 
*                         - ADC_FLAG_AnalogWatchdog0_LowThreshold:
724 
*                                          Analog Watchdog 0 LowThreshold Flag
725 
*                         - ADC_FLAG_AnalogWatchdog0_HighThreshold:
726 
*                                          Analog Watchdog 0 HighThreshold Flag
727 
*                         - ADC_FLAG_AnalogWatchdog1_LowThreshold:
728 
*                                          Analog Watchdog 1 LowThreshold Flag
729 
*                         - ADC_FLAG_AnalogWatchdog1_HighThreshold:
730 
*                                          Analog Watchdog 1 HighThreshold Flag
731 
*                         - ADC_FLAG_AnalogWatchdog2_LowThreshold:
732 
*                                          Analog Watchdog 2 LowThreshold Flag
733 
*                         - ADC_FLAG_AnalogWatchdog2_HighThreshold:
734 
*                                          Analog Watchdog 2 HighThreshold Flag
735 
*                         - ADC_FLAG_AnalogWatchdog3_LowThreshold:
736 
*                                          Analog Watchdog 3 LowThreshold Flag
737 
*                         - ADC_FLAG_AnalogWatchdog3_HighThreshold:
738 
*                                          Analog Watchdog 3 HighThreshold Flag
739 
* Output         : None
740 
* Return         : The new state of the ADC_FLAG (SET or RESET).
741 
*******************************************************************************/
742 
FlagStatus ADC_GetFlagStatus(u16 ADC_FLAG)
743 
{
744 
  /* Check the status of the specified ADC flag */
745 
  if((ADC->PBR & ADC_FLAG) != RESET)
746 
  {
747 
    /* Return SET if ADC_FLAG is set */
748 
    return SET;
749 
  }
750 
  else
751 
  {
752 
    /* Return RESET if ADC_FLAG is reset */
753 
    return RESET;
754 
  }
755 
}
756 
 
757 
/*******************************************************************************
758 
* Function Name  : ADC_ClearFlag
759 
* Description    : Clears the ADC’s pending flags.
760 
* Input          : - ADC_FLAG: specifies the flag to clear. This parameter can
761 
*                    be any combination of the following values:
762 
*                         - ADC_FLAG_ECH:  End of chain conversion flag
763 
*                         - ADC_FLAG_EOC:  End of channel conversion flag
764 
*                         - ADC_FLAG_JECH: Injected end of chain conversion flag
765 
*                         - ADC_FLAG_JEOC: Injected end of channel conversion flag
766 
*                         - ADC_FLAG_AnalogWatchdog0_LowThreshold:
767 
*                                         Analog Watchdog 0 LowThreshold flag
768 
*                         - ADC_FLAG_AnalogWatchdog0_HighThreshold:
769 
*                                         Analog Watchdog 0 HighThreshold flag
770 
*                         - ADC_FLAG_AnalogWatchdog1_LowThreshold:
771 
*                                         Analog Watchdog 1 LowThreshold flag
772 
*                         - ADC_FLAG_AnalogWatchdog1_HighThreshold:
773 
*                                         Analog Watchdog 1 HighThreshold flag
774 
*                         - ADC_FLAG_AnalogWatchdog2_LowThreshold:
775 
*                                         Analog Watchdog 2 LowThreshold flag
776 
*                         - ADC_FLAG_AnalogWatchdog2_HighThreshold:
777 
*                                         Analog Watchdog 2 HighThreshold flag
778 
*                         - ADC_FLAG_AnalogWatchdog3_LowThreshold:
779 
*                                         Analog Watchdog 3 LowThreshold flag
780 
*                         - ADC_FLAG_AnalogWatchdog3_HighThreshold:
781 
*                                         Analog Watchdog 3 HighThreshold flag
782 
* Output         : None
783 
* Return         : None
784 
*******************************************************************************/
785 
void ADC_ClearFlag(u16 ADC_FLAG)
786 
{
787 
  /* Clear the selected ADC flag */
788 
  ADC->PBR = ADC_FLAG;
789 
}
790 
 
791 
/*******************************************************************************
792 
* Function Name  : ADC_GetITStatus
793 
* Description    : Checks whether the specified ADC interrupt has occured or not.
794 
* Input          : - ADC_IT: specifies the ADC interrupt source to check. This
795 
*                    parameter can be one of the following values:
796 
*                         - ADC_IT_ECH :End of chain conversion interrupt
797 
*                         - ADC_IT_EOC :End of channel conversion interrupt
798 
*                         - ADC_IT_JECH :End of injected chain conversion interrupt
799 
*                         - ADC_IT_JEOC :End of injected channel conversion interrupt
800 
*                         - ADC_IT_AnalogWatchdog0_LowThreshold:
801 
*                                         Analog Watchdog 0 LowThreshold interrupt
802 
*                         - ADC_IT_AnalogWatchdog0_HighThreshold:
803 
*                                         Analog Watchdog 0 HighThreshold interrupt
804 
*                         - ADC_IT_AnalogWatchdog1_LowThreshold:
805 
*                                         Analog Watchdog 1 LowThreshold interrupt
806 
*                         - ADC_IT_AnalogWatchdog1_HighThreshold:
807 
*                                         Analog Watchdog 1 HighThreshold interrupt
808 
*                         - ADC_IT_AnalogWatchdog2_LowThreshold:
809 
*                                         Analog Watchdog 2 LowThreshold interrupt
810 
*                         - ADC_IT_AnalogWatchdog2_HighThreshold:
811 
*                                         Analog Watchdog 2 HighThreshold interrupt
812 
*                         - ADC_IT_AnalogWatchdog3_LowThreshold:
813 
*                                         Analog Watchdog 3 LowThreshold interrupt
814 
*                         - ADC_IT_AnalogWatchdog3_HighThreshold:
815 
*                                         Analog Watchdog 3 HighThreshold interrupt
816 
* Output         : None
817 
* Return         : The new state of the ADC_IT (SET or RESET).
818 
*******************************************************************************/
819 
ITStatus ADC_GetITStatus(u16 ADC_IT)
820 
{
821 
  /* Check the status of the specified ADC interrupt */
822 
  if((ADC->PBR & ADC_IT) != RESET)
823 
  {
824 
    /* Return SET if the ADC interrupt flag is set */
825 
    return SET;
826 
  }
827 
  else
828 
  {
829 
    /* Return RESET if the ADC interrupt flag is reset */
830 
    return RESET;
831 
  }
832 
}
833 
 
834 
/*******************************************************************************
835 
* Function Name  : ADC_ClearITPendingBit
836 
* Description    : Clears the ADC’s interrupt pending bits.
837 
* Input          : - ADC_IT: specifies the interrupt pending bit to clear. This
838 
*                    parameter can be can be any combination of the following
839 
*                    values:
840 
*                         - ADC_IT_ECH:  End of chain conversion interrupt
841 
*                         - ADC_IT_EOC:  End of channel conversion interrupt
842 
*                         - ADC_IT_JECH: Injected end of chain conversion interrupt
843 
*                         - ADC_IT_JEOC: Injected end of channel conversion interrupt
844 
*                         - ADC_IT_AnalogWatchdog0_LowThreshold:
845 
*                                         Analog Watchdog 0 LowThreshold interrupt
846 
*                         - ADC_IT_AnalogWatchdog0_HighThreshold:
847 
*                                         Analog Watchdog 0 HighThreshold interrupt
848 
*                         - ADC_IT_AnalogWatchdog1_LowThreshold:
849 
*                                         Analog Watchdog 1 LowThreshold interrupt
850 
*                         - ADC_IT_AnalogWatchdog1_HighThreshold:
851 
*                                         Analog Watchdog 1 HighThreshold interrupt
852 
*                         - ADC_IT_AnalogWatchdog2_LowThreshold:
853 
*                                         Analog Watchdog 2 LowThreshold interrupt
854 
*                         - ADC_IT_AnalogWatchdog2_HighThreshold:
855 
*                                         Analog Watchdog 2 HighThreshold interrupt
856 
*                         - ADC_IT_AnalogWatchdog3_LowThreshold:
857 
*                                         Analog Watchdog 3 LowThreshold interrupt
858 
*                         - ADC_IT_AnalogWatchdog3_HighThreshold:
859 
*                                         Analog Watchdog 5 HighThreshold interrupt
860 
* Output         : None
861 
* Return         : None
862 
*******************************************************************************/
863 
void ADC_ClearITPendingBit(u16 ADC_IT)
864 
{
865 
  /* Clear the selected ADC interrupts pending bits */
866 
  ADC->PBR = ADC_IT;
867 
}
868 
 
869 
/******************* (C) COPYRIGHT 2006 STMicroelectronics *****END OF FILE****/

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.