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_AVCC,
  71         ADC_VREF_V110   = 1100,
  72         ADC_VREF_V256   = 2560,
  73 };
  74
  75 typedef struct avr_adc_t {
  76         avr_io_t                io;
  77
  78         uint8_t                 r_admux;
  79         // if the last bit exists in the mux, we are an extended ADC
  80         avr_regbit_t    mux[5];
  81         avr_regbit_t    ref[3];         // reference voltages bits
  82         uint16_t                ref_values[7]; // ADC_VREF_*
  83
  84         avr_regbit_t    adlar;          // left/right adjustment bit
  85
  86         uint8_t                 r_adcsra;       // ADC Control and Status Register A
  87         avr_regbit_t    aden;           // ADC Enabled
  88         avr_regbit_t    adsc;           // ADC Start Conversion
  89         avr_regbit_t    adate;          // ADC Auto Trigger Enable
  90
  91         avr_regbit_t    adps[3];        // Prescaler bits. Note that it's a frequency bit shift
  92
  93         uint8_t                 r_adcl, r_adch; // Data Registers
  94
  95         uint8_t                 r_adcsrb;       // ADC Control and Status Register B
  96         avr_regbit_t    adts[3];        // Timing Source
  97         avr_regbit_t    bin;            // Bipolar Input Mode (tinyx5 have it)
  98         avr_regbit_t    ipr;            // Input Polarity Reversal (tinyx5 have it)
  99
 100         // use ADIF and ADIE bits
 101         avr_int_vector_t adc;
 102
 103         /*
 104          * runtime bits
 105          */
 106         avr_adc_mux_t   muxmode[32];// maximum 5 bits of mux modes
 107         uint16_t                adc_values[8];  // current values on the ADCs
 108         uint16_t                temp;           // temp sensor reading
 109         uint8_t                 first;
 110         uint8_t                 read_status;    // marked one when adcl is read
 111 } avr_adc_t;
 112
 113 void avr_adc_init(avr_t * avr, avr_adc_t * port);
 114
 115
 116 /*
 117  * Helper macros for the Cores definition of muxes
 118  */
 119 #define AVR_ADC_SINGLE(_chan) { \
 120                 .kind = ADC_MUX_SINGLE, \
 121                 .src = (_chan), \
 122         }
 123 #define AVR_ADC_DIFF(_a,_b,_g) { \
 124                 .kind = ADC_MUX_DIFF, \
 125                 .src = (_a), \
 126                 .diff = (_b), \
 127                 .gain = (_g), \
 128         }
 129 #define AVR_ADC_REF(_t) { \
 130                 .kind = ADC_MUX_REF, \
 131                 .src = (_t), \
 132         }
 133 #define AVR_ADC_TEMP() { \
 134                 .kind = ADC_MUX_TEMP, \
 135         }
 136
 137 #endif /* __AVR_ADC_H___ */