drivers/media/radio/saa7706h.c

   1 // SPDX-License-Identifier: GPL-2.0-only
   2 /*
   3  * saa7706.c Philips SAA7706H Car Radio DSP driver
   4  * Copyright (c) 2009 Intel Corporation
   5  */
   6
   7 #include <linux/module.h>
   8 #include <linux/init.h>
   9 #include <linux/delay.h>
  10 #include <linux/errno.h>
  11 #include <linux/kernel.h>
  12 #include <linux/interrupt.h>
  13 #include <linux/i2c.h>
  14 #include <linux/slab.h>
  15 #include <media/v4l2-device.h>
  16 #include <media/v4l2-ctrls.h>
  17
  18 #define DRIVER_NAME "saa7706h"
  19
  20 /* the I2C memory map looks like this
  21
  22         $1C00 - $FFFF Not Used
  23         $2200 - $3FFF Reserved YRAM (DSP2) space
  24         $2000 - $21FF YRAM (DSP2)
  25         $1FF0 - $1FFF Hardware Registers
  26         $1280 - $1FEF Reserved XRAM (DSP2) space
  27         $1000 - $127F XRAM (DSP2)
  28         $0FFF        DSP CONTROL
  29         $0A00 - $0FFE Reserved
  30         $0980 - $09FF Reserved YRAM (DSP1) space
  31         $0800 - $097F YRAM (DSP1)
  32         $0200 - $07FF Not Used
  33         $0180 - $01FF Reserved XRAM (DSP1) space
  34         $0000 - $017F XRAM (DSP1)
  35 */
  36
  37 #define SAA7706H_REG_CTRL               0x0fff
  38 #define SAA7706H_CTRL_BYP_PLL           0x0001
  39 #define SAA7706H_CTRL_PLL_DIV_MASK      0x003e
  40 #define SAA7706H_CTRL_PLL3_62975MHZ     0x003e
  41 #define SAA7706H_CTRL_DSP_TURBO         0x0040
  42 #define SAA7706H_CTRL_PC_RESET_DSP1     0x0080
  43 #define SAA7706H_CTRL_PC_RESET_DSP2     0x0100
  44 #define SAA7706H_CTRL_DSP1_ROM_EN_MASK  0x0600
  45 #define SAA7706H_CTRL_DSP1_FUNC_PROM    0x0000
  46 #define SAA7706H_CTRL_DSP2_ROM_EN_MASK  0x1800
  47 #define SAA7706H_CTRL_DSP2_FUNC_PROM    0x0000
  48 #define SAA7706H_CTRL_DIG_SIL_INTERPOL  0x8000
  49
  50 #define SAA7706H_REG_EVALUATION                 0x1ff0
  51 #define SAA7706H_EVAL_DISABLE_CHARGE_PUMP       0x000001
  52 #define SAA7706H_EVAL_DCS_CLOCK                 0x000002
  53 #define SAA7706H_EVAL_GNDRC1_ENABLE             0x000004
  54 #define SAA7706H_EVAL_GNDRC2_ENABLE             0x000008
  55
  56 #define SAA7706H_REG_CL_GEN1                    0x1ff3
  57 #define SAA7706H_CL_GEN1_MIN_LOOPGAIN_MASK      0x00000f
  58 #define SAA7706H_CL_GEN1_LOOPGAIN_MASK          0x0000f0
  59 #define SAA7706H_CL_GEN1_COARSE_RATION          0xffff00
  60
  61 #define SAA7706H_REG_CL_GEN2                    0x1ff4
  62 #define SAA7706H_CL_GEN2_WSEDGE_FALLING         0x000001
  63 #define SAA7706H_CL_GEN2_STOP_VCO               0x000002
  64 #define SAA7706H_CL_GEN2_FRERUN                 0x000004
  65 #define SAA7706H_CL_GEN2_ADAPTIVE               0x000008
  66 #define SAA7706H_CL_GEN2_FINE_RATIO_MASK        0x0ffff0
  67
  68 #define SAA7706H_REG_CL_GEN4            0x1ff6
  69 #define SAA7706H_CL_GEN4_BYPASS_PLL1    0x001000
  70 #define SAA7706H_CL_GEN4_PLL1_DIV_MASK  0x03e000
  71 #define SAA7706H_CL_GEN4_DSP1_TURBO     0x040000
  72
  73 #define SAA7706H_REG_SEL        0x1ff7
  74 #define SAA7706H_SEL_DSP2_SRCA_MASK     0x000007
  75 #define SAA7706H_SEL_DSP2_FMTA_MASK     0x000031
  76 #define SAA7706H_SEL_DSP2_SRCB_MASK     0x0001c0
  77 #define SAA7706H_SEL_DSP2_FMTB_MASK     0x000e00
  78 #define SAA7706H_SEL_DSP1_SRC_MASK      0x003000
  79 #define SAA7706H_SEL_DSP1_FMT_MASK      0x01c003
  80 #define SAA7706H_SEL_SPDIF2             0x020000
  81 #define SAA7706H_SEL_HOST_IO_FMT_MASK   0x1c0000
  82 #define SAA7706H_SEL_EN_HOST_IO         0x200000
  83
  84 #define SAA7706H_REG_IAC                0x1ff8
  85 #define SAA7706H_REG_CLK_SET            0x1ff9
  86 #define SAA7706H_REG_CLK_COEFF          0x1ffa
  87 #define SAA7706H_REG_INPUT_SENS         0x1ffb
  88 #define SAA7706H_INPUT_SENS_RDS_VOL_MASK        0x0003f
  89 #define SAA7706H_INPUT_SENS_FM_VOL_MASK         0x00fc0
  90 #define SAA7706H_INPUT_SENS_FM_MPX              0x01000
  91 #define SAA7706H_INPUT_SENS_OFF_FILTER_A_EN     0x02000
  92 #define SAA7706H_INPUT_SENS_OFF_FILTER_B_EN     0x04000
  93 #define SAA7706H_REG_PHONE_NAV_AUDIO    0x1ffc
  94 #define SAA7706H_REG_IO_CONF_DSP2       0x1ffd
  95 #define SAA7706H_REG_STATUS_DSP2        0x1ffe
  96 #define SAA7706H_REG_PC_DSP2            0x1fff
  97
  98 #define SAA7706H_DSP1_MOD0      0x0800
  99 #define SAA7706H_DSP1_ROM_VER   0x097f
 100 #define SAA7706H_DSP2_MPTR0     0x1000
 101
 102 #define SAA7706H_DSP1_MODPNTR   0x0000
 103
 104 #define SAA7706H_DSP2_XMEM_CONTLLCW     0x113e
 105 #define SAA7706H_DSP2_XMEM_BUSAMP       0x114a
 106 #define SAA7706H_DSP2_XMEM_FDACPNTR     0x11f9
 107 #define SAA7706H_DSP2_XMEM_IIS1PNTR     0x11fb
 108
 109 #define SAA7706H_DSP2_YMEM_PVGA         0x212a
 110 #define SAA7706H_DSP2_YMEM_PVAT1        0x212b
 111 #define SAA7706H_DSP2_YMEM_PVAT         0x212c
 112 #define SAA7706H_DSP2_YMEM_ROM_VER      0x21ff
 113
 114 #define SUPPORTED_DSP1_ROM_VER          0x667
 115
 116 struct saa7706h_state {
 117         struct v4l2_subdev sd;
 118         struct v4l2_ctrl_handler hdl;
 119         unsigned muted;
 120 };
 121
 122 static inline struct saa7706h_state *to_state(struct v4l2_subdev *sd)
 123 {
 124         return container_of(sd, struct saa7706h_state, sd);
 125 }
 126
 127 static int saa7706h_i2c_send(struct i2c_client *client, const u8 *data, int len)
 128 {
 129         int err = i2c_master_send(client, data, len);
 130         if (err == len)
 131                 return 0;
 132         return err > 0 ? -EIO : err;
 133 }
 134
 135 static int saa7706h_i2c_transfer(struct i2c_client *client,
 136         struct i2c_msg *msgs, int num)
 137 {
 138         int err = i2c_transfer(client->adapter, msgs, num);
 139         if (err == num)
 140                 return 0;
 141         return err > 0 ? -EIO : err;
 142 }
 143
 144 static int saa7706h_set_reg24(struct v4l2_subdev *sd, u16 reg, u32 val)
 145 {
 146         struct i2c_client *client = v4l2_get_subdevdata(sd);
 147         u8 buf[5];
 148         int pos = 0;
 149
 150         buf[pos++] = reg >> 8;
 151         buf[pos++] = reg;
 152         buf[pos++] = val >> 16;
 153         buf[pos++] = val >> 8;
 154         buf[pos++] = val;
 155
 156         return saa7706h_i2c_send(client, buf, pos);
 157 }
 158
 159 static int saa7706h_set_reg24_err(struct v4l2_subdev *sd, u16 reg, u32 val,
 160         int *err)
 161 {
 162         return *err ? *err : saa7706h_set_reg24(sd, reg, val);
 163 }
 164
 165 static int saa7706h_set_reg16(struct v4l2_subdev *sd, u16 reg, u16 val)
 166 {
 167         struct i2c_client *client = v4l2_get_subdevdata(sd);
 168         u8 buf[4];
 169         int pos = 0;
 170
 171         buf[pos++] = reg >> 8;
 172         buf[pos++] = reg;
 173         buf[pos++] = val >> 8;
 174         buf[pos++] = val;
 175
 176         return saa7706h_i2c_send(client, buf, pos);
 177 }
 178
 179 static int saa7706h_set_reg16_err(struct v4l2_subdev *sd, u16 reg, u16 val,
 180         int *err)
 181 {
 182         return *err ? *err : saa7706h_set_reg16(sd, reg, val);
 183 }
 184
 185 static int saa7706h_get_reg16(struct v4l2_subdev *sd, u16 reg)
 186 {
 187         struct i2c_client *client = v4l2_get_subdevdata(sd);
 188         u8 buf[2];
 189         int err;
 190         u8 regaddr[] = {reg >> 8, reg};
 191         struct i2c_msg msg[] = {
 192                                         {
 193                                                 .addr = client->addr,
 194                                                 .len = sizeof(regaddr),
 195                                                 .buf = regaddr
 196                                         },
 197                                         {
 198                                                 .addr = client->addr,
 199                                                 .flags = I2C_M_RD,
 200                                                 .len = sizeof(buf),
 201                                                 .buf = buf
 202                                         }
 203                                 };
 204
 205         err = saa7706h_i2c_transfer(client, msg, ARRAY_SIZE(msg));
 206         if (err)
 207                 return err;
 208
 209         return buf[0] << 8 | buf[1];
 210 }
 211
 212 static int saa7706h_unmute(struct v4l2_subdev *sd)
 213 {
 214         struct saa7706h_state *state = to_state(sd);
 215         int err = 0;
 216
 217         err = saa7706h_set_reg16_err(sd, SAA7706H_REG_CTRL,
 218                 SAA7706H_CTRL_PLL3_62975MHZ | SAA7706H_CTRL_PC_RESET_DSP1 |
 219                 SAA7706H_CTRL_PC_RESET_DSP2, &err);
 220
 221         /* newer versions of the chip requires a small sleep after reset */
 222         msleep(1);
 223
 224         err = saa7706h_set_reg16_err(sd, SAA7706H_REG_CTRL,
 225                 SAA7706H_CTRL_PLL3_62975MHZ, &err);
 226
 227         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_EVALUATION, 0, &err);
 228
 229         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_CL_GEN1, 0x040022, &err);
 230
 231         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_CL_GEN2,
 232                 SAA7706H_CL_GEN2_WSEDGE_FALLING, &err);
 233
 234         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_CL_GEN4, 0x024080, &err);
 235
 236         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_SEL, 0x200080, &err);
 237
 238         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_IAC, 0xf4caed, &err);
 239
 240         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_CLK_SET, 0x124334, &err);
 241
 242         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_CLK_COEFF, 0x004a1a,
 243                 &err);
 244
 245         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_INPUT_SENS, 0x0071c7,
 246                 &err);
 247
 248         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_PHONE_NAV_AUDIO,
 249                 0x0e22ff, &err);
 250
 251         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_IO_CONF_DSP2, 0x001ff8,
 252                 &err);
 253
 254         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_STATUS_DSP2, 0x080003,
 255                 &err);
 256
 257         err = saa7706h_set_reg24_err(sd, SAA7706H_REG_PC_DSP2, 0x000004, &err);
 258
 259         err = saa7706h_set_reg16_err(sd, SAA7706H_DSP1_MOD0, 0x0c6c, &err);
 260
 261         err = saa7706h_set_reg24_err(sd, SAA7706H_DSP2_MPTR0, 0x000b4b, &err);
 262
 263         err = saa7706h_set_reg24_err(sd, SAA7706H_DSP1_MODPNTR, 0x000600, &err);
 264
 265         err = saa7706h_set_reg24_err(sd, SAA7706H_DSP1_MODPNTR, 0x0000c0, &err);
 266
 267         err = saa7706h_set_reg24_err(sd, SAA7706H_DSP2_XMEM_CONTLLCW, 0x000819,
 268                 &err);
 269
 270         err = saa7706h_set_reg24_err(sd, SAA7706H_DSP2_XMEM_CONTLLCW, 0x00085a,
 271                 &err);
 272
 273         err = saa7706h_set_reg24_err(sd, SAA7706H_DSP2_XMEM_BUSAMP, 0x7fffff,
 274                 &err);
 275
 276         err = saa7706h_set_reg24_err(sd, SAA7706H_DSP2_XMEM_FDACPNTR, 0x2000cb,
 277                 &err);
 278
 279         err = saa7706h_set_reg24_err(sd, SAA7706H_DSP2_XMEM_IIS1PNTR, 0x2000cb,
 280                 &err);
 281
 282         err = saa7706h_set_reg16_err(sd, SAA7706H_DSP2_YMEM_PVGA, 0x0f80, &err);
 283
 284         err = saa7706h_set_reg16_err(sd, SAA7706H_DSP2_YMEM_PVAT1, 0x0800,
 285                 &err);
 286
 287         err = saa7706h_set_reg16_err(sd, SAA7706H_DSP2_YMEM_PVAT, 0x0800, &err);
 288
 289         err = saa7706h_set_reg24_err(sd, SAA7706H_DSP2_XMEM_CONTLLCW, 0x000905,
 290                 &err);
 291         if (!err)
 292                 state->muted = 0;
 293         return err;
 294 }
 295
 296 static int saa7706h_mute(struct v4l2_subdev *sd)
 297 {
 298         struct saa7706h_state *state = to_state(sd);
 299         int err;
 300
 301         err = saa7706h_set_reg16(sd, SAA7706H_REG_CTRL,
 302                 SAA7706H_CTRL_PLL3_62975MHZ | SAA7706H_CTRL_PC_RESET_DSP1 |
 303                 SAA7706H_CTRL_PC_RESET_DSP2);
 304         if (!err)
 305                 state->muted = 1;
 306         return err;
 307 }
 308
 309 static int saa7706h_s_ctrl(struct v4l2_ctrl *ctrl)
 310 {
 311         struct saa7706h_state *state =
 312                 container_of(ctrl->handler, struct saa7706h_state, hdl);
 313
 314         switch (ctrl->id) {
 315         case V4L2_CID_AUDIO_MUTE:
 316                 if (ctrl->val)
 317                         return saa7706h_mute(&state->sd);
 318                 return saa7706h_unmute(&state->sd);
 319         }
 320         return -EINVAL;
 321 }
 322
 323 static const struct v4l2_ctrl_ops saa7706h_ctrl_ops = {
 324         .s_ctrl = saa7706h_s_ctrl,
 325 };
 326
 327 static const struct v4l2_subdev_ops empty_ops = {};
 328
 329 /*
 330  * Generic i2c probe
 331  * concerning the addresses: i2c wants 7 bit (without the r/w bit), so '>>1'
 332  */
 333
 334 static int saa7706h_probe(struct i2c_client *client,
 335                           const struct i2c_device_id *id)
 336 {
 337         struct saa7706h_state *state;
 338         struct v4l2_subdev *sd;
 339         int err;
 340
 341         /* Check if the adapter supports the needed features */
 342         if (!i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_BYTE_DATA))
 343                 return -EIO;
 344
 345         v4l_info(client, "chip found @ 0x%02x (%s)\n",
 346                         client->addr << 1, client->adapter->name);
 347
 348         state = kzalloc(sizeof(struct saa7706h_state), GFP_KERNEL);
 349         if (state == NULL)
 350                 return -ENOMEM;
 351         sd = &state->sd;
 352         v4l2_i2c_subdev_init(sd, client, &empty_ops);
 353
 354         v4l2_ctrl_handler_init(&state->hdl, 4);
 355         v4l2_ctrl_new_std(&state->hdl, &saa7706h_ctrl_ops,
 356                         V4L2_CID_AUDIO_MUTE, 0, 1, 1, 1);
 357         sd->ctrl_handler = &state->hdl;
 358         err = state->hdl.error;
 359         if (err)
 360                 goto err;
 361
 362         /* check the rom versions */
 363         err = saa7706h_get_reg16(sd, SAA7706H_DSP1_ROM_VER);
 364         if (err < 0)
 365                 goto err;
 366         if (err != SUPPORTED_DSP1_ROM_VER)
 367                 v4l2_warn(sd, "Unknown DSP1 ROM code version: 0x%x\n", err);
 368         state->muted = 1;
 369
 370         /* startup in a muted state */
 371         err = saa7706h_mute(sd);
 372         if (err)
 373                 goto err;
 374
 375         return 0;
 376
 377 err:
 378         v4l2_device_unregister_subdev(sd);
 379         v4l2_ctrl_handler_free(&state->hdl);
 380         kfree(to_state(sd));
 381
 382         printk(KERN_ERR DRIVER_NAME ": Failed to probe: %d\n", err);
 383
 384         return err;
 385 }
 386
 387 static int saa7706h_remove(struct i2c_client *client)
 388 {
 389         struct v4l2_subdev *sd = i2c_get_clientdata(client);
 390         struct saa7706h_state *state = to_state(sd);
 391
 392         saa7706h_mute(sd);
 393         v4l2_device_unregister_subdev(sd);
 394         v4l2_ctrl_handler_free(&state->hdl);
 395         kfree(to_state(sd));
 396         return 0;
 397 }
 398
 399 static const struct i2c_device_id saa7706h_id[] = {
 400         {DRIVER_NAME, 0},
 401         {},
 402 };
 403
 404 MODULE_DEVICE_TABLE(i2c, saa7706h_id);
 405
 406 static struct i2c_driver saa7706h_driver = {
 407         .driver = {
 408                 .name   = DRIVER_NAME,
 409         },
 410         .probe          = saa7706h_probe,
 411         .remove         = saa7706h_remove,
 412         .id_table       = saa7706h_id,
 413 };
 414
 415 module_i2c_driver(saa7706h_driver);
 416
 417 MODULE_DESCRIPTION("SAA7706H Car Radio DSP driver");
 418 MODULE_AUTHOR("Mocean Laboratories");
 419 MODULE_LICENSE("GPL v2");