Skip to content

Commit 91348b1

Browse files
committed
Merge tag 'ib-mfd-pwm-v4.18-1' of git://git.kernel.org/pub/scm/linux/kernel/git/lee/mfd into for-next
Immutable branch between MFD and PWM due for the v4.18 merge window (v2)
2 parents d968e50 + acc8e22 commit 91348b1

File tree

4 files changed

+534
-2
lines changed

4 files changed

+534
-2
lines changed

Documentation/devicetree/bindings/mfd/stm32-timers.txt

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,11 @@ Required parameters:
1919
Optional parameters:
2020
- resets: Phandle to the parent reset controller.
2121
See ../reset/st,stm32-rcc.txt
22+
- dmas: List of phandle to dma channels that can be used for
23+
this timer instance. There may be up to 7 dma channels.
24+
- dma-names: List of dma names. Must match 'dmas' property. Valid
25+
names are: "ch1", "ch2", "ch3", "ch4", "up", "trig",
26+
"com".
2227

2328
Optional subnodes:
2429
- pwm: See ../pwm/pwm-stm32.txt
@@ -44,3 +49,18 @@ Example:
4449
reg = <0>;
4550
};
4651
};
52+
53+
Example with all dmas:
54+
timer@40010000 {
55+
...
56+
dmas = <&dmamux1 11 0x400 0x0>,
57+
<&dmamux1 12 0x400 0x0>,
58+
<&dmamux1 13 0x400 0x0>,
59+
<&dmamux1 14 0x400 0x0>,
60+
<&dmamux1 15 0x400 0x0>,
61+
<&dmamux1 16 0x400 0x0>,
62+
<&dmamux1 17 0x400 0x0>;
63+
dma-names = "ch1", "ch2", "ch3", "ch4", "up", "trig", "com";
64+
...
65+
child nodes...
66+
};

drivers/mfd/stm32-timers.c

Lines changed: 199 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,156 @@
44
* Author: Benjamin Gaignard <[email protected]>
55
*/
66

7+
#include <linux/bitfield.h>
78
#include <linux/mfd/stm32-timers.h>
89
#include <linux/module.h>
910
#include <linux/of_platform.h>
1011
#include <linux/reset.h>
1112

13+
#define STM32_TIMERS_MAX_REGISTERS 0x3fc
14+
15+
/* DIER register DMA enable bits */
16+
static const u32 stm32_timers_dier_dmaen[STM32_TIMERS_MAX_DMAS] = {
17+
TIM_DIER_CC1DE,
18+
TIM_DIER_CC2DE,
19+
TIM_DIER_CC3DE,
20+
TIM_DIER_CC4DE,
21+
TIM_DIER_UIE,
22+
TIM_DIER_TDE,
23+
TIM_DIER_COMDE
24+
};
25+
26+
static void stm32_timers_dma_done(void *p)
27+
{
28+
struct stm32_timers_dma *dma = p;
29+
struct dma_tx_state state;
30+
enum dma_status status;
31+
32+
status = dmaengine_tx_status(dma->chan, dma->chan->cookie, &state);
33+
if (status == DMA_COMPLETE)
34+
complete(&dma->completion);
35+
}
36+
37+
/**
38+
* stm32_timers_dma_burst_read - Read from timers registers using DMA.
39+
*
40+
* Read from STM32 timers registers using DMA on a single event.
41+
* @dev: reference to stm32_timers MFD device
42+
* @buf: DMA'able destination buffer
43+
* @id: stm32_timers_dmas event identifier (ch[1..4], up, trig or com)
44+
* @reg: registers start offset for DMA to read from (like CCRx for capture)
45+
* @num_reg: number of registers to read upon each DMA request, starting @reg.
46+
* @bursts: number of bursts to read (e.g. like two for pwm period capture)
47+
* @tmo_ms: timeout (milliseconds)
48+
*/
49+
int stm32_timers_dma_burst_read(struct device *dev, u32 *buf,
50+
enum stm32_timers_dmas id, u32 reg,
51+
unsigned int num_reg, unsigned int bursts,
52+
unsigned long tmo_ms)
53+
{
54+
struct stm32_timers *ddata = dev_get_drvdata(dev);
55+
unsigned long timeout = msecs_to_jiffies(tmo_ms);
56+
struct regmap *regmap = ddata->regmap;
57+
struct stm32_timers_dma *dma = &ddata->dma;
58+
size_t len = num_reg * bursts * sizeof(u32);
59+
struct dma_async_tx_descriptor *desc;
60+
struct dma_slave_config config;
61+
dma_cookie_t cookie;
62+
dma_addr_t dma_buf;
63+
u32 dbl, dba;
64+
long err;
65+
int ret;
66+
67+
/* Sanity check */
68+
if (id < STM32_TIMERS_DMA_CH1 || id >= STM32_TIMERS_MAX_DMAS)
69+
return -EINVAL;
70+
71+
if (!num_reg || !bursts || reg > STM32_TIMERS_MAX_REGISTERS ||
72+
(reg + num_reg * sizeof(u32)) > STM32_TIMERS_MAX_REGISTERS)
73+
return -EINVAL;
74+
75+
if (!dma->chans[id])
76+
return -ENODEV;
77+
mutex_lock(&dma->lock);
78+
79+
/* Select DMA channel in use */
80+
dma->chan = dma->chans[id];
81+
dma_buf = dma_map_single(dev, buf, len, DMA_FROM_DEVICE);
82+
if (dma_mapping_error(dev, dma_buf)) {
83+
ret = -ENOMEM;
84+
goto unlock;
85+
}
86+
87+
/* Prepare DMA read from timer registers, using DMA burst mode */
88+
memset(&config, 0, sizeof(config));
89+
config.src_addr = (dma_addr_t)dma->phys_base + TIM_DMAR;
90+
config.src_addr_width = DMA_SLAVE_BUSWIDTH_4_BYTES;
91+
ret = dmaengine_slave_config(dma->chan, &config);
92+
if (ret)
93+
goto unmap;
94+
95+
desc = dmaengine_prep_slave_single(dma->chan, dma_buf, len,
96+
DMA_DEV_TO_MEM, DMA_PREP_INTERRUPT);
97+
if (!desc) {
98+
ret = -EBUSY;
99+
goto unmap;
100+
}
101+
102+
desc->callback = stm32_timers_dma_done;
103+
desc->callback_param = dma;
104+
cookie = dmaengine_submit(desc);
105+
ret = dma_submit_error(cookie);
106+
if (ret)
107+
goto dma_term;
108+
109+
reinit_completion(&dma->completion);
110+
dma_async_issue_pending(dma->chan);
111+
112+
/* Setup and enable timer DMA burst mode */
113+
dbl = FIELD_PREP(TIM_DCR_DBL, bursts - 1);
114+
dba = FIELD_PREP(TIM_DCR_DBA, reg >> 2);
115+
ret = regmap_write(regmap, TIM_DCR, dbl | dba);
116+
if (ret)
117+
goto dma_term;
118+
119+
/* Clear pending flags before enabling DMA request */
120+
ret = regmap_write(regmap, TIM_SR, 0);
121+
if (ret)
122+
goto dcr_clr;
123+
124+
ret = regmap_update_bits(regmap, TIM_DIER, stm32_timers_dier_dmaen[id],
125+
stm32_timers_dier_dmaen[id]);
126+
if (ret)
127+
goto dcr_clr;
128+
129+
err = wait_for_completion_interruptible_timeout(&dma->completion,
130+
timeout);
131+
if (err == 0)
132+
ret = -ETIMEDOUT;
133+
else if (err < 0)
134+
ret = err;
135+
136+
regmap_update_bits(regmap, TIM_DIER, stm32_timers_dier_dmaen[id], 0);
137+
regmap_write(regmap, TIM_SR, 0);
138+
dcr_clr:
139+
regmap_write(regmap, TIM_DCR, 0);
140+
dma_term:
141+
dmaengine_terminate_all(dma->chan);
142+
unmap:
143+
dma_unmap_single(dev, dma_buf, len, DMA_FROM_DEVICE);
144+
unlock:
145+
dma->chan = NULL;
146+
mutex_unlock(&dma->lock);
147+
148+
return ret;
149+
}
150+
EXPORT_SYMBOL_GPL(stm32_timers_dma_burst_read);
151+
12152
static const struct regmap_config stm32_timers_regmap_cfg = {
13153
.reg_bits = 32,
14154
.val_bits = 32,
15155
.reg_stride = sizeof(u32),
16-
.max_register = 0x3fc,
156+
.max_register = STM32_TIMERS_MAX_REGISTERS,
17157
};
18158

19159
static void stm32_timers_get_arr_size(struct stm32_timers *ddata)
@@ -27,12 +167,45 @@ static void stm32_timers_get_arr_size(struct stm32_timers *ddata)
27167
regmap_write(ddata->regmap, TIM_ARR, 0x0);
28168
}
29169

170+
static void stm32_timers_dma_probe(struct device *dev,
171+
struct stm32_timers *ddata)
172+
{
173+
int i;
174+
char name[4];
175+
176+
init_completion(&ddata->dma.completion);
177+
mutex_init(&ddata->dma.lock);
178+
179+
/* Optional DMA support: get valid DMA channel(s) or NULL */
180+
for (i = STM32_TIMERS_DMA_CH1; i <= STM32_TIMERS_DMA_CH4; i++) {
181+
snprintf(name, ARRAY_SIZE(name), "ch%1d", i + 1);
182+
ddata->dma.chans[i] = dma_request_slave_channel(dev, name);
183+
}
184+
ddata->dma.chans[STM32_TIMERS_DMA_UP] =
185+
dma_request_slave_channel(dev, "up");
186+
ddata->dma.chans[STM32_TIMERS_DMA_TRIG] =
187+
dma_request_slave_channel(dev, "trig");
188+
ddata->dma.chans[STM32_TIMERS_DMA_COM] =
189+
dma_request_slave_channel(dev, "com");
190+
}
191+
192+
static void stm32_timers_dma_remove(struct device *dev,
193+
struct stm32_timers *ddata)
194+
{
195+
int i;
196+
197+
for (i = STM32_TIMERS_DMA_CH1; i < STM32_TIMERS_MAX_DMAS; i++)
198+
if (ddata->dma.chans[i])
199+
dma_release_channel(ddata->dma.chans[i]);
200+
}
201+
30202
static int stm32_timers_probe(struct platform_device *pdev)
31203
{
32204
struct device *dev = &pdev->dev;
33205
struct stm32_timers *ddata;
34206
struct resource *res;
35207
void __iomem *mmio;
208+
int ret;
36209

37210
ddata = devm_kzalloc(dev, sizeof(*ddata), GFP_KERNEL);
38211
if (!ddata)
@@ -43,6 +216,9 @@ static int stm32_timers_probe(struct platform_device *pdev)
43216
if (IS_ERR(mmio))
44217
return PTR_ERR(mmio);
45218

219+
/* Timer physical addr for DMA */
220+
ddata->dma.phys_base = res->start;
221+
46222
ddata->regmap = devm_regmap_init_mmio_clk(dev, "int", mmio,
47223
&stm32_timers_regmap_cfg);
48224
if (IS_ERR(ddata->regmap))
@@ -54,9 +230,29 @@ static int stm32_timers_probe(struct platform_device *pdev)
54230

55231
stm32_timers_get_arr_size(ddata);
56232

233+
stm32_timers_dma_probe(dev, ddata);
234+
57235
platform_set_drvdata(pdev, ddata);
58236

59-
return devm_of_platform_populate(&pdev->dev);
237+
ret = of_platform_populate(pdev->dev.of_node, NULL, NULL, &pdev->dev);
238+
if (ret)
239+
stm32_timers_dma_remove(dev, ddata);
240+
241+
return ret;
242+
}
243+
244+
static int stm32_timers_remove(struct platform_device *pdev)
245+
{
246+
struct stm32_timers *ddata = platform_get_drvdata(pdev);
247+
248+
/*
249+
* Don't use devm_ here: enfore of_platform_depopulate() happens before
250+
* DMA are released, to avoid race on DMA.
251+
*/
252+
of_platform_depopulate(&pdev->dev);
253+
stm32_timers_dma_remove(&pdev->dev, ddata);
254+
255+
return 0;
60256
}
61257

62258
static const struct of_device_id stm32_timers_of_match[] = {
@@ -67,6 +263,7 @@ MODULE_DEVICE_TABLE(of, stm32_timers_of_match);
67263

68264
static struct platform_driver stm32_timers_driver = {
69265
.probe = stm32_timers_probe,
266+
.remove = stm32_timers_remove,
70267
.driver = {
71268
.name = "stm32-timers",
72269
.of_match_table = stm32_timers_of_match,

0 commit comments

Comments
 (0)