2 * This file is part of STM32 ADC driver
4 * Copyright (C) 2016, STMicroelectronics - All Rights Reserved
5 * Author: Fabrice Gasnier <fabrice.gasnier@st.com>.
9 * This program is free software; you can redistribute it and/or modify it
10 * under the terms of the GNU General Public License version 2 as published by
11 * the Free Software Foundation.
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
15 * or FITNESS FOR A PARTICULAR PURPOSE.
16 * See the GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License along with
19 * this program. If not, see <http://www.gnu.org/licenses/>.
22 #include <linux/clk.h>
23 #include <linux/delay.h>
24 #include <linux/dma-mapping.h>
25 #include <linux/dmaengine.h>
26 #include <linux/iio/iio.h>
27 #include <linux/iio/buffer.h>
28 #include <linux/iio/timer/stm32-lptim-trigger.h>
29 #include <linux/iio/timer/stm32-timer-trigger.h>
30 #include <linux/iio/trigger.h>
31 #include <linux/iio/trigger_consumer.h>
32 #include <linux/iio/triggered_buffer.h>
33 #include <linux/interrupt.h>
35 #include <linux/iopoll.h>
36 #include <linux/module.h>
37 #include <linux/platform_device.h>
39 #include <linux/of_device.h>
41 #include "stm32-adc-core.h"
43 /* Number of linear calibration shadow registers / LINCALRDYW control bits */
44 #define STM32H7_LINCALFACT_NUM 6
46 /* BOOST bit must be set on STM32H7 when ADC clock is above 20MHz */
47 #define STM32H7_BOOST_CLKRATE 20000000UL
49 #define STM32_ADC_MAX_SQ 16 /* SQ1..SQ16 */
50 #define STM32_ADC_MAX_SMP 7 /* SMPx range is [0..7] */
51 #define STM32_ADC_TIMEOUT_US 100000
52 #define STM32_ADC_TIMEOUT (msecs_to_jiffies(STM32_ADC_TIMEOUT_US / 1000))
54 #define STM32_DMA_BUFFER_SIZE PAGE_SIZE
56 /* External trigger enable */
57 enum stm32_adc_exten {
59 STM32_EXTEN_HWTRIG_RISING_EDGE,
60 STM32_EXTEN_HWTRIG_FALLING_EDGE,
61 STM32_EXTEN_HWTRIG_BOTH_EDGES,
64 /* extsel - trigger mux selection value */
65 enum stm32_adc_extsel {
90 * struct stm32_adc_trig_info - ADC trigger info
91 * @name: name of the trigger, corresponding to its source
92 * @extsel: trigger selection
94 struct stm32_adc_trig_info {
96 enum stm32_adc_extsel extsel;
100 * struct stm32_adc_calib - optional adc calibration data
101 * @calfact_s: Calibration offset for single ended channels
102 * @calfact_d: Calibration offset in differential
103 * @lincalfact: Linearity calibration factor
105 struct stm32_adc_calib {
108 u32 lincalfact[STM32H7_LINCALFACT_NUM];
112 * stm32_adc_regs - stm32 ADC misc registers & bitfield desc
113 * @reg: register offset
114 * @mask: bitfield mask
117 struct stm32_adc_regs {
124 * stm32_adc_regspec - stm32 registers definition, compatible dependent data
125 * @dr: data register offset
126 * @ier_eoc: interrupt enable register & eocie bitfield
127 * @isr_eoc: interrupt status register & eoc bitfield
128 * @sqr: reference to sequence registers array
129 * @exten: trigger control register & bitfield
130 * @extsel: trigger selection register & bitfield
131 * @res: resolution selection register & bitfield
132 * @smpr: smpr1 & smpr2 registers offset array
133 * @smp_bits: smpr1 & smpr2 index and bitfields
135 struct stm32_adc_regspec {
137 const struct stm32_adc_regs ier_eoc;
138 const struct stm32_adc_regs isr_eoc;
139 const struct stm32_adc_regs *sqr;
140 const struct stm32_adc_regs exten;
141 const struct stm32_adc_regs extsel;
142 const struct stm32_adc_regs res;
144 const struct stm32_adc_regs *smp_bits;
150 * stm32_adc_cfg - stm32 compatible configuration data
151 * @regs: registers descriptions
152 * @adc_info: per instance input channels definitions
153 * @trigs: external trigger sources
154 * @clk_required: clock is required
155 * @selfcalib: optional routine for self-calibration
156 * @prepare: optional prepare routine (power-up, enable)
157 * @start_conv: routine to start conversions
158 * @stop_conv: routine to stop conversions
159 * @unprepare: optional unprepare routine (disable, power-down)
160 * @smp_cycles: programmable sampling time (ADC clock cycles)
162 struct stm32_adc_cfg {
163 const struct stm32_adc_regspec *regs;
164 const struct stm32_adc_info *adc_info;
165 struct stm32_adc_trig_info *trigs;
167 int (*selfcalib)(struct stm32_adc *);
168 int (*prepare)(struct stm32_adc *);
169 void (*start_conv)(struct stm32_adc *, bool dma);
170 void (*stop_conv)(struct stm32_adc *);
171 void (*unprepare)(struct stm32_adc *);
172 const unsigned int *smp_cycles;
176 * struct stm32_adc - private data of each ADC IIO instance
177 * @common: reference to ADC block common data
178 * @offset: ADC instance register offset in ADC block
179 * @cfg: compatible configuration data
180 * @completion: end of single conversion completion
181 * @buffer: data buffer
182 * @clk: clock for this adc instance
183 * @irq: interrupt for this adc instance
185 * @bufi: data buffer index
186 * @num_conv: expected number of scan conversions
187 * @res: data resolution (e.g. RES bitfield value)
188 * @trigger_polarity: external trigger polarity (e.g. exten)
189 * @dma_chan: dma channel
190 * @rx_buf: dma rx buffer cpu address
191 * @rx_dma_buf: dma rx buffer bus address
192 * @rx_buf_sz: dma rx buffer size
193 * @pcsel bitmask to preselect channels on some devices
194 * @smpr_val: sampling time settings (e.g. smpr1 / smpr2)
195 * @cal: optional calibration data on some devices
198 struct stm32_adc_common *common;
200 const struct stm32_adc_cfg *cfg;
201 struct completion completion;
202 u16 buffer[STM32_ADC_MAX_SQ];
205 spinlock_t lock; /* interrupt lock */
207 unsigned int num_conv;
209 u32 trigger_polarity;
210 struct dma_chan *dma_chan;
212 dma_addr_t rx_dma_buf;
213 unsigned int rx_buf_sz;
216 struct stm32_adc_calib cal;
220 * struct stm32_adc_chan_spec - specification of stm32 adc channel
221 * @type: IIO channel type
222 * @channel: channel number (single ended)
223 * @name: channel name (single ended)
225 struct stm32_adc_chan_spec {
226 enum iio_chan_type type;
232 * struct stm32_adc_info - stm32 ADC, per instance config data
233 * @channels: Reference to stm32 channels spec
234 * @max_channels: Number of channels
235 * @resolutions: available resolutions
236 * @num_res: number of available resolutions
238 struct stm32_adc_info {
239 const struct stm32_adc_chan_spec *channels;
241 const unsigned int *resolutions;
242 const unsigned int num_res;
246 * Input definitions common for all instances:
247 * stm32f4 can have up to 16 channels
248 * stm32h7 can have up to 20 channels
250 static const struct stm32_adc_chan_spec stm32_adc_channels[] = {
251 { IIO_VOLTAGE, 0, "in0" },
252 { IIO_VOLTAGE, 1, "in1" },
253 { IIO_VOLTAGE, 2, "in2" },
254 { IIO_VOLTAGE, 3, "in3" },
255 { IIO_VOLTAGE, 4, "in4" },
256 { IIO_VOLTAGE, 5, "in5" },
257 { IIO_VOLTAGE, 6, "in6" },
258 { IIO_VOLTAGE, 7, "in7" },
259 { IIO_VOLTAGE, 8, "in8" },
260 { IIO_VOLTAGE, 9, "in9" },
261 { IIO_VOLTAGE, 10, "in10" },
262 { IIO_VOLTAGE, 11, "in11" },
263 { IIO_VOLTAGE, 12, "in12" },
264 { IIO_VOLTAGE, 13, "in13" },
265 { IIO_VOLTAGE, 14, "in14" },
266 { IIO_VOLTAGE, 15, "in15" },
267 { IIO_VOLTAGE, 16, "in16" },
268 { IIO_VOLTAGE, 17, "in17" },
269 { IIO_VOLTAGE, 18, "in18" },
270 { IIO_VOLTAGE, 19, "in19" },
273 static const unsigned int stm32f4_adc_resolutions[] = {
274 /* sorted values so the index matches RES[1:0] in STM32F4_ADC_CR1 */
278 static const struct stm32_adc_info stm32f4_adc_info = {
279 .channels = stm32_adc_channels,
281 .resolutions = stm32f4_adc_resolutions,
282 .num_res = ARRAY_SIZE(stm32f4_adc_resolutions),
285 static const unsigned int stm32h7_adc_resolutions[] = {
286 /* sorted values so the index matches RES[2:0] in STM32H7_ADC_CFGR */
290 static const struct stm32_adc_info stm32h7_adc_info = {
291 .channels = stm32_adc_channels,
293 .resolutions = stm32h7_adc_resolutions,
294 .num_res = ARRAY_SIZE(stm32h7_adc_resolutions),
298 * stm32f4_sq - describe regular sequence registers
299 * - L: sequence len (register & bit field)
300 * - SQ1..SQ16: sequence entries (register & bit field)
302 static const struct stm32_adc_regs stm32f4_sq[STM32_ADC_MAX_SQ + 1] = {
303 /* L: len bit field description to be kept as first element */
304 { STM32F4_ADC_SQR1, GENMASK(23, 20), 20 },
305 /* SQ1..SQ16 registers & bit fields (reg, mask, shift) */
306 { STM32F4_ADC_SQR3, GENMASK(4, 0), 0 },
307 { STM32F4_ADC_SQR3, GENMASK(9, 5), 5 },
308 { STM32F4_ADC_SQR3, GENMASK(14, 10), 10 },
309 { STM32F4_ADC_SQR3, GENMASK(19, 15), 15 },
310 { STM32F4_ADC_SQR3, GENMASK(24, 20), 20 },
311 { STM32F4_ADC_SQR3, GENMASK(29, 25), 25 },
312 { STM32F4_ADC_SQR2, GENMASK(4, 0), 0 },
313 { STM32F4_ADC_SQR2, GENMASK(9, 5), 5 },
314 { STM32F4_ADC_SQR2, GENMASK(14, 10), 10 },
315 { STM32F4_ADC_SQR2, GENMASK(19, 15), 15 },
316 { STM32F4_ADC_SQR2, GENMASK(24, 20), 20 },
317 { STM32F4_ADC_SQR2, GENMASK(29, 25), 25 },
318 { STM32F4_ADC_SQR1, GENMASK(4, 0), 0 },
319 { STM32F4_ADC_SQR1, GENMASK(9, 5), 5 },
320 { STM32F4_ADC_SQR1, GENMASK(14, 10), 10 },
321 { STM32F4_ADC_SQR1, GENMASK(19, 15), 15 },
324 /* STM32F4 external trigger sources for all instances */
325 static struct stm32_adc_trig_info stm32f4_adc_trigs[] = {
326 { TIM1_CH1, STM32_EXT0 },
327 { TIM1_CH2, STM32_EXT1 },
328 { TIM1_CH3, STM32_EXT2 },
329 { TIM2_CH2, STM32_EXT3 },
330 { TIM2_CH3, STM32_EXT4 },
331 { TIM2_CH4, STM32_EXT5 },
332 { TIM2_TRGO, STM32_EXT6 },
333 { TIM3_CH1, STM32_EXT7 },
334 { TIM3_TRGO, STM32_EXT8 },
335 { TIM4_CH4, STM32_EXT9 },
336 { TIM5_CH1, STM32_EXT10 },
337 { TIM5_CH2, STM32_EXT11 },
338 { TIM5_CH3, STM32_EXT12 },
339 { TIM8_CH1, STM32_EXT13 },
340 { TIM8_TRGO, STM32_EXT14 },
345 * stm32f4_smp_bits[] - describe sampling time register index & bit fields
346 * Sorted so it can be indexed by channel number.
348 static const struct stm32_adc_regs stm32f4_smp_bits[] = {
349 /* STM32F4_ADC_SMPR2: smpr[] index, mask, shift for SMP0 to SMP9 */
350 { 1, GENMASK(2, 0), 0 },
351 { 1, GENMASK(5, 3), 3 },
352 { 1, GENMASK(8, 6), 6 },
353 { 1, GENMASK(11, 9), 9 },
354 { 1, GENMASK(14, 12), 12 },
355 { 1, GENMASK(17, 15), 15 },
356 { 1, GENMASK(20, 18), 18 },
357 { 1, GENMASK(23, 21), 21 },
358 { 1, GENMASK(26, 24), 24 },
359 { 1, GENMASK(29, 27), 27 },
360 /* STM32F4_ADC_SMPR1, smpr[] index, mask, shift for SMP10 to SMP18 */
361 { 0, GENMASK(2, 0), 0 },
362 { 0, GENMASK(5, 3), 3 },
363 { 0, GENMASK(8, 6), 6 },
364 { 0, GENMASK(11, 9), 9 },
365 { 0, GENMASK(14, 12), 12 },
366 { 0, GENMASK(17, 15), 15 },
367 { 0, GENMASK(20, 18), 18 },
368 { 0, GENMASK(23, 21), 21 },
369 { 0, GENMASK(26, 24), 24 },
372 /* STM32F4 programmable sampling time (ADC clock cycles) */
373 static const unsigned int stm32f4_adc_smp_cycles[STM32_ADC_MAX_SMP + 1] = {
374 3, 15, 28, 56, 84, 112, 144, 480,
377 static const struct stm32_adc_regspec stm32f4_adc_regspec = {
378 .dr = STM32F4_ADC_DR,
379 .ier_eoc = { STM32F4_ADC_CR1, STM32F4_EOCIE },
380 .isr_eoc = { STM32F4_ADC_SR, STM32F4_EOC },
382 .exten = { STM32F4_ADC_CR2, STM32F4_EXTEN_MASK, STM32F4_EXTEN_SHIFT },
383 .extsel = { STM32F4_ADC_CR2, STM32F4_EXTSEL_MASK,
384 STM32F4_EXTSEL_SHIFT },
385 .res = { STM32F4_ADC_CR1, STM32F4_RES_MASK, STM32F4_RES_SHIFT },
386 .smpr = { STM32F4_ADC_SMPR1, STM32F4_ADC_SMPR2 },
387 .smp_bits = stm32f4_smp_bits,
390 static const struct stm32_adc_regs stm32h7_sq[STM32_ADC_MAX_SQ + 1] = {
391 /* L: len bit field description to be kept as first element */
392 { STM32H7_ADC_SQR1, GENMASK(3, 0), 0 },
393 /* SQ1..SQ16 registers & bit fields (reg, mask, shift) */
394 { STM32H7_ADC_SQR1, GENMASK(10, 6), 6 },
395 { STM32H7_ADC_SQR1, GENMASK(16, 12), 12 },
396 { STM32H7_ADC_SQR1, GENMASK(22, 18), 18 },
397 { STM32H7_ADC_SQR1, GENMASK(28, 24), 24 },
398 { STM32H7_ADC_SQR2, GENMASK(4, 0), 0 },
399 { STM32H7_ADC_SQR2, GENMASK(10, 6), 6 },
400 { STM32H7_ADC_SQR2, GENMASK(16, 12), 12 },
401 { STM32H7_ADC_SQR2, GENMASK(22, 18), 18 },
402 { STM32H7_ADC_SQR2, GENMASK(28, 24), 24 },
403 { STM32H7_ADC_SQR3, GENMASK(4, 0), 0 },
404 { STM32H7_ADC_SQR3, GENMASK(10, 6), 6 },
405 { STM32H7_ADC_SQR3, GENMASK(16, 12), 12 },
406 { STM32H7_ADC_SQR3, GENMASK(22, 18), 18 },
407 { STM32H7_ADC_SQR3, GENMASK(28, 24), 24 },
408 { STM32H7_ADC_SQR4, GENMASK(4, 0), 0 },
409 { STM32H7_ADC_SQR4, GENMASK(10, 6), 6 },
412 /* STM32H7 external trigger sources for all instances */
413 static struct stm32_adc_trig_info stm32h7_adc_trigs[] = {
414 { TIM1_CH1, STM32_EXT0 },
415 { TIM1_CH2, STM32_EXT1 },
416 { TIM1_CH3, STM32_EXT2 },
417 { TIM2_CH2, STM32_EXT3 },
418 { TIM3_TRGO, STM32_EXT4 },
419 { TIM4_CH4, STM32_EXT5 },
420 { TIM8_TRGO, STM32_EXT7 },
421 { TIM8_TRGO2, STM32_EXT8 },
422 { TIM1_TRGO, STM32_EXT9 },
423 { TIM1_TRGO2, STM32_EXT10 },
424 { TIM2_TRGO, STM32_EXT11 },
425 { TIM4_TRGO, STM32_EXT12 },
426 { TIM6_TRGO, STM32_EXT13 },
427 { TIM3_CH4, STM32_EXT15 },
428 { LPTIM1_OUT, STM32_EXT18 },
429 { LPTIM2_OUT, STM32_EXT19 },
430 { LPTIM3_OUT, STM32_EXT20 },
435 * stm32h7_smp_bits - describe sampling time register index & bit fields
436 * Sorted so it can be indexed by channel number.
438 static const struct stm32_adc_regs stm32h7_smp_bits[] = {
439 /* STM32H7_ADC_SMPR1, smpr[] index, mask, shift for SMP0 to SMP9 */
440 { 0, GENMASK(2, 0), 0 },
441 { 0, GENMASK(5, 3), 3 },
442 { 0, GENMASK(8, 6), 6 },
443 { 0, GENMASK(11, 9), 9 },
444 { 0, GENMASK(14, 12), 12 },
445 { 0, GENMASK(17, 15), 15 },
446 { 0, GENMASK(20, 18), 18 },
447 { 0, GENMASK(23, 21), 21 },
448 { 0, GENMASK(26, 24), 24 },
449 { 0, GENMASK(29, 27), 27 },
450 /* STM32H7_ADC_SMPR2, smpr[] index, mask, shift for SMP10 to SMP19 */
451 { 1, GENMASK(2, 0), 0 },
452 { 1, GENMASK(5, 3), 3 },
453 { 1, GENMASK(8, 6), 6 },
454 { 1, GENMASK(11, 9), 9 },
455 { 1, GENMASK(14, 12), 12 },
456 { 1, GENMASK(17, 15), 15 },
457 { 1, GENMASK(20, 18), 18 },
458 { 1, GENMASK(23, 21), 21 },
459 { 1, GENMASK(26, 24), 24 },
460 { 1, GENMASK(29, 27), 27 },
463 /* STM32H7 programmable sampling time (ADC clock cycles, rounded down) */
464 static const unsigned int stm32h7_adc_smp_cycles[STM32_ADC_MAX_SMP + 1] = {
465 1, 2, 8, 16, 32, 64, 387, 810,
468 static const struct stm32_adc_regspec stm32h7_adc_regspec = {
469 .dr = STM32H7_ADC_DR,
470 .ier_eoc = { STM32H7_ADC_IER, STM32H7_EOCIE },
471 .isr_eoc = { STM32H7_ADC_ISR, STM32H7_EOC },
473 .exten = { STM32H7_ADC_CFGR, STM32H7_EXTEN_MASK, STM32H7_EXTEN_SHIFT },
474 .extsel = { STM32H7_ADC_CFGR, STM32H7_EXTSEL_MASK,
475 STM32H7_EXTSEL_SHIFT },
476 .res = { STM32H7_ADC_CFGR, STM32H7_RES_MASK, STM32H7_RES_SHIFT },
477 .smpr = { STM32H7_ADC_SMPR1, STM32H7_ADC_SMPR2 },
478 .smp_bits = stm32h7_smp_bits,
482 * STM32 ADC registers access routines
483 * @adc: stm32 adc instance
484 * @reg: reg offset in adc instance
486 * Note: All instances share same base, with 0x0, 0x100 or 0x200 offset resp.
487 * for adc1, adc2 and adc3.
489 static u32 stm32_adc_readl(struct stm32_adc *adc, u32 reg)
491 return readl_relaxed(adc->common->base + adc->offset + reg);
494 #define stm32_adc_readl_addr(addr) stm32_adc_readl(adc, addr)
496 #define stm32_adc_readl_poll_timeout(reg, val, cond, sleep_us, timeout_us) \
497 readx_poll_timeout(stm32_adc_readl_addr, reg, val, \
498 cond, sleep_us, timeout_us)
500 static u16 stm32_adc_readw(struct stm32_adc *adc, u32 reg)
502 return readw_relaxed(adc->common->base + adc->offset + reg);
505 static void stm32_adc_writel(struct stm32_adc *adc, u32 reg, u32 val)
507 writel_relaxed(val, adc->common->base + adc->offset + reg);
510 static void stm32_adc_set_bits(struct stm32_adc *adc, u32 reg, u32 bits)
514 spin_lock_irqsave(&adc->lock, flags);
515 stm32_adc_writel(adc, reg, stm32_adc_readl(adc, reg) | bits);
516 spin_unlock_irqrestore(&adc->lock, flags);
519 static void stm32_adc_clr_bits(struct stm32_adc *adc, u32 reg, u32 bits)
523 spin_lock_irqsave(&adc->lock, flags);
524 stm32_adc_writel(adc, reg, stm32_adc_readl(adc, reg) & ~bits);
525 spin_unlock_irqrestore(&adc->lock, flags);
529 * stm32_adc_conv_irq_enable() - Enable end of conversion interrupt
530 * @adc: stm32 adc instance
532 static void stm32_adc_conv_irq_enable(struct stm32_adc *adc)
534 stm32_adc_set_bits(adc, adc->cfg->regs->ier_eoc.reg,
535 adc->cfg->regs->ier_eoc.mask);
539 * stm32_adc_conv_irq_disable() - Disable end of conversion interrupt
540 * @adc: stm32 adc instance
542 static void stm32_adc_conv_irq_disable(struct stm32_adc *adc)
544 stm32_adc_clr_bits(adc, adc->cfg->regs->ier_eoc.reg,
545 adc->cfg->regs->ier_eoc.mask);
548 static void stm32_adc_set_res(struct stm32_adc *adc)
550 const struct stm32_adc_regs *res = &adc->cfg->regs->res;
553 val = stm32_adc_readl(adc, res->reg);
554 val = (val & ~res->mask) | (adc->res << res->shift);
555 stm32_adc_writel(adc, res->reg, val);
559 * stm32f4_adc_start_conv() - Start conversions for regular channels.
560 * @adc: stm32 adc instance
561 * @dma: use dma to transfer conversion result
563 * Start conversions for regular channels.
564 * Also take care of normal or DMA mode. Circular DMA may be used for regular
565 * conversions, in IIO buffer modes. Otherwise, use ADC interrupt with direct
566 * DR read instead (e.g. read_raw, or triggered buffer mode without DMA).
568 static void stm32f4_adc_start_conv(struct stm32_adc *adc, bool dma)
570 stm32_adc_set_bits(adc, STM32F4_ADC_CR1, STM32F4_SCAN);
573 stm32_adc_set_bits(adc, STM32F4_ADC_CR2,
574 STM32F4_DMA | STM32F4_DDS);
576 stm32_adc_set_bits(adc, STM32F4_ADC_CR2, STM32F4_EOCS | STM32F4_ADON);
578 /* Wait for Power-up time (tSTAB from datasheet) */
581 /* Software start ? (e.g. trigger detection disabled ?) */
582 if (!(stm32_adc_readl(adc, STM32F4_ADC_CR2) & STM32F4_EXTEN_MASK))
583 stm32_adc_set_bits(adc, STM32F4_ADC_CR2, STM32F4_SWSTART);
586 static void stm32f4_adc_stop_conv(struct stm32_adc *adc)
588 stm32_adc_clr_bits(adc, STM32F4_ADC_CR2, STM32F4_EXTEN_MASK);
589 stm32_adc_clr_bits(adc, STM32F4_ADC_SR, STM32F4_STRT);
591 stm32_adc_clr_bits(adc, STM32F4_ADC_CR1, STM32F4_SCAN);
592 stm32_adc_clr_bits(adc, STM32F4_ADC_CR2,
593 STM32F4_ADON | STM32F4_DMA | STM32F4_DDS);
596 static void stm32h7_adc_start_conv(struct stm32_adc *adc, bool dma)
598 enum stm32h7_adc_dmngt dmngt;
603 dmngt = STM32H7_DMNGT_DMA_CIRC;
605 dmngt = STM32H7_DMNGT_DR_ONLY;
607 spin_lock_irqsave(&adc->lock, flags);
608 val = stm32_adc_readl(adc, STM32H7_ADC_CFGR);
609 val = (val & ~STM32H7_DMNGT_MASK) | (dmngt << STM32H7_DMNGT_SHIFT);
610 stm32_adc_writel(adc, STM32H7_ADC_CFGR, val);
611 spin_unlock_irqrestore(&adc->lock, flags);
613 stm32_adc_set_bits(adc, STM32H7_ADC_CR, STM32H7_ADSTART);
616 static void stm32h7_adc_stop_conv(struct stm32_adc *adc)
618 struct iio_dev *indio_dev = iio_priv_to_dev(adc);
622 stm32_adc_set_bits(adc, STM32H7_ADC_CR, STM32H7_ADSTP);
624 ret = stm32_adc_readl_poll_timeout(STM32H7_ADC_CR, val,
625 !(val & (STM32H7_ADSTART)),
626 100, STM32_ADC_TIMEOUT_US);
628 dev_warn(&indio_dev->dev, "stop failed\n");
630 stm32_adc_clr_bits(adc, STM32H7_ADC_CFGR, STM32H7_DMNGT_MASK);
633 static void stm32h7_adc_exit_pwr_down(struct stm32_adc *adc)
635 /* Exit deep power down, then enable ADC voltage regulator */
636 stm32_adc_clr_bits(adc, STM32H7_ADC_CR, STM32H7_DEEPPWD);
637 stm32_adc_set_bits(adc, STM32H7_ADC_CR, STM32H7_ADVREGEN);
639 if (adc->common->rate > STM32H7_BOOST_CLKRATE)
640 stm32_adc_set_bits(adc, STM32H7_ADC_CR, STM32H7_BOOST);
642 /* Wait for startup time */
643 usleep_range(10, 20);
646 static void stm32h7_adc_enter_pwr_down(struct stm32_adc *adc)
648 stm32_adc_clr_bits(adc, STM32H7_ADC_CR, STM32H7_BOOST);
650 /* Setting DEEPPWD disables ADC vreg and clears ADVREGEN */
651 stm32_adc_set_bits(adc, STM32H7_ADC_CR, STM32H7_DEEPPWD);
654 static int stm32h7_adc_enable(struct stm32_adc *adc)
656 struct iio_dev *indio_dev = iio_priv_to_dev(adc);
660 stm32_adc_set_bits(adc, STM32H7_ADC_CR, STM32H7_ADEN);
662 /* Poll for ADRDY to be set (after adc startup time) */
663 ret = stm32_adc_readl_poll_timeout(STM32H7_ADC_ISR, val,
665 100, STM32_ADC_TIMEOUT_US);
667 stm32_adc_set_bits(adc, STM32H7_ADC_CR, STM32H7_ADDIS);
668 dev_err(&indio_dev->dev, "Failed to enable ADC\n");
670 /* Clear ADRDY by writing one */
671 stm32_adc_set_bits(adc, STM32H7_ADC_ISR, STM32H7_ADRDY);
677 static void stm32h7_adc_disable(struct stm32_adc *adc)
679 struct iio_dev *indio_dev = iio_priv_to_dev(adc);
683 /* Disable ADC and wait until it's effectively disabled */
684 stm32_adc_set_bits(adc, STM32H7_ADC_CR, STM32H7_ADDIS);
685 ret = stm32_adc_readl_poll_timeout(STM32H7_ADC_CR, val,
686 !(val & STM32H7_ADEN), 100,
687 STM32_ADC_TIMEOUT_US);
689 dev_warn(&indio_dev->dev, "Failed to disable\n");
693 * stm32h7_adc_read_selfcalib() - read calibration shadow regs, save result
694 * @adc: stm32 adc instance
696 static int stm32h7_adc_read_selfcalib(struct stm32_adc *adc)
698 struct iio_dev *indio_dev = iio_priv_to_dev(adc);
700 u32 lincalrdyw_mask, val;
702 /* Enable adc so LINCALRDYW1..6 bits are writable */
703 ret = stm32h7_adc_enable(adc);
707 /* Read linearity calibration */
708 lincalrdyw_mask = STM32H7_LINCALRDYW6;
709 for (i = STM32H7_LINCALFACT_NUM - 1; i >= 0; i--) {
710 /* Clear STM32H7_LINCALRDYW[6..1]: transfer calib to CALFACT2 */
711 stm32_adc_clr_bits(adc, STM32H7_ADC_CR, lincalrdyw_mask);
713 /* Poll: wait calib data to be ready in CALFACT2 register */
714 ret = stm32_adc_readl_poll_timeout(STM32H7_ADC_CR, val,
715 !(val & lincalrdyw_mask),
716 100, STM32_ADC_TIMEOUT_US);
718 dev_err(&indio_dev->dev, "Failed to read calfact\n");
722 val = stm32_adc_readl(adc, STM32H7_ADC_CALFACT2);
723 adc->cal.lincalfact[i] = (val & STM32H7_LINCALFACT_MASK);
724 adc->cal.lincalfact[i] >>= STM32H7_LINCALFACT_SHIFT;
726 lincalrdyw_mask >>= 1;
729 /* Read offset calibration */
730 val = stm32_adc_readl(adc, STM32H7_ADC_CALFACT);
731 adc->cal.calfact_s = (val & STM32H7_CALFACT_S_MASK);
732 adc->cal.calfact_s >>= STM32H7_CALFACT_S_SHIFT;
733 adc->cal.calfact_d = (val & STM32H7_CALFACT_D_MASK);
734 adc->cal.calfact_d >>= STM32H7_CALFACT_D_SHIFT;
737 stm32h7_adc_disable(adc);
743 * stm32h7_adc_restore_selfcalib() - Restore saved self-calibration result
744 * @adc: stm32 adc instance
745 * Note: ADC must be enabled, with no on-going conversions.
747 static int stm32h7_adc_restore_selfcalib(struct stm32_adc *adc)
749 struct iio_dev *indio_dev = iio_priv_to_dev(adc);
751 u32 lincalrdyw_mask, val;
753 val = (adc->cal.calfact_s << STM32H7_CALFACT_S_SHIFT) |
754 (adc->cal.calfact_d << STM32H7_CALFACT_D_SHIFT);
755 stm32_adc_writel(adc, STM32H7_ADC_CALFACT, val);
757 lincalrdyw_mask = STM32H7_LINCALRDYW6;
758 for (i = STM32H7_LINCALFACT_NUM - 1; i >= 0; i--) {
760 * Write saved calibration data to shadow registers:
761 * Write CALFACT2, and set LINCALRDYW[6..1] bit to trigger
762 * data write. Then poll to wait for complete transfer.
764 val = adc->cal.lincalfact[i] << STM32H7_LINCALFACT_SHIFT;
765 stm32_adc_writel(adc, STM32H7_ADC_CALFACT2, val);
766 stm32_adc_set_bits(adc, STM32H7_ADC_CR, lincalrdyw_mask);
767 ret = stm32_adc_readl_poll_timeout(STM32H7_ADC_CR, val,
768 val & lincalrdyw_mask,
769 100, STM32_ADC_TIMEOUT_US);
771 dev_err(&indio_dev->dev, "Failed to write calfact\n");
776 * Read back calibration data, has two effects:
777 * - It ensures bits LINCALRDYW[6..1] are kept cleared
778 * for next time calibration needs to be restored.
779 * - BTW, bit clear triggers a read, then check data has been
782 stm32_adc_clr_bits(adc, STM32H7_ADC_CR, lincalrdyw_mask);
783 ret = stm32_adc_readl_poll_timeout(STM32H7_ADC_CR, val,
784 !(val & lincalrdyw_mask),
785 100, STM32_ADC_TIMEOUT_US);
787 dev_err(&indio_dev->dev, "Failed to read calfact\n");
790 val = stm32_adc_readl(adc, STM32H7_ADC_CALFACT2);
791 if (val != adc->cal.lincalfact[i] << STM32H7_LINCALFACT_SHIFT) {
792 dev_err(&indio_dev->dev, "calfact not consistent\n");
796 lincalrdyw_mask >>= 1;
803 * Fixed timeout value for ADC calibration.
805 * - low clock frequency
806 * - maximum prescalers
807 * Calibration requires:
808 * - 131,072 ADC clock cycle for the linear calibration
809 * - 20 ADC clock cycle for the offset calibration
811 * Set to 100ms for now
813 #define STM32H7_ADC_CALIB_TIMEOUT_US 100000
816 * stm32h7_adc_selfcalib() - Procedure to calibrate ADC (from power down)
817 * @adc: stm32 adc instance
818 * Exit from power down, calibrate ADC, then return to power down.
820 static int stm32h7_adc_selfcalib(struct stm32_adc *adc)
822 struct iio_dev *indio_dev = iio_priv_to_dev(adc);
826 stm32h7_adc_exit_pwr_down(adc);
829 * Select calibration mode:
830 * - Offset calibration for single ended inputs
831 * - No linearity calibration (do it later, before reading it)
833 stm32_adc_clr_bits(adc, STM32H7_ADC_CR, STM32H7_ADCALDIF);
834 stm32_adc_clr_bits(adc, STM32H7_ADC_CR, STM32H7_ADCALLIN);
836 /* Start calibration, then wait for completion */
837 stm32_adc_set_bits(adc, STM32H7_ADC_CR, STM32H7_ADCAL);
838 ret = stm32_adc_readl_poll_timeout(STM32H7_ADC_CR, val,
839 !(val & STM32H7_ADCAL), 100,
840 STM32H7_ADC_CALIB_TIMEOUT_US);
842 dev_err(&indio_dev->dev, "calibration failed\n");
847 * Select calibration mode, then start calibration:
848 * - Offset calibration for differential input
849 * - Linearity calibration (needs to be done only once for single/diff)
850 * will run simultaneously with offset calibration.
852 stm32_adc_set_bits(adc, STM32H7_ADC_CR,
853 STM32H7_ADCALDIF | STM32H7_ADCALLIN);
854 stm32_adc_set_bits(adc, STM32H7_ADC_CR, STM32H7_ADCAL);
855 ret = stm32_adc_readl_poll_timeout(STM32H7_ADC_CR, val,
856 !(val & STM32H7_ADCAL), 100,
857 STM32H7_ADC_CALIB_TIMEOUT_US);
859 dev_err(&indio_dev->dev, "calibration failed\n");
863 stm32_adc_clr_bits(adc, STM32H7_ADC_CR,
864 STM32H7_ADCALDIF | STM32H7_ADCALLIN);
866 /* Read calibration result for future reference */
867 ret = stm32h7_adc_read_selfcalib(adc);
870 stm32h7_adc_enter_pwr_down(adc);
876 * stm32h7_adc_prepare() - Leave power down mode to enable ADC.
877 * @adc: stm32 adc instance
878 * Leave power down mode.
880 * Restore calibration data.
881 * Pre-select channels that may be used in PCSEL (required by input MUX / IO).
883 static int stm32h7_adc_prepare(struct stm32_adc *adc)
887 stm32h7_adc_exit_pwr_down(adc);
889 ret = stm32h7_adc_enable(adc);
893 ret = stm32h7_adc_restore_selfcalib(adc);
897 stm32_adc_writel(adc, STM32H7_ADC_PCSEL, adc->pcsel);
902 stm32h7_adc_disable(adc);
904 stm32h7_adc_enter_pwr_down(adc);
909 static void stm32h7_adc_unprepare(struct stm32_adc *adc)
911 stm32h7_adc_disable(adc);
912 stm32h7_adc_enter_pwr_down(adc);
916 * stm32_adc_conf_scan_seq() - Build regular channels scan sequence
917 * @indio_dev: IIO device
918 * @scan_mask: channels to be converted
920 * Conversion sequence :
921 * Apply sampling time settings for all channels.
922 * Configure ADC scan sequence based on selected channels in scan_mask.
923 * Add channels to SQR registers, from scan_mask LSB to MSB, then
924 * program sequence len.
926 static int stm32_adc_conf_scan_seq(struct iio_dev *indio_dev,
927 const unsigned long *scan_mask)
929 struct stm32_adc *adc = iio_priv(indio_dev);
930 const struct stm32_adc_regs *sqr = adc->cfg->regs->sqr;
931 const struct iio_chan_spec *chan;
935 /* Apply sampling time settings */
936 stm32_adc_writel(adc, adc->cfg->regs->smpr[0], adc->smpr_val[0]);
937 stm32_adc_writel(adc, adc->cfg->regs->smpr[1], adc->smpr_val[1]);
939 for_each_set_bit(bit, scan_mask, indio_dev->masklength) {
940 chan = indio_dev->channels + bit;
942 * Assign one channel per SQ entry in regular
943 * sequence, starting with SQ1.
946 if (i > STM32_ADC_MAX_SQ)
949 dev_dbg(&indio_dev->dev, "%s chan %d to SQ%d\n",
950 __func__, chan->channel, i);
952 val = stm32_adc_readl(adc, sqr[i].reg);
954 val |= chan->channel << sqr[i].shift;
955 stm32_adc_writel(adc, sqr[i].reg, val);
962 val = stm32_adc_readl(adc, sqr[0].reg);
964 val |= ((i - 1) << sqr[0].shift);
965 stm32_adc_writel(adc, sqr[0].reg, val);
971 * stm32_adc_get_trig_extsel() - Get external trigger selection
974 * Returns trigger extsel value, if trig matches, -EINVAL otherwise.
976 static int stm32_adc_get_trig_extsel(struct iio_dev *indio_dev,
977 struct iio_trigger *trig)
979 struct stm32_adc *adc = iio_priv(indio_dev);
982 /* lookup triggers registered by stm32 timer trigger driver */
983 for (i = 0; adc->cfg->trigs[i].name; i++) {
985 * Checking both stm32 timer trigger type and trig name
986 * should be safe against arbitrary trigger names.
988 if ((is_stm32_timer_trigger(trig) ||
989 is_stm32_lptim_trigger(trig)) &&
990 !strcmp(adc->cfg->trigs[i].name, trig->name)) {
991 return adc->cfg->trigs[i].extsel;
999 * stm32_adc_set_trig() - Set a regular trigger
1000 * @indio_dev: IIO device
1001 * @trig: IIO trigger
1003 * Set trigger source/polarity (e.g. SW, or HW with polarity) :
1004 * - if HW trigger disabled (e.g. trig == NULL, conversion launched by sw)
1005 * - if HW trigger enabled, set source & polarity
1007 static int stm32_adc_set_trig(struct iio_dev *indio_dev,
1008 struct iio_trigger *trig)
1010 struct stm32_adc *adc = iio_priv(indio_dev);
1011 u32 val, extsel = 0, exten = STM32_EXTEN_SWTRIG;
1012 unsigned long flags;
1016 ret = stm32_adc_get_trig_extsel(indio_dev, trig);
1020 /* set trigger source and polarity (default to rising edge) */
1022 exten = adc->trigger_polarity + STM32_EXTEN_HWTRIG_RISING_EDGE;
1025 spin_lock_irqsave(&adc->lock, flags);
1026 val = stm32_adc_readl(adc, adc->cfg->regs->exten.reg);
1027 val &= ~(adc->cfg->regs->exten.mask | adc->cfg->regs->extsel.mask);
1028 val |= exten << adc->cfg->regs->exten.shift;
1029 val |= extsel << adc->cfg->regs->extsel.shift;
1030 stm32_adc_writel(adc, adc->cfg->regs->exten.reg, val);
1031 spin_unlock_irqrestore(&adc->lock, flags);
1036 static int stm32_adc_set_trig_pol(struct iio_dev *indio_dev,
1037 const struct iio_chan_spec *chan,
1040 struct stm32_adc *adc = iio_priv(indio_dev);
1042 adc->trigger_polarity = type;
1047 static int stm32_adc_get_trig_pol(struct iio_dev *indio_dev,
1048 const struct iio_chan_spec *chan)
1050 struct stm32_adc *adc = iio_priv(indio_dev);
1052 return adc->trigger_polarity;
1055 static const char * const stm32_trig_pol_items[] = {
1056 "rising-edge", "falling-edge", "both-edges",
1059 static const struct iio_enum stm32_adc_trig_pol = {
1060 .items = stm32_trig_pol_items,
1061 .num_items = ARRAY_SIZE(stm32_trig_pol_items),
1062 .get = stm32_adc_get_trig_pol,
1063 .set = stm32_adc_set_trig_pol,
1067 * stm32_adc_single_conv() - Performs a single conversion
1068 * @indio_dev: IIO device
1069 * @chan: IIO channel
1070 * @res: conversion result
1072 * The function performs a single conversion on a given channel:
1073 * - Apply sampling time settings
1074 * - Program sequencer with one channel (e.g. in SQ1 with len = 1)
1076 * - Start conversion, then wait for interrupt completion.
1078 static int stm32_adc_single_conv(struct iio_dev *indio_dev,
1079 const struct iio_chan_spec *chan,
1082 struct stm32_adc *adc = iio_priv(indio_dev);
1083 const struct stm32_adc_regspec *regs = adc->cfg->regs;
1088 reinit_completion(&adc->completion);
1092 if (adc->cfg->prepare) {
1093 ret = adc->cfg->prepare(adc);
1098 /* Apply sampling time settings */
1099 stm32_adc_writel(adc, regs->smpr[0], adc->smpr_val[0]);
1100 stm32_adc_writel(adc, regs->smpr[1], adc->smpr_val[1]);
1102 /* Program chan number in regular sequence (SQ1) */
1103 val = stm32_adc_readl(adc, regs->sqr[1].reg);
1104 val &= ~regs->sqr[1].mask;
1105 val |= chan->channel << regs->sqr[1].shift;
1106 stm32_adc_writel(adc, regs->sqr[1].reg, val);
1108 /* Set regular sequence len (0 for 1 conversion) */
1109 stm32_adc_clr_bits(adc, regs->sqr[0].reg, regs->sqr[0].mask);
1111 /* Trigger detection disabled (conversion can be launched in SW) */
1112 stm32_adc_clr_bits(adc, regs->exten.reg, regs->exten.mask);
1114 stm32_adc_conv_irq_enable(adc);
1116 adc->cfg->start_conv(adc, false);
1118 timeout = wait_for_completion_interruptible_timeout(
1119 &adc->completion, STM32_ADC_TIMEOUT);
1122 } else if (timeout < 0) {
1125 *res = adc->buffer[0];
1129 adc->cfg->stop_conv(adc);
1131 stm32_adc_conv_irq_disable(adc);
1133 if (adc->cfg->unprepare)
1134 adc->cfg->unprepare(adc);
1139 static int stm32_adc_read_raw(struct iio_dev *indio_dev,
1140 struct iio_chan_spec const *chan,
1141 int *val, int *val2, long mask)
1143 struct stm32_adc *adc = iio_priv(indio_dev);
1147 case IIO_CHAN_INFO_RAW:
1148 ret = iio_device_claim_direct_mode(indio_dev);
1151 if (chan->type == IIO_VOLTAGE)
1152 ret = stm32_adc_single_conv(indio_dev, chan, val);
1155 iio_device_release_direct_mode(indio_dev);
1158 case IIO_CHAN_INFO_SCALE:
1159 *val = adc->common->vref_mv;
1160 *val2 = chan->scan_type.realbits;
1161 return IIO_VAL_FRACTIONAL_LOG2;
1168 static irqreturn_t stm32_adc_isr(int irq, void *data)
1170 struct stm32_adc *adc = data;
1171 struct iio_dev *indio_dev = iio_priv_to_dev(adc);
1172 const struct stm32_adc_regspec *regs = adc->cfg->regs;
1173 u32 status = stm32_adc_readl(adc, regs->isr_eoc.reg);
1175 if (status & regs->isr_eoc.mask) {
1176 /* Reading DR also clears EOC status flag */
1177 adc->buffer[adc->bufi] = stm32_adc_readw(adc, regs->dr);
1178 if (iio_buffer_enabled(indio_dev)) {
1180 if (adc->bufi >= adc->num_conv) {
1181 stm32_adc_conv_irq_disable(adc);
1182 iio_trigger_poll(indio_dev->trig);
1185 complete(&adc->completion);
1194 * stm32_adc_validate_trigger() - validate trigger for stm32 adc
1195 * @indio_dev: IIO device
1196 * @trig: new trigger
1198 * Returns: 0 if trig matches one of the triggers registered by stm32 adc
1199 * driver, -EINVAL otherwise.
1201 static int stm32_adc_validate_trigger(struct iio_dev *indio_dev,
1202 struct iio_trigger *trig)
1204 return stm32_adc_get_trig_extsel(indio_dev, trig) < 0 ? -EINVAL : 0;
1207 static int stm32_adc_set_watermark(struct iio_dev *indio_dev, unsigned int val)
1209 struct stm32_adc *adc = iio_priv(indio_dev);
1210 unsigned int watermark = STM32_DMA_BUFFER_SIZE / 2;
1211 unsigned int rx_buf_sz = STM32_DMA_BUFFER_SIZE;
1214 * dma cyclic transfers are used, buffer is split into two periods.
1216 * - always one buffer (period) dma is working on
1217 * - one buffer (period) driver can push with iio_trigger_poll().
1219 watermark = min(watermark, val * (unsigned)(sizeof(u16)));
1220 adc->rx_buf_sz = min(rx_buf_sz, watermark * 2 * adc->num_conv);
1225 static int stm32_adc_update_scan_mode(struct iio_dev *indio_dev,
1226 const unsigned long *scan_mask)
1228 struct stm32_adc *adc = iio_priv(indio_dev);
1231 adc->num_conv = bitmap_weight(scan_mask, indio_dev->masklength);
1233 ret = stm32_adc_conf_scan_seq(indio_dev, scan_mask);
1240 static int stm32_adc_of_xlate(struct iio_dev *indio_dev,
1241 const struct of_phandle_args *iiospec)
1245 for (i = 0; i < indio_dev->num_channels; i++)
1246 if (indio_dev->channels[i].channel == iiospec->args[0])
1253 * stm32_adc_debugfs_reg_access - read or write register value
1255 * To read a value from an ADC register:
1256 * echo [ADC reg offset] > direct_reg_access
1257 * cat direct_reg_access
1259 * To write a value in a ADC register:
1260 * echo [ADC_reg_offset] [value] > direct_reg_access
1262 static int stm32_adc_debugfs_reg_access(struct iio_dev *indio_dev,
1263 unsigned reg, unsigned writeval,
1266 struct stm32_adc *adc = iio_priv(indio_dev);
1269 stm32_adc_writel(adc, reg, writeval);
1271 *readval = stm32_adc_readl(adc, reg);
1276 static const struct iio_info stm32_adc_iio_info = {
1277 .read_raw = stm32_adc_read_raw,
1278 .validate_trigger = stm32_adc_validate_trigger,
1279 .hwfifo_set_watermark = stm32_adc_set_watermark,
1280 .update_scan_mode = stm32_adc_update_scan_mode,
1281 .debugfs_reg_access = stm32_adc_debugfs_reg_access,
1282 .of_xlate = stm32_adc_of_xlate,
1283 .driver_module = THIS_MODULE,
1286 static unsigned int stm32_adc_dma_residue(struct stm32_adc *adc)
1288 struct dma_tx_state state;
1289 enum dma_status status;
1291 status = dmaengine_tx_status(adc->dma_chan,
1292 adc->dma_chan->cookie,
1294 if (status == DMA_IN_PROGRESS) {
1295 /* Residue is size in bytes from end of buffer */
1296 unsigned int i = adc->rx_buf_sz - state.residue;
1299 /* Return available bytes */
1301 size = i - adc->bufi;
1303 size = adc->rx_buf_sz + i - adc->bufi;
1311 static void stm32_adc_dma_buffer_done(void *data)
1313 struct iio_dev *indio_dev = data;
1314 struct stm32_adc *adc = iio_priv(indio_dev);
1315 int residue = stm32_adc_dma_residue(adc);
1318 * In DMA mode the trigger services of IIO are not used
1319 * (e.g. no call to iio_trigger_poll).
1320 * Calling irq handler associated to the hardware trigger is not
1321 * relevant as the conversions have already been done. Data
1322 * transfers are performed directly in DMA callback instead.
1323 * This implementation avoids to call trigger irq handler that
1324 * may sleep, in an atomic context (DMA irq handler context).
1326 dev_dbg(&indio_dev->dev, "%s bufi=%d\n", __func__, adc->bufi);
1328 while (residue >= indio_dev->scan_bytes) {
1329 u16 *buffer = (u16 *)&adc->rx_buf[adc->bufi];
1331 iio_push_to_buffers(indio_dev, buffer);
1333 residue -= indio_dev->scan_bytes;
1334 adc->bufi += indio_dev->scan_bytes;
1335 if (adc->bufi >= adc->rx_buf_sz)
1340 static int stm32_adc_dma_start(struct iio_dev *indio_dev)
1342 struct stm32_adc *adc = iio_priv(indio_dev);
1343 struct dma_async_tx_descriptor *desc;
1344 dma_cookie_t cookie;
1350 dev_dbg(&indio_dev->dev, "%s size=%d watermark=%d\n", __func__,
1351 adc->rx_buf_sz, adc->rx_buf_sz / 2);
1353 /* Prepare a DMA cyclic transaction */
1354 desc = dmaengine_prep_dma_cyclic(adc->dma_chan,
1356 adc->rx_buf_sz, adc->rx_buf_sz / 2,
1358 DMA_PREP_INTERRUPT);
1362 desc->callback = stm32_adc_dma_buffer_done;
1363 desc->callback_param = indio_dev;
1365 cookie = dmaengine_submit(desc);
1366 ret = dma_submit_error(cookie);
1368 dmaengine_terminate_sync(adc->dma_chan);
1372 /* Issue pending DMA requests */
1373 dma_async_issue_pending(adc->dma_chan);
1378 static int stm32_adc_buffer_postenable(struct iio_dev *indio_dev)
1380 struct stm32_adc *adc = iio_priv(indio_dev);
1383 if (adc->cfg->prepare) {
1384 ret = adc->cfg->prepare(adc);
1389 ret = stm32_adc_set_trig(indio_dev, indio_dev->trig);
1391 dev_err(&indio_dev->dev, "Can't set trigger\n");
1395 ret = stm32_adc_dma_start(indio_dev);
1397 dev_err(&indio_dev->dev, "Can't start dma\n");
1401 ret = iio_triggered_buffer_postenable(indio_dev);
1405 /* Reset adc buffer index */
1409 stm32_adc_conv_irq_enable(adc);
1411 adc->cfg->start_conv(adc, !!adc->dma_chan);
1417 dmaengine_terminate_all(adc->dma_chan);
1419 stm32_adc_set_trig(indio_dev, NULL);
1421 if (adc->cfg->unprepare)
1422 adc->cfg->unprepare(adc);
1427 static int stm32_adc_buffer_predisable(struct iio_dev *indio_dev)
1429 struct stm32_adc *adc = iio_priv(indio_dev);
1432 adc->cfg->stop_conv(adc);
1434 stm32_adc_conv_irq_disable(adc);
1436 ret = iio_triggered_buffer_predisable(indio_dev);
1438 dev_err(&indio_dev->dev, "predisable failed\n");
1441 dmaengine_terminate_sync(adc->dma_chan);
1443 if (stm32_adc_set_trig(indio_dev, NULL))
1444 dev_err(&indio_dev->dev, "Can't clear trigger\n");
1446 if (adc->cfg->unprepare)
1447 adc->cfg->unprepare(adc);
1452 static const struct iio_buffer_setup_ops stm32_adc_buffer_setup_ops = {
1453 .postenable = &stm32_adc_buffer_postenable,
1454 .predisable = &stm32_adc_buffer_predisable,
1457 static irqreturn_t stm32_adc_trigger_handler(int irq, void *p)
1459 struct iio_poll_func *pf = p;
1460 struct iio_dev *indio_dev = pf->indio_dev;
1461 struct stm32_adc *adc = iio_priv(indio_dev);
1463 dev_dbg(&indio_dev->dev, "%s bufi=%d\n", __func__, adc->bufi);
1465 if (!adc->dma_chan) {
1466 /* reset buffer index */
1468 iio_push_to_buffers_with_timestamp(indio_dev, adc->buffer,
1471 int residue = stm32_adc_dma_residue(adc);
1473 while (residue >= indio_dev->scan_bytes) {
1474 u16 *buffer = (u16 *)&adc->rx_buf[adc->bufi];
1476 iio_push_to_buffers_with_timestamp(indio_dev, buffer,
1478 residue -= indio_dev->scan_bytes;
1479 adc->bufi += indio_dev->scan_bytes;
1480 if (adc->bufi >= adc->rx_buf_sz)
1485 iio_trigger_notify_done(indio_dev->trig);
1487 /* re-enable eoc irq */
1489 stm32_adc_conv_irq_enable(adc);
1494 static const struct iio_chan_spec_ext_info stm32_adc_ext_info[] = {
1495 IIO_ENUM("trigger_polarity", IIO_SHARED_BY_ALL, &stm32_adc_trig_pol),
1497 .name = "trigger_polarity_available",
1498 .shared = IIO_SHARED_BY_ALL,
1499 .read = iio_enum_available_read,
1500 .private = (uintptr_t)&stm32_adc_trig_pol,
1505 static int stm32_adc_of_get_resolution(struct iio_dev *indio_dev)
1507 struct device_node *node = indio_dev->dev.of_node;
1508 struct stm32_adc *adc = iio_priv(indio_dev);
1512 if (of_property_read_u32(node, "assigned-resolution-bits", &res))
1513 res = adc->cfg->adc_info->resolutions[0];
1515 for (i = 0; i < adc->cfg->adc_info->num_res; i++)
1516 if (res == adc->cfg->adc_info->resolutions[i])
1518 if (i >= adc->cfg->adc_info->num_res) {
1519 dev_err(&indio_dev->dev, "Bad resolution: %u bits\n", res);
1523 dev_dbg(&indio_dev->dev, "Using %u bits resolution\n", res);
1529 static void stm32_adc_smpr_init(struct stm32_adc *adc, int channel, u32 smp_ns)
1531 const struct stm32_adc_regs *smpr = &adc->cfg->regs->smp_bits[channel];
1532 u32 period_ns, shift = smpr->shift, mask = smpr->mask;
1533 unsigned int smp, r = smpr->reg;
1535 /* Determine sampling time (ADC clock cycles) */
1536 period_ns = NSEC_PER_SEC / adc->common->rate;
1537 for (smp = 0; smp <= STM32_ADC_MAX_SMP; smp++)
1538 if ((period_ns * adc->cfg->smp_cycles[smp]) >= smp_ns)
1540 if (smp > STM32_ADC_MAX_SMP)
1541 smp = STM32_ADC_MAX_SMP;
1543 /* pre-build sampling time registers (e.g. smpr1, smpr2) */
1544 adc->smpr_val[r] = (adc->smpr_val[r] & ~mask) | (smp << shift);
1547 static void stm32_adc_chan_init_one(struct iio_dev *indio_dev,
1548 struct iio_chan_spec *chan,
1549 const struct stm32_adc_chan_spec *channel,
1550 int scan_index, u32 smp)
1552 struct stm32_adc *adc = iio_priv(indio_dev);
1554 chan->type = channel->type;
1555 chan->channel = channel->channel;
1556 chan->datasheet_name = channel->name;
1557 chan->scan_index = scan_index;
1559 chan->info_mask_separate = BIT(IIO_CHAN_INFO_RAW);
1560 chan->info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SCALE);
1561 chan->scan_type.sign = 'u';
1562 chan->scan_type.realbits = adc->cfg->adc_info->resolutions[adc->res];
1563 chan->scan_type.storagebits = 16;
1564 chan->ext_info = stm32_adc_ext_info;
1566 /* Prepare sampling time settings */
1567 stm32_adc_smpr_init(adc, chan->channel, smp);
1569 /* pre-build selected channels mask */
1570 adc->pcsel |= BIT(chan->channel);
1573 static int stm32_adc_chan_of_init(struct iio_dev *indio_dev)
1575 struct device_node *node = indio_dev->dev.of_node;
1576 struct stm32_adc *adc = iio_priv(indio_dev);
1577 const struct stm32_adc_info *adc_info = adc->cfg->adc_info;
1578 struct property *prop;
1580 struct iio_chan_spec *channels;
1581 int scan_index = 0, num_channels, ret;
1584 num_channels = of_property_count_u32_elems(node, "st,adc-channels");
1585 if (num_channels < 0 ||
1586 num_channels > adc_info->max_channels) {
1587 dev_err(&indio_dev->dev, "Bad st,adc-channels?\n");
1588 return num_channels < 0 ? num_channels : -EINVAL;
1591 /* Optional sample time is provided either for each, or all channels */
1592 ret = of_property_count_u32_elems(node, "st,min-sample-time-nsecs");
1593 if (ret > 1 && ret != num_channels) {
1594 dev_err(&indio_dev->dev, "Invalid st,min-sample-time-nsecs\n");
1598 channels = devm_kcalloc(&indio_dev->dev, num_channels,
1599 sizeof(struct iio_chan_spec), GFP_KERNEL);
1603 of_property_for_each_u32(node, "st,adc-channels", prop, cur, val) {
1604 if (val >= adc_info->max_channels) {
1605 dev_err(&indio_dev->dev, "Invalid channel %d\n", val);
1610 * Using of_property_read_u32_index(), smp value will only be
1611 * modified if valid u32 value can be decoded. This allows to
1612 * get either no value, 1 shared value for all indexes, or one
1613 * value per channel.
1615 of_property_read_u32_index(node, "st,min-sample-time-nsecs",
1618 stm32_adc_chan_init_one(indio_dev, &channels[scan_index],
1619 &adc_info->channels[val],
1624 indio_dev->num_channels = scan_index;
1625 indio_dev->channels = channels;
1630 static int stm32_adc_dma_request(struct device *dev, struct iio_dev *indio_dev)
1632 struct stm32_adc *adc = iio_priv(indio_dev);
1633 struct dma_slave_config config;
1636 adc->dma_chan = dma_request_chan(dev, "rx");
1637 if (IS_ERR(adc->dma_chan)) {
1638 ret = PTR_ERR(adc->dma_chan);
1639 if (ret != -ENODEV) {
1640 if (ret != -EPROBE_DEFER)
1642 "DMA channel request failed with %d\n",
1647 /* DMA is optional: fall back to IRQ mode */
1648 adc->dma_chan = NULL;
1652 adc->rx_buf = dma_alloc_coherent(adc->dma_chan->device->dev,
1653 STM32_DMA_BUFFER_SIZE,
1654 &adc->rx_dma_buf, GFP_KERNEL);
1660 /* Configure DMA channel to read data register */
1661 memset(&config, 0, sizeof(config));
1662 config.src_addr = (dma_addr_t)adc->common->phys_base;
1663 config.src_addr += adc->offset + adc->cfg->regs->dr;
1664 config.src_addr_width = DMA_SLAVE_BUSWIDTH_2_BYTES;
1666 ret = dmaengine_slave_config(adc->dma_chan, &config);
1673 dma_free_coherent(adc->dma_chan->device->dev, STM32_DMA_BUFFER_SIZE,
1674 adc->rx_buf, adc->rx_dma_buf);
1676 dma_release_channel(adc->dma_chan);
1681 static int stm32_adc_probe(struct platform_device *pdev)
1683 struct iio_dev *indio_dev;
1684 struct device *dev = &pdev->dev;
1685 irqreturn_t (*handler)(int irq, void *p) = NULL;
1686 struct stm32_adc *adc;
1689 if (!pdev->dev.of_node)
1692 indio_dev = devm_iio_device_alloc(&pdev->dev, sizeof(*adc));
1696 adc = iio_priv(indio_dev);
1697 adc->common = dev_get_drvdata(pdev->dev.parent);
1698 spin_lock_init(&adc->lock);
1699 init_completion(&adc->completion);
1700 adc->cfg = (const struct stm32_adc_cfg *)
1701 of_match_device(dev->driver->of_match_table, dev)->data;
1703 indio_dev->name = dev_name(&pdev->dev);
1704 indio_dev->dev.parent = &pdev->dev;
1705 indio_dev->dev.of_node = pdev->dev.of_node;
1706 indio_dev->info = &stm32_adc_iio_info;
1707 indio_dev->modes = INDIO_DIRECT_MODE | INDIO_HARDWARE_TRIGGERED;
1709 platform_set_drvdata(pdev, adc);
1711 ret = of_property_read_u32(pdev->dev.of_node, "reg", &adc->offset);
1713 dev_err(&pdev->dev, "missing reg property\n");
1717 adc->irq = platform_get_irq(pdev, 0);
1719 dev_err(&pdev->dev, "failed to get irq\n");
1723 ret = devm_request_irq(&pdev->dev, adc->irq, stm32_adc_isr,
1724 0, pdev->name, adc);
1726 dev_err(&pdev->dev, "failed to request IRQ\n");
1730 adc->clk = devm_clk_get(&pdev->dev, NULL);
1731 if (IS_ERR(adc->clk)) {
1732 ret = PTR_ERR(adc->clk);
1733 if (ret == -ENOENT && !adc->cfg->clk_required) {
1736 dev_err(&pdev->dev, "Can't get clock\n");
1742 ret = clk_prepare_enable(adc->clk);
1744 dev_err(&pdev->dev, "clk enable failed\n");
1749 ret = stm32_adc_of_get_resolution(indio_dev);
1751 goto err_clk_disable;
1752 stm32_adc_set_res(adc);
1754 if (adc->cfg->selfcalib) {
1755 ret = adc->cfg->selfcalib(adc);
1757 goto err_clk_disable;
1760 ret = stm32_adc_chan_of_init(indio_dev);
1762 goto err_clk_disable;
1764 ret = stm32_adc_dma_request(dev, indio_dev);
1766 goto err_clk_disable;
1769 handler = &stm32_adc_trigger_handler;
1771 ret = iio_triggered_buffer_setup(indio_dev,
1772 &iio_pollfunc_store_time, handler,
1773 &stm32_adc_buffer_setup_ops);
1775 dev_err(&pdev->dev, "buffer setup failed\n");
1776 goto err_dma_disable;
1779 ret = iio_device_register(indio_dev);
1781 dev_err(&pdev->dev, "iio dev register failed\n");
1782 goto err_buffer_cleanup;
1788 iio_triggered_buffer_cleanup(indio_dev);
1791 if (adc->dma_chan) {
1792 dma_free_coherent(adc->dma_chan->device->dev,
1793 STM32_DMA_BUFFER_SIZE,
1794 adc->rx_buf, adc->rx_dma_buf);
1795 dma_release_channel(adc->dma_chan);
1799 clk_disable_unprepare(adc->clk);
1804 static int stm32_adc_remove(struct platform_device *pdev)
1806 struct stm32_adc *adc = platform_get_drvdata(pdev);
1807 struct iio_dev *indio_dev = iio_priv_to_dev(adc);
1809 iio_device_unregister(indio_dev);
1810 iio_triggered_buffer_cleanup(indio_dev);
1811 if (adc->dma_chan) {
1812 dma_free_coherent(adc->dma_chan->device->dev,
1813 STM32_DMA_BUFFER_SIZE,
1814 adc->rx_buf, adc->rx_dma_buf);
1815 dma_release_channel(adc->dma_chan);
1818 clk_disable_unprepare(adc->clk);
1823 static const struct stm32_adc_cfg stm32f4_adc_cfg = {
1824 .regs = &stm32f4_adc_regspec,
1825 .adc_info = &stm32f4_adc_info,
1826 .trigs = stm32f4_adc_trigs,
1827 .clk_required = true,
1828 .start_conv = stm32f4_adc_start_conv,
1829 .stop_conv = stm32f4_adc_stop_conv,
1830 .smp_cycles = stm32f4_adc_smp_cycles,
1833 static const struct stm32_adc_cfg stm32h7_adc_cfg = {
1834 .regs = &stm32h7_adc_regspec,
1835 .adc_info = &stm32h7_adc_info,
1836 .trigs = stm32h7_adc_trigs,
1837 .selfcalib = stm32h7_adc_selfcalib,
1838 .start_conv = stm32h7_adc_start_conv,
1839 .stop_conv = stm32h7_adc_stop_conv,
1840 .prepare = stm32h7_adc_prepare,
1841 .unprepare = stm32h7_adc_unprepare,
1842 .smp_cycles = stm32h7_adc_smp_cycles,
1845 static const struct of_device_id stm32_adc_of_match[] = {
1846 { .compatible = "st,stm32f4-adc", .data = (void *)&stm32f4_adc_cfg },
1847 { .compatible = "st,stm32h7-adc", .data = (void *)&stm32h7_adc_cfg },
1850 MODULE_DEVICE_TABLE(of, stm32_adc_of_match);
1852 static struct platform_driver stm32_adc_driver = {
1853 .probe = stm32_adc_probe,
1854 .remove = stm32_adc_remove,
1856 .name = "stm32-adc",
1857 .of_match_table = stm32_adc_of_match,
1860 module_platform_driver(stm32_adc_driver);
1862 MODULE_AUTHOR("Fabrice Gasnier <fabrice.gasnier@st.com>");
1863 MODULE_DESCRIPTION("STMicroelectronics STM32 ADC IIO driver");
1864 MODULE_LICENSE("GPL v2");
1865 MODULE_ALIAS("platform:stm32-adc");