Commit | Line | Data |
---|---|---|
3a6a9201 SD |
1 | /* |
2 | * Intel MIC Platform Software Stack (MPSS) | |
3 | * | |
4 | * Copyright(c) 2013 Intel Corporation. | |
5 | * | |
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. | |
9 | * | |
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. | |
14 | * | |
15 | * The full GNU General Public License is included in this distribution in | |
16 | * the file called "COPYING". | |
17 | * | |
18 | * Intel MIC driver. | |
19 | * | |
20 | */ | |
21 | #ifndef __MIC_COMMON_H_ | |
22 | #define __MIC_COMMON_H_ | |
23 | ||
f69bcbf3 AD |
24 | #include <linux/virtio_ring.h> |
25 | ||
1e31aa92 | 26 | #define __mic_align(a, x) (((a) + (x) - 1) & ~((x) - 1)) |
f69bcbf3 AD |
27 | |
28 | /** | |
29 | * struct mic_device_desc: Virtio device information shared between the | |
30 | * virtio driver and userspace backend | |
31 | * | |
32 | * @type: Device type: console/network/disk etc. Type 0/-1 terminates. | |
33 | * @num_vq: Number of virtqueues. | |
34 | * @feature_len: Number of bytes of feature bits. Multiply by 2: one for | |
35 | host features and one for guest acknowledgements. | |
36 | * @config_len: Number of bytes of the config array after virtqueues. | |
37 | * @status: A status byte, written by the Guest. | |
38 | * @config: Start of the following variable length config. | |
39 | */ | |
40 | struct mic_device_desc { | |
41 | __s8 type; | |
42 | __u8 num_vq; | |
43 | __u8 feature_len; | |
44 | __u8 config_len; | |
45 | __u8 status; | |
173c0727 | 46 | __le64 config[0]; |
1e31aa92 | 47 | } __attribute__ ((aligned(8))); |
f69bcbf3 AD |
48 | |
49 | /** | |
50 | * struct mic_device_ctrl: Per virtio device information in the device page | |
51 | * used internally by the host and card side drivers. | |
52 | * | |
53 | * @vdev: Used for storing MIC vdev information by the guest. | |
54 | * @config_change: Set to 1 by host when a config change is requested. | |
55 | * @vdev_reset: Set to 1 by guest to indicate virtio device has been reset. | |
56 | * @guest_ack: Set to 1 by guest to ack a command. | |
57 | * @host_ack: Set to 1 by host to ack a command. | |
58 | * @used_address_updated: Set to 1 by guest when the used address should be | |
59 | * updated. | |
60 | * @c2h_vdev_db: The doorbell number to be used by guest. Set by host. | |
61 | * @h2c_vdev_db: The doorbell number to be used by host. Set by guest. | |
62 | */ | |
63 | struct mic_device_ctrl { | |
173c0727 | 64 | __le64 vdev; |
f69bcbf3 AD |
65 | __u8 config_change; |
66 | __u8 vdev_reset; | |
67 | __u8 guest_ack; | |
68 | __u8 host_ack; | |
69 | __u8 used_address_updated; | |
70 | __s8 c2h_vdev_db; | |
71 | __s8 h2c_vdev_db; | |
1e31aa92 | 72 | } __attribute__ ((aligned(8))); |
3a6a9201 SD |
73 | |
74 | /** | |
75 | * struct mic_bootparam: Virtio device independent information in device page | |
76 | * | |
77 | * @magic: A magic value used by the card to ensure it can see the host | |
78 | * @c2h_shutdown_db: Card to Host shutdown doorbell set by host | |
79 | * @h2c_shutdown_db: Host to Card shutdown doorbell set by card | |
80 | * @h2c_config_db: Host to Card Virtio config doorbell set by card | |
81 | * @shutdown_status: Card shutdown status set by card | |
82 | * @shutdown_card: Set to 1 by the host when a card shutdown is initiated | |
c9d5c53d SD |
83 | * @tot_nodes: Total number of nodes in the SCIF network |
84 | * @node_id: Unique id of the node | |
85 | * @h2c_scif_db - Host to card SCIF doorbell set by card | |
86 | * @c2h_scif_db - Card to host SCIF doorbell set by host | |
87 | * @scif_host_dma_addr - SCIF host queue pair DMA address | |
88 | * @scif_card_dma_addr - SCIF card queue pair DMA address | |
3a6a9201 SD |
89 | */ |
90 | struct mic_bootparam { | |
173c0727 | 91 | __le32 magic; |
3a6a9201 SD |
92 | __s8 c2h_shutdown_db; |
93 | __s8 h2c_shutdown_db; | |
94 | __s8 h2c_config_db; | |
95 | __u8 shutdown_status; | |
96 | __u8 shutdown_card; | |
c9d5c53d SD |
97 | __u8 tot_nodes; |
98 | __u8 node_id; | |
99 | __u8 h2c_scif_db; | |
100 | __u8 c2h_scif_db; | |
101 | __u64 scif_host_dma_addr; | |
102 | __u64 scif_card_dma_addr; | |
1e31aa92 | 103 | } __attribute__ ((aligned(8))); |
3a6a9201 | 104 | |
f69bcbf3 AD |
105 | /** |
106 | * struct mic_device_page: High level representation of the device page | |
107 | * | |
108 | * @bootparam: The bootparam structure is used for sharing information and | |
109 | * status updates between MIC host and card drivers. | |
110 | * @desc: Array of MIC virtio device descriptors. | |
111 | */ | |
112 | struct mic_device_page { | |
113 | struct mic_bootparam bootparam; | |
114 | struct mic_device_desc desc[0]; | |
115 | }; | |
116 | /** | |
117 | * struct mic_vqconfig: This is how we expect the device configuration field | |
118 | * for a virtqueue to be laid out in config space. | |
119 | * | |
120 | * @address: Guest/MIC physical address of the virtio ring | |
121 | * (avail and desc rings) | |
122 | * @used_address: Guest/MIC physical address of the used ring | |
123 | * @num: The number of entries in the virtio_ring | |
124 | */ | |
125 | struct mic_vqconfig { | |
173c0727 AD |
126 | __le64 address; |
127 | __le64 used_address; | |
128 | __le16 num; | |
1e31aa92 | 129 | } __attribute__ ((aligned(8))); |
f69bcbf3 AD |
130 | |
131 | /* | |
132 | * The alignment to use between consumer and producer parts of vring. | |
133 | * This is pagesize for historical reasons. | |
134 | */ | |
135 | #define MIC_VIRTIO_RING_ALIGN 4096 | |
136 | ||
137 | #define MIC_MAX_VRINGS 4 | |
138 | #define MIC_VRING_ENTRIES 128 | |
139 | ||
140 | /* | |
141 | * Max vring entries (power of 2) to ensure desc and avail rings | |
142 | * fit in a single page | |
143 | */ | |
144 | #define MIC_MAX_VRING_ENTRIES 128 | |
145 | ||
146 | /** | |
147 | * Max size of the desc block in bytes: includes: | |
148 | * - struct mic_device_desc | |
149 | * - struct mic_vqconfig (num_vq of these) | |
150 | * - host and guest features | |
151 | * - virtio device config space | |
152 | */ | |
153 | #define MIC_MAX_DESC_BLK_SIZE 256 | |
154 | ||
155 | /** | |
156 | * struct _mic_vring_info - Host vring info exposed to userspace backend | |
157 | * for the avail index and magic for the card. | |
158 | * | |
159 | * @avail_idx: host avail idx | |
160 | * @magic: A magic debug cookie. | |
161 | */ | |
162 | struct _mic_vring_info { | |
163 | __u16 avail_idx; | |
173c0727 | 164 | __le32 magic; |
f69bcbf3 AD |
165 | }; |
166 | ||
167 | /** | |
168 | * struct mic_vring - Vring information. | |
169 | * | |
170 | * @vr: The virtio ring. | |
171 | * @info: Host vring information exposed to the userspace backend for the | |
172 | * avail index and magic for the card. | |
173 | * @va: The va for the buffer allocated for vr and info. | |
174 | * @len: The length of the buffer required for allocating vr and info. | |
175 | */ | |
176 | struct mic_vring { | |
177 | struct vring vr; | |
178 | struct _mic_vring_info *info; | |
179 | void *va; | |
180 | int len; | |
181 | }; | |
182 | ||
1e31aa92 | 183 | #define mic_aligned_desc_size(d) __mic_align(mic_desc_size(d), 8) |
f69bcbf3 AD |
184 | |
185 | #ifndef INTEL_MIC_CARD | |
186 | static inline unsigned mic_desc_size(const struct mic_device_desc *desc) | |
187 | { | |
1e31aa92 AD |
188 | return sizeof(*desc) + desc->num_vq * sizeof(struct mic_vqconfig) |
189 | + desc->feature_len * 2 + desc->config_len; | |
f69bcbf3 AD |
190 | } |
191 | ||
192 | static inline struct mic_vqconfig * | |
193 | mic_vq_config(const struct mic_device_desc *desc) | |
194 | { | |
195 | return (struct mic_vqconfig *)(desc + 1); | |
196 | } | |
197 | ||
198 | static inline __u8 *mic_vq_features(const struct mic_device_desc *desc) | |
199 | { | |
200 | return (__u8 *)(mic_vq_config(desc) + desc->num_vq); | |
201 | } | |
202 | ||
203 | static inline __u8 *mic_vq_configspace(const struct mic_device_desc *desc) | |
204 | { | |
205 | return mic_vq_features(desc) + desc->feature_len * 2; | |
206 | } | |
207 | static inline unsigned mic_total_desc_size(struct mic_device_desc *desc) | |
208 | { | |
1e31aa92 | 209 | return mic_aligned_desc_size(desc) + sizeof(struct mic_device_ctrl); |
f69bcbf3 AD |
210 | } |
211 | #endif | |
212 | ||
3a6a9201 SD |
213 | /* Device page size */ |
214 | #define MIC_DP_SIZE 4096 | |
215 | ||
216 | #define MIC_MAGIC 0xc0ffee00 | |
217 | ||
218 | /** | |
219 | * enum mic_states - MIC states. | |
220 | */ | |
221 | enum mic_states { | |
222 | MIC_OFFLINE = 0, | |
223 | MIC_ONLINE, | |
224 | MIC_SHUTTING_DOWN, | |
225 | MIC_RESET_FAILED, | |
af190494 DC |
226 | MIC_SUSPENDING, |
227 | MIC_SUSPENDED, | |
3a6a9201 SD |
228 | MIC_LAST |
229 | }; | |
230 | ||
231 | /** | |
232 | * enum mic_status - MIC status reported by card after | |
233 | * a host or card initiated shutdown or a card crash. | |
234 | */ | |
235 | enum mic_status { | |
236 | MIC_NOP = 0, | |
237 | MIC_CRASHED, | |
238 | MIC_HALTED, | |
239 | MIC_POWER_OFF, | |
240 | MIC_RESTART, | |
241 | MIC_STATUS_LAST | |
242 | }; | |
243 | ||
244 | #endif |