1 | /*
|
---|
2 | * TOPPERS/ASP Kernel
|
---|
3 | * Toyohashi Open Platform for Embedded Real-Time Systems/
|
---|
4 | * Advanced Standard Profile Kernel
|
---|
5 | *
|
---|
6 | * Copyright (C) 2008-2011 by Embedded and Real-Time Systems Laboratory
|
---|
7 | * Graduate School of Information Science, Nagoya Univ., JAPAN
|
---|
8 | * Copyright (C) 2015-2016 by TOPPERS PROJECT Educational Working Group.
|
---|
9 | *
|
---|
10 | * 上記著作権者は,以下の(1)~(4)の条件を満たす場合に限り,本ソフトウェ
|
---|
11 | * ア(本ソフトウェアを改変したものを含む.以下同じ)を使用・複製・改
|
---|
12 | * 変・再配布(以下,利用と呼ぶ)することを無償で許諾する.
|
---|
13 | * (1) 本ソフトウェアをソースコードの形で利用する場合には,上記の著作
|
---|
14 | * 権表示,この利用条件および下記の無保証規定が,そのままの形でソー
|
---|
15 | * スコード中に含まれていること.
|
---|
16 | * (2) 本ソフトウェアを,ライブラリ形式など,他のソフトウェア開発に使
|
---|
17 | * 用できる形で再配布する場合には,再配布に伴うドキュメント(利用
|
---|
18 | * 者マニュアルなど)に,上記の著作権表示,この利用条件および下記
|
---|
19 | * の無保証規定を掲載すること.
|
---|
20 | * (3) 本ソフトウェアを,機器に組み込むなど,他のソフトウェア開発に使
|
---|
21 | * 用できない形で再配布する場合には,次のいずれかの条件を満たすこ
|
---|
22 | * と.
|
---|
23 | * (a) 再配布に伴うドキュメント(利用者マニュアルなど)に,上記の著
|
---|
24 | * 作権表示,この利用条件および下記の無保証規定を掲載すること.
|
---|
25 | * (b) 再配布の形態を,別に定める方法によって,TOPPERSプロジェクトに
|
---|
26 | * 報告すること.
|
---|
27 | * (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
|
---|
28 | * 害からも,上記著作権者およびTOPPERSプロジェクトを免責すること.
|
---|
29 | * また,本ソフトウェアのユーザまたはエンドユーザからのいかなる理
|
---|
30 | * 由に基づく請求からも,上記著作権者およびTOPPERSプロジェクトを
|
---|
31 | * 免責すること.
|
---|
32 | *
|
---|
33 | * 本ソフトウェアは,無保証で提供されているものである.上記著作権者お
|
---|
34 | * よびTOPPERSプロジェクトは,本ソフトウェアに関して,特定の使用目的
|
---|
35 | * に対する適合性も含めて,いかなる保証も行わない.また,本ソフトウェ
|
---|
36 | * アの利用により直接的または間接的に生じたいかなる損害に関しても,そ
|
---|
37 | * の責任を負わない.
|
---|
38 | *
|
---|
39 | * @(#) $Id$
|
---|
40 | */
|
---|
41 | /*
|
---|
42 | *
|
---|
43 | * STM32F4xx ADCデバイスドライバの外部宣言
|
---|
44 | *
|
---|
45 | */
|
---|
46 |
|
---|
47 | #ifndef _ADC_H_
|
---|
48 | #define _ADC_H_
|
---|
49 |
|
---|
50 | #ifdef __cplusplus
|
---|
51 | extern "C" {
|
---|
52 | #endif
|
---|
53 |
|
---|
54 | /*
|
---|
55 | * ADCポート定義
|
---|
56 | */
|
---|
57 | #define ADC1_PORTID 1
|
---|
58 | #define ADC2_PORTID 2
|
---|
59 | #define ADC3_PORTID 3
|
---|
60 | #define NUM_ADCPORT 3
|
---|
61 |
|
---|
62 | /*
|
---|
63 | * ADCクロックプリスケーラ定義(ClockPrescaler)
|
---|
64 | */
|
---|
65 | #define ADC_CLOCK_SYNC_PCLK_DIV2 0x00000000
|
---|
66 | #define ADC_CLOCK_SYNC_PCLK_DIV4 ADC_CCR_ADCPRE_0
|
---|
67 | #define ADC_CLOCK_SYNC_PCLK_DIV6 ADC_CCR_ADCPRE_1
|
---|
68 | #define ADC_CLOCK_SYNC_PCLK_DIV8 ADC_CCR_ADCPRE
|
---|
69 |
|
---|
70 | /*
|
---|
71 | * ADCリゾリューション定義(Resolution)
|
---|
72 | */
|
---|
73 | #define ADC_RESOLUTION_12B 0x00000000
|
---|
74 | #define ADC_RESOLUTION_10B ADC_CR1_RES_0
|
---|
75 | #define ADC_RESOLUTION_8B ADC_CR1_RES_1
|
---|
76 | #define ADC_RESOLUTION_6B ADC_CR1_RES
|
---|
77 |
|
---|
78 | /*
|
---|
79 | * ADCデータアライン定義(DataAlign)
|
---|
80 | */
|
---|
81 | #define ADC_DATAALIGN_RIGHT 0x00000000
|
---|
82 | #define ADC_DATAALIGN_LEFT ADC_CR2_ALIGN
|
---|
83 |
|
---|
84 |
|
---|
85 | /*
|
---|
86 | * ADCスキャンコンバージョンモード(ScanConvMode)
|
---|
87 | */
|
---|
88 | #define ADC_SCANMODE_DISABLE 0x00000000
|
---|
89 | #define ADC_SCANMODE_ENABLE ADC_CR1_SCAN
|
---|
90 |
|
---|
91 | /*
|
---|
92 | * ADC EOCシーケンス設定(EOCSelection)
|
---|
93 | */
|
---|
94 | #define ADC_EOC_SEQ_DISABLE 0x00000000
|
---|
95 | #define ADC_EOC_SEQ_ENABLE ADC_CR2_EOCS
|
---|
96 |
|
---|
97 | /*
|
---|
98 | * ADC継続モード設定(ContinuousConvMode)
|
---|
99 | */
|
---|
100 | #define ADC_CONTINUOUS_DISABLE 0x00000000
|
---|
101 | #define ADC_CONTINUOUS_ENABLE ADC_CR2_CONT
|
---|
102 |
|
---|
103 | /*
|
---|
104 | * ADC DMA設定定義(DMAContinuousRequests)
|
---|
105 | */
|
---|
106 | #define ADC_DMACONTINUOUS_DISABLE 0x00000000
|
---|
107 | #define ADC_DMANONECIRCULAR 0x80000000
|
---|
108 | #define ADC_DMACONTINUOUS_ENABLE ADC_CR2_DDS
|
---|
109 | #define ADC_DMACONTINUOUS_ENABLE2 (ADC_CR2_DDS | ADC_DMANONECIRCULAR)
|
---|
110 |
|
---|
111 | /*
|
---|
112 | * ADC 非継続モード設定(DiscontinuousConvMode)
|
---|
113 | */
|
---|
114 | #define ADC_DISCONTINUOUS_DISABLE 0x00000000
|
---|
115 | #define ADC_DISCONTINUOUS_ENABLE ADC_CR1_DISCEN
|
---|
116 |
|
---|
117 | /*
|
---|
118 | * ADC外部トリガソース設定(ExternalTrigConv)
|
---|
119 | */
|
---|
120 | #define ADC_EXTERNALTRIGCONV_T1_CC1 0x00000000
|
---|
121 | #define ADC_EXTERNALTRIGCONV_T1_CC2 ADC_CR2_EXTSEL_0
|
---|
122 | #define ADC_EXTERNALTRIGCONV_T1_CC3 ADC_CR2_EXTSEL_1
|
---|
123 | #define ADC_EXTERNALTRIGCONV_T2_CC2 (ADC_CR2_EXTSEL_1 | ADC_CR2_EXTSEL_0)
|
---|
124 | #define ADC_EXTERNALTRIGCONV_T2_CC3 ADC_CR2_EXTSEL_2
|
---|
125 | #define ADC_EXTERNALTRIGCONV_T2_CC4 (ADC_CR2_EXTSEL_2 | ADC_CR2_EXTSEL_0)
|
---|
126 | #define ADC_EXTERNALTRIGCONV_T2_TRGO (ADC_CR2_EXTSEL_2 | ADC_CR2_EXTSEL_1)
|
---|
127 | #define ADC_EXTERNALTRIGCONV_T3_CC1 (ADC_CR2_EXTSEL_2 | ADC_CR2_EXTSEL_1 | ADC_CR2_EXTSEL_0)
|
---|
128 | #define ADC_EXTERNALTRIGCONV_T3_TRGO ADC_CR2_EXTSEL_3
|
---|
129 | #define ADC_EXTERNALTRIGCONV_T4_CC4 (ADC_CR2_EXTSEL_3 | ADC_CR2_EXTSEL_0)
|
---|
130 | #define ADC_EXTERNALTRIGCONV_T5_CC1 (ADC_CR2_EXTSEL_3 | ADC_CR2_EXTSEL_1)
|
---|
131 | #define ADC_EXTERNALTRIGCONV_T5_CC2 (ADC_CR2_EXTSEL_3 | ADC_CR2_EXTSEL_1 | ADC_CR2_EXTSEL_0)
|
---|
132 | #define ADC_EXTERNALTRIGCONV_T5_CC3 (ADC_CR2_EXTSEL_3 | ADC_CR2_EXTSEL_2)
|
---|
133 | #define ADC_EXTERNALTRIGCONV_T8_CC1 (ADC_CR2_EXTSEL_3 | ADC_CR2_EXTSEL_2 | ADC_CR2_EXTSEL_0)
|
---|
134 | #define ADC_EXTERNALTRIGCONV_T8_TRGO (ADC_CR2_EXTSEL_3 | ADC_CR2_EXTSEL_2 | ADC_CR2_EXTSEL_1)
|
---|
135 | #define ADC_EXTERNALTRIGCONV_Ext_IT11 ADC_CR2_EXTSEL
|
---|
136 | #define ADC_SOFTWARE_START (ADC_CR2_EXTSEL + 1)
|
---|
137 |
|
---|
138 | /*
|
---|
139 | * ADC外部トリガエッジ設定()
|
---|
140 | */
|
---|
141 | #define ADC_EXTERNALTRIGCONVEDGE_NONE 0x00000000
|
---|
142 | #define ADC_EXTERNALTRIGCONVEDGE_RISING ADC_CR2_EXTEN_0
|
---|
143 | #define ADC_EXTERNALTRIGCONVEDGE_FALLING ADC_CR2_EXTEN_1
|
---|
144 | #define ADC_EXTERNALTRIGCONVEDGE_RISINGFALLING ADC_CR2_EXTEN
|
---|
145 |
|
---|
146 |
|
---|
147 | /*
|
---|
148 | * ADCチャネル定義
|
---|
149 | */
|
---|
150 | #define ADC_CHANNEL_0 0x00000000
|
---|
151 | #define ADC_CHANNEL_1 ADC_CR1_AWDCH_0
|
---|
152 | #define ADC_CHANNEL_2 ADC_CR1_AWDCH_1
|
---|
153 | #define ADC_CHANNEL_3 (ADC_CR1_AWDCH_1 | ADC_CR1_AWDCH_0)
|
---|
154 | #define ADC_CHANNEL_4 ADC_CR1_AWDCH_2
|
---|
155 | #define ADC_CHANNEL_5 (ADC_CR1_AWDCH_2 | ADC_CR1_AWDCH_0)
|
---|
156 | #define ADC_CHANNEL_6 (ADC_CR1_AWDCH_2 | ADC_CR1_AWDCH_1)
|
---|
157 | #define ADC_CHANNEL_7 (ADC_CR1_AWDCH_2 | ADC_CR1_AWDCH_1 | ADC_CR1_AWDCH_0)
|
---|
158 | #define ADC_CHANNEL_8 ADC_CR1_AWDCH_3
|
---|
159 | #define ADC_CHANNEL_9 (ADC_CR1_AWDCH_3 | ADC_CR1_AWDCH_0)
|
---|
160 | #define ADC_CHANNEL_10 (ADC_CR1_AWDCH_3 | ADC_CR1_AWDCH_1)
|
---|
161 | #define ADC_CHANNEL_11 (ADC_CR1_AWDCH_3 | ADC_CR1_AWDCH_1 | ADC_CR1_AWDCH_0)
|
---|
162 | #define ADC_CHANNEL_12 (ADC_CR1_AWDCH_3 | ADC_CR1_AWDCH_2)
|
---|
163 | #define ADC_CHANNEL_13 (ADC_CR1_AWDCH_3 | ADC_CR1_AWDCH_2 | ADC_CR1_AWDCH_0)
|
---|
164 | #define ADC_CHANNEL_14 (ADC_CR1_AWDCH_3 | ADC_CR1_AWDCH_2 | ADC_CR1_AWDCH_1)
|
---|
165 | #define ADC_CHANNEL_15 (ADC_CR1_AWDCH_3 | ADC_CR1_AWDCH_2 | ADC_CR1_AWDCH_1 | ADC_CR1_AWDCH_0)
|
---|
166 | #define ADC_CHANNEL_16 ADC_CR1_AWDCH_4
|
---|
167 | #define ADC_CHANNEL_17 (ADC_CR1_AWDCH_4 | ADC_CR1_AWDCH_0)
|
---|
168 | #define ADC_CHANNEL_18 (ADC_CR1_AWDCH_4 | ADC_CR1_AWDCH_1)
|
---|
169 |
|
---|
170 | #define ADC_CHANNEL_VREFINT ADC_CHANNEL_17
|
---|
171 | #define ADC_CHANNEL_VBAT ADC_CHANNEL_18
|
---|
172 |
|
---|
173 | /*
|
---|
174 | * ADCサンプリング時間設定
|
---|
175 | */
|
---|
176 | #define ADC_SAMPLETIME_3CYCLES 0x00000000
|
---|
177 | #define ADC_SAMPLETIME_15CYCLES ADC_SMPR1_SMP10_0
|
---|
178 | #define ADC_SAMPLETIME_28CYCLES ADC_SMPR1_SMP10_1
|
---|
179 | #define ADC_SAMPLETIME_56CYCLES (ADC_SMPR1_SMP10_1 | ADC_SMPR1_SMP10_0)
|
---|
180 | #define ADC_SAMPLETIME_84CYCLES ADC_SMPR1_SMP10_2
|
---|
181 | #define ADC_SAMPLETIME_112CYCLES (ADC_SMPR1_SMP10_2 | ADC_SMPR1_SMP10_0)
|
---|
182 | #define ADC_SAMPLETIME_144CYCLES (ADC_SMPR1_SMP10_2 | ADC_SMPR1_SMP10_1)
|
---|
183 | #define ADC_SAMPLETIME_480CYCLES ADC_SMPR1_SMP10
|
---|
184 |
|
---|
185 |
|
---|
186 | /*
|
---|
187 | * ADCアナログウォッチドックモード設定
|
---|
188 | */
|
---|
189 | #define ADC_ANALOGWATCHDOG_NONE 0x00000000
|
---|
190 | #define ADC_ANALOGWATCHDOG_SINGLE_REG (ADC_CR1_AWDSGL | ADC_CR1_AWDEN)
|
---|
191 | #define ADC_ANALOGWATCHDOG_SINGLE_INJEC (ADC_CR1_AWDSGL | ADC_CR1_JAWDEN)
|
---|
192 | #define ADC_ANALOGWATCHDOG_SINGLE_REGINJEC (ADC_CR1_AWDSGL | ADC_CR1_AWDEN | ADC_CR1_JAWDEN)
|
---|
193 | #define ADC_ANALOGWATCHDOG_ALL_REG ADC_CR1_AWDEN
|
---|
194 | #define ADC_ANALOGWATCHDOG_ALL_INJEC ADC_CR1_JAWDEN
|
---|
195 | #define ADC_ANALOGWATCHDOG_ALL_REGINJEC (ADC_CR1_AWDEN | ADC_CR1_JAWDEN)
|
---|
196 |
|
---|
197 | /*
|
---|
198 | * ADCアナログウォッチドック割込みモード設定
|
---|
199 | */
|
---|
200 | #define ADC_ANALOGWATCHDOG_ITMODE_DISABLE 0x00000000
|
---|
201 | #define ADC_ANALOGWATCHDOG_ITMODE_ENABLE ADC_CR1_AWDIE
|
---|
202 |
|
---|
203 | /*
|
---|
204 | * ADCハードウェア設定構造体
|
---|
205 | */
|
---|
206 | typedef struct _ADC_PortControlBlock{
|
---|
207 | uint32_t base;
|
---|
208 | uint32_t adcclockbase;
|
---|
209 | uint32_t adcclockbit;
|
---|
210 | uint32_t dmaclockbase;
|
---|
211 | uint32_t dmaclockbit;
|
---|
212 | uint32_t dmarxbase;
|
---|
213 | uint32_t dmarxchannel;
|
---|
214 | } ADC_PortControlBlock;
|
---|
215 |
|
---|
216 | /*
|
---|
217 | * ADCの初期化構造体
|
---|
218 | */
|
---|
219 | typedef struct
|
---|
220 | {
|
---|
221 | uint32_t ClockPrescaler; /* ADCクロックプリスケーラ値(各ADCにて共通値) */
|
---|
222 | uint32_t Resolution; /* ADCのリゾリューション */
|
---|
223 | uint32_t DataAlign; /* ADC結果データアライン設定 */
|
---|
224 | uint32_t ScanConvMode; /* ADCスキャンコンバージョンモード */
|
---|
225 | uint32_t EOCSelection; /* ADC EOC設定 */
|
---|
226 | uint32_t ContinuousConvMode; /* ADC継続モード */
|
---|
227 | uint32_t DMAContinuousRequests; /* ADC-DMAモード */
|
---|
228 | uint32_t NumConversion; /* ADCコンバージョン数 */
|
---|
229 | uint32_t DiscontinuousConvMode; /* ADC非継続モード */
|
---|
230 | uint32_t NumDiscConversion; /* ADC非継続変換数 */
|
---|
231 | uint32_t ExternalTrigConv; /* ADC外部トリガ設定 */
|
---|
232 | uint32_t ExternalTrigConvEdge; /* ADC外部トリガエッジ設定 */
|
---|
233 | }ADC_Init_t;
|
---|
234 |
|
---|
235 | /*
|
---|
236 | * ADCハンドラ構造体
|
---|
237 | */
|
---|
238 | typedef struct __ADC_Handle_t ADC_Handle_t;
|
---|
239 | struct __ADC_Handle_t
|
---|
240 | {
|
---|
241 | uint32_t base; /* ADCベースアドレス */
|
---|
242 | ADC_Init_t Init; /* ADC初期化データ */
|
---|
243 | volatile uint32_t NumCurrentConversionRank; /* ADC現在のコンバージョンランク値 */
|
---|
244 | DMA_Handle_t *hdmarx; /* ADC用DMAハンドラへのポインタ */
|
---|
245 | void (*xfercallback)(ADC_Handle_t * hadc); /* ADC 転送完了コールバック */
|
---|
246 | void (*xferhalfcallback)(ADC_Handle_t * hadc); /* ADC 半分転送コールバック */
|
---|
247 | void (*outofwincallback)(ADC_Handle_t * hadc); /* ADC アナログウォッチドックコールバック */
|
---|
248 | void (*errorcallback)(ADC_Handle_t * hadc); /* ADC エラーコールバック */
|
---|
249 | volatile uint32_t status; /* ADCステータス */
|
---|
250 | volatile uint32_t ErrorCode; /* ADCエラー値 */
|
---|
251 | };
|
---|
252 |
|
---|
253 | /*
|
---|
254 | * チャンネル設定構造体
|
---|
255 | */
|
---|
256 | typedef struct
|
---|
257 | {
|
---|
258 | uint32_t Channel; /* ADCチャンネル番号 */
|
---|
259 | uint32_t Rank; /* ADCランク番号(1-16) */
|
---|
260 | uint32_t SamplingTime; /* ADCサンプリング時間 */
|
---|
261 | uint32_t GpioBase; /* ADC-GPIOベースアドレス */
|
---|
262 | uint32_t GpioPin; /* ADC-GPIOピン番号 */
|
---|
263 | }ADC_ChannelConf_t;
|
---|
264 |
|
---|
265 | /*
|
---|
266 | * ADCアナログウォッチドック設定構造体
|
---|
267 | */
|
---|
268 | typedef struct
|
---|
269 | {
|
---|
270 | uint32_t WatchdogMode; /* ADCアナログウォッチドッグモード */
|
---|
271 | uint32_t HighThreshold; /* ADCスレッシュホールド上限値 */
|
---|
272 | uint32_t LowThreshold; /* ADCスレッシュホールド下限値 */
|
---|
273 | uint32_t Channel; /* ADC対応チャネル番号 */
|
---|
274 | uint32_t ITMode; /* ADCアナログウォッチドック割込み設定 */
|
---|
275 | }ADC_AnalogWDGConf_t;
|
---|
276 |
|
---|
277 | /*
|
---|
278 | * ADCのステータス定義
|
---|
279 | */
|
---|
280 | #define ADC_STATUS_RESET 0x00 /* ADC 未使用状態 */
|
---|
281 | #define ADC_STATUS_READY 0x01 /* ADC レディ状態 */
|
---|
282 | #define ADC_STATUS_BUSY 0x02 /* ADC ビジィ状態 */
|
---|
283 | #define ADC_STATUS_EOC 0x10 /* ADC 終了状態 */
|
---|
284 | #define ADC_STATUS_BUSY_EOC 0x12 /* ADC ビジィ終了発生状態 */
|
---|
285 | #define ADC_STATUS_AWD 0x20 /* ADC アナログウォッチドック発生状態 */
|
---|
286 |
|
---|
287 | /*
|
---|
288 | * ADCエラー定義
|
---|
289 | */
|
---|
290 | #define ADC_ERROR_NONE 0x00 /* No error */
|
---|
291 | #define ADC_ERROR_OVR 0x01 /* OVR error */
|
---|
292 | #define ADC_ERROR_DMA 0x02 /* DMA transfer error */
|
---|
293 |
|
---|
294 |
|
---|
295 | extern ADC_Handle_t *adc_init(ID portid, ADC_Init_t *pini);
|
---|
296 | extern ER adc_deinit(ADC_Handle_t *hadc);
|
---|
297 | extern ER adc_start_int(ADC_Handle_t* hadc);
|
---|
298 | extern ER adc_end_int(ADC_Handle_t* hadc);
|
---|
299 | extern ER adc_start_dma(ADC_Handle_t* hadc, uint32_t* pdata, uint32_t length);
|
---|
300 | extern ER adc_end_dma(ADC_Handle_t* hadc);
|
---|
301 | extern ER adc_setupchannel(ADC_Handle_t* hadc, ADC_ChannelConf_t* sConfig);
|
---|
302 | extern ER adc_setupwatchdog(ADC_Handle_t* hadc, ADC_AnalogWDGConf_t* AnalogWDGConfig);
|
---|
303 | extern uint32_t adc_getvalue(ADC_Handle_t* hadc);
|
---|
304 |
|
---|
305 | extern void adc_handler(ADC_Handle_t* hadc);
|
---|
306 | extern void adc_int_handler(void);
|
---|
307 |
|
---|
308 | #ifdef __cplusplus
|
---|
309 | }
|
---|
310 | #endif
|
---|
311 |
|
---|
312 | #endif /* _ADC_H_ */
|
---|
313 |
|
---|