Function	Description
BusyADC	Is A/D converter currently performing a conversion?
CloseADC	Disable the A/D converter.
ConvertADC	Start an A/D conversion.
OpenADC	Configure the A/D converter.
ReadADC	Read the results of an A/D conversion.
SetChanADC	Select A/D channel to be used.
SelChanConvADC	Select A/D channel to be used and start an A/D conversion.

Based on the different control registers, configuration bits and their positions in the control register, all PIC18 devices are divided into the following different versions. Wherever required, separate functions have been designed to support these versions, so before calling the LIB functions care has to be taken to know the version of the configured device and to call the appropriate function with correct number of arguments. For ADC_V11 user has to configure the I/O registers.

Below is the table to find the ADC version for the configured device:

TABLE: VERSION vs. DEVICES

Version name	Device number
ADC_V1	18C242, 18C252, 18C442, 18C452, 18F242, 18F252, 18F442, 18F452, 18F248 18F258, 18F448, 18F458, 18F2439, 18F2539, 18F4439, 18F4539
ADC_V2	18C601, 18C801, 18C658, 18C858, 18F6620, 18F6720, 18F8620, 18F8720, 18F6520, 18F8520
ADC_V3	18F1220, 18F1320
ADC_V4	18F1230, 18F1330
ADC_V5	18F2220, 18F2320, 18F4220, 18F4320, 18F2420, 18F2520, 18F4420, 18F4520, 18F2423, 18F2523, 18F4423, 18F4523, 18F2455, 18F2550, 18F4455, 18F4550, 18F2410, 18F2510, 18F2515, 18F2610, 18F4410, 18F4510, 18F4515, 18F4610, 18F2525, 18F2620, 18F4525, 18F4620, 18F6310, 18F6410 18F8310, 18F8410, 18F6390, 18F6490, 18F8390, 18F8490, 18F6527, 18F6622, 18F6627, 18F6722, 18F8527, 18F8622, 18F8627, 18F8722, 18F6585, 18F6680, 18F8585, 18F8680, 18F6525, 18F6621, 18F8525, 18F8621, 18F2450, 18F4450, 18F2480, 18F2580, 18F4480, 18F4580, 18F2585, 18F2680, 18F4585, 18F4680, 18F2682, 18F2685, 18F4682, 18F4685, 18F2221, 18F2321, 18F4221, 18F4321
ADC_V6	18F24J10, 18F25J10, 18F44J10, 18F45J10, 18F63J11, 18F64J11, 18F65J11, 18F83J11, 18F84J11, 18F85J11, 18F63J90, 18F64J90, 18F65J90, 18F83J90, 18F84J90, 18F85J90, 18F65J10, 18F65J15, 18F66J10, 18F66J15, 18F67J10, 18F85J10, 18F85J15, 18F86J10, 18F86J15, 18F87J10, 18F66J60, 18F66J65, 18F67J60, 18F86J60, 18F86J65, 18F87J60, 18F96J60, 18F96J65, 18F97J60
ADC_V7	18F4331, 18F4431
ADC_V7_1	18F2331, 18F2431
ADC_V8	18F23K20, 18F24K20, 18F25K20, 18F43K20, 18F44K20, 18F45K20
ADC_V9	18F66J11, 18F66J16, 18F67J11, 18F86J11, 18F86J16 18F87J11, 18F65J50, 18F66J50, 18F66J55, 18F67J50 18F85J50, 18F86J50, 18F86J55, 18F87J50
ADC_V10	18F13K50, 18LF13K50, 18F14K50, 18LF14K50, 18F13K22, 18F14K22, 18LF13K22, 18LF14K22
ADC_V11	18F24J50, 18F25J50, 18F26J50, 18F44J50, 18F45J50, 18F46J50, 18F24J11, 18F25J11, 18F26J11, 18F44J11, 18F45J11, 18F46J11, 18F24J50, 18F25J50, 18F26J50, 18F44J50, 18F45J50, 18LF46J50, 18LF24J11, 18LF25J11, 18LF26J11, 18LF44J11,18LF45J11, 18LF46J11
ADC_V12	18F66J90, 18F67J90, 18F86J90, 18F87J90, 18F66J93, 18F67J93, 18F86J93, 18F87J93

2 Function Descriptions

2.1 BusyADC

Function:	Is the A/D converter currently performing a conversion?
Include:	adc.h;
Prototype:	char BusyADC( void );
Remarks:	This function indicates if the A/D peripheral is in the process of converting a value.
Return Value:	1 if the A/D peripheral is performing a conversion. 0 if the A/D peripheral isn’t performing a conversion.
File Name:	adcbusy.c

2.2 CloseADC

Function:	Disable the A/D converter.
Include:	adc.h
Prototype:	void CloseADC( void );
Remarks:	This function disables the A/D converter and A/D interrupt mechanism.
File Name:	adcclose.c

2.3 ConvertADC

Function:	Starts the A/D conversion process.
Include:	adc.h
Prototype:	void ConvertADC( void );
Remarks:	This function starts an A/D conversion. The BusyADC() function or A/D interrupt may be used to detect completion of the conversion.
File Name:	adcconv.c

2.4 OpenADC

2.4.1 OpenADC (ADC_V1)

For ADC_V1

Function:	Configure the A/D converter.
Include:	adc.h
Prototype:	void OpenADC( unsigned char *config, unsigned char config2* );
Arguments:	*Config* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	A/D clock source: ADC_FOSC_2 Fosc / 2 ADC_FOSC_4 Fosc / 4 ADC_FOSC_8 Fosc / 8 ADC_FOSC_16 Fosc / 16 ADC_FOSC_32 Fosc / 32 ADC_FOSC_64 Fosc / 64 ADC_FOSC_RC Internal RC Oscillator
	A/D result justification: ADC_RIGHT_JUST Result in Least Significant bits ADC_LEFT_JUST Result in Most Significant bits
	A/D voltage reference source: ADC_8ANA_0REF Vref+ = Vdd, Vref- = Vss, All analog channels ADC_7ANA_1REF Vref+ = AN3, Vref- = Vss All analog channels except AN3 ADC_6ANA_2REF Vref+ = AN3, Vref- = AN2 ADC_6ANA_0REF Vref+ = Vdd, Vref- = Vss ADC_5ANA_1REF Vref+ = AN3, Vref- = Vss ADC_5ANA_0REF Vref+ = Vdd, Vref- = Vss ADC_4ANA_2REF Vref+ = AN3, Vref- = AN2 ADC_4ANA_1REF Vref+ = AN3, Vref- = Vss ADC_3ANA_2REF Vref+ = AN3, Vref- = AN2 ADC_3ANA_0REF Vref+ = Vdd, Vref- = Vss ADC_2ANA_2REF Vref+ = AN3, Vref- = AN2 ADC_2ANA_1REF Vref+ = AN3, ADC_1ANA_2REF Vref+ = AN3, Vref- = AN2 AN0 is analog input ADC_1ANA_0REF Vref+ = Vdd, Vref- = Vss AN0 is analog input ADC_0ANA_0REF All digital I/O
	*Config2* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), user configurable, with a value from each of the categories listed below. These values are defined in the file adc.h.
	Channel: ADC_CH0 Channel 0 ADC_CH1 Channel 1 ADC_CH2 Channel 2 ADC_CH3 Channel 3 ADC_CH4 Channel 4 ADC_CH5 Channel 5 ADC_CH6 Channel 6 ADC_CH7 Channel 7
	A/D Interrupts: ADC_INT_ON Interrupts enabled ADC_INT_OFF Interrupts disabled
Remarks:	This function resets the A/D peripheral to the POR state and configures the A/D-related Special Function Registers (SFRs) according to the options specified.
File Name:	adcopen.c
Code Example:	With AND mask: OpenADC( ADC_FOSC_32 & ADC_RIGHT_JUST & ADC_1ANA_0REF, ADC_CH0 & ADC_INT_OFF ); With OR mask: OpenADC( ADC_FOSC_32 \| ADC_RIGHT_JUST \| ADC_1ANA_0REF, ADC_CH0 \| ADC_INT_OFF );

2.4.2 OpenADC (ADC_V2)

For ADC_V2

Function:	Configure the A/D converter.
Include:	adc.h
Prototype:	void OpenADC( unsigned char *config, unsigned char config2* );
Arguments:	*Config* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown on the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	A/D clock source: ADC_FOSC_2 Fosc / 2 ADC_FOSC_4 Fosc / 4 ADC_FOSC_8 Fosc / 8 ADC_FOSC_16 Fosc / 16 ADC_FOSC_32 Fosc / 32 ADC_FOSC_64 Fosc / 64 ADC_FOSC_RC Internal RC Oscillator
	A/D result justification: ADC_RIGHT_JUST Result in Least Significant bits ADC_LEFT_JUST Result in Most Significant bits
	A/D port configuration: ADC_0ANA All digital ADC_1ANA analog:AN0 digital:AN1-AN15 ADC_2ANA analog:AN0-AN1 digital:AN2-AN15 ADC_3ANA analog:AN0-AN2 digital:AN3-AN15 ADC_4ANA analog:AN0-AN3 digital:AN4-AN15 ADC_5ANA analog:AN0-AN4 digital:AN5-AN15 ADC_6ANA analog:AN0-AN5 digital:AN6-AN15 ADC_7ANA analog:AN0-AN6 digital:AN7-AN15 ADC_8ANA analog:AN0-AN7 digital:AN8-AN15 ADC_9ANA analog:AN0-AN8 digital:AN9-AN15 ADC_10ANA analog:AN0-AN9 digital:AN10-AN15 ADC_11ANA analog:AN0-AN10 digital:AN11-AN15 ADC_12ANA analog:AN0-AN11 digital:AN12-AN15 ADC_13ANA analog:AN0-AN12 digital:AN13-AN15 ADC_14ANA analog:AN0-AN13 digital:AN14-AN15 ADC_15ANA All analog
	*config2* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), user configurable, with a value from each of the categories listed below. These values are defined in the file adc.h.
	Channel: ADC_CH0 Channel 0 ADC_CH1 Channel 1 ADC_CH2 Channel 2 ADC_CH3 Channel 3 ADC_CH4 Channel 4 ADC_CH5 Channel 5 ADC_CH6 Channel 6 ADC_CH7 Channel 7 ADC_CH8 Channel 8 ADC_CH9 Channel 9 ADC_CH10 Channel 10 ADC_CH11 Channel 11 ADC_CH12 Channel 12 ADC_CH13 Channel 13 ADC_CH14 Channel 14 ADC_CH15 Channel 15
	A/D Interrupts: ADC_INT_ON Interrupts enabled ADC_INT_OFF Interrupts disabled
	A/D Vref+ and Vref- configuration: ADC_REF_VDD_VREFMINUS VREF+ = VDD & VREF- = Ext. ADC_REF_VREFPLUS_VREFMINUS VREF+ = Ext. & VREF- = Ext. ADC_REF_VREFPLUS_VSS VREF+ = Ext. & VREF- = VSS ADC_REF_VDD_VSS VREF+ = VDD & VREF- = VSS
Remarks:	This function resets the A/D-related registers to the POR state and then configures the clock, result format, voltage reference, port and channel.
File Name:	adcopen.c
Code Example:	With AND mask: OpenADC( ADC_FOSC_32 & ADC_RIGHT_JUST & ADC_14ANA, ADC_CH0 & ADC_INT_OFF ); With OR mask: OpenADC( ADC_FOSC_32 \| ADC_RIGHT_JUST \| ADC_14ANA, ADC_CH0 \| ADC_INT_OFF );

2.4.3 OpenADC (ADC_V3, 4, 5, 6)

For ADC_V3, ADC_V4, ADC_V5 and ADC_V6

Function:	Configure the A/D convertor.
Include:	adc.h
Prototype:	void OpenADC(unsigned char *config, unsigned char config2* , unsigned char *portconfig*);
Arguments:	*Config* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	A/D clock source: ADC_FOSC_2 Fosc / 2 ADC_FOSC_4 Fosc / 4 ADC_FOSC_8 Fosc / 8 ADC_FOSC_16 Fosc / 16 ADC_FOSC_32 Fosc / 32 ADC_FOSC_64 Fosc / 64 ADC_FOSC_RC Internal RC Oscillator
	A/D result justification: ADC_RIGHT_JUST Result in Least Significant bits ADC_LEFT_JUST Result in Most Significant bits
	A/D acquisition time select: ADC_0_TAD 0 Tad ADC_2_TAD 2 Tad ADC_4_TAD 4 Tad ADC_6_TAD 6 Tad ADC_8_TAD 8 Tad ADC_12_TAD 12 Tad ADC_16_TAD 16 Tad ADC_20_TAD 20 Tad
	*config2* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	Channel: For ADC_V3: ADC_CH0 Channel 0 ADC_CH1 Channel 1 ADC_CH2 Channel 2 ADC_CH3 Channel 3 ADC_CH4 Channel 4 ADC_CH5 Channel 5 ADC_CH6 Channel 6 For ADC_V4: ADC_CH0 Channel 0 ADC_CH1 Channel 1 ADC_CH2 Channel 2 ADC_CH3 Channel 3 For ADC_V5 and ADC_V6: ADC_CH0 Channel 0 ADC_CH1 Channel 1 ADC_CH2 Channel 2 ADC_CH3 Channel 3 ADC_CH4 Channel 4 ADC_CH5 Channel 5 ADC_CH6 Channel 6 ADC_CH7 Channel 7 ADC_CH8 Channel 8 ADC_CH9 Channel 9 ADC_CH10 Channel 10 ADC_CH11 Channel 11 ADC_CH12 Channel 12 ADC_CH13 Channel 13 ADC_CH14 Channel 14 ADC_CH15 Channel 15
	A/D Interrupts: ADC_INT_ON Interrupts enabled ADC_INT_OFF Interrupts disabled
	A/D Vref+ and Vref- configuration: ADC_REF_VDD_VREFMINUS VREF+ = VDD & VREF- = Ext. ADC_REF_VREFPLUS_VREFMINUS VREF+ = Ext. & VREF- = Ext. ADC_REF_VREFPLUS_VSS VREF+ = Ext. & VREF- = VSS ADC_REF_VDD_VSS VREF+ = VDD & VREF- = VSS
	*Portconfig* For ADC_V3: The value of portconfig can be any value from 0 to 127, few are defined below ADC_0ANA All digital ADC_1ANA analog:AN0 ADC_2ANA analog:AN0-AN1 ADC_3ANA analog:AN0-AN2 ADC_4ANA analog:AN0-AN3 ADC_5ANA analog:AN0-AN4 ADC_6ANA analog:AN0-AN5 ADC_7ANA analog:AN0-AN6 For ADC_V4: The value of portconfig can be any value from 0 to 15, few are defined below ADC_0ANA All digital ADC_1ANA analog:AN0 ADC_2ANA analog:AN0-AN1 ADC_3ANA analog:AN0-AN2 ADC_4ANA analog:AN0-AN3 For ADC_V5 and ADC_V6: ADC_0ANA All digital ADC_1ANA analog:AN0 digital:AN1-AN15 ADC_2ANA analog:AN0-AN1 digital:AN2-AN15 ADC_3ANA analog:AN0-AN2 digital:AN3-AN15 ADC_4ANA analog:AN0-AN3 digital:AN4-AN15 ADC_5ANA analog:AN0-AN4 digital:AN5-AN15 ADC_6ANA analog:AN0-AN5 digital:AN6-AN15 ADC_7ANA analog:AN0-AN6 digital:AN7-AN15 ADC_8ANA analog:AN0-AN7 digital:AN8-AN15 ADC_9ANA analog:AN0-AN8 digital:AN9-AN15 ADC_10ANA analog:AN0-AN9 digital:AN10-AN15 ADC_11ANA analog:AN0-AN10 digital:AN11-AN15 ADC_12ANA analog:AN0-AN11 digital:AN12-AN15 ADC_13ANA analog:AN0-AN12 digital:AN13-AN15 ADC_14ANA analog:AN0-AN13 digital:AN14-AN15 ADC_15ANA All analog
Remarks:	This function resets the A/D-related registers to the POR state and then configures the clock, result format, voltage reference, port and channel.
File Name:	adcopen.c
Code Example:	With AND mask: OpenADC( ADC_FOSC_32 & ADC_RIGHT_JUST & ADC_12_TAD, ADC_CH0 & ADC_REF_VDD_VSS & ADC_INT_OFF, 12 ); With OR mask: OpenADC( ADC_FOSC_32 \| ADC_RIGHT_JUST \| ADC_12_TAD, ADC_CH0 \| ADC_REF_VDD_VSS \| ADC_INT_OFF, 12 );

2.4.4 OpenADC (ADC_V7, V7_1)

For ADC_V7 and ADC_V7_1

Function:	Configure the A/D converter.
Include:	adc.h
Prototype:	void OpenADC(unsigned char *config1, unsigned char config2* , unsigned char *config3*);
Arguments:	*Config1* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	A/D conversion type: ADC_CONV_CONTINUOUS ADC_CONV_SINGLE_SHOT A/D conversion mode: ADC_MODE_MULTI_CH ADC_MODE_SINGLE_CH A/D conversion sequence select: ADC_CONV_SEQ_SEQM1 Sequence mode 1 ADC_CONV_SEQ_SEQM2 Sequence mode 2 ADC_CONV_SEQ_STNM1 Simultaneous mode 1 ADC_CONV_SEQ_STNM2 Simultaneous mode 2 A/D result buffer depth Interrupt select control: INT_EACH_WR_BUF Interrupt when each is written to BUF INT_2_4_WR_BUF Interrupt at 2nd & 4th words are written to BUF INT_4_WR_BUF Interrupt at 4th word is written to BUF A/D Interrupts: ADC_INT_ON Interrupts enabled ADC_INT_OFF Interrupts disabled
	*Config2* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), user configurable, with a value from each of the categories listed below. These values are defined in the file adc.h.
	A/D Vref+ and Vref- configuration: ADC_REF_VDD_VREFMINUS VREF+ = VDD & VREF- = Ext. ADC_REF_VREFPLUS_VREFMINUS VREF+ = Ext. & VREF- = Ext. ADC_REF_VREFPLUS_VSS VREF+ = Ext. & VREF- = VSS ADC_REF_VDD_VSS VREF+ = VDD & VREF- = VSS A/D FIFO buffer control: ADC_FIFO_EN ADC_FIFO_DIS A/D Trigger Source: ADC_TRIG_EXT_INT0 External INT0 starts A/D ADC_TRIG_TMR_5 TMR5 starts A/D ADC_TRIG_INP_CAP Input Capture starts A/D ADC_TRIG_CCP2_COM CCP2 Compare starts A/D ADC_TRIG_PCPWM PCPWM rising edge starts A/D
	*Config3* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	A/D result justification: ADC_RIGHT_JUST Result in Least Significant bits ADC_LEFT_JUST Result in Most Significant bits
	A/D acquisition time select: ADC_0_TAD 0 Tad ADC_2_TAD 2 Tad ADC_4_TAD 4 Tad ADC_6_TAD 6 Tad ADC_8_TAD 8 Tad ADC_10_TAD 10 Tad ADC_12_TAD 12 Tad ADC_16_TAD 16 Tad ADC_20_TAD 20 Tad ADC_24_TAD 24 Tad ADC_28_TAD 28 Tad ADC_32_TAD 32 Tad ADC_36_TAD 36 Tad ADC_40_TAD 40 Tad ADC_48_TAD 48 Tad ADC_64_TAD 64 Tad
	A/D clock source: ADC_FOSC_2 Fosc / 2 ADC_FOSC_4 Fosc / 4 ADC_FOSC_8 Fosc / 8 ADC_FOSC_16 Fosc / 16 ADC_FOSC_32 Fosc / 32 ADC_FOSC_64 Fosc / 64 ADC_FOSC_RC Internal RC Oscillator
	A/D Channel selection: Channel from group A ADC_CH_GRA_AN0() select AN0 as analog ADC_CH_GRA_AN4() select AN4 as analog ADC_CH_GRA_AN8() select AN8 as analog Channel from group B ADC_CH_GRB_AN1() select AN1 as analog ADC_CH_GRB_AN5() select AN5 as analog Channel from group C ADC_CH_GRC_AN2() select AN2 as analog ADC_CH_GRC_AN6() select AN6 as analog Channel from group D ADC_CH_GRD_AN3() select AN3 as analog ADC_CH_GRD_AN7() select AN7 as analog ALL_CH_DIGITAL() Make all Channels Digital NOTE: AN5 to AN8 are not available in PIC18F2X31 devices.
Remarks:	This function resets the A/D-related registers to the POR state and then configures the clock, result format, voltage reference, conversion type, conversion mode, triggering sources, FIFO buffer control and conversion sequence select.
File Name:	adcopen.c
Code Example:	With AND mask: OpenADC( ADC_CONV_CONTINUOUS & ADC_MODE_MULTI_CH & ADC_CONV_SEQ_SEQM2, ADC_REF_VDD_VSS & ADC_FIFO_DIS & ADC_TRIG_INP_CAP, ADC_RIGHT_JUST & ADC_10_TAD & ADC_FOSC_8 ); With OR mask: OpenADC( ADC_CONV_CONTINUOUS \| ADC_MODE_MULTI_CH \| ADC_CONV_SEQ_SEQM2, ADC_REF_VDD_VSS \| ADC_FIFO_DIS \| ADC_TRIG_INP_CAP, ADC_RIGHT_JUST \| ADC_10_TAD \| ADC_FOSC_8 );

2.4.5 OpenADC (ADC_V8, 9)

For ADC_V8 and ADC_V9

Function:	Configure the A/D convertor.
Include:	adc.h
Prototype:	void OpenADC(unsigned char *config, unsigned char config2* , unsigned int *portconfig*);
Arguments:	*Config* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file,, with a value from each of the categories listed below. These values are defined in the file adc.h.
	A/D clock source: ADC_FOSC_2 Fosc / 2 ADC_FOSC_4 Fosc / 4 ADC_FOSC_8 Fosc / 8 ADC_FOSC_16 Fosc / 16 ADC_FOSC_32 Fosc / 32 ADC_FOSC_64 Fosc / 64 ADC_FOSC_RC Internal RC Oscillator
	A/D result justification: ADC_RIGHT_JUST Result in Least Significant bits ADC_LEFT_JUST Result in Most Significant bits
	A/D acquisition time select: ADC_0_TAD 0 Tad ADC_2_TAD 2 Tad ADC_4_TAD 4 Tad ADC_6_TAD 6 Tad ADC_8_TAD 8 Tad ADC_12_TAD 12 Tad ADC_16_TAD 16 Tad ADC_20_TAD 20 Tad
	*config2* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file,, with a value from each of the categories listed below. These values are defined in the file adc.h.
	Channel: For ADC_V8: ADC_CH0 Channel 0 ADC_CH1 Channel 1 ADC_CH2 Channel 2 ADC_CH3 Channel 3 ADC_CH4 Channel 4 ADC_CH5 Channel 5 ADC_CH6 Channel 6 ADC_CH7 Channel 7 ADC_CH8 Channel 8 ADC_CH9 Channel 9 ADC_CH10 Channel 10 ADC_CH11 Channel 11 ADC_CH12 Channel 12 For ADC_V9: ADC_CH0 Channel 0 ADC_CH1 Channel 1 ADC_CH2 Channel 2 ADC_CH3 Channel 3 ADC_CH4 Channel 4 ADC_CH5 Unused Channel ADC_CH6 Channel 6 ADC_CH7 Channel 7 ADC_CH8 Channel 8 ADC_CH9 Channel 9 ADC_CH10 Channel 10 ADC_CH11 Channel 11 ADC_CH12 Channel 12 ADC_CH13 Channel 13 ADC_CH14 Channel 14 ADC_CH15 Channel 15
	A/D Interrupts: ADC_INT_ON Interrupts enabled ADC_INT_OFF Interrupts disabled
	A/D Vref+ and Vref- configuration: ADC_REF_VDD_VREFMINUS VREF+ = VDD & VREF- = Ext. ADC_REF_VREFPLUS_VREFMINUS VREF+ = Ext. & VREF- = Ext. ADC_REF_VREFPLUS_VSS VREF+ = Ext. & VREF- = VSS ADC_REF_VDD_VSS VREF+ = VDD & VREF- = VSS
	*Portconfig* For ADC_V8: The portconfig can have 8192 different combination, few are defined below ADC_0ANA All digital ADC_1ANA analog:AN0 ADC_2ANA analog:AN0-AN1 ADC_3ANA analog:AN0-AN2 ADC_4ANA analog:AN0-AN3 ADC_5ANA analog:AN0-AN4 ADC_6ANA analog:AN0-AN5 ADC_7ANA analog:AN0-AN6 ADC_8ANA analog:AN0-AN7 ADC_9ANA analog:AN0-AN8 ADC_10ANA analog:AN0-AN9 ADC_11ANA analog:AN0-AN10 ADC_12ANA analog:AN0-AN11 For ADC_V9: The portconfig can have 16384 different combinations, few are defined below ADC_0ANA All digital ADC_1ANA analog:AN0 ADC_2ANA analog:AN0-AN1 ADC_3ANA analog:AN0-AN2 ADC_4ANA analog:AN0-AN3 ADC_5ANA analog:AN0-AN4 ADC_6ANA analog:AN0-AN6 ADC_7ANA analog:AN0-AN7 ADC_8ANA analog:AN0-AN8 ADC_9ANA analog:AN0-AN9 ADC_10ANA analog:AN0-AN10 ADC_11ANA analog:AN0-AN11 ADC_12ANA analog:AN0-AN12 ADC_13ANA analog:AN0-AN13 ADC_14ANA analog:AN0-AN14 ADC_15ANA All analog
Remarks:	This function resets the A/D-related registers to the POR state and then configures the clock, result format, voltage reference, port and channel.
File Name:	adcopen.c
Code Example:	With AND mask: OpenADC( ADC_FOSC_32 & ADC_RIGHT_JUST & ADC_12_TAD, ADC_CH0 & ADC_REF_VDD_VSS & ADC_INT_ON, ADC_10ANA ); With OR mask: OpenADC( ADC_FOSC_32 \| ADC_RIGHT_JUST \| ADC_12_TAD, ADC_CH0 \| ADC_REF_VDD_VSS \| ADC_INT_ON, ADC_10ANA );

2.4.6 OpenADC (ADC_V10)

For ADC_V10

Function:	Configure the A/D convertor.
Include:	adc.h
Prototype:	void OpenADC(unsigned char *config, unsigned char config2* , unsigned char *config3,* unsigned int *portconfig*);
Arguments:	*Config* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file,, with a value from each of the categories listed below. These values are defined in the file adc.h.
	A/D clock source: ADC_FOSC_2 Fosc / 2 ADC_FOSC_4 Fosc / 4 ADC_FOSC_8 Fosc / 8 ADC_FOSC_16 Fosc / 16 ADC_FOSC_32 Fosc / 32 ADC_FOSC_64 Fosc / 64 ADC_FOSC_RC Internal RC Oscillator
	A/D result justification: ADC_RIGHT_JUST Result in Least Significant bits ADC_LEFT_JUST Result in Most Significant bits
	A/D acquisition time select: ADC_0_TAD 0 Tad ADC_2_TAD 2 Tad ADC_4_TAD 4 Tad ADC_6_TAD 6 Tad ADC_8_TAD 8 Tad ADC_12_TAD 12 Tad ADC_16_TAD 16 Tad ADC_20_TAD 20 Tad
	*config2* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file,, with a value from each of the categories listed below. These values are defined in the file adc.h.
	Channel: ADC_CH3 Channel 3 ADC_CH4 Channel 4 ADC_CH5 Channel 5 ADC_CH6 Channel 6 ADC_CH7 Channel 7 ADC_CH8 Channel 8 ADC_CH9 Channel 9 ADC_CH10 Channel 10 ADC_CH11 Channel 11
	Misc options: TEMP_REF_BANDGAP Temperature reference from BandGap DAC1 DAC FVR1 Fixed Voltage reference
	A/D Interrupts: ADC_INT_ON Interrupts enabled ADC_INT_OFF Interrupts disabled
	*Config3* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file,, with a value from each of the categories listed below. These values are defined in the file adc.h.
	A/D Vref+ and Vref- configuration: ADC_REF_VDD_VDD VREF+ = AVDD ADC_REF_VDD_VREFPLUS VREF+ = ext. source at VREF+ ADC_REF_VDD_FVREF VREF+ = FVREF+ ADC_REF_VDD_VSS VREF- = AVSS ADC_REF_VDD_VREFMINUS VREF- = ext. source at VREF-
	*Portconfig* The portconfig can have 16384 different combinations, few are defined below ADC_0ANA All digital ADC_1ANA analog:AN0 ADC_2ANA analog:AN0-AN1 ADC_3ANA analog:AN0-AN2 ADC_4ANA analog:AN0-AN3 ADC_5ANA analog:AN0-AN4 ADC_6ANA analog:AN0-AN6 ADC_7ANA analog:AN0-AN7 ADC_8ANA analog:AN0-AN8 ADC_9ANA analog:AN0-AN9 ADC_10ANA analog:AN0-AN10 ADC_11ANA analog:AN0-AN11 ADC_12ANA analog:AN0-AN12 ADC_13ANA analog:AN0-AN13 ADC_14ANA analog:AN0-AN14 ADC_15ANA All analog
Remarks:	This function resets the A/D-related registers to the POR state and then configures the clock, result format, voltage reference, port and channel.
File Name:	adcopen.c
Code Example:	With AND mask: OpenADC( ADC_FOSC_32 & ADC_RIGHT_JUST & ADC_12_TAD, ADC_CH0 & ADC_REF_VDD_VSS & ADC_INT_ON, ADC_10ANA ); With OR mask: OpenADC( ADC_FOSC_32 \| ADC_RIGHT_JUST \| ADC_12_TAD, ADC_CH0 \| ADC_REF_VDD_VSS \| ADC_INT_ON, ADC_10ANA );

2.4.7 OpenADC (ADC_V11)

For ADC_V11

Function:	Configure the A/D convertor.
Include:	adc.h
Prototype:	void OpenADC(unsigned char *config, unsigned char config2* , unsigned char *config3*);
Arguments:	*Config* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	A/D clock source: ADC_FOSC_2 Fosc / 2 ADC_FOSC_4 Fosc / 4 ADC_FOSC_8 Fosc / 8 ADC_FOSC_16 Fosc / 16 ADC_FOSC_32 Fosc / 32 ADC_FOSC_64 Fosc / 64 ADC_FOSC_RC Internal RC Oscillator
	A/D result justification: ADC_RIGHT_JUST Result in Least Significant bits ADC_LEFT_JUST Result in Most Significant bits
	A/D acquisition time select: ADC_0_TAD 0 Tad ADC_2_TAD 2 Tad ADC_4_TAD 4 Tad ADC_6_TAD 6 Tad ADC_8_TAD 8 Tad ADC_12_TAD 12 Tad ADC_16_TAD 16 Tad ADC_20_TAD 20 Tad
	*config2* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	Channel: ADC_CH0 Channel 0 ADC_CH1 Channel 1 ADC_CH2 Channel 2 ADC_CH3 Channel 3 ADC_CH4 Channel 4 ADC_CH5 Channel 5 ADC_CH6 Channel 6 ADC_CH7 Channel 7 ADC_CH8 Channel 8 ADC_CH9 Channel 9 ADC_CH10 Channel 10 ADC_CH11 Channel 11 ADC_CH12 Channel 12 ADC_CH_CTMU Channel 13 ADC_CH_VDDCORE Channel 14 ADC_CH_VBG Channel 15
	A/D Interrupts: ADC_INT_ON Interrupts enabled ADC_INT_OFF Interrupts disabled

	A/D Vref+ and Vref- configuration: ADC_REF_VDD_VREFMINUS VREF+ = VDD & VREF- = Ext. ADC_REF_VREFPLUS_VREFMINUS VREF+ = Ext. & VREF- = Ext. ADC_REF_VREFPLUS_VSS VREF+ = Ext. & VREF- = VSS ADC_REF_VDD_VSS VREF+ = VDD & VREF- = VSS
	*Config3* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	*Portconfig* ADC_0ANA All digital ADC_1ANA analog:AN0 digital:AN1-AN13 ADC_2ANA analog:AN0-AN1 digital:AN2-AN13 ADC_3ANA analog:AN0-AN2 digital:AN3-AN13 ADC_4ANA analog:AN0-AN3 digital:AN4-AN13 ADC_5ANA analog:AN0-AN4 digital:AN5-AN13 ADC_6ANA analog:AN0-AN5 digital:AN6-AN13 ADC_7ANA analog:AN0-AN6 digital:AN7-AN13 ADC_8ANA analog:AN0-AN7 digital:AN8-AN13 ADC_9ANA analog:AN0-AN8 digital:AN9-AN13 ADC_10ANA analog:AN0-AN9 digital:AN10-AN13 ADC_11ANA analog:AN0-AN10 digital:AN11-AN13 ADC_12ANA analog:AN0-AN11 digital:AN12-AN13 ADC_13ANA analog:AN0-AN12
	*Band Gap selection* ADC_VBG_ON VBG output enabled ADC_VBG_OFF VBG output disabled ADC_VBG2_ON VBG/2 output enabled ADC_VBG2_OFF VBG/2 output disabled
Remarks:	This function resets the A/D-related registers to the POR state and then configures the clock, result format, voltage reference, port and channel.
File Name:	adcopen.c
Code Example:	With AND mask: OpenADC( ADC_FOSC_32 & ADC_RIGHT_JUST & ADC_12_TAD, ADC_CH0 & ADC_REF_VDD_VSS & ADC_INT_OFF, 12 ); With OR mask: OpenADC( ADC_FOSC_32 \| ADC_RIGHT_JUST \| ADC_12_TAD, ADC_CH0 \| ADC_REF_VDD_VSS \| ADC_INT_OFF, 12 );
Function:	Configure the A/D convertor.
Include:	adc.h

2.4.8 OpenADC (ADC_V12)

For ADC_V12

Function:	Configure the A/D convertor.
Include:	adc.h
Prototype:	void OpenADC(unsigned char *config, unsigned char config2* , unsigned char *config3*);
Arguments:	*Config* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	A/D clock source: ADC_FOSC_2 Fosc / 2 ADC_FOSC_4 Fosc / 4 ADC_FOSC_8 Fosc / 8 ADC_FOSC_16 Fosc / 16 ADC_FOSC_32 Fosc / 32 ADC_FOSC_64 Fosc / 64 ADC_FOSC_RC Internal RC Oscillator
	A/D result justification: ADC_RIGHT_JUST Result in Least Significant bits ADC_LEFT_JUST Result in Most Significant bits
	A/D acquisition time select: ADC_0_TAD 0 Tad ADC_2_TAD 2 Tad ADC_4_TAD 4 Tad ADC_6_TAD 6 Tad ADC_8_TAD 8 Tad ADC_12_TAD 12 Tad ADC_16_TAD 16 Tad ADC_20_TAD 20 Tad
	*config2* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	Channel: ADC_CH0 Channel 0 ADC_CH1 Channel 1 ADC_CH2 Channel 2 ADC_CH3 Channel 3 ADC_CH4 Channel 4 ADC_CH5 Channel 5 ADC_CH6 Channel 6 ADC_CH7 Channel 7 ADC_CH8 Channel 8 ADC_CH9 Channel 9 ADC_CH10 Channel 10 ADC_CH11 Channel 11
	A/D Interrupts: ADC_INT_ON Interrupts enabled ADC_INT_OFF Interrupts disabled
	A/D Vref+ and Vref- configuration: ADC_REF_VDD_VREFMINUS VREF+ = VDD & VREF- = Ext. ADC_REF_VREFPLUS_VREFMINUS VREF+ = Ext. & VREF- = Ext. ADC_REF_VREFPLUS_VSS VREF+ = Ext. & VREF- = VSS ADC_REF_VDD_VSS VREF+ = VDD & VREF- = VSS
	*config3* A bitmask that is created by performing either bitwise AND operation (‘&’) or bitwise OR operation (‘\|’), configurable either way as shown in the example at the end of this file, with a value from each of the categories listed below. These values are defined in the file adc.h.
	Special Trigger configuration: ADC_TRIG_CTMU Special Trigger from CTMU ADC_TRIG_CCP2 Special Trigger from CCP2
	A/D port configuration: ADC_0ANA All digital ADC_1ANA analog:AN0 digital:AN1-AN15 ADC_2ANA analog:AN0-AN1 digital:AN2-AN15 ADC_3ANA analog:AN0-AN2 digital:AN3-AN15 ADC_4ANA analog:AN0-AN3 digital:AN4-AN15 ADC_5ANA analog:AN0-AN4 digital:AN5-AN15 ADC_6ANA analog:AN0-AN5 digital:AN6-AN15 ADC_7ANA analog:AN0-AN6 digital:AN7-AN15 ADC_8ANA analog:AN0-AN7 digital:AN8-AN15 ADC_9ANA analog:AN0-AN8 digital:AN9-AN15 ADC_10ANA analog:AN0-AN9 digital:AN10-AN15 ADC_11ANA analog:AN0-AN10 digital:AN11-AN15
Remarks:	This function resets the A/D-related registers to the POR state and then configures the clock, result format, voltage reference, port, special trigger and channel.
File Name:	adcopen.c
Code Example:	With AND mask: OpenADC( ADC_FOSC_32 & ADC_RIGHT_JUST & ADC_12_TAD, ADC_CH0 & ADC_REF_VDD_VSS & ADC_INT_OFF, ADC_TRIG_CTMU & ADC_1ANA ); With OR mask: OpenADC( ADC_FOSC_32 \| ADC_RIGHT_JUST \| ADC_12_TAD, ADC_CH0 \| ADC_REF_VDD_VSS \| ADC_INT_OFF, ADC_TRIG_CTMU \| ADC_1ANA );

2.5 ReadADC

Function:	Read the result of an A/D conversion.
Include:	adc.h
Prototype:	int ReadADC( void );
Remarks:	This function reads the 16-bit result of an A/D conversion.
Return Value:	This function returns the 16-bit signed result of the A/D conversion. Based on the configuration of the A/D converter (e.g., using the OpenADC() function), the result will be contained in the Least Significant or Most Significant bits of the 16-bit result.
File Name:	adcread.c

2.6 SetChanADC

This function not supports ADC_V7 and ADC_V7_1.

Function:	Select the channel used as input to the A/D converter.
Include:	adc.h
Prototype:	void SetChanADC( unsigned char *channel* );
Arguments:	*Channel* One of the following values (defined in adc.h): ADC_CH0 Channel 0 ADC_CH1 Channel 1 ADC_CH2 Channel 2 ADC_CH3 Channel 3 ADC_CH4 Channel 4 ADC_CH5 Channel 5 ADC_CH6 Channel 6 ADC_CH7 Channel 7 ADC_CH8 Channel 8 ADC_CH9 Channel 9 ADC_CH10 Channel 10 ADC_CH11 Channel 11 ADC_CH12 Channel 12 ADC_CH13 Channel 13 ADC_CH14 Channel 14 ADC_CH15 Channel 15 ADC_CH_CTMU Channel 13 ADC_CH_VDDCORE Channel 14 ADC_CH_VBG Channel 15
Remarks:	Selects the pin that will be used as input to the A/D converter.
File Name:	adcsetch.c
Code Example:	SetChanADC( ADC_CH0 );

2.7 SelChanConvADC

Function:	Select the channel used as input to the A/D converter and starts the A/D conversion process.
Include:	adc.h
Prototype:	void SelChanConvADC( unsigned char *channel* );
Arguments:	*Channel* One of the following values (defined in adc.h): ADC_CH0 Channel 0 ADC_CH1 Channel 1 ADC_CH2 Channel 2 ADC_CH3 Channel 3 ADC_CH4 Channel 4 ADC_CH5 Channel 5 ADC_CH6 Channel 6 ADC_CH7 Channel 7 ADC_CH8 Channel 8 ADC_CH9 Channel 9 ADC_CH10 Channel 10 ADC_CH11 Channel 11 ADC_CH12 Channel 12 ADC_CH13 Channel 13 ADC_CH14 Channel 14 ADC_CH15 Channel 15 ADC_CH_CTMU Channel CTMU ADC_CH_VDDCORE Channel VDDCore ADC_CH_VBG Channel VBG
Remarks:	Selects the pin that will be used as input to the A/D converter. And starts an A/D conversion. The BusyADC() function or A/D interrupt may be used to detect completion of the conversion.
File Name:	adcselchcov.c
Code Example:	SelChanConvADC( ADC_CH0 );

2.8 Macro definitions

Macros	Description
ADC_INT_ENABLE()	Enables A/D interrupt i.e. sets PEIE and ADIE bits.
ADC_INT_DISABLE()	Disables the A/D interrupt.
ADC_SEVT_ENABLE()	Enables the Special Event Trigger bit, this macro is available for ADC_V4 only.
ADC_SEVT_DISABLE()	Disables the Special Event Trigger bit, this macro is available for ADC_V4 only.
ADC_CALIB()	Enables the A/D calibration bit, this macro is available for ADC_V6 , ADC_V9, ADC_V11 and ADC_V12 only.
ADC_NO_CALIB()	Disables the A/D calibration bit, this macro is available for ADC_V6 , ADC_V9, ADC_V11 and ADC_V12 only.
ADC_CH_GRA_AN0()	Selects the adc channel, this macro is available for ADC_V7 and ADC_V7_1 only.
ADC_CH_GRA_AN4()	Selects the adc channel, this macro is available for ADC_V7 and ADC_V7_1 only.
ADC_CH_GRB_AN1()	Selects the adc channel, this macro is available for ADC_V7 and ADC_V7_1 only.
ADC_CH_GRC_AN2()	Selects the adc channel, this macro is available for ADC_V7 and ADC_V7_1 only.
ADC_CH_GRD_AN3()	Selects the adc channel, this macro is available for ADC_V7 and ADC_V7_1 only.
ADC_CH_GRB_AN5()	Selects the adc channel, this macro is available for ADC_V7 only.
ADC_CH_GRC_AN6()	Selects the adc channel, this macro is available for ADC_V7 only.
ADC_CH_GRD_AN7()	Selects the adc channel, this macro is available for ADC_V7 only.
ADC_CH_GRA_AN8()	Selects the adc channel, this macro is available for ADC_V7 only.
ALL_CH_DIGITAL()	Selects the adc channel, this macro is available for ADC_V7 only.

Example Use of the A/D Converter Routines with AND mask:

#include <p18cxxx.h>

#include <adc.h>

#include <delays.h>

int result;

void main( void )

{

// configure A/D convertor

OpenADC( ADC_FOSC_32 &

ADC_RIGHT_JUST &

ADC_12_TAD,

ADC_CH0 &

ADC_REF_VDD_VSS &

ADC_INT_OFF, ADC_CH10 );

Delay10TCYx( 5 ); // Delay for 50TCY

ConvertADC(); // Start conversion

while( BusyADC() ); // Wait for completion

result = ReadADC(); // Read result

CloseADC(); // Disable A/D converter

}

Example Use of the A/D Converter Routines with OR mask: