Skip to contentSkip to conversation

soc: mediatek: cmdq: Remove timeout handler in helper function

PATCH In review Chun-Kuang Hu 2 participants 4 messages Sep 20, 2020 – Sep 21, 2020

Subsystems (3)
lore
Share & tools
lore

Chun-Kuang Hu

author maintainer
#0 lore raw

PATCH 1/1 soc: mediatek: cmdq: Remove timeout handler in helper function

For each client driver, its timeout handler need to dump hardware register or its state machine information, so remove timeout handler in helper function and let client driver implement its own timeout handler.

---
 drivers/gpu/drm/mediatek/mtk_drm_crtc.c |  3 +-
 drivers/soc/mediatek/mtk-cmdq-helper.c  | 41 +------------------------
 include/linux/soc/mediatek/mtk-cmdq.h   | 11 +------
 3 files changed, 3 insertions(+), 52 deletions(-)
drivers/gpu/drm/mediatek/mtk_drm_crtc.c +1 -2
index 3fc5511330b9..cabeb7fea2be 100644
@@ -824,8 +824,7 @@ int mtk_drm_crtc_create(struct drm_device *drm_dev,
 #if IS_REACHABLE(CONFIG_MTK_CMDQ)
 	mtk_crtc->cmdq_client =
 			cmdq_mbox_create(mtk_crtc->mmsys_dev,
-					 drm_crtc_index(&mtk_crtc->base),
-					 2000);
+					 drm_crtc_index(&mtk_crtc->base));
 	if (IS_ERR(mtk_crtc->cmdq_client)) {
 		dev_dbg(dev, "mtk_crtc %d failed to create mailbox client, writing register by CPU now\n",
 			drm_crtc_index(&mtk_crtc->base));
drivers/soc/mediatek/mtk-cmdq-helper.c +1 -40

77 lines not on this page · raw message

include/linux/soc/mediatek/mtk-cmdq.h +1 -10
index 2249ecaf77e4..175bd89f46f8 100644
@@ -11,8 +11,6 @@
 #include <linux/mailbox/mtk-cmdq-mailbox.h>
 #include <linux/timer.h>
 
-#define CMDQ_NO_TIMEOUT		0xffffffffu
-
 struct cmdq_pkt;
 
 struct cmdq_client_reg {
@@ -22,12 +20,8 @@ struct cmdq_client_reg {
 };
 
 struct cmdq_client {
-	spinlock_t lock;
-	u32 pkt_cnt;
 	struct mbox_client client;
 	struct mbox_chan *chan;
-	struct timer_list timer;
-	u32 timeout_ms; /* in unit of microsecond */
 };
 
 /**
@@ -49,13 +43,10 @@ int cmdq_dev_get_client_reg(struct device *dev,
  * cmdq_mbox_create() - create CMDQ mailbox client and channel
  * @dev:	device of CMDQ mailbox client
  * @index:	index of CMDQ mailbox channel
- * @timeout:	timeout of a pkt execution by GCE, in unit of microsecond, set
- *		CMDQ_NO_TIMEOUT if a timer is not used.
  *
  * Return: CMDQ mailbox client pointer
  */
-struct cmdq_client *cmdq_mbox_create(struct device *dev, int index,
-				     u32 timeout);
+struct cmdq_client *cmdq_mbox_create(struct device *dev, int index);
 
 /**
  * cmdq_mbox_destroy() - destroy CMDQ mailbox client and channel
Signature · 1 line
2.17.1
maintainer
#1 lore raw
Quoted 4 lines · Chun-Kuang Hu

For each client driver, its timeout handler need to dump hardware register or its state machine information, so remove timeout handler in helper function and let client driver implement its own timeout handler.

I don't see the implementation of a client side handler. Did I miss something? Would it make sense to instead add a callback to the handler in cmdq_mbox_create()?

Regards,
Matthias

Quoted 150 lines
---
  drivers/gpu/drm/mediatek/mtk_drm_crtc.c |  3 +-
  drivers/soc/mediatek/mtk-cmdq-helper.c  | 41 +------------------------
  include/linux/soc/mediatek/mtk-cmdq.h   | 11 +------
  3 files changed, 3 insertions(+), 52 deletions(-)
drivers/gpu/drm/mediatek/mtk_drm_crtc.c +1 -2
index 3fc5511330b9..cabeb7fea2be 100644
@@ -824,8 +824,7 @@ int mtk_drm_crtc_create(struct drm_device *drm_dev,
  #if IS_REACHABLE(CONFIG_MTK_CMDQ)
  	mtk_crtc->cmdq_client =
  			cmdq_mbox_create(mtk_crtc->mmsys_dev,
-					 drm_crtc_index(&mtk_crtc->base),
-					 2000);
+					 drm_crtc_index(&mtk_crtc->base));
  	if (IS_ERR(mtk_crtc->cmdq_client)) {
  		dev_dbg(dev, "mtk_crtc %d failed to create mailbox client, writing register by CPU now\n",
  			drm_crtc_index(&mtk_crtc->base));
drivers/soc/mediatek/mtk-cmdq-helper.c +1 -40
index dc644cfb6419..4f311f035b59 100644
@@ -65,14 +65,7 @@ int cmdq_dev_get_client_reg(struct device *dev,
  }
  EXPORT_SYMBOL(cmdq_dev_get_client_reg);
 
-static void cmdq_client_timeout(struct timer_list *t)
-{
-	struct cmdq_client *client = from_timer(client, t, timer);
-
-	dev_err(client->client.dev, "cmdq timeout!\n");
-}
-
-struct cmdq_client *cmdq_mbox_create(struct device *dev, int index, u32 timeout)
+struct cmdq_client *cmdq_mbox_create(struct device *dev, int index)
  {
  	struct cmdq_client *client;
 
@@ -80,12 +73,6 @@ struct cmdq_client *cmdq_mbox_create(struct device *dev, int index, u32 timeout)
  	if (!client)
  		return (struct cmdq_client *)-ENOMEM;
 
-	client->timeout_ms = timeout;
-	if (timeout != CMDQ_NO_TIMEOUT) {
-		spin_lock_init(&client->lock);
-		timer_setup(&client->timer, cmdq_client_timeout, 0);
-	}
-	client->pkt_cnt = 0;
  	client->client.dev = dev;
  	client->client.tx_block = false;
  	client->client.knows_txdone = true;
@@ -107,11 +94,6 @@ EXPORT_SYMBOL(cmdq_mbox_create);
 
  void cmdq_mbox_destroy(struct cmdq_client *client)
  {
-	if (client->timeout_ms != CMDQ_NO_TIMEOUT) {
-		spin_lock(&client->lock);
-		del_timer_sync(&client->timer);
-		spin_unlock(&client->lock);
-	}
  	mbox_free_channel(client->chan);
  	kfree(client);
  }
@@ -342,18 +324,6 @@ static void cmdq_pkt_flush_async_cb(struct cmdq_cb_data data)
  	struct cmdq_task_cb *cb = &pkt->cb;
  	struct cmdq_client *client = (struct cmdq_client *)pkt->cl;
 
-	if (client->timeout_ms != CMDQ_NO_TIMEOUT) {
-		unsigned long flags = 0;
-
-		spin_lock_irqsave(&client->lock, flags);
-		if (--client->pkt_cnt == 0)
-			del_timer(&client->timer);
-		else
-			mod_timer(&client->timer, jiffies +
-				  msecs_to_jiffies(client->timeout_ms));
-		spin_unlock_irqrestore(&client->lock, flags);
-	}
-
  	dma_sync_single_for_cpu(client->chan->mbox->dev, pkt->pa_base,
  				pkt->cmd_buf_size, DMA_TO_DEVICE);
  	if (cb->cb) {
@@ -366,7 +336,6 @@ int cmdq_pkt_flush_async(struct cmdq_pkt *pkt, cmdq_async_flush_cb cb,
  			 void *data)
  {
  	int err;
-	unsigned long flags = 0;
  	struct cmdq_client *client = (struct cmdq_client *)pkt->cl;
 
  	pkt->cb.cb = cb;
@@ -377,14 +346,6 @@ int cmdq_pkt_flush_async(struct cmdq_pkt *pkt, cmdq_async_flush_cb cb,
  	dma_sync_single_for_device(client->chan->mbox->dev, pkt->pa_base,
  				   pkt->cmd_buf_size, DMA_TO_DEVICE);
 
-	if (client->timeout_ms != CMDQ_NO_TIMEOUT) {
-		spin_lock_irqsave(&client->lock, flags);
-		if (client->pkt_cnt++ == 0)
-			mod_timer(&client->timer, jiffies +
-				  msecs_to_jiffies(client->timeout_ms));
-		spin_unlock_irqrestore(&client->lock, flags);
-	}
-
  	err = mbox_send_message(client->chan, pkt);
  	if (err < 0)
  		return err;
include/linux/soc/mediatek/mtk-cmdq.h +1 -10
index 2249ecaf77e4..175bd89f46f8 100644
@@ -11,8 +11,6 @@
  #include <linux/mailbox/mtk-cmdq-mailbox.h>
  #include <linux/timer.h>
 
-#define CMDQ_NO_TIMEOUT		0xffffffffu
-
  struct cmdq_pkt;
 
  struct cmdq_client_reg {
@@ -22,12 +20,8 @@ struct cmdq_client_reg {
  };
 
  struct cmdq_client {
-	spinlock_t lock;
-	u32 pkt_cnt;
  	struct mbox_client client;
  	struct mbox_chan *chan;
-	struct timer_list timer;
-	u32 timeout_ms; /* in unit of microsecond */
  };
 
  /**
@@ -49,13 +43,10 @@ int cmdq_dev_get_client_reg(struct device *dev,
   * cmdq_mbox_create() - create CMDQ mailbox client and channel
   * @dev:	device of CMDQ mailbox client
   * @index:	index of CMDQ mailbox channel
- * @timeout:	timeout of a pkt execution by GCE, in unit of microsecond, set
- *		CMDQ_NO_TIMEOUT if a timer is not used.
   *
   * Return: CMDQ mailbox client pointer
   */
-struct cmdq_client *cmdq_mbox_create(struct device *dev, int index,
-				     u32 timeout);
+struct cmdq_client *cmdq_mbox_create(struct device *dev, int index);
 
  /**
   * cmdq_mbox_destroy() - destroy CMDQ mailbox client and channel
author maintainer
#2 lore raw

Hi, Matthias:

Matthias Brugger <[email protected]> 於 2020年9月21日 週一 下午4:53寫道:

Quoted 11 lines · Chun-Kuang Hu
Quoted 4 lines

For each client driver, its timeout handler need to dump hardware register or its state machine information, so remove timeout handler in helper function and let client driver implement its own timeout handler.

I don't see the implementation of a client side handler. Did I miss something? Would it make sense to instead add a callback to the handler in cmdq_mbox_create()?

According to the commit message, it make sense to add a callback to the handler in comq_mbox_create().
But for DRM, I would like to check timeout in vblank irq because the register should be applied in vblank. (I have not implement this patch yet)
What I want to say is that different client may have different way to detect timeout and different way to handle it.
If you want, I would add DRM timeout handle patch with this patch, and modify commit message to include different way to detect timeout.

Regards,
Chun-Kuang.

Quoted 154 lines

Regards,
Matthias

Quoted 150 lines
---
  drivers/gpu/drm/mediatek/mtk_drm_crtc.c |  3 +-
  drivers/soc/mediatek/mtk-cmdq-helper.c  | 41 +------------------------
  include/linux/soc/mediatek/mtk-cmdq.h   | 11 +------
  3 files changed, 3 insertions(+), 52 deletions(-)
drivers/gpu/drm/mediatek/mtk_drm_crtc.c +1 -2
index 3fc5511330b9..cabeb7fea2be 100644
@@ -824,8 +824,7 @@ int mtk_drm_crtc_create(struct drm_device *drm_dev,
  #if IS_REACHABLE(CONFIG_MTK_CMDQ)
      mtk_crtc->cmdq_client =
                      cmdq_mbox_create(mtk_crtc->mmsys_dev,
-                                      drm_crtc_index(&mtk_crtc->base),
-                                      2000);
+                                      drm_crtc_index(&mtk_crtc->base));
      if (IS_ERR(mtk_crtc->cmdq_client)) {
              dev_dbg(dev, "mtk_crtc %d failed to create mailbox client, writing register by CPU now\n",
                      drm_crtc_index(&mtk_crtc->base));
drivers/soc/mediatek/mtk-cmdq-helper.c +1 -40
index dc644cfb6419..4f311f035b59 100644
@@ -65,14 +65,7 @@ int cmdq_dev_get_client_reg(struct device *dev,
  }
  EXPORT_SYMBOL(cmdq_dev_get_client_reg);
 
-static void cmdq_client_timeout(struct timer_list *t)
-{
-     struct cmdq_client *client = from_timer(client, t, timer);
-
-     dev_err(client->client.dev, "cmdq timeout!\n");
-}
-
-struct cmdq_client *cmdq_mbox_create(struct device *dev, int index, u32 timeout)
+struct cmdq_client *cmdq_mbox_create(struct device *dev, int index)
  {
      struct cmdq_client *client;
 
@@ -80,12 +73,6 @@ struct cmdq_client *cmdq_mbox_create(struct device *dev, int index, u32 timeout)
      if (!client)
              return (struct cmdq_client *)-ENOMEM;
 
-     client->timeout_ms = timeout;
-     if (timeout != CMDQ_NO_TIMEOUT) {
-             spin_lock_init(&client->lock);
-             timer_setup(&client->timer, cmdq_client_timeout, 0);
-     }
-     client->pkt_cnt = 0;
      client->client.dev = dev;
      client->client.tx_block = false;
      client->client.knows_txdone = true;
@@ -107,11 +94,6 @@ EXPORT_SYMBOL(cmdq_mbox_create);
 
  void cmdq_mbox_destroy(struct cmdq_client *client)
  {
-     if (client->timeout_ms != CMDQ_NO_TIMEOUT) {
-             spin_lock(&client->lock);
-             del_timer_sync(&client->timer);
-             spin_unlock(&client->lock);
-     }
      mbox_free_channel(client->chan);
      kfree(client);
  }
@@ -342,18 +324,6 @@ static void cmdq_pkt_flush_async_cb(struct cmdq_cb_data data)
      struct cmdq_task_cb *cb = &pkt->cb;
      struct cmdq_client *client = (struct cmdq_client *)pkt->cl;
 
-     if (client->timeout_ms != CMDQ_NO_TIMEOUT) {
-             unsigned long flags = 0;
-
-             spin_lock_irqsave(&client->lock, flags);
-             if (--client->pkt_cnt == 0)
-                     del_timer(&client->timer);
-             else
-                     mod_timer(&client->timer, jiffies +
-                               msecs_to_jiffies(client->timeout_ms));
-             spin_unlock_irqrestore(&client->lock, flags);
-     }
-
      dma_sync_single_for_cpu(client->chan->mbox->dev, pkt->pa_base,
                              pkt->cmd_buf_size, DMA_TO_DEVICE);
      if (cb->cb) {
@@ -366,7 +336,6 @@ int cmdq_pkt_flush_async(struct cmdq_pkt *pkt, cmdq_async_flush_cb cb,
                       void *data)
  {
      int err;
-     unsigned long flags = 0;
      struct cmdq_client *client = (struct cmdq_client *)pkt->cl;
 
      pkt->cb.cb = cb;
@@ -377,14 +346,6 @@ int cmdq_pkt_flush_async(struct cmdq_pkt *pkt, cmdq_async_flush_cb cb,
      dma_sync_single_for_device(client->chan->mbox->dev, pkt->pa_base,
                                 pkt->cmd_buf_size, DMA_TO_DEVICE);
 
-     if (client->timeout_ms != CMDQ_NO_TIMEOUT) {
-             spin_lock_irqsave(&client->lock, flags);
-             if (client->pkt_cnt++ == 0)
-                     mod_timer(&client->timer, jiffies +
-                               msecs_to_jiffies(client->timeout_ms));
-             spin_unlock_irqrestore(&client->lock, flags);
-     }
-
      err = mbox_send_message(client->chan, pkt);
      if (err < 0)
              return err;
include/linux/soc/mediatek/mtk-cmdq.h +1 -10
index 2249ecaf77e4..175bd89f46f8 100644
@@ -11,8 +11,6 @@
  #include <linux/mailbox/mtk-cmdq-mailbox.h>
  #include <linux/timer.h>
 
-#define CMDQ_NO_TIMEOUT              0xffffffffu
-
  struct cmdq_pkt;
 
  struct cmdq_client_reg {
@@ -22,12 +20,8 @@ struct cmdq_client_reg {
  };
 
  struct cmdq_client {
-     spinlock_t lock;
-     u32 pkt_cnt;
      struct mbox_client client;
      struct mbox_chan *chan;
-     struct timer_list timer;
-     u32 timeout_ms; /* in unit of microsecond */
  };
 
  /**
@@ -49,13 +43,10 @@ int cmdq_dev_get_client_reg(struct device *dev,
   * cmdq_mbox_create() - create CMDQ mailbox client and channel
   * @dev:    device of CMDQ mailbox client
   * @index:  index of CMDQ mailbox channel
- * @timeout: timeout of a pkt execution by GCE, in unit of microsecond, set
- *           CMDQ_NO_TIMEOUT if a timer is not used.
   *
   * Return: CMDQ mailbox client pointer
   */
-struct cmdq_client *cmdq_mbox_create(struct device *dev, int index,
-                                  u32 timeout);
+struct cmdq_client *cmdq_mbox_create(struct device *dev, int index);
 
  /**
   * cmdq_mbox_destroy() - destroy CMDQ mailbox client and channel
maintainer
#3 lore raw
Quoted 15 lines · Chun-Kuang Hu

Hi, Matthias:

Matthias Brugger <[email protected]> 於 2020年9月21日 週一 下午4:53寫道:

Quoted 11 lines · Chun-Kuang Hu
Quoted 4 lines

For each client driver, its timeout handler need to dump hardware register or its state machine information, so remove timeout handler in helper function and let client driver implement its own timeout handler.

I don't see the implementation of a client side handler. Did I miss something? Would it make sense to instead add a callback to the handler in cmdq_mbox_create()?

Quoted 10 lines

According to the commit message, it make sense to add a callback to the handler in comq_mbox_create().
But for DRM, I would like to check timeout in vblank irq because the register should be applied in vblank. (I have not implement this patch yet)
What I want to say is that different client may have different way to detect timeout and different way to handle it.
If you want, I would add DRM timeout handle patch with this patch, and modify commit message to include different way to detect timeout.

I think that would help me to understand the whole picture.

Thanks a lot!
Matthias

Quoted 157 lines

Regards,
Chun-Kuang.

Quoted 154 lines

Regards,
Matthias

Quoted 150 lines
---
   drivers/gpu/drm/mediatek/mtk_drm_crtc.c |  3 +-
   drivers/soc/mediatek/mtk-cmdq-helper.c  | 41 +------------------------
   include/linux/soc/mediatek/mtk-cmdq.h   | 11 +------
   3 files changed, 3 insertions(+), 52 deletions(-)
drivers/gpu/drm/mediatek/mtk_drm_crtc.c +1 -2
index 3fc5511330b9..cabeb7fea2be 100644
@@ -824,8 +824,7 @@ int mtk_drm_crtc_create(struct drm_device *drm_dev,
   #if IS_REACHABLE(CONFIG_MTK_CMDQ)
       mtk_crtc->cmdq_client =
                       cmdq_mbox_create(mtk_crtc->mmsys_dev,
-                                      drm_crtc_index(&mtk_crtc->base),
-                                      2000);
+                                      drm_crtc_index(&mtk_crtc->base));
       if (IS_ERR(mtk_crtc->cmdq_client)) {
               dev_dbg(dev, "mtk_crtc %d failed to create mailbox client, writing register by CPU now\n",
                       drm_crtc_index(&mtk_crtc->base));
drivers/soc/mediatek/mtk-cmdq-helper.c +1 -40
index dc644cfb6419..4f311f035b59 100644
@@ -65,14 +65,7 @@ int cmdq_dev_get_client_reg(struct device *dev,
   }
   EXPORT_SYMBOL(cmdq_dev_get_client_reg);
 
-static void cmdq_client_timeout(struct timer_list *t)
-{
-     struct cmdq_client *client = from_timer(client, t, timer);
-
-     dev_err(client->client.dev, "cmdq timeout!\n");
-}
-
-struct cmdq_client *cmdq_mbox_create(struct device *dev, int index, u32 timeout)
+struct cmdq_client *cmdq_mbox_create(struct device *dev, int index)
   {
       struct cmdq_client *client;
 
@@ -80,12 +73,6 @@ struct cmdq_client *cmdq_mbox_create(struct device *dev, int index, u32 timeout)
       if (!client)
               return (struct cmdq_client *)-ENOMEM;
 
-     client->timeout_ms = timeout;
-     if (timeout != CMDQ_NO_TIMEOUT) {
-             spin_lock_init(&client->lock);
-             timer_setup(&client->timer, cmdq_client_timeout, 0);
-     }
-     client->pkt_cnt = 0;
       client->client.dev = dev;
       client->client.tx_block = false;
       client->client.knows_txdone = true;
@@ -107,11 +94,6 @@ EXPORT_SYMBOL(cmdq_mbox_create);
 
   void cmdq_mbox_destroy(struct cmdq_client *client)
   {
-     if (client->timeout_ms != CMDQ_NO_TIMEOUT) {
-             spin_lock(&client->lock);
-             del_timer_sync(&client->timer);
-             spin_unlock(&client->lock);
-     }
       mbox_free_channel(client->chan);
       kfree(client);
   }
@@ -342,18 +324,6 @@ static void cmdq_pkt_flush_async_cb(struct cmdq_cb_data data)
       struct cmdq_task_cb *cb = &pkt->cb;
       struct cmdq_client *client = (struct cmdq_client *)pkt->cl;
 
-     if (client->timeout_ms != CMDQ_NO_TIMEOUT) {
-             unsigned long flags = 0;
-
-             spin_lock_irqsave(&client->lock, flags);
-             if (--client->pkt_cnt == 0)
-                     del_timer(&client->timer);
-             else
-                     mod_timer(&client->timer, jiffies +
-                               msecs_to_jiffies(client->timeout_ms));
-             spin_unlock_irqrestore(&client->lock, flags);
-     }
-
       dma_sync_single_for_cpu(client->chan->mbox->dev, pkt->pa_base,
                               pkt->cmd_buf_size, DMA_TO_DEVICE);
       if (cb->cb) {
@@ -366,7 +336,6 @@ int cmdq_pkt_flush_async(struct cmdq_pkt *pkt, cmdq_async_flush_cb cb,
                        void *data)
   {
       int err;
-     unsigned long flags = 0;
       struct cmdq_client *client = (struct cmdq_client *)pkt->cl;
 
       pkt->cb.cb = cb;
@@ -377,14 +346,6 @@ int cmdq_pkt_flush_async(struct cmdq_pkt *pkt, cmdq_async_flush_cb cb,
       dma_sync_single_for_device(client->chan->mbox->dev, pkt->pa_base,
                                  pkt->cmd_buf_size, DMA_TO_DEVICE);
 
-     if (client->timeout_ms != CMDQ_NO_TIMEOUT) {
-             spin_lock_irqsave(&client->lock, flags);
-             if (client->pkt_cnt++ == 0)
-                     mod_timer(&client->timer, jiffies +
-                               msecs_to_jiffies(client->timeout_ms));
-             spin_unlock_irqrestore(&client->lock, flags);
-     }
-
       err = mbox_send_message(client->chan, pkt);
       if (err < 0)
               return err;
include/linux/soc/mediatek/mtk-cmdq.h +1 -10
index 2249ecaf77e4..175bd89f46f8 100644
@@ -11,8 +11,6 @@
   #include <linux/mailbox/mtk-cmdq-mailbox.h>
   #include <linux/timer.h>
 
-#define CMDQ_NO_TIMEOUT              0xffffffffu
-
   struct cmdq_pkt;
 
   struct cmdq_client_reg {
@@ -22,12 +20,8 @@ struct cmdq_client_reg {
   };
 
   struct cmdq_client {
-     spinlock_t lock;
-     u32 pkt_cnt;
       struct mbox_client client;
       struct mbox_chan *chan;
-     struct timer_list timer;
-     u32 timeout_ms; /* in unit of microsecond */
   };
 
   /**
@@ -49,13 +43,10 @@ int cmdq_dev_get_client_reg(struct device *dev,
    * cmdq_mbox_create() - create CMDQ mailbox client and channel
    * @dev:    device of CMDQ mailbox client
    * @index:  index of CMDQ mailbox channel
- * @timeout: timeout of a pkt execution by GCE, in unit of microsecond, set
- *           CMDQ_NO_TIMEOUT if a timer is not used.
    *
    * Return: CMDQ mailbox client pointer
    */
-struct cmdq_client *cmdq_mbox_create(struct device *dev, int index,
-                                  u32 timeout);
+struct cmdq_client *cmdq_mbox_create(struct device *dev, int index);
 
   /**
    * cmdq_mbox_destroy() - destroy CMDQ mailbox client and channel