root/drivers/gpu/drm/i2c/tda9950.c

DEFINITIONS

1. tda9950_write_range
2. tda9950_write
3. tda9950_read_range
4. tda9950_read
5. tda9950_irq
6. tda9950_cec_transmit
7. tda9950_cec_adap_log_addr
8. tda9950_glue_open
9. tda9950_glue_release
10. tda9950_open
11. tda9950_release
12. tda9950_cec_adap_enable
13. tda9950_devm_glue_exit
14. tda9950_devm_glue_init
15. tda9950_cec_del
16. tda9950_probe
17. tda9950_remove

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