blob: f821b7aa636e5d4df0cde6abbfc62a59809acdcd (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
/*
* This file is subject to the terms of the GFX License. If a copy of
* the license was not distributed with this file, you can obtain one at:
*
* http://ugfx.org/license.html
*/
/**
* @file src/gadc/gadc_driver.h
* @brief GADC - Periodic ADC driver header file.
*
* @defgroup GADC_Driver Driver
* @ingroup GADC
*
* @brief Driver interface for the GADC module.
*
* @{
*/
#ifndef _GADC_LLD_H
#define _GADC_LLD_H
#include "../../gfx.h"
#if GFX_USE_GADC || defined(__DOXYGEN__)
/*===========================================================================*/
/* Type definitions */
/*===========================================================================*/
/**
* @brief The structure passed to start a timer conversion
* @{
*/
typedef struct GadcTimerJob_t {
uint32_t physdev; // @< The physical device/s. The exact meaning of physdev is hardware dependent.
uint32_t frequency; // @< The frequency to sample
adcsample_t *buffer; // @< Where to put the samples
size_t todo; // @< How many conversions to do
size_t done; // @< How many conversions have already been done
} GadcTimerJob;
/** @} */
/**
* @brief The structure passed to do a single conversion
* @{
*/
typedef struct GadcNonTimerJob_t {
uint32_t physdev; // @< The physical device/s. The exact meaning of physdev is hardware dependent.
adcsample_t *buffer; // @< Where to put the samples.
} GadcNonTimerJob;
/** @} */
/*===========================================================================*/
/* External declarations. */
/*===========================================================================*/
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief These routines are the callbacks that the driver uses.
* @details Defined in the high level GADC code.
*
* @notapi
* @{
*/
/**
* @brief Indicate that some data has been placed into the buffer for the current job
*
* @param[in] n The number of samples placed in the buffer
*
* @note Calling this with n = 0 causes the current job to be terminated early or aborted.
* It can be called in this mode on an ADC conversion error. Any job will then be
* restarted by the high level code as appropriate.
*/
void gadcGotDataI(size_t n);
/**
* @}
*/
/**
* @brief Initialise the driver
*
* @api
*/
void gadc_lld_init(void);
/**
* @brief Using the hardware dependant "physdev", return the number of samples for each conversion
*
* @param[in] physdev The hardware dependent physical device descriptor
*
* @return The number of samples per conversion
*
* @api
*/
size_t gadc_lld_samplesperconversion(uint32_t physdev);
/**
* @brief Start a periodic timer for high frequency conversions.
*
* @param[in] freq The frequency for the timer
*
* @note This will only be called if the timer is currently stopped.
*
* @api
* @iclass
*/
void gadc_lld_start_timerI(uint32_t freq);
/**
* @brief Stop the periodic timer for high frequency conversions.
*
* @note This will only be called if the timer is currently running and all timer jobs
* have been completed/aborted.
*
* @api
* @iclass
*/
void gadc_lld_stop_timerI(void);
/**
* @brief Start a set of high frequency conversions.
*
* @note This will only be called if the timer is currently running and the ADC should be ready for
* a new job.
*
* @param[in] pjob The job to be started.
*
* @api
* @iclass
*/
void gadc_lld_timerjobI(GadcTimerJob *pjob);
/**
* @brief Start a non-timer conversion.
*
* @note This will only be called if the ADC should be ready for a new job.
*
* @param[in] pjob The job to be started
*
* @api
* @iclass
*/
void gadc_lld_nontimerjobI(GadcNonTimerJob *pjob);
#ifdef __cplusplus
}
#endif
#endif /* GFX_USE_GADC */
#endif /* _GADC_LLD_H */
/** @} */
|