Merge branch 'for-4.20' of git://git.kernel.org/pub/scm/linux/kernel/git/dennis/percpu
[linux-2.6-block.git] / drivers / gpu / drm / i2c / tda9950.c
CommitLineData
f0316f93
RK
1/*
2 * TDA9950 Consumer Electronics Control driver
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License version 2 as
6 * published by the Free Software Foundation.
7 *
8 * The NXP TDA9950 implements the HDMI Consumer Electronics Control
9 * interface. The host interface is similar to a mailbox: the data
10 * registers starting at REG_CDR0 are written to send a command to the
11 * internal CPU, and replies are read from these registers.
12 *
13 * As the data registers represent a mailbox, they must be accessed
14 * as a single I2C transaction. See the TDA9950 data sheet for details.
15 */
16#include <linux/delay.h>
17#include <linux/i2c.h>
18#include <linux/interrupt.h>
19#include <linux/module.h>
20#include <linux/platform_data/tda9950.h>
21#include <linux/slab.h>
22#include <drm/drm_edid.h>
23#include <media/cec.h>
24#include <media/cec-notifier.h>
25
26enum {
27 REG_CSR = 0x00,
28 CSR_BUSY = BIT(7),
29 CSR_INT = BIT(6),
30 CSR_ERR = BIT(5),
31
32 REG_CER = 0x01,
33
34 REG_CVR = 0x02,
35
36 REG_CCR = 0x03,
37 CCR_RESET = BIT(7),
38 CCR_ON = BIT(6),
39
40 REG_ACKH = 0x04,
41 REG_ACKL = 0x05,
42
43 REG_CCONR = 0x06,
44 CCONR_ENABLE_ERROR = BIT(4),
45 CCONR_RETRY_MASK = 7,
46
47 REG_CDR0 = 0x07,
48
49 CDR1_REQ = 0x00,
50 CDR1_CNF = 0x01,
51 CDR1_IND = 0x81,
52 CDR1_ERR = 0x82,
53 CDR1_IER = 0x83,
54
55 CDR2_CNF_SUCCESS = 0x00,
56 CDR2_CNF_OFF_STATE = 0x80,
57 CDR2_CNF_BAD_REQ = 0x81,
58 CDR2_CNF_CEC_ACCESS = 0x82,
59 CDR2_CNF_ARB_ERROR = 0x83,
60 CDR2_CNF_BAD_TIMING = 0x84,
61 CDR2_CNF_NACK_ADDR = 0x85,
62 CDR2_CNF_NACK_DATA = 0x86,
63};
64
65struct tda9950_priv {
66 struct i2c_client *client;
67 struct device *hdmi;
68 struct cec_adapter *adap;
69 struct tda9950_glue *glue;
70 u16 addresses;
71 struct cec_msg rx_msg;
72 struct cec_notifier *notify;
73 bool open;
74};
75
76static int tda9950_write_range(struct i2c_client *client, u8 addr, u8 *p, int cnt)
77{
78 struct i2c_msg msg;
699112f5 79 u8 buf[CEC_MAX_MSG_SIZE + 3];
f0316f93
RK
80 int ret;
81
699112f5
KC
82 if (WARN_ON(cnt > sizeof(buf) - 1))
83 return -EINVAL;
84
f0316f93
RK
85 buf[0] = addr;
86 memcpy(buf + 1, p, cnt);
87
88 msg.addr = client->addr;
89 msg.flags = 0;
90 msg.len = cnt + 1;
91 msg.buf = buf;
92
93 dev_dbg(&client->dev, "wr 0x%02x: %*ph\n", addr, cnt, p);
94
95 ret = i2c_transfer(client->adapter, &msg, 1);
96 if (ret < 0)
97 dev_err(&client->dev, "Error %d writing to cec:0x%x\n", ret, addr);
98 return ret < 0 ? ret : 0;
99}
100
101static void tda9950_write(struct i2c_client *client, u8 addr, u8 val)
102{
103 tda9950_write_range(client, addr, &val, 1);
104}
105
106static int tda9950_read_range(struct i2c_client *client, u8 addr, u8 *p, int cnt)
107{
108 struct i2c_msg msg[2];
109 int ret;
110
111 msg[0].addr = client->addr;
112 msg[0].flags = 0;
113 msg[0].len = 1;
114 msg[0].buf = &addr;
115 msg[1].addr = client->addr;
116 msg[1].flags = I2C_M_RD;
117 msg[1].len = cnt;
118 msg[1].buf = p;
119
120 ret = i2c_transfer(client->adapter, msg, 2);
121 if (ret < 0)
122 dev_err(&client->dev, "Error %d reading from cec:0x%x\n", ret, addr);
123
124 dev_dbg(&client->dev, "rd 0x%02x: %*ph\n", addr, cnt, p);
125
126 return ret;
127}
128
129static u8 tda9950_read(struct i2c_client *client, u8 addr)
130{
131 int ret;
132 u8 val;
133
134 ret = tda9950_read_range(client, addr, &val, 1);
135 if (ret < 0)
136 val = 0;
137
138 return val;
139}
140
141static irqreturn_t tda9950_irq(int irq, void *data)
142{
143 struct tda9950_priv *priv = data;
144 unsigned int tx_status;
145 u8 csr, cconr, buf[19];
146 u8 arb_lost_cnt, nack_cnt, err_cnt;
147
148 if (!priv->open)
149 return IRQ_NONE;
150
151 csr = tda9950_read(priv->client, REG_CSR);
152 if (!(csr & CSR_INT))
153 return IRQ_NONE;
154
155 cconr = tda9950_read(priv->client, REG_CCONR) & CCONR_RETRY_MASK;
156
157 tda9950_read_range(priv->client, REG_CDR0, buf, sizeof(buf));
158
159 /*
160 * This should never happen: the data sheet says that there will
161 * always be a valid message if the interrupt line is asserted.
162 */
163 if (buf[0] == 0) {
164 dev_warn(&priv->client->dev, "interrupt pending, but no message?\n");
165 return IRQ_NONE;
166 }
167
168 switch (buf[1]) {
169 case CDR1_CNF: /* transmit result */
170 arb_lost_cnt = nack_cnt = err_cnt = 0;
171 switch (buf[2]) {
172 case CDR2_CNF_SUCCESS:
173 tx_status = CEC_TX_STATUS_OK;
174 break;
175
176 case CDR2_CNF_ARB_ERROR:
177 tx_status = CEC_TX_STATUS_ARB_LOST;
178 arb_lost_cnt = cconr;
179 break;
180
181 case CDR2_CNF_NACK_ADDR:
182 tx_status = CEC_TX_STATUS_NACK;
183 nack_cnt = cconr;
184 break;
185
186 default: /* some other error, refer to TDA9950 docs */
187 dev_err(&priv->client->dev, "CNF reply error 0x%02x\n",
188 buf[2]);
189 tx_status = CEC_TX_STATUS_ERROR;
190 err_cnt = cconr;
191 break;
192 }
193 /* TDA9950 executes all retries for us */
e0dccce1
HV
194 if (tx_status != CEC_TX_STATUS_OK)
195 tx_status |= CEC_TX_STATUS_MAX_RETRIES;
f0316f93
RK
196 cec_transmit_done(priv->adap, tx_status, arb_lost_cnt,
197 nack_cnt, 0, err_cnt);
198 break;
199
200 case CDR1_IND:
201 priv->rx_msg.len = buf[0] - 2;
202 if (priv->rx_msg.len > CEC_MAX_MSG_SIZE)
203 priv->rx_msg.len = CEC_MAX_MSG_SIZE;
204
205 memcpy(priv->rx_msg.msg, buf + 2, priv->rx_msg.len);
206 cec_received_msg(priv->adap, &priv->rx_msg);
207 break;
208
209 default: /* unknown */
210 dev_err(&priv->client->dev, "unknown service id 0x%02x\n",
211 buf[1]);
212 break;
213 }
214
215 return IRQ_HANDLED;
216}
217
218static int tda9950_cec_transmit(struct cec_adapter *adap, u8 attempts,
219 u32 signal_free_time, struct cec_msg *msg)
220{
221 struct tda9950_priv *priv = adap->priv;
222 u8 buf[CEC_MAX_MSG_SIZE + 2];
223
224 buf[0] = 2 + msg->len;
225 buf[1] = CDR1_REQ;
226 memcpy(buf + 2, msg->msg, msg->len);
227
228 if (attempts > 5)
229 attempts = 5;
230
231 tda9950_write(priv->client, REG_CCONR, attempts);
232
233 return tda9950_write_range(priv->client, REG_CDR0, buf, 2 + msg->len);
234}
235
236static int tda9950_cec_adap_log_addr(struct cec_adapter *adap, u8 addr)
237{
238 struct tda9950_priv *priv = adap->priv;
239 u16 addresses;
240 u8 buf[2];
241
242 if (addr == CEC_LOG_ADDR_INVALID)
243 addresses = priv->addresses = 0;
244 else
245 addresses = priv->addresses |= BIT(addr);
246
247 /* TDA9950 doesn't want address 15 set */
248 addresses &= 0x7fff;
249 buf[0] = addresses >> 8;
250 buf[1] = addresses;
251
252 return tda9950_write_range(priv->client, REG_ACKH, buf, 2);
253}
254
255/*
256 * When operating as part of the TDA998x, we need additional handling
257 * to initialise and shut down the TDA9950 part of the device. These
258 * two hooks are provided to allow the TDA998x code to perform those
259 * activities.
260 */
261static int tda9950_glue_open(struct tda9950_priv *priv)
262{
263 int ret = 0;
264
265 if (priv->glue && priv->glue->open)
266 ret = priv->glue->open(priv->glue->data);
267
268 priv->open = true;
269
270 return ret;
271}
272
273static void tda9950_glue_release(struct tda9950_priv *priv)
274{
275 priv->open = false;
276
277 if (priv->glue && priv->glue->release)
278 priv->glue->release(priv->glue->data);
279}
280
281static int tda9950_open(struct tda9950_priv *priv)
282{
283 struct i2c_client *client = priv->client;
284 int ret;
285
286 ret = tda9950_glue_open(priv);
287 if (ret)
288 return ret;
289
290 /* Reset the TDA9950, and wait 250ms for it to recover */
291 tda9950_write(client, REG_CCR, CCR_RESET);
292 msleep(250);
293
294 tda9950_cec_adap_log_addr(priv->adap, CEC_LOG_ADDR_INVALID);
295
296 /* Start the command processor */
297 tda9950_write(client, REG_CCR, CCR_ON);
298
299 return 0;
300}
301
302static void tda9950_release(struct tda9950_priv *priv)
303{
304 struct i2c_client *client = priv->client;
305 int timeout = 50;
306 u8 csr;
307
308 /* Stop the command processor */
309 tda9950_write(client, REG_CCR, 0);
310
311 /* Wait up to .5s for it to signal non-busy */
312 do {
313 csr = tda9950_read(client, REG_CSR);
d98627d1 314 if (!(csr & CSR_BUSY) || !--timeout)
f0316f93
RK
315 break;
316 msleep(10);
317 } while (1);
318
319 /* Warn the user that their IRQ may die if it's shared. */
320 if (csr & CSR_BUSY)
321 dev_warn(&client->dev, "command processor failed to stop, irq%d may die (csr=0x%02x)\n",
322 client->irq, csr);
323
324 tda9950_glue_release(priv);
325}
326
327static int tda9950_cec_adap_enable(struct cec_adapter *adap, bool enable)
328{
329 struct tda9950_priv *priv = adap->priv;
330
331 if (!enable) {
332 tda9950_release(priv);
333 return 0;
334 } else {
335 return tda9950_open(priv);
336 }
337}
338
339static const struct cec_adap_ops tda9950_cec_ops = {
340 .adap_enable = tda9950_cec_adap_enable,
341 .adap_log_addr = tda9950_cec_adap_log_addr,
342 .adap_transmit = tda9950_cec_transmit,
343};
344
345/*
346 * When operating as part of the TDA998x, we need to claim additional
347 * resources. These two hooks permit the management of those resources.
348 */
349static void tda9950_devm_glue_exit(void *data)
350{
351 struct tda9950_glue *glue = data;
352
353 if (glue && glue->exit)
354 glue->exit(glue->data);
355}
356
357static int tda9950_devm_glue_init(struct device *dev, struct tda9950_glue *glue)
358{
359 int ret;
360
361 if (glue && glue->init) {
362 ret = glue->init(glue->data);
363 if (ret)
364 return ret;
365 }
366
367 ret = devm_add_action(dev, tda9950_devm_glue_exit, glue);
368 if (ret)
369 tda9950_devm_glue_exit(glue);
370
371 return ret;
372}
373
374static void tda9950_cec_del(void *data)
375{
376 struct tda9950_priv *priv = data;
377
378 cec_delete_adapter(priv->adap);
379}
380
381static int tda9950_probe(struct i2c_client *client,
382 const struct i2c_device_id *id)
383{
384 struct tda9950_glue *glue = client->dev.platform_data;
385 struct device *dev = &client->dev;
386 struct tda9950_priv *priv;
387 unsigned long irqflags;
388 int ret;
389 u8 cvr;
390
391 /*
392 * We must have I2C functionality: our multi-byte accesses
393 * must be performed as a single contiguous transaction.
394 */
395 if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C)) {
396 dev_err(&client->dev,
397 "adapter does not support I2C functionality\n");
398 return -ENXIO;
399 }
400
401 /* We must have an interrupt to be functional. */
402 if (client->irq <= 0) {
403 dev_err(&client->dev, "driver requires an interrupt\n");
404 return -ENXIO;
405 }
406
407 priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
408 if (!priv)
409 return -ENOMEM;
410
411 priv->client = client;
412 priv->glue = glue;
413
414 i2c_set_clientdata(client, priv);
415
416 /*
417 * If we're part of a TDA998x, we want the class devices to be
418 * associated with the HDMI Tx so we have a tight relationship
419 * between the HDMI interface and the CEC interface.
420 */
421 priv->hdmi = dev;
422 if (glue && glue->parent)
423 priv->hdmi = glue->parent;
424
425 priv->adap = cec_allocate_adapter(&tda9950_cec_ops, priv, "tda9950",
426 CEC_CAP_DEFAULTS,
427 CEC_MAX_LOG_ADDRS);
428 if (IS_ERR(priv->adap))
429 return PTR_ERR(priv->adap);
430
431 ret = devm_add_action(dev, tda9950_cec_del, priv);
432 if (ret) {
433 cec_delete_adapter(priv->adap);
434 return ret;
435 }
436
437 ret = tda9950_devm_glue_init(dev, glue);
438 if (ret)
439 return ret;
440
441 ret = tda9950_glue_open(priv);
442 if (ret)
443 return ret;
444
445 cvr = tda9950_read(client, REG_CVR);
446
447 dev_info(&client->dev,
448 "TDA9950 CEC interface, hardware version %u.%u\n",
449 cvr >> 4, cvr & 15);
450
451 tda9950_glue_release(priv);
452
453 irqflags = IRQF_TRIGGER_FALLING;
454 if (glue)
455 irqflags = glue->irq_flags;
456
457 ret = devm_request_threaded_irq(dev, client->irq, NULL, tda9950_irq,
458 irqflags | IRQF_SHARED | IRQF_ONESHOT,
459 dev_name(&client->dev), priv);
460 if (ret < 0)
461 return ret;
462
463 priv->notify = cec_notifier_get(priv->hdmi);
464 if (!priv->notify)
465 return -ENOMEM;
466
467 ret = cec_register_adapter(priv->adap, priv->hdmi);
468 if (ret < 0) {
469 cec_notifier_put(priv->notify);
470 return ret;
471 }
472
473 /*
474 * CEC documentation says we must not call cec_delete_adapter
475 * after a successful call to cec_register_adapter().
476 */
477 devm_remove_action(dev, tda9950_cec_del, priv);
478
479 cec_register_cec_notifier(priv->adap, priv->notify);
480
481 return 0;
482}
483
484static int tda9950_remove(struct i2c_client *client)
485{
486 struct tda9950_priv *priv = i2c_get_clientdata(client);
487
488 cec_unregister_adapter(priv->adap);
489 cec_notifier_put(priv->notify);
490
491 return 0;
492}
493
494static struct i2c_device_id tda9950_ids[] = {
495 { "tda9950", 0 },
496 { },
497};
498MODULE_DEVICE_TABLE(i2c, tda9950_ids);
499
500static struct i2c_driver tda9950_driver = {
501 .probe = tda9950_probe,
502 .remove = tda9950_remove,
503 .driver = {
504 .name = "tda9950",
505 },
506 .id_table = tda9950_ids,
507};
508
509module_i2c_driver(tda9950_driver);
510
511MODULE_AUTHOR("Russell King <rmk+kernel@armlinux.org.uk>");
512MODULE_DESCRIPTION("TDA9950/TDA998x Consumer Electronics Control Driver");
513MODULE_LICENSE("GPL v2");