[linux-2.6-block.git] / drivers / misc / mic / host / mic_virtio.h

/*
 * Intel MIC Platform Software Stack (MPSS)
 *
 * Copyright(c) 2013 Intel Corporation.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License, version 2, as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * General Public License for more details.
 *
 * The full GNU General Public License is included in this distribution in
 * the file called "COPYING".
 *
 * Intel MIC Host driver.
 *
 */
#ifndef MIC_VIRTIO_H
#define MIC_VIRTIO_H

#include <linux/virtio_config.h>
#include <linux/mic_ioctl.h>

/*
 * Note on endianness.
 * 1. Host can be both BE or LE
 * 2. Guest/card is LE. Host uses le_to_cpu to access desc/avail
 *    rings and ioreadXX/iowriteXX to access used ring.
 * 3. Device page exposed by host to guest contains LE values. Guest
 *    accesses these using ioreadXX/iowriteXX etc. This way in general we
 *    obey the virtio spec according to which guest works with native
 *    endianness and host is aware of guest endianness and does all
 *    required endianness conversion.
 * 4. Data provided from user space to guest (in ADD_DEVICE and
 *    CONFIG_CHANGE ioctl's) is not interpreted by the driver and should be
 *    in guest endianness.
 */

/**
 * struct mic_vringh - Virtio ring host information.
 *
 * @vring: The MIC vring used for setting up user space mappings.
 * @vrh: The host VRINGH used for accessing the card vrings.
 * @riov: The VRINGH read kernel IOV.
 * @wiov: The VRINGH write kernel IOV.
 * @vr_mutex: Mutex for synchronizing access to the VRING.
 * @buf: Temporary kernel buffer used to copy in/out data
 * from/to the card via DMA.
 * @buf_da: dma address of buf.
 * @mvdev: Back pointer to MIC virtio device for vringh_notify(..).
 * @head: The VRINGH head index address passed to vringh_getdesc_kern(..).
 */
struct mic_vringh {
	struct mic_vring vring;
	struct vringh vrh;
	struct vringh_kiov riov;
	struct vringh_kiov wiov;
	struct mutex vr_mutex;
	void *buf;
	dma_addr_t buf_da;
	struct mic_vdev *mvdev;
	u16 head;
};

/**
 * struct mic_vdev - Host information for a card Virtio device.
 *
 * @virtio_id - Virtio device id.
 * @waitq - Waitqueue to allow ring3 apps to poll.
 * @mdev - Back pointer to host MIC device.
 * @poll_wake - Used for waking up threads blocked in poll.
 * @out_bytes - Debug stats for number of bytes copied from host to card.
 * @in_bytes - Debug stats for number of bytes copied from card to host.
 * @out_bytes_dma - Debug stats for number of bytes copied from host to card
 * using DMA.
 * @in_bytes_dma - Debug stats for number of bytes copied from card to host
 * using DMA.
 * @tx_len_unaligned - Debug stats for number of bytes copied to the card where
 * the transfer length did not have the required DMA alignment.
 * @tx_dst_unaligned - Debug stats for number of bytes copied where the
 * destination address on the card did not have the required DMA alignment.
 * @mvr - Store per VRING data structures.
 * @virtio_bh_work - Work struct used to schedule virtio bottom half handling.
 * @dd - Virtio device descriptor.
 * @dc - Virtio device control fields.
 * @list - List of Virtio devices.
 * @virtio_db - The doorbell used by the card to interrupt the host.
 * @virtio_cookie - The cookie returned while requesting interrupts.
 */
struct mic_vdev {
	int virtio_id;
	wait_queue_head_t waitq;
	struct mic_device *mdev;
	int poll_wake;
	unsigned long out_bytes;
	unsigned long in_bytes;
	unsigned long out_bytes_dma;
	unsigned long in_bytes_dma;
	unsigned long tx_len_unaligned;
	unsigned long tx_dst_unaligned;
	struct mic_vringh mvr[MIC_MAX_VRINGS];
	struct work_struct virtio_bh_work;
	struct mic_device_desc *dd;
	struct mic_device_ctrl *dc;
	struct list_head list;
	int virtio_db;
	struct mic_irq *virtio_cookie;
};

void mic_virtio_uninit(struct mic_device *mdev);
int mic_virtio_add_device(struct mic_vdev *mvdev,
			void __user *argp);
void mic_virtio_del_device(struct mic_vdev *mvdev);
int mic_virtio_config_change(struct mic_vdev *mvdev,
			void __user *argp);
int mic_virtio_copy_desc(struct mic_vdev *mvdev,
	struct mic_copy_desc *request);
void mic_virtio_reset_devices(struct mic_device *mdev);
void mic_bh_handler(struct work_struct *work);

/* Helper API to obtain the MIC PCIe device */
static inline struct device *mic_dev(struct mic_vdev *mvdev)
{
	return &mvdev->mdev->pdev->dev;
}

/* Helper API to check if a virtio device is initialized */
static inline int mic_vdev_inited(struct mic_vdev *mvdev)
{
	/* Device has not been created yet */
	if (!mvdev->dd || !mvdev->dd->type) {
		dev_err(mic_dev(mvdev), "%s %d err %d\n",
			__func__, __LINE__, -EINVAL);
		return -EINVAL;
	}

	/* Device has been removed/deleted */
	if (mvdev->dd->type == -1) {
		dev_err(mic_dev(mvdev), "%s %d err %d\n",
			__func__, __LINE__, -ENODEV);
		return -ENODEV;
	}

	return 0;
}

/* Helper API to check if a virtio device is running */
static inline bool mic_vdevup(struct mic_vdev *mvdev)
{
	return !!mvdev->dd->status;
}
#endif
Commit	Line	Data
f69bcbf3 AD	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 Host driver.
	19	*
	20	*/
	21	#ifndef MIC_VIRTIO_H
	22	#define MIC_VIRTIO_H
	23
	24	#include <linux/virtio_config.h>
	25	#include <linux/mic_ioctl.h>
	26
	27	/*
	28	* Note on endianness.
	29	* 1. Host can be both BE or LE
	30	* 2. Guest/card is LE. Host uses le_to_cpu to access desc/avail
	31	* rings and ioreadXX/iowriteXX to access used ring.
	32	* 3. Device page exposed by host to guest contains LE values. Guest
	33	* accesses these using ioreadXX/iowriteXX etc. This way in general we
	34	* obey the virtio spec according to which guest works with native
	35	* endianness and host is aware of guest endianness and does all
	36	* required endianness conversion.
	37	* 4. Data provided from user space to guest (in ADD_DEVICE and
	38	* CONFIG_CHANGE ioctl's) is not interpreted by the driver and should be
	39	* in guest endianness.
	40	*/
	41
	42	/**
	43	* struct mic_vringh - Virtio ring host information.
	44	*
	45	* @vring: The MIC vring used for setting up user space mappings.
	46	* @vrh: The host VRINGH used for accessing the card vrings.
	47	* @riov: The VRINGH read kernel IOV.
	48	* @wiov: The VRINGH write kernel IOV.
f69bcbf3	49	* @vr_mutex: Mutex for synchronizing access to the VRING.
d4ef098e SY	50	* @buf: Temporary kernel buffer used to copy in/out data
	51	* from/to the card via DMA.
	52	* @buf_da: dma address of buf.
f69bcbf3	53	* @mvdev: Back pointer to MIC virtio device for vringh_notify(..).
d4ef098e	54	* @head: The VRINGH head index address passed to vringh_getdesc_kern(..).
f69bcbf3 AD	55	*/
	56	struct mic_vringh {
	57	struct mic_vring vring;
	58	struct vringh vrh;
	59	struct vringh_kiov riov;
	60	struct vringh_kiov wiov;
f69bcbf3	61	struct mutex vr_mutex;
d4ef098e SY	62	void *buf;
d4ef098e SY	63	dma_addr_t buf_da;
f69bcbf3	64	struct mic_vdev *mvdev;
d4ef098e	65	u16 head;
f69bcbf3 AD	66	};
	67
	68	/**
	69	* struct mic_vdev - Host information for a card Virtio device.
	70	*
	71	* @virtio_id - Virtio device id.
	72	* @waitq - Waitqueue to allow ring3 apps to poll.
	73	* @mdev - Back pointer to host MIC device.
	74	* @poll_wake - Used for waking up threads blocked in poll.
	75	* @out_bytes - Debug stats for number of bytes copied from host to card.
	76	* @in_bytes - Debug stats for number of bytes copied from card to host.
d4ef098e SY	77	* @out_bytes_dma - Debug stats for number of bytes copied from host to card
	78	* using DMA.
	79	* @in_bytes_dma - Debug stats for number of bytes copied from card to host
	80	* using DMA.
	81	* @tx_len_unaligned - Debug stats for number of bytes copied to the card where
	82	* the transfer length did not have the required DMA alignment.
	83	* @tx_dst_unaligned - Debug stats for number of bytes copied where the
	84	* destination address on the card did not have the required DMA alignment.
f69bcbf3 AD	85	* @mvr - Store per VRING data structures.
	86	* @virtio_bh_work - Work struct used to schedule virtio bottom half handling.
	87	* @dd - Virtio device descriptor.
	88	* @dc - Virtio device control fields.
	89	* @list - List of Virtio devices.
	90	* @virtio_db - The doorbell used by the card to interrupt the host.
	91	* @virtio_cookie - The cookie returned while requesting interrupts.
	92	*/
	93	struct mic_vdev {
	94	int virtio_id;
	95	wait_queue_head_t waitq;
	96	struct mic_device *mdev;
	97	int poll_wake;
	98	unsigned long out_bytes;
	99	unsigned long in_bytes;
d4ef098e SY	100	unsigned long out_bytes_dma;
	101	unsigned long in_bytes_dma;
	102	unsigned long tx_len_unaligned;
	103	unsigned long tx_dst_unaligned;
f69bcbf3 AD	104	struct mic_vringh mvr[MIC_MAX_VRINGS];
	105	struct work_struct virtio_bh_work;
	106	struct mic_device_desc *dd;
	107	struct mic_device_ctrl *dc;
	108	struct list_head list;
	109	int virtio_db;
	110	struct mic_irq *virtio_cookie;
	111	};
	112
	113	void mic_virtio_uninit(struct mic_device *mdev);
	114	int mic_virtio_add_device(struct mic_vdev *mvdev,
	115	void __user *argp);
	116	void mic_virtio_del_device(struct mic_vdev *mvdev);
	117	int mic_virtio_config_change(struct mic_vdev *mvdev,
	118	void __user *argp);
	119	int mic_virtio_copy_desc(struct mic_vdev *mvdev,
	120	struct mic_copy_desc *request);
	121	void mic_virtio_reset_devices(struct mic_device *mdev);
	122	void mic_bh_handler(struct work_struct *work);
	123
	124	/* Helper API to obtain the MIC PCIe device */
	125	static inline struct device mic_dev(struct mic_vdev mvdev)
	126	{
1da2b3ee	127	return &mvdev->mdev->pdev->dev;
f69bcbf3 AD	128	}
	129
	130	/* Helper API to check if a virtio device is initialized */
	131	static inline int mic_vdev_inited(struct mic_vdev *mvdev)
	132	{
	133	/* Device has not been created yet */
	134	if (!mvdev->dd \|\| !mvdev->dd->type) {
	135	dev_err(mic_dev(mvdev), "%s %d err %d\n",
	136	__func__, __LINE__, -EINVAL);
	137	return -EINVAL;
	138	}
	139
	140	/* Device has been removed/deleted */
	141	if (mvdev->dd->type == -1) {
	142	dev_err(mic_dev(mvdev), "%s %d err %d\n",
	143	__func__, __LINE__, -ENODEV);
	144	return -ENODEV;
	145	}
	146
	147	return 0;
	148	}
	149
	150	/* Helper API to check if a virtio device is running */
	151	static inline bool mic_vdevup(struct mic_vdev *mvdev)
	152	{
	153	return !!mvdev->dd->status;
	154	}
	155	#endif