git.rot13.org Git - simavr/blob - simavr/sim/avr_adc.h

   1 /*
   2         avr_adc.h
   3
   4         Copyright 2008, 2009 Michel Pollet <buserror@gmail.com>
   5
   6         This file is part of simavr.
   7
   8         simavr is free software: you can redistribute it and/or modify
   9         it under the terms of the GNU General Public License as published by
  10         the Free Software Foundation, either version 3 of the License, or
  11         (at your option) any later version.
  12
  13         simavr is distributed in the hope that it will be useful,
  14         but WITHOUT ANY WARRANTY; without even the implied warranty of
  15         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16         GNU General Public License for more details.
  17
  18         You should have received a copy of the GNU General Public License
  19         along with simavr.  If not, see <http://www.gnu.org/licenses/>.
  20  */
  21
  22 #ifndef __AVR_ADC_H___
  23 #define __AVR_ADC_H___
  24
  25 #include "sim_avr.h"
  26
  27 /*
  28  * simavr ADC allows external code to feed real voltages to the
  29  * simulator, and the simulator uses it's 'real' reference voltage
  30  * to do the right thing and return the 'proper' 10 bits ADC value
  31  * to the AVR firmware.
  32  *
  33  * To send values to the ADC, register your code to wait for the
  34  * ADC_IRQ_OUT_TRIGGER irq, and at that point send any of the
  35  * ADC_IRQ_ADC* with Millivolts as value.
  36  *
  37  * External trigger is not done yet.
  38  */
  39
  40 enum {
  41         // input IRQ values. Values are /always/ volts * 1000 (millivolts)
  42         ADC_IRQ_ADC0 = 0, ADC_IRQ_ADC1, ADC_IRQ_ADC2, ADC_IRQ_ADC3,
  43         ADC_IRQ_ADC4, ADC_IRQ_ADC5, ADC_IRQ_ADC6, ADC_IRQ_ADC7,
  44         ADC_IRQ_TEMP,                   // see the datasheet
  45         ADC_IRQ_IN_TRIGGER,
  46         ADC_IRQ_OUT_TRIGGER,    // sends a avr_adc_mux_t
  47         ADC_IRQ_COUNT
  48 };
  49
  50 // Get the internal IRQ corresponding to the INT
  51 #define AVR_IOCTL_ADC_GETIRQ AVR_IOCTL_DEF('a','d','c','i')
  52
  53 /*
  54  * Definition of a ADC mux mode.
  55  */
  56 enum {
  57         ADC_MUX_NONE = 0,               // Nothing. return 0
  58         ADC_MUX_NOISE,                  // Nothing. return something random
  59         ADC_MUX_SINGLE,                 // Normal ADC pin reading
  60         ADC_MUX_DIFF,                   // differencial channels (src-diff)
  61         ADC_MUX_TEMP,                   // internal temp sensor
  62         ADC_MUX_REF,                    // reference voltage (in src * 100)
  63 };
  64 typedef struct avr_adc_mux_t {
  65         unsigned long kind : 3, gain : 8, diff : 8, src : 13;
  66 } avr_adc_mux_t;
  67
  68 enum {
  69         ADC_VREF_AREF   = 0,    // default mode
  70         ADC_VREF_VCC,
  71         ADC_VREF_AVCC,
  72         ADC_VREF_V110   = 1100,
  73         ADC_VREF_V256   = 2560,
  74 };
  75
  76 typedef struct avr_adc_t {
  77         avr_io_t                io;
  78
  79         uint8_t                 r_admux;
  80         // if the last bit exists in the mux, we are an extended ADC
  81         avr_regbit_t    mux[5];
  82         avr_regbit_t    ref[3];         // reference voltages bits
  83         uint16_t                ref_values[7]; // ADC_VREF_*
  84
  85         avr_regbit_t    adlar;          // left/right adjustment bit
  86
  87         uint8_t                 r_adcsra;       // ADC Control and Status Register A
  88         avr_regbit_t    aden;           // ADC Enabled
  89         avr_regbit_t    adsc;           // ADC Start Conversion
  90         avr_regbit_t    adate;          // ADC Auto Trigger Enable
  91
  92         avr_regbit_t    adps[3];        // Prescaler bits. Note that it's a frequency bit shift
  93
  94         uint8_t                 r_adcl, r_adch; // Data Registers
  95
  96         uint8_t                 r_adcsrb;       // ADC Control and Status Register B
  97         avr_regbit_t    adts[3];        // Timing Source
  98         avr_regbit_t    bin;            // Bipolar Input Mode (tinyx5 have it)
  99         avr_regbit_t    ipr;            // Input Polarity Reversal (tinyx5 have it)
 100
 101         // use ADIF and ADIE bits
 102         avr_int_vector_t adc;
 103
 104         /*
 105          * runtime bits
 106          */
 107         avr_adc_mux_t   muxmode[32];// maximum 5 bits of mux modes
 108         uint16_t                adc_values[8];  // current values on the ADCs
 109         uint16_t                temp;           // temp sensor reading
 110         uint8_t                 first;
 111         uint8_t                 read_status;    // marked one when adcl is read
 112 } avr_adc_t;
 113
 114 void avr_adc_init(avr_t * avr, avr_adc_t * port);
 115
 116
 117 /*
 118  * Helper macros for the Cores definition of muxes
 119  */
 120 #define AVR_ADC_SINGLE(_chan) { \
 121                 .kind = ADC_MUX_SINGLE, \
 122                 .src = (_chan), \
 123         }
 124 #define AVR_ADC_DIFF(_a,_b,_g) { \
 125                 .kind = ADC_MUX_DIFF, \
 126                 .src = (_a), \
 127                 .diff = (_b), \
 128                 .gain = (_g), \
 129         }
 130 #define AVR_ADC_REF(_t) { \
 131                 .kind = ADC_MUX_REF, \
 132                 .src = (_t), \
 133         }
 134 #define AVR_ADC_TEMP() { \
 135                 .kind = ADC_MUX_TEMP, \
 136         }
 137
 138 #endif /* __AVR_ADC_H___ */