drivers/mailbox/ti-msgmgr.c

/* [<][>][^][v][top][bottom][index][help] */
This source file includes following definitions.
ti_msgmgr_queue_get_num_messages
ti_msgmgr_queue_is_error
ti_msgmgr_queue_rx_interrupt
ti_msgmgr_queue_peek_data
ti_msgmgr_last_tx_done
ti_msgmgr_send_data
ti_msgmgr_queue_rx_irq_req
ti_msgmgr_queue_startup
ti_msgmgr_queue_shutdown
ti_msgmgr_of_xlate
ti_msgmgr_queue_setup
ti_msgmgr_probe
   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  * Texas Instruments' Message Manager Driver
   4  *
   5  * Copyright (C) 2015-2017 Texas Instruments Incorporated - http://www.ti.com/
   6  *      Nishanth Menon
   7  */
   8 
   9 #define pr_fmt(fmt) "%s: " fmt, __func__
  10 
  11 #include <linux/device.h>
  12 #include <linux/interrupt.h>
  13 #include <linux/io.h>
  14 #include <linux/kernel.h>
  15 #include <linux/mailbox_controller.h>
  16 #include <linux/module.h>
  17 #include <linux/of_device.h>
  18 #include <linux/of.h>
  19 #include <linux/of_irq.h>
  20 #include <linux/platform_device.h>
  21 #include <linux/soc/ti/ti-msgmgr.h>
  22 
  23 #define Q_DATA_OFFSET(proxy, queue, reg)        \
  24                      ((0x10000 * (proxy)) + (0x80 * (queue)) + ((reg) * 4))
  25 #define Q_STATE_OFFSET(queue)                   ((queue) * 0x4)
  26 #define Q_STATE_ENTRY_COUNT_MASK                (0xFFF000)
  27 
  28 #define SPROXY_THREAD_OFFSET(tid) (0x1000 * (tid))
  29 #define SPROXY_THREAD_DATA_OFFSET(tid, reg) \
  30         (SPROXY_THREAD_OFFSET(tid) + ((reg) * 0x4) + 0x4)
  31 
  32 #define SPROXY_THREAD_STATUS_OFFSET(tid) (SPROXY_THREAD_OFFSET(tid))
  33 
  34 #define SPROXY_THREAD_STATUS_COUNT_MASK (0xFF)
  35 
  36 #define SPROXY_THREAD_CTRL_OFFSET(tid) (0x1000 + SPROXY_THREAD_OFFSET(tid))
  37 #define SPROXY_THREAD_CTRL_DIR_MASK (0x1 << 31)
  38 
  39 /**
  40  * struct ti_msgmgr_valid_queue_desc - SoC valid queues meant for this processor
  41  * @queue_id:   Queue Number for this path
  42  * @proxy_id:   Proxy ID representing the processor in SoC
  43  * @is_tx:      Is this a receive path?
  44  */
  45 struct ti_msgmgr_valid_queue_desc {
  46         u8 queue_id;
  47         u8 proxy_id;
  48         bool is_tx;
  49 };
  50 
  51 /**
  52  * struct ti_msgmgr_desc - Description of message manager integration
  53  * @queue_count:        Number of Queues
  54  * @max_message_size:   Message size in bytes
  55  * @max_messages:       Number of messages
  56  * @data_first_reg:     First data register for proxy data region
  57  * @data_last_reg:      Last data register for proxy data region
  58  * @status_cnt_mask:    Mask for getting the status value
  59  * @status_err_mask:    Mask for getting the error value, if applicable
  60  * @tx_polled:          Do I need to use polled mechanism for tx
  61  * @tx_poll_timeout_ms: Timeout in ms if polled
  62  * @valid_queues:       List of Valid queues that the processor can access
  63  * @data_region_name:   Name of the proxy data region
  64  * @status_region_name: Name of the proxy status region
  65  * @ctrl_region_name:   Name of the proxy control region
  66  * @num_valid_queues:   Number of valid queues
  67  * @is_sproxy:          Is this an Secure Proxy instance?
  68  *
  69  * This structure is used in of match data to describe how integration
  70  * for a specific compatible SoC is done.
  71  */
  72 struct ti_msgmgr_desc {
  73         u8 queue_count;
  74         u8 max_message_size;
  75         u8 max_messages;
  76         u8 data_first_reg;
  77         u8 data_last_reg;
  78         u32 status_cnt_mask;
  79         u32 status_err_mask;
  80         bool tx_polled;
  81         int tx_poll_timeout_ms;
  82         const struct ti_msgmgr_valid_queue_desc *valid_queues;
  83         const char *data_region_name;
  84         const char *status_region_name;
  85         const char *ctrl_region_name;
  86         int num_valid_queues;
  87         bool is_sproxy;
  88 };
  89 
  90 /**
  91  * struct ti_queue_inst - Description of a queue instance
  92  * @name:       Queue Name
  93  * @queue_id:   Queue Identifier as mapped on SoC
  94  * @proxy_id:   Proxy Identifier as mapped on SoC
  95  * @irq:        IRQ for Rx Queue
  96  * @is_tx:      'true' if transmit queue, else, 'false'
  97  * @queue_buff_start: First register of Data Buffer
  98  * @queue_buff_end: Last (or confirmation) register of Data buffer
  99  * @queue_state: Queue status register
 100  * @queue_ctrl: Queue Control register
 101  * @chan:       Mailbox channel
 102  * @rx_buff:    Receive buffer pointer allocated at probe, max_message_size
 103  */
 104 struct ti_queue_inst {
 105         char name[30];
 106         u8 queue_id;
 107         u8 proxy_id;
 108         int irq;
 109         bool is_tx;
 110         void __iomem *queue_buff_start;
 111         void __iomem *queue_buff_end;
 112         void __iomem *queue_state;
 113         void __iomem *queue_ctrl;
 114         struct mbox_chan *chan;
 115         u32 *rx_buff;
 116 };
 117 
 118 /**
 119  * struct ti_msgmgr_inst - Description of a Message Manager Instance
 120  * @dev:        device pointer corresponding to the Message Manager instance
 121  * @desc:       Description of the SoC integration
 122  * @queue_proxy_region: Queue proxy region where queue buffers are located
 123  * @queue_state_debug_region:   Queue status register regions
 124  * @queue_ctrl_region:  Queue Control register regions
 125  * @num_valid_queues:   Number of valid queues defined for the processor
 126  *              Note: other queues are probably reserved for other processors
 127  *              in the SoC.
 128  * @qinsts:     Array of valid Queue Instances for the Processor
 129  * @mbox:       Mailbox Controller
 130  * @chans:      Array for channels corresponding to the Queue Instances.
 131  */
 132 struct ti_msgmgr_inst {
 133         struct device *dev;
 134         const struct ti_msgmgr_desc *desc;
 135         void __iomem *queue_proxy_region;
 136         void __iomem *queue_state_debug_region;
 137         void __iomem *queue_ctrl_region;
 138         u8 num_valid_queues;
 139         struct ti_queue_inst *qinsts;
 140         struct mbox_controller mbox;
 141         struct mbox_chan *chans;
 142 };
 143 
 144 /**
 145  * ti_msgmgr_queue_get_num_messages() - Get the number of pending messages
 146  * @d:          Description of message manager
 147  * @qinst:      Queue instance for which we check the number of pending messages
 148  *
 149  * Return: number of messages pending in the queue (0 == no pending messages)
 150  */
 151 static inline int
 152 ti_msgmgr_queue_get_num_messages(const struct ti_msgmgr_desc *d,
 153                                  struct ti_queue_inst *qinst)
 154 {
 155         u32 val;
 156         u32 status_cnt_mask = d->status_cnt_mask;
 157 
 158         /*
 159          * We cannot use relaxed operation here - update may happen
 160          * real-time.
 161          */
 162         val = readl(qinst->queue_state) & status_cnt_mask;
 163         val >>= __ffs(status_cnt_mask);
 164 
 165         return val;
 166 }
 167 
 168 /**
 169  * ti_msgmgr_queue_is_error() - Check to see if there is queue error
 170  * @d:          Description of message manager
 171  * @qinst:      Queue instance for which we check the number of pending messages
 172  *
 173  * Return: true if error, else false
 174  */
 175 static inline bool ti_msgmgr_queue_is_error(const struct ti_msgmgr_desc *d,
 176                                             struct ti_queue_inst *qinst)
 177 {
 178         u32 val;
 179 
 180         /* Msgmgr has no error detection */
 181         if (!d->is_sproxy)
 182                 return false;
 183 
 184         /*
 185          * We cannot use relaxed operation here - update may happen
 186          * real-time.
 187          */
 188         val = readl(qinst->queue_state) & d->status_err_mask;
 189 
 190         return val ? true : false;
 191 }
 192 
 193 /**
 194  * ti_msgmgr_queue_rx_interrupt() - Interrupt handler for receive Queue
 195  * @irq:        Interrupt number
 196  * @p:          Channel Pointer
 197  *
 198  * Return: -EINVAL if there is no instance
 199  * IRQ_NONE if the interrupt is not ours.
 200  * IRQ_HANDLED if the rx interrupt was successfully handled.
 201  */
 202 static irqreturn_t ti_msgmgr_queue_rx_interrupt(int irq, void *p)
 203 {
 204         struct mbox_chan *chan = p;
 205         struct device *dev = chan->mbox->dev;
 206         struct ti_msgmgr_inst *inst = dev_get_drvdata(dev);
 207         struct ti_queue_inst *qinst = chan->con_priv;
 208         const struct ti_msgmgr_desc *desc;
 209         int msg_count, num_words;
 210         struct ti_msgmgr_message message;
 211         void __iomem *data_reg;
 212         u32 *word_data;
 213 
 214         if (WARN_ON(!inst)) {
 215                 dev_err(dev, "no platform drv data??\n");
 216                 return -EINVAL;
 217         }
 218 
 219         /* Do I have an invalid interrupt source? */
 220         if (qinst->is_tx) {
 221                 dev_err(dev, "Cannot handle rx interrupt on tx channel %s\n",
 222                         qinst->name);
 223                 return IRQ_NONE;
 224         }
 225 
 226         desc = inst->desc;
 227         if (ti_msgmgr_queue_is_error(desc, qinst)) {
 228                 dev_err(dev, "Error on Rx channel %s\n", qinst->name);
 229                 return IRQ_NONE;
 230         }
 231 
 232         /* Do I actually have messages to read? */
 233         msg_count = ti_msgmgr_queue_get_num_messages(desc, qinst);
 234         if (!msg_count) {
 235                 /* Shared IRQ? */
 236                 dev_dbg(dev, "Spurious event - 0 pending data!\n");
 237                 return IRQ_NONE;
 238         }
 239 
 240         /*
 241          * I have no idea about the protocol being used to communicate with the
 242          * remote producer - 0 could be valid data, so I wont make a judgement
 243          * of how many bytes I should be reading. Let the client figure this
 244          * out.. I just read the full message and pass it on..
 245          */
 246         message.len = desc->max_message_size;
 247         message.buf = (u8 *)qinst->rx_buff;
 248 
 249         /*
 250          * NOTE about register access involved here:
 251          * the hardware block is implemented with 32bit access operations and no
 252          * support for data splitting.  We don't want the hardware to misbehave
 253          * with sub 32bit access - For example: if the last register read is
 254          * split into byte wise access, it can result in the queue getting
 255          * stuck or indeterminate behavior. An out of order read operation may
 256          * result in weird data results as well.
 257          * Hence, we do not use memcpy_fromio or __ioread32_copy here, instead
 258          * we depend on readl for the purpose.
 259          *
 260          * Also note that the final register read automatically marks the
 261          * queue message as read.
 262          */
 263         for (data_reg = qinst->queue_buff_start, word_data = qinst->rx_buff,
 264              num_words = (desc->max_message_size / sizeof(u32));
 265              num_words; num_words--, data_reg += sizeof(u32), word_data++)
 266                 *word_data = readl(data_reg);
 267 
 268         /*
 269          * Last register read automatically clears the IRQ if only 1 message
 270          * is pending - so send the data up the stack..
 271          * NOTE: Client is expected to be as optimal as possible, since
 272          * we invoke the handler in IRQ context.
 273          */
 274         mbox_chan_received_data(chan, (void *)&message);
 275 
 276         return IRQ_HANDLED;
 277 }
 278 
 279 /**
 280  * ti_msgmgr_queue_peek_data() - Peek to see if there are any rx messages.
 281  * @chan:       Channel Pointer
 282  *
 283  * Return: 'true' if there is pending rx data, 'false' if there is none.
 284  */
 285 static bool ti_msgmgr_queue_peek_data(struct mbox_chan *chan)
 286 {
 287         struct ti_queue_inst *qinst = chan->con_priv;
 288         struct device *dev = chan->mbox->dev;
 289         struct ti_msgmgr_inst *inst = dev_get_drvdata(dev);
 290         const struct ti_msgmgr_desc *desc = inst->desc;
 291         int msg_count;
 292 
 293         if (qinst->is_tx)
 294                 return false;
 295 
 296         if (ti_msgmgr_queue_is_error(desc, qinst)) {
 297                 dev_err(dev, "Error on channel %s\n", qinst->name);
 298                 return false;
 299         }
 300 
 301         msg_count = ti_msgmgr_queue_get_num_messages(desc, qinst);
 302 
 303         return msg_count ? true : false;
 304 }
 305 
 306 /**
 307  * ti_msgmgr_last_tx_done() - See if all the tx messages are sent
 308  * @chan:       Channel pointer
 309  *
 310  * Return: 'true' is no pending tx data, 'false' if there are any.
 311  */
 312 static bool ti_msgmgr_last_tx_done(struct mbox_chan *chan)
 313 {
 314         struct ti_queue_inst *qinst = chan->con_priv;
 315         struct device *dev = chan->mbox->dev;
 316         struct ti_msgmgr_inst *inst = dev_get_drvdata(dev);
 317         const struct ti_msgmgr_desc *desc = inst->desc;
 318         int msg_count;
 319 
 320         if (!qinst->is_tx)
 321                 return false;
 322 
 323         if (ti_msgmgr_queue_is_error(desc, qinst)) {
 324                 dev_err(dev, "Error on channel %s\n", qinst->name);
 325                 return false;
 326         }
 327 
 328         msg_count = ti_msgmgr_queue_get_num_messages(desc, qinst);
 329 
 330         if (desc->is_sproxy) {
 331                 /* In secure proxy, msg_count indicates how many we can send */
 332                 return msg_count ? true : false;
 333         }
 334 
 335         /* if we have any messages pending.. */
 336         return msg_count ? false : true;
 337 }
 338 
 339 /**
 340  * ti_msgmgr_send_data() - Send data
 341  * @chan:       Channel Pointer
 342  * @data:       ti_msgmgr_message * Message Pointer
 343  *
 344  * Return: 0 if all goes good, else appropriate error messages.
 345  */
 346 static int ti_msgmgr_send_data(struct mbox_chan *chan, void *data)
 347 {
 348         struct device *dev = chan->mbox->dev;
 349         struct ti_msgmgr_inst *inst = dev_get_drvdata(dev);
 350         const struct ti_msgmgr_desc *desc;
 351         struct ti_queue_inst *qinst = chan->con_priv;
 352         int num_words, trail_bytes;
 353         struct ti_msgmgr_message *message = data;
 354         void __iomem *data_reg;
 355         u32 *word_data;
 356 
 357         if (WARN_ON(!inst)) {
 358                 dev_err(dev, "no platform drv data??\n");
 359                 return -EINVAL;
 360         }
 361         desc = inst->desc;
 362 
 363         if (ti_msgmgr_queue_is_error(desc, qinst)) {
 364                 dev_err(dev, "Error on channel %s\n", qinst->name);
 365                 return false;
 366         }
 367 
 368         if (desc->max_message_size < message->len) {
 369                 dev_err(dev, "Queue %s message length %zu > max %d\n",
 370                         qinst->name, message->len, desc->max_message_size);
 371                 return -EINVAL;
 372         }
 373 
 374         /* NOTE: Constraints similar to rx path exists here as well */
 375         for (data_reg = qinst->queue_buff_start,
 376              num_words = message->len / sizeof(u32),
 377              word_data = (u32 *)message->buf;
 378              num_words; num_words--, data_reg += sizeof(u32), word_data++)
 379                 writel(*word_data, data_reg);
 380 
 381         trail_bytes = message->len % sizeof(u32);
 382         if (trail_bytes) {
 383                 u32 data_trail = *word_data;
 384 
 385                 /* Ensure all unused data is 0 */
 386                 data_trail &= 0xFFFFFFFF >> (8 * (sizeof(u32) - trail_bytes));
 387                 writel(data_trail, data_reg);
 388                 data_reg++;
 389         }
 390         /*
 391          * 'data_reg' indicates next register to write. If we did not already
 392          * write on tx complete reg(last reg), we must do so for transmit
 393          */
 394         if (data_reg <= qinst->queue_buff_end)
 395                 writel(0, qinst->queue_buff_end);
 396 
 397         return 0;
 398 }
 399 
 400 /**
 401  *  ti_msgmgr_queue_rx_irq_req() - RX IRQ request
 402  *  @dev:       device pointer
 403  *  @d:         descriptor for ti_msgmgr
 404  *  @qinst:     Queue instance
 405  *  @chan:      Channel pointer
 406  */
 407 static int ti_msgmgr_queue_rx_irq_req(struct device *dev,
 408                                       const struct ti_msgmgr_desc *d,
 409                                       struct ti_queue_inst *qinst,
 410                                       struct mbox_chan *chan)
 411 {
 412         int ret = 0;
 413         char of_rx_irq_name[7];
 414         struct device_node *np;
 415 
 416         snprintf(of_rx_irq_name, sizeof(of_rx_irq_name),
 417                  "rx_%03d", d->is_sproxy ? qinst->proxy_id : qinst->queue_id);
 418 
 419         /* Get the IRQ if not found */
 420         if (qinst->irq < 0) {
 421                 np = of_node_get(dev->of_node);
 422                 if (!np)
 423                         return -ENODATA;
 424                 qinst->irq = of_irq_get_byname(np, of_rx_irq_name);
 425                 of_node_put(np);
 426 
 427                 if (qinst->irq < 0) {
 428                         dev_err(dev,
 429                                 "QID %d PID %d:No IRQ[%s]: %d\n",
 430                                 qinst->queue_id, qinst->proxy_id,
 431                                 of_rx_irq_name, qinst->irq);
 432                         return qinst->irq;
 433                 }
 434         }
 435 
 436         /* With the expectation that the IRQ might be shared in SoC */
 437         ret = request_irq(qinst->irq, ti_msgmgr_queue_rx_interrupt,
 438                           IRQF_SHARED, qinst->name, chan);
 439         if (ret) {
 440                 dev_err(dev, "Unable to get IRQ %d on %s(res=%d)\n",
 441                         qinst->irq, qinst->name, ret);
 442         }
 443 
 444         return ret;
 445 }
 446 
 447 /**
 448  * ti_msgmgr_queue_startup() - Startup queue
 449  * @chan:       Channel pointer
 450  *
 451  * Return: 0 if all goes good, else return corresponding error message
 452  */
 453 static int ti_msgmgr_queue_startup(struct mbox_chan *chan)
 454 {
 455         struct device *dev = chan->mbox->dev;
 456         struct ti_msgmgr_inst *inst = dev_get_drvdata(dev);
 457         struct ti_queue_inst *qinst = chan->con_priv;
 458         const struct ti_msgmgr_desc *d = inst->desc;
 459         int ret;
 460         int msg_count;
 461 
 462         /*
 463          * If sproxy is starting and can send messages, we are a Tx thread,
 464          * else Rx
 465          */
 466         if (d->is_sproxy) {
 467                 qinst->is_tx = (readl(qinst->queue_ctrl) &
 468                                 SPROXY_THREAD_CTRL_DIR_MASK) ? false : true;
 469 
 470                 msg_count = ti_msgmgr_queue_get_num_messages(d, qinst);
 471 
 472                 if (!msg_count && qinst->is_tx) {
 473                         dev_err(dev, "%s: Cannot transmit with 0 credits!\n",
 474                                 qinst->name);
 475                         return -EINVAL;
 476                 }
 477         }
 478 
 479         if (!qinst->is_tx) {
 480                 /* Allocate usage buffer for rx */
 481                 qinst->rx_buff = kzalloc(d->max_message_size, GFP_KERNEL);
 482                 if (!qinst->rx_buff)
 483                         return -ENOMEM;
 484                 /* Request IRQ */
 485                 ret = ti_msgmgr_queue_rx_irq_req(dev, d, qinst, chan);
 486                 if (ret) {
 487                         kfree(qinst->rx_buff);
 488                         return ret;
 489                 }
 490         }
 491 
 492         return 0;
 493 }
 494 
 495 /**
 496  * ti_msgmgr_queue_shutdown() - Shutdown the queue
 497  * @chan:       Channel pointer
 498  */
 499 static void ti_msgmgr_queue_shutdown(struct mbox_chan *chan)
 500 {
 501         struct ti_queue_inst *qinst = chan->con_priv;
 502 
 503         if (!qinst->is_tx) {
 504                 free_irq(qinst->irq, chan);
 505                 kfree(qinst->rx_buff);
 506         }
 507 }
 508 
 509 /**
 510  * ti_msgmgr_of_xlate() - Translation of phandle to queue
 511  * @mbox:       Mailbox controller
 512  * @p:          phandle pointer
 513  *
 514  * Return: Mailbox channel corresponding to the queue, else return error
 515  * pointer.
 516  */
 517 static struct mbox_chan *ti_msgmgr_of_xlate(struct mbox_controller *mbox,
 518                                             const struct of_phandle_args *p)
 519 {
 520         struct ti_msgmgr_inst *inst;
 521         int req_qid, req_pid;
 522         struct ti_queue_inst *qinst;
 523         const struct ti_msgmgr_desc *d;
 524         int i, ncells;
 525 
 526         inst = container_of(mbox, struct ti_msgmgr_inst, mbox);
 527         if (WARN_ON(!inst))
 528                 return ERR_PTR(-EINVAL);
 529 
 530         d = inst->desc;
 531 
 532         if (d->is_sproxy)
 533                 ncells = 1;
 534         else
 535                 ncells = 2;
 536         if (p->args_count != ncells) {
 537                 dev_err(inst->dev, "Invalid arguments in dt[%d]. Must be %d\n",
 538                         p->args_count, ncells);
 539                 return ERR_PTR(-EINVAL);
 540         }
 541         if (ncells == 1) {
 542                 req_qid = 0;
 543                 req_pid = p->args[0];
 544         } else {
 545                 req_qid = p->args[0];
 546                 req_pid = p->args[1];
 547         }
 548 
 549         if (d->is_sproxy) {
 550                 if (req_pid >= d->num_valid_queues)
 551                         goto err;
 552                 qinst = &inst->qinsts[req_pid];
 553                 return qinst->chan;
 554         }
 555 
 556         for (qinst = inst->qinsts, i = 0; i < inst->num_valid_queues;
 557              i++, qinst++) {
 558                 if (req_qid == qinst->queue_id && req_pid == qinst->proxy_id)
 559                         return qinst->chan;
 560         }
 561 
 562 err:
 563         dev_err(inst->dev, "Queue ID %d, Proxy ID %d is wrong on %pOFn\n",
 564                 req_qid, req_pid, p->np);
 565         return ERR_PTR(-ENOENT);
 566 }
 567 
 568 /**
 569  * ti_msgmgr_queue_setup() - Setup data structures for each queue instance
 570  * @idx:        index of the queue
 571  * @dev:        pointer to the message manager device
 572  * @np:         pointer to the of node
 573  * @inst:       Queue instance pointer
 574  * @d:          Message Manager instance description data
 575  * @qd:         Queue description data
 576  * @qinst:      Queue instance pointer
 577  * @chan:       pointer to mailbox channel
 578  *
 579  * Return: 0 if all went well, else return corresponding error
 580  */
 581 static int ti_msgmgr_queue_setup(int idx, struct device *dev,
 582                                  struct device_node *np,
 583                                  struct ti_msgmgr_inst *inst,
 584                                  const struct ti_msgmgr_desc *d,
 585                                  const struct ti_msgmgr_valid_queue_desc *qd,
 586                                  struct ti_queue_inst *qinst,
 587                                  struct mbox_chan *chan)
 588 {
 589         char *dir;
 590 
 591         qinst->proxy_id = qd->proxy_id;
 592         qinst->queue_id = qd->queue_id;
 593 
 594         if (qinst->queue_id > d->queue_count) {
 595                 dev_err(dev, "Queue Data [idx=%d] queuid %d > %d\n",
 596                         idx, qinst->queue_id, d->queue_count);
 597                 return -ERANGE;
 598         }
 599 
 600         if (d->is_sproxy) {
 601                 qinst->queue_buff_start = inst->queue_proxy_region +
 602                     SPROXY_THREAD_DATA_OFFSET(qinst->proxy_id,
 603                                               d->data_first_reg);
 604                 qinst->queue_buff_end = inst->queue_proxy_region +
 605                     SPROXY_THREAD_DATA_OFFSET(qinst->proxy_id,
 606                                               d->data_last_reg);
 607                 qinst->queue_state = inst->queue_state_debug_region +
 608                     SPROXY_THREAD_STATUS_OFFSET(qinst->proxy_id);
 609                 qinst->queue_ctrl = inst->queue_ctrl_region +
 610                     SPROXY_THREAD_CTRL_OFFSET(qinst->proxy_id);
 611 
 612                 /* XXX: DONOT read registers here!.. Some may be unusable */
 613                 dir = "thr";
 614                 snprintf(qinst->name, sizeof(qinst->name), "%s %s_%03d",
 615                          dev_name(dev), dir, qinst->proxy_id);
 616         } else {
 617                 qinst->queue_buff_start = inst->queue_proxy_region +
 618                     Q_DATA_OFFSET(qinst->proxy_id, qinst->queue_id,
 619                                   d->data_first_reg);
 620                 qinst->queue_buff_end = inst->queue_proxy_region +
 621                     Q_DATA_OFFSET(qinst->proxy_id, qinst->queue_id,
 622                                   d->data_last_reg);
 623                 qinst->queue_state =
 624                     inst->queue_state_debug_region +
 625                     Q_STATE_OFFSET(qinst->queue_id);
 626                 qinst->is_tx = qd->is_tx;
 627                 dir = qinst->is_tx ? "tx" : "rx";
 628                 snprintf(qinst->name, sizeof(qinst->name), "%s %s_%03d_%03d",
 629                          dev_name(dev), dir, qinst->queue_id, qinst->proxy_id);
 630         }
 631 
 632         qinst->chan = chan;
 633 
 634         /* Setup an error value for IRQ - Lazy allocation */
 635         qinst->irq = -EINVAL;
 636 
 637         chan->con_priv = qinst;
 638 
 639         dev_dbg(dev, "[%d] qidx=%d pidx=%d irq=%d q_s=%p q_e = %p\n",
 640                 idx, qinst->queue_id, qinst->proxy_id, qinst->irq,
 641                 qinst->queue_buff_start, qinst->queue_buff_end);
 642         return 0;
 643 }
 644 
 645 /* Queue operations */
 646 static const struct mbox_chan_ops ti_msgmgr_chan_ops = {
 647         .startup = ti_msgmgr_queue_startup,
 648         .shutdown = ti_msgmgr_queue_shutdown,
 649         .peek_data = ti_msgmgr_queue_peek_data,
 650         .last_tx_done = ti_msgmgr_last_tx_done,
 651         .send_data = ti_msgmgr_send_data,
 652 };
 653 
 654 /* Keystone K2G SoC integration details */
 655 static const struct ti_msgmgr_valid_queue_desc k2g_valid_queues[] = {
 656         {.queue_id = 0, .proxy_id = 0, .is_tx = true,},
 657         {.queue_id = 1, .proxy_id = 0, .is_tx = true,},
 658         {.queue_id = 2, .proxy_id = 0, .is_tx = true,},
 659         {.queue_id = 3, .proxy_id = 0, .is_tx = true,},
 660         {.queue_id = 5, .proxy_id = 2, .is_tx = false,},
 661         {.queue_id = 56, .proxy_id = 1, .is_tx = true,},
 662         {.queue_id = 57, .proxy_id = 2, .is_tx = false,},
 663         {.queue_id = 58, .proxy_id = 3, .is_tx = true,},
 664         {.queue_id = 59, .proxy_id = 4, .is_tx = true,},
 665         {.queue_id = 60, .proxy_id = 5, .is_tx = true,},
 666         {.queue_id = 61, .proxy_id = 6, .is_tx = true,},
 667 };
 668 
 669 static const struct ti_msgmgr_desc k2g_desc = {
 670         .queue_count = 64,
 671         .max_message_size = 64,
 672         .max_messages = 128,
 673         .data_region_name = "queue_proxy_region",
 674         .status_region_name = "queue_state_debug_region",
 675         .data_first_reg = 16,
 676         .data_last_reg = 31,
 677         .status_cnt_mask = Q_STATE_ENTRY_COUNT_MASK,
 678         .tx_polled = false,
 679         .valid_queues = k2g_valid_queues,
 680         .num_valid_queues = ARRAY_SIZE(k2g_valid_queues),
 681         .is_sproxy = false,
 682 };
 683 
 684 static const struct ti_msgmgr_desc am654_desc = {
 685         .queue_count = 190,
 686         .num_valid_queues = 190,
 687         .max_message_size = 60,
 688         .data_region_name = "target_data",
 689         .status_region_name = "rt",
 690         .ctrl_region_name = "scfg",
 691         .data_first_reg = 0,
 692         .data_last_reg = 14,
 693         .status_cnt_mask = SPROXY_THREAD_STATUS_COUNT_MASK,
 694         .tx_polled = false,
 695         .is_sproxy = true,
 696 };
 697 
 698 static const struct of_device_id ti_msgmgr_of_match[] = {
 699         {.compatible = "ti,k2g-message-manager", .data = &k2g_desc},
 700         {.compatible = "ti,am654-secure-proxy", .data = &am654_desc},
 701         { /* Sentinel */ }
 702 };
 703 
 704 MODULE_DEVICE_TABLE(of, ti_msgmgr_of_match);
 705 
 706 static int ti_msgmgr_probe(struct platform_device *pdev)
 707 {
 708         struct device *dev = &pdev->dev;
 709         const struct of_device_id *of_id;
 710         struct device_node *np;
 711         struct resource *res;
 712         const struct ti_msgmgr_desc *desc;
 713         struct ti_msgmgr_inst *inst;
 714         struct ti_queue_inst *qinst;
 715         struct mbox_controller *mbox;
 716         struct mbox_chan *chans;
 717         int queue_count;
 718         int i;
 719         int ret = -EINVAL;
 720         const struct ti_msgmgr_valid_queue_desc *queue_desc;
 721 
 722         if (!dev->of_node) {
 723                 dev_err(dev, "no OF information\n");
 724                 return -EINVAL;
 725         }
 726         np = dev->of_node;
 727 
 728         of_id = of_match_device(ti_msgmgr_of_match, dev);
 729         if (!of_id) {
 730                 dev_err(dev, "OF data missing\n");
 731                 return -EINVAL;
 732         }
 733         desc = of_id->data;
 734 
 735         inst = devm_kzalloc(dev, sizeof(*inst), GFP_KERNEL);
 736         if (!inst)
 737                 return -ENOMEM;
 738 
 739         inst->dev = dev;
 740         inst->desc = desc;
 741 
 742         res = platform_get_resource_byname(pdev, IORESOURCE_MEM,
 743                                            desc->data_region_name);
 744         inst->queue_proxy_region = devm_ioremap_resource(dev, res);
 745         if (IS_ERR(inst->queue_proxy_region))
 746                 return PTR_ERR(inst->queue_proxy_region);
 747 
 748         res = platform_get_resource_byname(pdev, IORESOURCE_MEM,
 749                                            desc->status_region_name);
 750         inst->queue_state_debug_region = devm_ioremap_resource(dev, res);
 751         if (IS_ERR(inst->queue_state_debug_region))
 752                 return PTR_ERR(inst->queue_state_debug_region);
 753 
 754         if (desc->is_sproxy) {
 755                 res = platform_get_resource_byname(pdev, IORESOURCE_MEM,
 756                                                    desc->ctrl_region_name);
 757                 inst->queue_ctrl_region = devm_ioremap_resource(dev, res);
 758                 if (IS_ERR(inst->queue_ctrl_region))
 759                         return PTR_ERR(inst->queue_ctrl_region);
 760         }
 761 
 762         dev_dbg(dev, "proxy region=%p, queue_state=%p\n",
 763                 inst->queue_proxy_region, inst->queue_state_debug_region);
 764 
 765         queue_count = desc->num_valid_queues;
 766         if (!queue_count || queue_count > desc->queue_count) {
 767                 dev_crit(dev, "Invalid Number of queues %d. Max %d\n",
 768                          queue_count, desc->queue_count);
 769                 return -ERANGE;
 770         }
 771         inst->num_valid_queues = queue_count;
 772 
 773         qinst = devm_kcalloc(dev, queue_count, sizeof(*qinst), GFP_KERNEL);
 774         if (!qinst)
 775                 return -ENOMEM;
 776         inst->qinsts = qinst;
 777 
 778         chans = devm_kcalloc(dev, queue_count, sizeof(*chans), GFP_KERNEL);
 779         if (!chans)
 780                 return -ENOMEM;
 781         inst->chans = chans;
 782 
 783         if (desc->is_sproxy) {
 784                 struct ti_msgmgr_valid_queue_desc sproxy_desc;
 785 
 786                 /* All proxies may be valid in Secure Proxy instance */
 787                 for (i = 0; i < queue_count; i++, qinst++, chans++) {
 788                         sproxy_desc.queue_id = 0;
 789                         sproxy_desc.proxy_id = i;
 790                         ret = ti_msgmgr_queue_setup(i, dev, np, inst,
 791                                                     desc, &sproxy_desc, qinst,
 792                                                     chans);
 793                         if (ret)
 794                                 return ret;
 795                 }
 796         } else {
 797                 /* Only Some proxies are valid in Message Manager */
 798                 for (i = 0, queue_desc = desc->valid_queues;
 799                      i < queue_count; i++, qinst++, chans++, queue_desc++) {
 800                         ret = ti_msgmgr_queue_setup(i, dev, np, inst,
 801                                                     desc, queue_desc, qinst,
 802                                                     chans);
 803                         if (ret)
 804                                 return ret;
 805                 }
 806         }
 807 
 808         mbox = &inst->mbox;
 809         mbox->dev = dev;
 810         mbox->ops = &ti_msgmgr_chan_ops;
 811         mbox->chans = inst->chans;
 812         mbox->num_chans = inst->num_valid_queues;
 813         mbox->txdone_irq = false;
 814         mbox->txdone_poll = desc->tx_polled;
 815         if (desc->tx_polled)
 816                 mbox->txpoll_period = desc->tx_poll_timeout_ms;
 817         mbox->of_xlate = ti_msgmgr_of_xlate;
 818 
 819         platform_set_drvdata(pdev, inst);
 820         ret = devm_mbox_controller_register(dev, mbox);
 821         if (ret)
 822                 dev_err(dev, "Failed to register mbox_controller(%d)\n", ret);
 823 
 824         return ret;
 825 }
 826 
 827 static struct platform_driver ti_msgmgr_driver = {
 828         .probe = ti_msgmgr_probe,
 829         .driver = {
 830                    .name = "ti-msgmgr",
 831                    .of_match_table = of_match_ptr(ti_msgmgr_of_match),
 832         },
 833 };
 834 module_platform_driver(ti_msgmgr_driver);
 835 
 836 MODULE_LICENSE("GPL v2");
 837 MODULE_DESCRIPTION("TI message manager driver");
 838 MODULE_AUTHOR("Nishanth Menon");
 839 MODULE_ALIAS("platform:ti-msgmgr");
/* [<][>][^][v][top][bottom][index][help] */
root/drivers/mailbox/ti-msgmgr.c

DEFINITIONS
