drivers/misc/mic/card/mic_device.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Intel MIC Platform Software Stack (MPSS)
   4  *
   5  * Copyright(c) 2013 Intel Corporation.
   6  *
   7  * Disclaimer: The codes contained in these modules may be specific to
   8  * the Intel Software Development Platform codenamed: Knights Ferry, and
   9  * the Intel product codenamed: Knights Corner, and are not backward
  10  * compatible with other Intel products. Additionally, Intel will NOT
  11  * support the codes or instruction set in future products.
  12  *
  13  * Intel MIC Card driver.
  14  */
  15 #ifndef _MIC_CARD_DEVICE_H_
  16 #define _MIC_CARD_DEVICE_H_
  17
  18 #include <linux/workqueue.h>
  19 #include <linux/io.h>
  20 #include <linux/interrupt.h>
  21 #include <linux/mic_bus.h>
  22 #include "../bus/scif_bus.h"
  23 #include "../bus/vop_bus.h"
  24
  25 /**
  26  * struct mic_intr_info - Contains h/w specific interrupt sources info
  27  *
  28  * @num_intr: The number of irqs available
  29  */
  30 struct mic_intr_info {
  31         u32 num_intr;
  32 };
  33
  34 /**
  35  * struct mic_irq_info - OS specific irq information
  36  *
  37  * @irq_usage_count: usage count array tracking the number of sources
  38  * assigned for each irq.
  39  */
  40 struct mic_irq_info {
  41         int *irq_usage_count;
  42 };
  43
  44 /**
  45  * struct mic_device -  MIC device information.
  46  *
  47  * @mmio: MMIO bar information.
  48  */
  49 struct mic_device {
  50         struct mic_mw mmio;
  51 };
  52
  53 /**
  54  * struct mic_driver - MIC card driver information.
  55  *
  56  * @name: Name for MIC driver.
  57  * @dbg_dir: debugfs directory of this MIC device.
  58  * @dev: The device backing this MIC.
  59  * @dp: The pointer to the virtio device page.
  60  * @mdev: MIC device information for the host.
  61  * @hotplug_work: Hot plug work for adding/removing virtio devices.
  62  * @irq_info: The OS specific irq information
  63  * @intr_info: H/W specific interrupt information.
  64  * @dma_mbdev: dma device on the MIC virtual bus.
  65  * @dma_ch - Array of DMA channels
  66  * @num_dma_ch - Number of DMA channels available
  67  * @scdev: SCIF device on the SCIF virtual bus.
  68  * @vpdev: Virtio over PCIe device on the VOP virtual bus.
  69  */
  70 struct mic_driver {
  71         char name[20];
  72         struct dentry *dbg_dir;
  73         struct device *dev;
  74         void __iomem *dp;
  75         struct mic_device mdev;
  76         struct work_struct hotplug_work;
  77         struct mic_irq_info irq_info;
  78         struct mic_intr_info intr_info;
  79         struct mbus_device *dma_mbdev;
  80         struct dma_chan *dma_ch[MIC_MAX_DMA_CHAN];
  81         int num_dma_ch;
  82         struct scif_hw_dev *scdev;
  83         struct vop_device *vpdev;
  84 };
  85
  86 /**
  87  * struct mic_irq - opaque pointer used as cookie
  88  */
  89 struct mic_irq;
  90
  91 /**
  92  * mic_mmio_read - read from an MMIO register.
  93  * @mw: MMIO register base virtual address.
  94  * @offset: register offset.
  95  *
  96  * RETURNS: register value.
  97  */
  98 static inline u32 mic_mmio_read(struct mic_mw *mw, u32 offset)
  99 {
 100         return ioread32(mw->va + offset);
 101 }
 102
 103 /**
 104  * mic_mmio_write - write to an MMIO register.
 105  * @mw: MMIO register base virtual address.
 106  * @val: the data value to put into the register
 107  * @offset: register offset.
 108  *
 109  * RETURNS: none.
 110  */
 111 static inline void
 112 mic_mmio_write(struct mic_mw *mw, u32 val, u32 offset)
 113 {
 114         iowrite32(val, mw->va + offset);
 115 }
 116
 117 int mic_driver_init(struct mic_driver *mdrv);
 118 void mic_driver_uninit(struct mic_driver *mdrv);
 119 int mic_next_card_db(void);
 120 struct mic_irq *
 121 mic_request_card_irq(irq_handler_t handler, irq_handler_t thread_fn,
 122                      const char *name, void *data, int db);
 123 void mic_free_card_irq(struct mic_irq *cookie, void *data);
 124 u32 mic_read_spad(struct mic_device *mdev, unsigned int idx);
 125 void mic_send_intr(struct mic_device *mdev, int doorbell);
 126 void mic_send_p2p_intr(int doorbell, struct mic_mw *mw);
 127 int mic_db_to_irq(struct mic_driver *mdrv, int db);
 128 u32 mic_ack_interrupt(struct mic_device *mdev);
 129 void mic_hw_intr_init(struct mic_driver *mdrv);
 130 void __iomem *
 131 mic_card_map(struct mic_device *mdev, dma_addr_t addr, size_t size);
 132 void mic_card_unmap(struct mic_device *mdev, void __iomem *addr);
 133 void __init mic_create_card_debug_dir(struct mic_driver *mdrv);
 134 void mic_delete_card_debug_dir(struct mic_driver *mdrv);
 135 void __init mic_init_card_debugfs(void);
 136 void mic_exit_card_debugfs(void);
 137 #endif