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