1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3 * Driver for Mediatek IR Receiver Controller
4 *
5 * Copyright (C) 2017 Sean Wang <sean.wang@mediatek.com>
6 */
7
8 #include <linux/clk.h>
9 #include <linux/interrupt.h>
10 #include <linux/module.h>
11 #include <linux/of_platform.h>
12 #include <linux/reset.h>
13 #include <media/rc-core.h>
14
15 #define MTK_IR_DEV KBUILD_MODNAME
16
17 /* Register to enable PWM and IR */
18 #define MTK_CONFIG_HIGH_REG 0x0c
19
20 /* Bit to enable IR pulse width detection */
21 #define MTK_PWM_EN BIT(13)
22
23 /*
24 * Register to setting ok count whose unit based on hardware sampling period
25 * indicating IR receiving completion and then making IRQ fires
26 */
27 #define MTK_OK_COUNT(x) (((x) & GENMASK(23, 16)) << 16)
28
29 /* Bit to enable IR hardware function */
30 #define MTK_IR_EN BIT(0)
31
32 /* Bit to restart IR receiving */
33 #define MTK_IRCLR BIT(0)
34
35 /* Fields containing pulse width data */
36 #define MTK_WIDTH_MASK (GENMASK(7, 0))
37
38 /* IR threshold */
39 #define MTK_IRTHD 0x14
40 #define MTK_DG_CNT_MASK (GENMASK(12, 8))
41 #define MTK_DG_CNT(x) ((x) << 8)
42
43 /* Bit to enable interrupt */
44 #define MTK_IRINT_EN BIT(0)
45
46 /* Bit to clear interrupt status */
47 #define MTK_IRINT_CLR BIT(0)
48
49 /* Maximum count of samples */
50 #define MTK_MAX_SAMPLES 0xff
51 /* Indicate the end of IR message */
52 #define MTK_IR_END(v, p) ((v) == MTK_MAX_SAMPLES && (p) == 0)
53 /* Number of registers to record the pulse width */
54 #define MTK_CHKDATA_SZ 17
55 /* Sample period in us */
56 #define MTK_IR_SAMPLE 46
57
58 enum mtk_fields {
59 /* Register to setting software sampling period */
60 MTK_CHK_PERIOD,
61 /* Register to setting hardware sampling period */
62 MTK_HW_PERIOD,
63 };
64
65 enum mtk_regs {
66 /* Register to clear state of state machine */
67 MTK_IRCLR_REG,
68 /* Register containing pulse width data */
69 MTK_CHKDATA_REG,
70 /* Register to enable IR interrupt */
71 MTK_IRINT_EN_REG,
72 /* Register to ack IR interrupt */
73 MTK_IRINT_CLR_REG
74 };
75
76 static const u32 mt7623_regs[] = {
77 [MTK_IRCLR_REG] = 0x20,
78 [MTK_CHKDATA_REG] = 0x88,
79 [MTK_IRINT_EN_REG] = 0xcc,
80 [MTK_IRINT_CLR_REG] = 0xd0,
81 };
82
83 static const u32 mt7622_regs[] = {
84 [MTK_IRCLR_REG] = 0x18,
85 [MTK_CHKDATA_REG] = 0x30,
86 [MTK_IRINT_EN_REG] = 0x1c,
87 [MTK_IRINT_CLR_REG] = 0x20,
88 };
89
90 struct mtk_field_type {
91 u32 reg;
92 u8 offset;
93 u32 mask;
94 };
95
96 /*
97 * struct mtk_ir_data - This is the structure holding all differences among
98 various hardwares
99 * @regs: The pointer to the array holding registers offset
100 * @fields: The pointer to the array holding fields location
101 * @div: The internal divisor for the based reference clock
102 * @ok_count: The count indicating the completion of IR data
103 * receiving when count is reached
104 * @hw_period: The value indicating the hardware sampling period
105 */
106 struct mtk_ir_data {
107 const u32 *regs;
108 const struct mtk_field_type *fields;
109 u8 div;
110 u8 ok_count;
111 u32 hw_period;
112 };
113
114 static const struct mtk_field_type mt7623_fields[] = {
115 [MTK_CHK_PERIOD] = {0x10, 8, GENMASK(20, 8)},
116 [MTK_HW_PERIOD] = {0x10, 0, GENMASK(7, 0)},
117 };
118
119 static const struct mtk_field_type mt7622_fields[] = {
120 [MTK_CHK_PERIOD] = {0x24, 0, GENMASK(24, 0)},
121 [MTK_HW_PERIOD] = {0x10, 0, GENMASK(24, 0)},
122 };
123
124 /*
125 * struct mtk_ir - This is the main datasructure for holding the state
126 * of the driver
127 * @dev: The device pointer
128 * @rc: The rc instrance
129 * @base: The mapped register i/o base
130 * @irq: The IRQ that we are using
131 * @clk: The clock that IR internal is using
132 * @bus: The clock that software decoder is using
133 * @data: Holding specific data for vaious platform
134 */
135 struct mtk_ir {
136 struct device *dev;
137 struct rc_dev *rc;
138 void __iomem *base;
139 int irq;
140 struct clk *clk;
141 struct clk *bus;
142 const struct mtk_ir_data *data;
143 };
144
mtk_chkdata_reg(struct mtk_ir * ir,u32 i)145 static inline u32 mtk_chkdata_reg(struct mtk_ir *ir, u32 i)
146 {
147 return ir->data->regs[MTK_CHKDATA_REG] + 4 * i;
148 }
149
mtk_chk_period(struct mtk_ir * ir)150 static inline u32 mtk_chk_period(struct mtk_ir *ir)
151 {
152 u32 val;
153
154 /*
155 * Period for software decoder used in the
156 * unit of raw software sampling
157 */
158 val = DIV_ROUND_CLOSEST(clk_get_rate(ir->bus),
159 USEC_PER_SEC * ir->data->div / MTK_IR_SAMPLE);
160
161 dev_dbg(ir->dev, "@pwm clk = \t%lu\n",
162 clk_get_rate(ir->bus) / ir->data->div);
163 dev_dbg(ir->dev, "@chkperiod = %08x\n", val);
164
165 return val;
166 }
167
mtk_w32_mask(struct mtk_ir * ir,u32 val,u32 mask,unsigned int reg)168 static void mtk_w32_mask(struct mtk_ir *ir, u32 val, u32 mask, unsigned int reg)
169 {
170 u32 tmp;
171
172 tmp = __raw_readl(ir->base + reg);
173 tmp = (tmp & ~mask) | val;
174 __raw_writel(tmp, ir->base + reg);
175 }
176
mtk_w32(struct mtk_ir * ir,u32 val,unsigned int reg)177 static void mtk_w32(struct mtk_ir *ir, u32 val, unsigned int reg)
178 {
179 __raw_writel(val, ir->base + reg);
180 }
181
mtk_r32(struct mtk_ir * ir,unsigned int reg)182 static u32 mtk_r32(struct mtk_ir *ir, unsigned int reg)
183 {
184 return __raw_readl(ir->base + reg);
185 }
186
mtk_irq_disable(struct mtk_ir * ir,u32 mask)187 static inline void mtk_irq_disable(struct mtk_ir *ir, u32 mask)
188 {
189 u32 val;
190
191 val = mtk_r32(ir, ir->data->regs[MTK_IRINT_EN_REG]);
192 mtk_w32(ir, val & ~mask, ir->data->regs[MTK_IRINT_EN_REG]);
193 }
194
mtk_irq_enable(struct mtk_ir * ir,u32 mask)195 static inline void mtk_irq_enable(struct mtk_ir *ir, u32 mask)
196 {
197 u32 val;
198
199 val = mtk_r32(ir, ir->data->regs[MTK_IRINT_EN_REG]);
200 mtk_w32(ir, val | mask, ir->data->regs[MTK_IRINT_EN_REG]);
201 }
202
mtk_ir_irq(int irqno,void * dev_id)203 static irqreturn_t mtk_ir_irq(int irqno, void *dev_id)
204 {
205 struct mtk_ir *ir = dev_id;
206 u8 wid = 0;
207 u32 i, j, val;
208 struct ir_raw_event rawir = {};
209
210 /*
211 * Reset decoder state machine explicitly is required
212 * because 1) the longest duration for space MTK IR hardware
213 * could record is not safely long. e.g 12ms if rx resolution
214 * is 46us by default. There is still the risk to satisfying
215 * every decoder to reset themselves through long enough
216 * trailing spaces and 2) the IRQ handler guarantees that
217 * start of IR message is always contained in and starting
218 * from register mtk_chkdata_reg(ir, i).
219 */
220 ir_raw_event_reset(ir->rc);
221
222 /* First message must be pulse */
223 rawir.pulse = false;
224
225 /* Handle all pulse and space IR controller captures */
226 for (i = 0 ; i < MTK_CHKDATA_SZ ; i++) {
227 val = mtk_r32(ir, mtk_chkdata_reg(ir, i));
228 dev_dbg(ir->dev, "@reg%d=0x%08x\n", i, val);
229
230 for (j = 0 ; j < 4 ; j++) {
231 wid = (val & (MTK_WIDTH_MASK << j * 8)) >> j * 8;
232 rawir.pulse = !rawir.pulse;
233 rawir.duration = wid * (MTK_IR_SAMPLE + 1);
234 ir_raw_event_store_with_filter(ir->rc, &rawir);
235 }
236 }
237
238 /*
239 * The maximum number of edges the IR controller can
240 * hold is MTK_CHKDATA_SZ * 4. So if received IR messages
241 * is over the limit, the last incomplete IR message would
242 * be appended trailing space and still would be sent into
243 * ir-rc-raw to decode. That helps it is possible that it
244 * has enough information to decode a scancode even if the
245 * trailing end of the message is missing.
246 */
247 if (!MTK_IR_END(wid, rawir.pulse)) {
248 rawir.pulse = false;
249 rawir.duration = MTK_MAX_SAMPLES * (MTK_IR_SAMPLE + 1);
250 ir_raw_event_store_with_filter(ir->rc, &rawir);
251 }
252
253 ir_raw_event_handle(ir->rc);
254
255 /*
256 * Restart controller for the next receive that would
257 * clear up all CHKDATA registers
258 */
259 mtk_w32_mask(ir, 0x1, MTK_IRCLR, ir->data->regs[MTK_IRCLR_REG]);
260
261 /* Clear interrupt status */
262 mtk_w32_mask(ir, 0x1, MTK_IRINT_CLR,
263 ir->data->regs[MTK_IRINT_CLR_REG]);
264
265 return IRQ_HANDLED;
266 }
267
268 static const struct mtk_ir_data mt7623_data = {
269 .regs = mt7623_regs,
270 .fields = mt7623_fields,
271 .ok_count = 0xf,
272 .hw_period = 0xff,
273 .div = 4,
274 };
275
276 static const struct mtk_ir_data mt7622_data = {
277 .regs = mt7622_regs,
278 .fields = mt7622_fields,
279 .ok_count = 0xf,
280 .hw_period = 0xffff,
281 .div = 32,
282 };
283
284 static const struct of_device_id mtk_ir_match[] = {
285 { .compatible = "mediatek,mt7623-cir", .data = &mt7623_data},
286 { .compatible = "mediatek,mt7622-cir", .data = &mt7622_data},
287 {},
288 };
289 MODULE_DEVICE_TABLE(of, mtk_ir_match);
290
mtk_ir_probe(struct platform_device * pdev)291 static int mtk_ir_probe(struct platform_device *pdev)
292 {
293 struct device *dev = &pdev->dev;
294 struct device_node *dn = dev->of_node;
295 struct mtk_ir *ir;
296 u32 val;
297 int ret = 0;
298 const char *map_name;
299
300 ir = devm_kzalloc(dev, sizeof(struct mtk_ir), GFP_KERNEL);
301 if (!ir)
302 return -ENOMEM;
303
304 ir->dev = dev;
305 ir->data = of_device_get_match_data(dev);
306
307 ir->clk = devm_clk_get(dev, "clk");
308 if (IS_ERR(ir->clk)) {
309 dev_err(dev, "failed to get a ir clock.\n");
310 return PTR_ERR(ir->clk);
311 }
312
313 ir->bus = devm_clk_get(dev, "bus");
314 if (IS_ERR(ir->bus)) {
315 /*
316 * For compatibility with older device trees try unnamed
317 * ir->bus uses the same clock as ir->clock.
318 */
319 ir->bus = ir->clk;
320 }
321
322 ir->base = devm_platform_ioremap_resource(pdev, 0);
323 if (IS_ERR(ir->base))
324 return PTR_ERR(ir->base);
325
326 ir->rc = devm_rc_allocate_device(dev, RC_DRIVER_IR_RAW);
327 if (!ir->rc) {
328 dev_err(dev, "failed to allocate device\n");
329 return -ENOMEM;
330 }
331
332 ir->rc->priv = ir;
333 ir->rc->device_name = MTK_IR_DEV;
334 ir->rc->input_phys = MTK_IR_DEV "/input0";
335 ir->rc->input_id.bustype = BUS_HOST;
336 ir->rc->input_id.vendor = 0x0001;
337 ir->rc->input_id.product = 0x0001;
338 ir->rc->input_id.version = 0x0001;
339 map_name = of_get_property(dn, "linux,rc-map-name", NULL);
340 ir->rc->map_name = map_name ?: RC_MAP_EMPTY;
341 ir->rc->dev.parent = dev;
342 ir->rc->driver_name = MTK_IR_DEV;
343 ir->rc->allowed_protocols = RC_PROTO_BIT_ALL_IR_DECODER;
344 ir->rc->rx_resolution = MTK_IR_SAMPLE;
345 ir->rc->timeout = MTK_MAX_SAMPLES * (MTK_IR_SAMPLE + 1);
346
347 ret = devm_rc_register_device(dev, ir->rc);
348 if (ret) {
349 dev_err(dev, "failed to register rc device\n");
350 return ret;
351 }
352
353 platform_set_drvdata(pdev, ir);
354
355 ir->irq = platform_get_irq(pdev, 0);
356 if (ir->irq < 0)
357 return -ENODEV;
358
359 if (clk_prepare_enable(ir->clk)) {
360 dev_err(dev, "try to enable ir_clk failed\n");
361 return -EINVAL;
362 }
363
364 if (clk_prepare_enable(ir->bus)) {
365 dev_err(dev, "try to enable ir_clk failed\n");
366 ret = -EINVAL;
367 goto exit_clkdisable_clk;
368 }
369
370 /*
371 * Enable interrupt after proper hardware
372 * setup and IRQ handler registration
373 */
374 mtk_irq_disable(ir, MTK_IRINT_EN);
375
376 ret = devm_request_irq(dev, ir->irq, mtk_ir_irq, 0, MTK_IR_DEV, ir);
377 if (ret) {
378 dev_err(dev, "failed request irq\n");
379 goto exit_clkdisable_bus;
380 }
381
382 /*
383 * Setup software sample period as the reference of software decoder
384 */
385 val = (mtk_chk_period(ir) << ir->data->fields[MTK_CHK_PERIOD].offset) &
386 ir->data->fields[MTK_CHK_PERIOD].mask;
387 mtk_w32_mask(ir, val, ir->data->fields[MTK_CHK_PERIOD].mask,
388 ir->data->fields[MTK_CHK_PERIOD].reg);
389
390 /*
391 * Setup hardware sampling period used to setup the proper timeout for
392 * indicating end of IR receiving completion
393 */
394 val = (ir->data->hw_period << ir->data->fields[MTK_HW_PERIOD].offset) &
395 ir->data->fields[MTK_HW_PERIOD].mask;
396 mtk_w32_mask(ir, val, ir->data->fields[MTK_HW_PERIOD].mask,
397 ir->data->fields[MTK_HW_PERIOD].reg);
398
399 /* Set de-glitch counter */
400 mtk_w32_mask(ir, MTK_DG_CNT(1), MTK_DG_CNT_MASK, MTK_IRTHD);
401
402 /* Enable IR and PWM */
403 val = mtk_r32(ir, MTK_CONFIG_HIGH_REG);
404 val |= MTK_OK_COUNT(ir->data->ok_count) | MTK_PWM_EN | MTK_IR_EN;
405 mtk_w32(ir, val, MTK_CONFIG_HIGH_REG);
406
407 mtk_irq_enable(ir, MTK_IRINT_EN);
408
409 dev_info(dev, "Initialized MT7623 IR driver, sample period = %dus\n",
410 MTK_IR_SAMPLE);
411
412 return 0;
413
414 exit_clkdisable_bus:
415 clk_disable_unprepare(ir->bus);
416 exit_clkdisable_clk:
417 clk_disable_unprepare(ir->clk);
418
419 return ret;
420 }
421
mtk_ir_remove(struct platform_device * pdev)422 static int mtk_ir_remove(struct platform_device *pdev)
423 {
424 struct mtk_ir *ir = platform_get_drvdata(pdev);
425
426 /*
427 * Avoid contention between remove handler and
428 * IRQ handler so that disabling IR interrupt and
429 * waiting for pending IRQ handler to complete
430 */
431 mtk_irq_disable(ir, MTK_IRINT_EN);
432 synchronize_irq(ir->irq);
433
434 clk_disable_unprepare(ir->bus);
435 clk_disable_unprepare(ir->clk);
436
437 return 0;
438 }
439
440 static struct platform_driver mtk_ir_driver = {
441 .probe = mtk_ir_probe,
442 .remove = mtk_ir_remove,
443 .driver = {
444 .name = MTK_IR_DEV,
445 .of_match_table = mtk_ir_match,
446 },
447 };
448
449 module_platform_driver(mtk_ir_driver);
450
451 MODULE_DESCRIPTION("Mediatek IR Receiver Controller Driver");
452 MODULE_AUTHOR("Sean Wang <sean.wang@mediatek.com>");
453 MODULE_LICENSE("GPL");
454