ADC Library

ADC (Analog to Digital Converter) module is available with a number of PIC32 MCU modules. ADC is an electronic circuit that converts continuous signals to discrete digital numbers. ADC Library provides you a comfortable work with the module.

Library Routines

ADCx_Init

Prototype

void ADCx_Init();

Description

This routines configures ADC module to work with default settings.

The internal ADC module is set to:

  • single channel conversion
  • 10-bit conversion resolution
  • unsigned integer data format
  • auto-convert
  • VRef+ : AVdd, VRef- : AVss
  • instruction cycle clock
  • conversion clock : 32*Tcy
  • auto-sample time : 31TAD

Parameters

None.

Returns

Nothing.

Requires
  • MCU with built-in ADC module.
Example
ADC1_Init();  // Initialize ADC module with default settings
Notes

None.

ADCx_Init_Advanced

Prototype

void ADC1_Init_Advanced(unsigned Reference);

Description

This routine configures the internal ADC module to work with user defined settings.

Parameters
  • Reference: voltage reference used in ADC process.
    Description Predefined library const
    Voltage reference:
    Internal voltage reference _ADC_INTERNAL_REF
    External voltage reference _ADC_EXTERNAL_REF
Returns

Nothing.

Requires
  • The MCU with built-in ADC module.
Example
ADC1_Init_Advanced(_ADC_INTERNAL_REF);  // set internal reference used
Notes
  • Not all MCUs support advanced configuration. Please, read the appropriate datasheet before utilizing this library.

ADCx_Get_Sample

Prototype

unsigned ADCx_Get_Sample(unsigned channel);

Description

The function enables ADC module and reads the specified analog channel input.

Parameters
  • channel represents the channel from which the analog value is to be acquired.
Returns

10-bit unsigned value from the specified channel.

Requires
  • The MCU with built-in ADC module.
  • Prior to using this routine, ADC module needs to be initialized. See ADCx_Init and ADCx_Init_Advanced.
  • Before using the function, be sure to configure the appropriate TRISx bits to designate pins as inputs.
Example
unsigned adc_value;
...
adc_value = ADC1_Get_Sample(10);    // read analog value from ADC module channel 10
Notes
  • The function sets the appropriate bit in the AD1PCFG registers to enable analog function of the chosen pin.
  • Refer to the appropriate Datasheet for channel-to-pin mapping.

ADCx_Read

Prototype

unsigned ADCx_Read(unsigned channel);

Description

The function initializes, enables ADC module and reads the specified analog channel input.

Parameters
  • channel represents the channel from which the analog value is to be acquired.
Returns

10-bit unsigned value from the specified channel.

Requires
  • The MCU with built-in ADC module.
  • Before using the function, be sure to configure the appropriate TRISx bits to designate pins as inputs.
Example
unsigned adc_value;
...
adc_value = ADC1_Read(10);    // read analog value from ADC1 module channel 10
Notes
  • This is a standalone routine, so there is no need for a previous initialization of ADC module.
  • The function sets the appropriate bit in the ADPCFG registers to enable analog function of the chosen pin.
  • Refer to the appropriate Datasheet for channel-to-pin mapping.
Copyright (c) 2002-2012 mikroElektronika. All rights reserved.
What do you think about this topic ? Send us feedback!
Want more examples and libraries? 
Find them on LibStock - A place for the code