This routines configures ADC module.

The internal ADC module is set to:

• single conversion mode,
• internal voltage reference.

None.

Nothing.

• MCU with built-in ADC module.

ADC_Init();  // Initialize ADC module with default settings

None.

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

• mode: mode used in ADC process :

  Value	Description
  _ADC_MODE_SINGLE	Single conversion mode.
  _ADC_MODE_CONTINUOUS	Continuos conversion mode.

Nothing.

• The MCU with built-in ADC module.

ADC_Init_Advanced(_ADC_MODE_CONTINUOUS);  // set continuous conversion mode

None.

The function sets appropriate ADC channel as an analog input.

• channel: represents the channel which will be set as an analog input:

  Value	Description
  _ADC_CHANNEL_0	ADC channel 0.
  _ADC_CHANNEL_1	ADC channel 1.
  _ADC_CHANNEL_2	ADC channel 2.
  _ADC_CHANNEL_3	ADC channel 3.
  _ADC_CHANNEL_4	ADC channel 4.
  _ADC_CHANNEL_5	ADC channel 5.
  _ADC_CHANNEL_6	ADC channel 6.
  _ADC_CHANNEL_ALL	All ADC channels.

Nothing.

• The MCU with built-in ADC module.

// sets ADC channels 0 and 1 as analog inputs
ADC_Set_Input_Channel(_ADC_CHANNEL_0 | _ADC_CHANNEL_1);

• Refer to the appropriate Datasheet for the number of available channels.

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

• channel: represents the channel from which the analog value is to be acquired :

  Value	Description
  _ADC_CHANNEL_0	ADC channel 0.
  _ADC_CHANNEL_1	ADC channel 1.
  _ADC_CHANNEL_2	ADC channel 2.
  _ADC_CHANNEL_3	ADC channel 3.
  _ADC_CHANNEL_4	ADC channel 4.
  _ADC_CHANNEL_5	ADC channel 5.
  _ADC_CHANNEL_6	ADC channel 6.
  _ADC_CHANNEL_ALL	All ADC channels.

ADC value from the specified channel.

• The MCU with built-in ADC module.
• Prior to using this routine, appopriate ADC channels must be set as an analog input. Please see ADC_Set_Input_Channel.
• Also, ADC module needs to be previously initialized. See ADC_Init and ADC_Init_Advanced.

unsigned adc_value;
...
ADC_Set_Input_Channel(_ADC_CHANNEL_1); // Set ADC channel 1 as an analog input
ADC_Init();                             // Initialize ADC module
adc_value = ADC_Get_Sample(_ADC_CHANNEL_1);         // read analog value from ADC module channel 1

• Refer to the appropriate Datasheet for the number of available channels.

The function sets appropriate ADC channel as an analog input, enables ADC module, initializes ADC module and reads from the specified analog channel input.

• channel: represents the channel from which the analog value is to be acquired :

  Value	Description
  _ADC_CHANNEL_0	ADC channel 0.
  _ADC_CHANNEL_1	ADC channel 1.
  _ADC_CHANNEL_2	ADC channel 2.
  _ADC_CHANNEL_3	ADC channel 3.
  _ADC_CHANNEL_4	ADC channel 4.
  _ADC_CHANNEL_5	ADC channel 5.
  _ADC_CHANNEL_6	ADC channel 6.
  _ADC_CHANNEL_ALL	All ADC channels.

ADC value from the specified channel.

• The MCU with built-in ADC module.

unsigned adc_value;
...
adc_value = ADC_Read(_ADC_CHANNEL_1);    // read analog value from ADC module channel 1

• Refer to the appropriate Datasheet for the number of available channels.
• Since this routine enables, initializes and reads value from ADC module, its execution will be much slower than the ADC_Get_Sample which only samples analog value.
  If the speed is a key factor, it is advisable to initialize the ADC module first, and then sample analog value, rather than using ADC_Read routine.