sd-card: Only add header to the results file if it’s empty
[brewing-logger:firmware.git] / adc.h
1 /* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */
2 /*
3  * Brewing Logger.
4  * Copyright (C) Philip Withnall 2012 <philip@tecnocode.co.uk>
5  *
6  * Brewing Logger is free software: you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation, either version 3 of the License, or
9  * (at your option) any later version.
10  *
11  * Brewing Logger is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with Brewing Logger.  If not, see <http://www.gnu.org/licenses/>.
18  */
19
20 #ifndef _ADC_H
21 #define _ADC_H
22
23 #include "common.h"
24
25 /**
26  * \file
27  * \brief ADC control declarations.
28  *
29  * Declarations for symbols in adc.c.
30  */
31
32 typedef enum {
33         ADC0 = 0,
34         ADC1,
35         ADC2,
36         ADC3,
37         ADC4,
38         ADC5,
39         ADC6,
40         ADC7
41 } AdcInput;
42
43 void adc_init (void);
44 AdcReading adc_take_measurement (unsigned int adc_mux);
45 void adc_power_up (void);
46 void adc_power_down (void);
47
48 /**
49  * \brief Convert voltage to an ADC measurement.
50  *
51  * This converts a voltage, as would be seen at an ADC input pin, to the quantised binary representation which would be outputted by the ADC code.
52  * This simply scales by the reference voltage and the ADC precision. It is assumed that this will be used for constant data, so that floating point
53  * computation can be avoided at run time.
54  *
55  * Reference: ATmega644A manual, Section 23.8.
56  */
57 #define ADC_READING_FROM_VOLTAGE(v) ((AdcReading) (((v) / AVCC) * 1024.0))
58
59 #endif /* !_ADC_H */