xref: /linux/drivers/media/i2c/wm8775.c (revision 44f57d78)
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);
309