Admin at 19:09, 24 August 2013

2013-08-24T19:09:52Z

Admin at 19:08, 24 August 2013

2013-08-24T19:08:31Z

Admin: Created page with "= Action = Retrieves the analog value from the specified channel.
2013-02-11T17:24:35Z

Created page with "= Action = Retrieves the analog value from the specified channel. Action =

Retrieves the analog value from the specified channel.

 

 

= Syntax =

var = GETADC(channel [,offset])

 

= Syntax Xmega =

var = GETADC( ADC , channel [,MUX])

 

 

= Remarks AVR =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="604" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
Var

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
The variable that is assigned with the A/D value. This should be a Word or other 16 bit variable.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
Channel

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
The channel to measure. Might be higher then 7 on some chips. The Mega2560 has 16 channels. So the range is 0-15 on a Mega2560.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
Offset

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
An optional numeric variable of constant that specifies gain or mode. This option has effect on newer AVR micro’s only. The offset will be added by the channel value and inserted into the ADMUX register. This way you can control gain.

|}
</div>
 

 

= Remarks XMEGA =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="604" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
var

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
The variable that is assigned with the A/D value. This should be a Word or other 16 bit variable.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
ADC

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
The ADC to use. This is either ADCA or ADCB.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
Channel

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
The channel to use. There are 4 channels in the range from 0-3.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
MUX

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
An optional numeric variable or constant that specifies the MUX value thus which input pin is used for the measurement. The MUX number is coded with negative and positive input pin info. The positive pins are have an offset of 8. So PIN0 in single ended mode would need a value of 8.

 

When you do not supply the mux value, the value used by the CONFIG ADC command will be used. If you supply it, it will change the MUX register of the corresponding channel.

|}
</div>
 

 

The GETADC() function only will work on microprocessors that have an A/D converter.

The pins of the A/D converter input can be used for digital I/O too.

But it is important that no I/O switching is done while using the A/D converter.

 

Make sure you turn on the AD converter with the [[START]] ADC statement or by setting the proper bit in the ADC configuration register.

 

Some micro’s have more then 7 channels. This is supported as well. The ADCSRB register contains a bit named MUX5 that must be set when a channel higher then 7 is used. The compiler (lib routine) will handle this automatic. This is true for new chips like Mega1280, Mega2560 and probably other new chips with 100 pins.

 

An example on how to read singled ended input on a Mega1280:

 W = Getadc(0 , 64)  ' from data sheet :  100000 ADC8

 W = Getadc(1, 64)   ' from data sheet :  100001 ADC9

This will read channel 0 and 1. The offset is 64 in order to use singled ended input.

ADC8 is portK.0

 

 

GetADC() returns a word variable since the A/D converter data registers consist of 2 registers. The resolution depends on the chip.

The variable ADCD can be used to access the data register directly. The compiler will handle access to the byte registers automatically.

 

= See also =

[[CONFIG ADC|CONFIG ADC]]

 

 

= Example  =

 <source lang="bascomavr">
'--------------------------------------------------------------------------------
'name : adc.bas
'copyright : (c) 1995-2005, MCS Electronics
'purpose : demonstration of GETADC() function for 8535 or M163 micro
'micro : Mega163
'suited for demo : yes
'commercial addon needed : no
'use in simulator : possible
' Getadc() will also work for other AVR chips that have an ADC converter
'--------------------------------------------------------------------------------
$regfile = "m163def.dat" ' we use the M163
$crystal = 4000000

$hwstack = 32 ' default use 32 for the hardware stack
$swstack = 10 'default use 10 for the SW stack
$framesize = 40 'default use 40 for the frame space

'configure single mode and auto prescaler setting
'The single mode must be used with the GETADC() function

'The prescaler divides the internal clock by 2,4,8,16,32,64 or 128
'Because the ADC needs a clock from 50-200 KHz
'The AUTO feature, will select the highest clockrate possible
Config Adc = Single , Prescaler = Auto
'Now give power to the chip
Start Adc

'With STOP ADC, you can remove the power from the chip
'Stop Adc

Dim W As Word , Channel As Byte

Channel = 0
'now read A/D value from channel 0
Do
W = Getadc(channel)
Print "Channel " ; Channel ; " value " ; W
Incr Channel
If Channel > 7 Then Channel = 0
Loop
End

'The new M163 has options for the reference voltage
'For this chip you can use the additional param :
'Config Adc = Single , Prescaler = Auto, Reference = Internal
'The reference param may be :
'OFF : AREF, internal reference turned off
'AVCC : AVCC, with external capacitor at AREF pin
'INTERNAL : Internal 2.56 voltage reference with external capacitor ar AREF pin

'Using the additional param on chip that do not have the internal reference will have no effect.

Example Xmega
'----------------------------------------------------------------
' (c) 1995-2010, MCS
' xm128-ADC.bas
' This sample demonstrates the Xmega128A1 ADC
'-----------------------------------------------------------------

$regfile = "xm128a1def.dat"
$crystal = 32000000
$hwstack = 64
$swstack = 64
$framesize = 64
'include the following lib and code, the routines will be replaced since they are a workaround
$lib "xmega.lib"
$external _xmegafix_clear
$external _xmegafix_rol_r1014

'First Enable The Osc Of Your Choice
Config Osc = Enabled , 32mhzosc = Enabled

'configure the systemclock
Config Sysclock = 32mhz , Prescalea = 1 , Prescalebc = 1_1

Config Com1 = 19200 , Mode = Asynchroneous , Parity = None , Stopbits = 1 , Databits = 8

Print "ADC test"

'setup the ADC-A converter
Config Adca = Single , Convmode = Unsigned , Resolution = 12bit , Dma = Off , Reference = Int1v , Event_mode = None , Prescaler = 32 , Ch0_gain = 1 , Ch0_inp = Single_ended , Mux0 = &B000_00 _
Ch1_gain = 1 , Ch1_inp = Single_ended , Mux1 = &B1_000 , Ch2_gain = 1 , Ch2_inp = Single_ended , Mux2 = &B10_000 , Ch3_gain = 1 , Ch3_inp = Single_ended , Mux3 = &B11_000

Dim W As Word , I As Byte , Mux As Byte
Do
Mux = I * 8 ' or you can use shift left,3 to get the proper offset
W = Getadc(adca , 0 , Mux)
' W = Getadc(adca , 0) 'when not using the MUX parameter the last value of the MUX will be used!
' use ADCA , use channel 0, and use the pinA.0-pinA.3
Print "RES:" ; I ; "-" ; W
Incr I
If I > 3 Then I = 0
Waitms 500
Loop Until Inkey(#1) = 27
</source> {{Languages}}

[[Category:BASCOM Language Reference]]

@@ Line 91: / Line 91: @@
 &nbsp;
 The GETADC() function only will work on microprocessors that have an A/D converter.
@@ Line 110: / Line 118: @@
 An example on how to read singled ended input on a Mega1280:
-&nbsp;W = Getadc(0 , 64) &nbsp;' from data sheet&nbsp;: &nbsp;100000 ADC8
+&nbsp;W = Getadc(0, 32) &nbsp;' from data sheet : &nbsp;100000 ADC8
-&nbsp;W = Getadc(1, 64) &nbsp; ' from data sheet&nbsp;: &nbsp;100001 ADC9
+&nbsp;W = Getadc(1, 32) &nbsp; ' from data sheet : &nbsp;100001 ADC9
-This will read channel 0 and 1. The offset is 64 in order to use singled ended input.
+This will read channel 0 and 1. The offset is 32 in order to use singled ended input.
 ADC8 is portK.0
 &nbsp;

@@ Line 207: / Line 207: @@
 'Using the additional param on chip that do not have the internal reference will have no effect.
+</source>
-−
-Example Xmega
+= <span class="f_Header">Example XMEGA&nbsp;</span> =
 '----------------------------------------------------------------
 ' (c) 1995-2010, MCS

GETADC - Revision history

Admin at 19:09, 24 August 2013

Admin at 19:08, 24 August 2013