2 * Intel MIC Platform Software Stack (MPSS)
4 * Copyright(c) 2013 Intel Corporation.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License, version 2, as
8 * published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * General Public License for more details.
15 * The full GNU General Public License is included in this distribution in
16 * the file called "COPYING".
18 * Intel MIC Host driver.
21 #ifndef _MIC_DEVICE_H_
22 #define _MIC_DEVICE_H_
24 #include <linux/cdev.h>
25 #include <linux/idr.h>
26 #include <linux/notifier.h>
27 #include <linux/irqreturn.h>
31 /* The maximum number of MIC devices supported in a single host system. */
32 #define MIC_MAX_NUM_DEVS 256
35 * enum mic_hw_family - The hardware family to which a device belongs.
43 * enum mic_stepping - MIC stepping ids.
53 * struct mic_device - MIC device information for each card.
55 * @mmio: MMIO bar information.
56 * @aper: Aperture bar information.
57 * @family: The MIC family to which this device belongs.
58 * @ops: MIC HW specific operations.
59 * @id: The unique device id for this MIC device.
60 * @stepping: Stepping ID.
61 * @attr_group: Pointer to list of sysfs attribute groups.
62 * @sdev: Device for sysfs entries.
63 * @mic_mutex: Mutex for synchronizing access to mic_device.
64 * @intr_ops: HW specific interrupt operations.
65 * @smpt_ops: Hardware specific SMPT operations.
66 * @smpt: MIC SMPT information.
67 * @intr_info: H/W specific interrupt information.
68 * @irq_info: The OS specific irq information
69 * @dbg_dir: debugfs directory of this MIC device.
70 * @cmdline: Kernel command line.
71 * @firmware: Firmware file name.
72 * @ramdisk: Ramdisk file name.
73 * @bootmode: Boot mode i.e. "linux" or "elf" for flash updates.
74 * @bootaddr: MIC boot address.
75 * @reset_trigger_work: Work for triggering reset requests.
76 * @shutdown_work: Work for handling shutdown interrupts.
78 * @shutdown_status: MIC status reported by card for shutdown/crashes.
79 * @state_sysfs: Sysfs dirent for notifying ring 3 about MIC state changes.
80 * @reset_wait: Waitqueue for sleeping while reset completes.
81 * @log_buf_addr: Log buffer address for MIC.
82 * @log_buf_len: Log buffer length address for MIC.
83 * @dp: virtio device page
84 * @dp_dma_addr: virtio device page DMA address.
85 * @shutdown_db: shutdown doorbell.
86 * @shutdown_cookie: shutdown cookie.
87 * @cdev: Character device for MIC.
88 * @vdev_list: list of virtio devices.
89 * @pm_notifier: Handles PM notifications from the OS.
94 enum mic_hw_family family;
95 struct mic_hw_ops *ops;
97 enum mic_stepping stepping;
98 const struct attribute_group **attr_group;
100 struct mutex mic_mutex;
101 struct mic_hw_intr_ops *intr_ops;
102 struct mic_smpt_ops *smpt_ops;
103 struct mic_smpt_info *smpt;
104 struct mic_intr_info *intr_info;
105 struct mic_irq_info irq_info;
106 struct dentry *dbg_dir;
112 struct work_struct reset_trigger_work;
113 struct work_struct shutdown_work;
116 struct kernfs_node *state_sysfs;
117 struct completion reset_wait;
121 dma_addr_t dp_dma_addr;
123 struct mic_irq *shutdown_cookie;
125 struct list_head vdev_list;
126 struct notifier_block pm_notifier;
130 * struct mic_hw_ops - MIC HW specific operations.
131 * @aper_bar: Aperture bar resource number.
132 * @mmio_bar: MMIO bar resource number.
133 * @read_spad: Read from scratch pad register.
134 * @write_spad: Write to scratch pad register.
135 * @send_intr: Send an interrupt for a particular doorbell on the card.
136 * @ack_interrupt: Hardware specific operations to ack the h/w on
137 * receipt of an interrupt.
138 * @intr_workarounds: Hardware specific workarounds needed after
139 * handling an interrupt.
140 * @reset: Reset the remote processor.
141 * @reset_fw_ready: Reset firmware ready field.
142 * @is_fw_ready: Check if firmware is ready for OS download.
143 * @send_firmware_intr: Send an interrupt to the card firmware.
144 * @load_mic_fw: Load firmware segments required to boot the card
145 * into card memory. This includes the kernel, command line, ramdisk etc.
146 * @get_postcode: Get post code status from firmware.
151 u32 (*read_spad)(struct mic_device *mdev, unsigned int idx);
152 void (*write_spad)(struct mic_device *mdev, unsigned int idx, u32 val);
153 void (*send_intr)(struct mic_device *mdev, int doorbell);
154 u32 (*ack_interrupt)(struct mic_device *mdev);
155 void (*intr_workarounds)(struct mic_device *mdev);
156 void (*reset)(struct mic_device *mdev);
157 void (*reset_fw_ready)(struct mic_device *mdev);
158 bool (*is_fw_ready)(struct mic_device *mdev);
159 void (*send_firmware_intr)(struct mic_device *mdev);
160 int (*load_mic_fw)(struct mic_device *mdev, const char *buf);
161 u32 (*get_postcode)(struct mic_device *mdev);
165 * mic_mmio_read - read from an MMIO register.
166 * @mw: MMIO register base virtual address.
167 * @offset: register offset.
169 * RETURNS: register value.
171 static inline u32 mic_mmio_read(struct mic_mw *mw, u32 offset)
173 return ioread32(mw->va + offset);
177 * mic_mmio_write - write to an MMIO register.
178 * @mw: MMIO register base virtual address.
179 * @val: the data value to put into the register
180 * @offset: register offset.
185 mic_mmio_write(struct mic_mw *mw, u32 val, u32 offset)
187 iowrite32(val, mw->va + offset);
190 void mic_sysfs_init(struct mic_device *mdev);
191 int mic_start(struct mic_device *mdev, const char *buf);
192 void mic_stop(struct mic_device *mdev, bool force);
193 void mic_shutdown(struct mic_device *mdev);
194 void mic_reset_delayed_work(struct work_struct *work);
195 void mic_reset_trigger_work(struct work_struct *work);
196 void mic_shutdown_work(struct work_struct *work);
197 void mic_bootparam_init(struct mic_device *mdev);
198 void mic_set_state(struct mic_device *mdev, u8 state);
199 void mic_set_shutdown_status(struct mic_device *mdev, u8 status);
200 void mic_create_debug_dir(struct mic_device *dev);
201 void mic_delete_debug_dir(struct mic_device *dev);
202 void __init mic_init_debugfs(void);
203 void mic_exit_debugfs(void);
204 void mic_prepare_suspend(struct mic_device *mdev);
205 void mic_complete_resume(struct mic_device *mdev);
206 void mic_suspend(struct mic_device *mdev);