root/drivers/media/i2c/wm8775.c

DEFINITIONS

1. to_state
2. to_sd
3. wm8775_write
4. wm8775_set_audio
5. wm8775_s_routing
6. wm8775_s_ctrl
7. wm8775_log_status
8. wm8775_s_frequency
9. wm8775_probe
10. wm8775_remove

   1 // SPDX-License-Identifier: GPL-2.0-or-later
   2 /*
   3  * wm8775 - driver version 0.0.1
   4  *
   5  * Copyright (C) 2004 Ulf Eklund <ivtv at eklund.to>
   6  *
   7  * Based on saa7115 driver
   8  *
   9  * Copyright (C) 2005 Hans Verkuil <hverkuil@xs4all.nl>
  10  * - Cleanup
  11  * - V4L2 API update
  12  * - sound fixes
  13  */
  14 
  15 #include <linux/module.h>
  16 #include <linux/types.h>
  17 #include <linux/slab.h>
  18 #include <linux/ioctl.h>
  19 #include <linux/uaccess.h>
  20 #include <linux/i2c.h>
  21 #include <linux/videodev2.h>
  22 #include <media/v4l2-device.h>
  23 #include <media/v4l2-ctrls.h>
  24 #include <media/i2c/wm8775.h>
  25 
  26 MODULE_DESCRIPTION("wm8775 driver");
  27 MODULE_AUTHOR("Ulf Eklund, Hans Verkuil");
  28 MODULE_LICENSE("GPL");
  29 
  30 
  31 
  32 /* ----------------------------------------------------------------------- */
  33 
  34 enum {
  35         R7 = 7, R11 = 11,
  36         R12, R13, R14, R15, R16, R17, R18, R19, R20, R21, R23 = 23,
  37         TOT_REGS
  38 };
  39 
  40 #define ALC_HOLD 0x85 /* R17: use zero cross detection, ALC hold time 42.6 ms */
  41 #define ALC_EN 0x100  /* R17: ALC enable */
  42 
  43 struct wm8775_state {
  44         struct v4l2_subdev sd;
  45         struct v4l2_ctrl_handler hdl;
  46         struct v4l2_ctrl *mute;
  47         struct v4l2_ctrl *vol;
  48         struct v4l2_ctrl *bal;
  49         struct v4l2_ctrl *loud;
  50         u8 input;               /* Last selected input (0-0xf) */
  51 };
  52 
  53 static inline struct wm8775_state *to_state(struct v4l2_subdev *sd)
  54 {
  55         return container_of(sd, struct wm8775_state, sd);
  56 }
  57 
  58 static inline struct v4l2_subdev *to_sd(struct v4l2_ctrl *ctrl)
  59 {
  60         return &container_of(ctrl->handler, struct wm8775_state, hdl)->sd;
  61 }
  62 
  63 static int wm8775_write(struct v4l2_subdev *sd, int reg, u16 val)
  64 {
  65         struct i2c_client *client = v4l2_get_subdevdata(sd);
  66         int i;
  67 
  68         if (reg < 0 || reg >= TOT_REGS) {
  69                 v4l2_err(sd, "Invalid register R%d\n", reg);
  70                 return -1;
  71         }
  72 
  73         for (i = 0; i < 3; i++)
  74                 if (i2c_smbus_write_byte_data(client,
  75                                 (reg << 1) | (val >> 8), val & 0xff) == 0)
  76                         return 0;
  77         v4l2_err(sd, "I2C: cannot write %03x to register R%d\n", val, reg);
  78         return -1;
  79 }
  80 
  81 static void wm8775_set_audio(struct v4l2_subdev *sd, int quietly)
  82 {
  83         struct wm8775_state *state = to_state(sd);
  84         u8 vol_l, vol_r;
  85         int muted = 0 != state->mute->val;
  86         u16 volume = (u16)state->vol->val;
  87         u16 balance = (u16)state->bal->val;
  88 
  89         /* normalize ( 65535 to 0 -> 255 to 0 (+24dB to -103dB) ) */
  90         vol_l = (min(65536 - balance, 32768) * volume) >> 23;
  91         vol_r = (min(balance, (u16)32768) * volume) >> 23;
  92 
  93         /* Mute */
  94         if (muted || quietly)
  95                 wm8775_write(sd, R21, 0x0c0 | state->input);
  96 
  97         wm8775_write(sd, R14, vol_l | 0x100); /* 0x100= Left channel ADC zero cross enable */
  98         wm8775_write(sd, R15, vol_r | 0x100); /* 0x100= Right channel ADC zero cross enable */
  99 
 100         /* Un-mute */
 101         if (!muted)
 102                 wm8775_write(sd, R21, state->input);
 103 }
 104 
 105 static int wm8775_s_routing(struct v4l2_subdev *sd,
 106                             u32 input, u32 output, u32 config)
 107 {
 108         struct wm8775_state *state = to_state(sd);
 109 
 110         /* There are 4 inputs and one output. Zero or more inputs
 111            are multiplexed together to the output. Hence there are
 112            16 combinations.
 113            If only one input is active (the normal case) then the
 114            input values 1, 2, 4 or 8 should be used. */
 115         if (input > 15) {
 116                 v4l2_err(sd, "Invalid input %d.\n", input);
 117                 return -EINVAL;
 118         }
 119         state->input = input;
 120         if (v4l2_ctrl_g_ctrl(state->mute))
 121                 return 0;
 122         if (!v4l2_ctrl_g_ctrl(state->vol))
 123                 return 0;
 124         wm8775_set_audio(sd, 1);
 125         return 0;
 126 }
 127 
 128 static int wm8775_s_ctrl(struct v4l2_ctrl *ctrl)
 129 {
 130         struct v4l2_subdev *sd = to_sd(ctrl);
 131 
 132         switch (ctrl->id) {
 133         case V4L2_CID_AUDIO_MUTE:
 134         case V4L2_CID_AUDIO_VOLUME:
 135         case V4L2_CID_AUDIO_BALANCE:
 136                 wm8775_set_audio(sd, 0);
 137                 return 0;
 138         case V4L2_CID_AUDIO_LOUDNESS:
 139                 wm8775_write(sd, R17, (ctrl->val ? ALC_EN : 0) | ALC_HOLD);
 140                 return 0;
 141         }
 142         return -EINVAL;
 143 }
 144 
 145 static int wm8775_log_status(struct v4l2_subdev *sd)
 146 {
 147         struct wm8775_state *state = to_state(sd);
 148 
 149         v4l2_info(sd, "Input: %d\n", state->input);
 150         v4l2_ctrl_handler_log_status(&state->hdl, sd->name);
 151         return 0;
 152 }
 153 
 154 static int wm8775_s_frequency(struct v4l2_subdev *sd, const struct v4l2_frequency *freq)
 155 {
 156         wm8775_set_audio(sd, 0);
 157         return 0;
 158 }
 159 
 160 /* ----------------------------------------------------------------------- */
 161 
 162 static const struct v4l2_ctrl_ops wm8775_ctrl_ops = {
 163         .s_ctrl = wm8775_s_ctrl,
 164 };
 165 
 166 static const struct v4l2_subdev_core_ops wm8775_core_ops = {
 167         .log_status = wm8775_log_status,
 168 };
 169 
 170 static const struct v4l2_subdev_tuner_ops wm8775_tuner_ops = {
 171         .s_frequency = wm8775_s_frequency,
 172 };
 173 
 174 static const struct v4l2_subdev_audio_ops wm8775_audio_ops = {
 175         .s_routing = wm8775_s_routing,
 176 };
 177 
 178 static const struct v4l2_subdev_ops wm8775_ops = {
 179         .core = &wm8775_core_ops,
 180         .tuner = &wm8775_tuner_ops,
 181         .audio = &wm8775_audio_ops,
 182 };
 183 
 184 /* ----------------------------------------------------------------------- */
 185 
 186 /* i2c implementation */
 187 
 188 /*
 189  * Generic i2c probe
 190  * concerning the addresses: i2c wants 7 bit (without the r/w bit), so '>>1'
 191  */
 192 
 193 static int wm8775_probe(struct i2c_client *client,
 194                         const struct i2c_device_id *id)
 195 {
 196         struct wm8775_state *state;
 197         struct v4l2_subdev *sd;
 198         int err;
 199         bool is_nova_s = false;
 200 
 201         if (client->dev.platform_data) {
 202                 struct wm8775_platform_data *data = client->dev.platform_data;
 203                 is_nova_s = data->is_nova_s;
 204         }
 205 
 206         /* Check if the adapter supports the needed features */
 207         if (!i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_BYTE_DATA))
 208                 return -EIO;
 209 
 210         v4l_info(client, "chip found @ 0x%02x (%s)\n",
 211                         client->addr << 1, client->adapter->name);
 212 
 213         state = devm_kzalloc(&client->dev, sizeof(*state), GFP_KERNEL);
 214         if (state == NULL)
 215                 return -ENOMEM;
 216         sd = &state->sd;
 217         v4l2_i2c_subdev_init(sd, client, &wm8775_ops);
 218         state->input = 2;
 219 
 220         v4l2_ctrl_handler_init(&state->hdl, 4);
 221         state->mute = v4l2_ctrl_new_std(&state->hdl, &wm8775_ctrl_ops,
 222                         V4L2_CID_AUDIO_MUTE, 0, 1, 1, 0);
 223         state->vol = v4l2_ctrl_new_std(&state->hdl, &wm8775_ctrl_ops,
 224                         V4L2_CID_AUDIO_VOLUME, 0, 65535, (65535+99)/100, 0xCF00); /* 0dB*/
 225         state->bal = v4l2_ctrl_new_std(&state->hdl, &wm8775_ctrl_ops,
 226                         V4L2_CID_AUDIO_BALANCE, 0, 65535, (65535+99)/100, 32768);
 227         state->loud = v4l2_ctrl_new_std(&state->hdl, &wm8775_ctrl_ops,
 228                         V4L2_CID_AUDIO_LOUDNESS, 0, 1, 1, 1);
 229         sd->ctrl_handler = &state->hdl;
 230         err = state->hdl.error;
 231         if (err) {
 232                 v4l2_ctrl_handler_free(&state->hdl);
 233                 return err;
 234         }
 235 
 236         /* Initialize wm8775 */
 237 
 238         /* RESET */
 239         wm8775_write(sd, R23, 0x000);
 240         /* Disable zero cross detect timeout */
 241         wm8775_write(sd, R7, 0x000);
 242         /* HPF enable, left justified, 24-bit (Philips) mode */
 243         wm8775_write(sd, R11, 0x021);
 244         /* Master mode, clock ratio 256fs */
 245         wm8775_write(sd, R12, 0x102);
 246         /* Powered up */
 247         wm8775_write(sd, R13, 0x000);
 248 
 249         if (!is_nova_s) {
 250                 /* ADC gain +2.5dB, enable zero cross */
 251                 wm8775_write(sd, R14, 0x1d4);
 252                 /* ADC gain +2.5dB, enable zero cross */
 253                 wm8775_write(sd, R15, 0x1d4);
 254                 /* ALC Stereo, ALC target level -1dB FS max gain +8dB */
 255                 wm8775_write(sd, R16, 0x1bf);
 256                 /* Enable gain control, use zero cross detection,
 257                    ALC hold time 42.6 ms */
 258                 wm8775_write(sd, R17, 0x185);
 259         } else {
 260                 /* ALC stereo, ALC target level -5dB FS, ALC max gain +8dB */
 261                 wm8775_write(sd, R16, 0x1bb);
 262                 /* Set ALC mode and hold time */
 263                 wm8775_write(sd, R17, (state->loud->val ? ALC_EN : 0) | ALC_HOLD);
 264         }
 265         /* ALC gain ramp up delay 34 s, ALC gain ramp down delay 33 ms */
 266         wm8775_write(sd, R18, 0x0a2);
 267         /* Enable noise gate, threshold -72dBfs */
 268         wm8775_write(sd, R19, 0x005);
 269         if (!is_nova_s) {
 270                 /* Transient window 4ms, lower PGA gain limit -1dB */
 271                 wm8775_write(sd, R20, 0x07a);
 272                 /* LRBOTH = 1, use input 2. */
 273                 wm8775_write(sd, R21, 0x102);
 274         } else {
 275                 /* Transient window 4ms, ALC min gain -5dB  */
 276                 wm8775_write(sd, R20, 0x0fb);
 277 
 278                 wm8775_set_audio(sd, 1);      /* set volume/mute/mux */
 279         }
 280         return 0;
 281 }
 282 
 283 static int wm8775_remove(struct i2c_client *client)
 284 {
 285         struct v4l2_subdev *sd = i2c_get_clientdata(client);
 286         struct wm8775_state *state = to_state(sd);
 287 
 288         v4l2_device_unregister_subdev(sd);
 289         v4l2_ctrl_handler_free(&state->hdl);
 290         return 0;
 291 }
 292 
 293 static const struct i2c_device_id wm8775_id[] = {
 294         { "wm8775", 0 },
 295         { }
 296 };
 297 MODULE_DEVICE_TABLE(i2c, wm8775_id);
 298 
 299 static struct i2c_driver wm8775_driver = {
 300         .driver = {
 301                 .name   = "wm8775",
 302         },
 303         .probe          = wm8775_probe,
 304         .remove         = wm8775_remove,
 305         .id_table       = wm8775_id,
 306 };
 307 
 308 module_i2c_driver(wm8775_driver);