[mirror_edk2.git] / OvmfPkg / Include / IndustryStandard / Virtio095.h

/** @file\r
\r
  Generic type and macro definitions corresponding to the virtio-0.9.5\r
  specification.\r
\r
  Copyright (C) 2012-2016, Red Hat, Inc.\r
  Portion of Copyright (C) 2013, ARM Ltd.\r
\r
  This program and the accompanying materials are licensed and made available\r
  under the terms and conditions of the BSD License which accompanies this\r
  distribution. The full text of the license may be found at\r
  http://opensource.org/licenses/bsd-license.php\r
\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT\r
  WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#ifndef _VIRTIO_0_9_5_H_\r
#define _VIRTIO_0_9_5_H_\r
\r
#include <Base.h>\r
\r
//\r
// VirtIo Subsystem Device IDs\r
//\r
#define VIRTIO_SUBSYSTEM_NETWORK_CARD       1\r
#define VIRTIO_SUBSYSTEM_BLOCK_DEVICE       2\r
#define VIRTIO_SUBSYSTEM_CONSOLE            3\r
#define VIRTIO_SUBSYSTEM_ENTROPY_SOURCE     4\r
#define VIRTIO_SUBSYSTEM_MEMORY_BALLOONING  5\r
#define VIRTIO_SUBSYSTEM_IO_MEMORY          6\r
#define VIRTIO_SUBSYSTEM_RPMSG              7\r
#define VIRTIO_SUBSYSTEM_SCSI_HOST          8\r
#define VIRTIO_SUBSYSTEM_9P_TRANSPORT       9\r
#define VIRTIO_SUBSYSTEM_MAC80211_WLAN      10\r
\r
//\r
// Virtio IDs\r
//\r
#define VIRTIO_VENDOR_ID                    0x1AF4\r
#define VIRTIO_MMIO_MAGIC                   0x74726976 // "virt"\r
\r
\r
//\r
// VirtIo Device Specific Configuration Offsets\r
//\r
#define VIRTIO_DEVICE_SPECIFIC_CONFIGURATION_OFFSET_PCI             20\r
#define VIRTIO_DEVICE_SPECIFIC_CONFIGURATION_OFFSET_PCI_WITH_MSI_X  24\r
#define VIRTIO_DEVICE_SPECIFIC_CONFIGURATION_OFFSET_MMIO            0x100\r
\r
//\r
// PCI VirtIo Header Offsets\r
//\r
#define VIRTIO_PCI_OFFSET_DEVICE_FEATURES           0x00\r
#define VIRTIO_PCI_OFFSET_GUEST_FEATURES            0x04\r
#define VIRTIO_PCI_OFFSET_QUEUE_ADDRESS             0x08\r
#define VIRTIO_PCI_OFFSET_QUEUE_SIZE                0x0C\r
#define VIRTIO_PCI_OFFSET_QUEUE_SELECT              0x0E\r
#define VIRTIO_PCI_OFFSET_QUEUE_NOTIFY              0x10\r
#define VIRTIO_PCI_OFFSET_QUEUE_DEVICE_STATUS       0x12\r
#define VIRTIO_PCI_OFFSET_QUEUE_DEVICE_ISR          0x13\r
\r
//\r
// MMIO VirtIo Header Offsets\r
//\r
#define VIRTIO_MMIO_OFFSET_MAGIC                    0x00\r
#define VIRTIO_MMIO_OFFSET_VERSION                  0x04\r
#define VIRTIO_MMIO_OFFSET_DEVICE_ID                0x08\r
#define VIRTIO_MMIO_OFFSET_VENDOR_ID                0x0C\r
#define VIRTIO_MMIO_OFFSET_HOST_FEATURES            0x10\r
#define VIRTIO_MMIO_OFFSET_HOST_FEATURES_SEL        0x14\r
#define VIRTIO_MMIO_OFFSET_GUEST_FEATURES           0x20\r
#define VIRTIO_MMIO_OFFSET_GUEST_FEATURES_SEL       0x24\r
#define VIRTIO_MMIO_OFFSET_GUEST_PAGE_SIZE          0x28\r
#define VIRTIO_MMIO_OFFSET_QUEUE_SEL                0x30\r
#define VIRTIO_MMIO_OFFSET_QUEUE_NUM_MAX            0x34\r
#define VIRTIO_MMIO_OFFSET_QUEUE_NUM                0x38\r
#define VIRTIO_MMIO_OFFSET_QUEUE_ALIGN              0x3C\r
#define VIRTIO_MMIO_OFFSET_QUEUE_PFN                0x40\r
#define VIRTIO_MMIO_OFFSET_QUEUE_NOTIFY             0x50\r
#define VIRTIO_MMIO_OFFSET_INTERRUPT_STATUS         0x60\r
#define VIRTIO_MMIO_OFFSET_INTERRUPT_ACK            0x64\r
#define VIRTIO_MMIO_OFFSET_STATUS                   0x70\r
\r
//\r
// Data in the communication area is defined as packed and accessed as\r
// volatile.\r
//\r
// Some structures contain arrays with dynamically determined size. In such\r
// cases the array and its sibling fields are replaced with pointers.\r
//\r
// All indices (variables and fields named *Idx) are free-running and wrap\r
// around after 0xFFFF. The queue size reported by the host is always an\r
// integral power of 2, not greater than 32768. Actual array indices are\r
// consistently calculated by taking the remainder of a given Idx object modulo\r
// QueueSize. Since 0x10000 is an integral multiple of the QueueSize, UINT16\r
// wraparound is a correct wraparound modulo QueueSize too (it doesn't offset\r
// the remainder class).\r
//\r
// virtio-0.9.5, 2.3.4 Available Ring\r
//\r
#define VRING_AVAIL_F_NO_INTERRUPT BIT0\r
\r
typedef struct {\r
  volatile UINT16 *Flags;\r
  volatile UINT16 *Idx;\r
\r
  volatile UINT16 *Ring;      // QueueSize elements\r
  volatile UINT16 *UsedEvent; // unused as per negotiation\r
} VRING_AVAIL;\r
\r
\r
//\r
// virtio-0.9.5, 2.3.5 Used Ring\r
//\r
#define VRING_USED_F_NO_NOTIFY BIT0\r
\r
#pragma pack(1)\r
typedef struct {\r
  UINT32 Id;\r
  UINT32 Len;\r
} VRING_USED_ELEM;\r
#pragma pack()\r
\r
typedef struct {\r
  volatile UINT16          *Flags;\r
  volatile UINT16          *Idx;\r
  volatile VRING_USED_ELEM *UsedElem;   // QueueSize elements\r
  volatile UINT16          *AvailEvent; // unused as per negotiation\r
} VRING_USED;\r
\r
\r
//\r
// virtio-0.9.5, 2.3.2 Descriptor Table\r
//\r
#define VRING_DESC_F_NEXT     BIT0 // more descriptors in this request\r
#define VRING_DESC_F_WRITE    BIT1 // buffer to be written *by the host*\r
#define VRING_DESC_F_INDIRECT BIT2 // unused\r
\r
#pragma pack(1)\r
typedef struct {\r
  UINT64 Addr;\r
  UINT32 Len;\r
  UINT16 Flags;\r
  UINT16 Next;\r
} VRING_DESC;\r
#pragma pack()\r
\r
typedef struct {\r
  UINTN               NumPages;\r
  VOID                *Base;     // deallocate only this field\r
  volatile VRING_DESC *Desc;     // QueueSize elements\r
  VRING_AVAIL         Avail;\r
  VRING_USED          Used;\r
  UINT16              QueueSize;\r
} VRING;\r
\r
//\r
// virtio-0.9.5, 2.2.2.1 Device Status\r
//\r
#define VSTAT_ACK       BIT0\r
#define VSTAT_DRIVER    BIT1\r
#define VSTAT_DRIVER_OK BIT2\r
#define VSTAT_FAILED    BIT7\r
\r
//\r
// virtio-0.9.5, Appendix B: Reserved (Device-Independent) Feature Bits\r
//\r
#define VIRTIO_F_NOTIFY_ON_EMPTY    BIT24\r
#define VIRTIO_F_RING_INDIRECT_DESC BIT28\r
#define VIRTIO_F_RING_EVENT_IDX     BIT29\r
\r
\r
#endif // _VIRTIO_0_9_5_H_\r
Commit	Line	Data
3eb6278a LE	1	/** @file\r
	2	\r
	3	Generic type and macro definitions corresponding to the virtio-0.9.5\r
	4	specification.\r
	5	\r
	6	Copyright (C) 2012-2016, Red Hat, Inc.\r
	7	Portion of Copyright (C) 2013, ARM Ltd.\r
	8	\r
	9	This program and the accompanying materials are licensed and made available\r
	10	under the terms and conditions of the BSD License which accompanies this\r
	11	distribution. The full text of the license may be found at\r
	12	http://opensource.org/licenses/bsd-license.php\r
	13	\r
	14	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT\r
	15	WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	16	\r
	17	**/\r
	18	\r
	19	#ifndef _VIRTIO_0_9_5_H_\r
	20	#define _VIRTIO_0_9_5_H_\r
	21	\r
	22	#include <Base.h>\r
	23	\r
	24	//\r
	25	// VirtIo Subsystem Device IDs\r
	26	//\r
	27	#define VIRTIO_SUBSYSTEM_NETWORK_CARD 1\r
	28	#define VIRTIO_SUBSYSTEM_BLOCK_DEVICE 2\r
	29	#define VIRTIO_SUBSYSTEM_CONSOLE 3\r
	30	#define VIRTIO_SUBSYSTEM_ENTROPY_SOURCE 4\r
	31	#define VIRTIO_SUBSYSTEM_MEMORY_BALLOONING 5\r
	32	#define VIRTIO_SUBSYSTEM_IO_MEMORY 6\r
	33	#define VIRTIO_SUBSYSTEM_RPMSG 7\r
	34	#define VIRTIO_SUBSYSTEM_SCSI_HOST 8\r
	35	#define VIRTIO_SUBSYSTEM_9P_TRANSPORT 9\r
	36	#define VIRTIO_SUBSYSTEM_MAC80211_WLAN 10\r
	37	\r
	38	//\r
	39	// Virtio IDs\r
	40	//\r
	41	#define VIRTIO_VENDOR_ID 0x1AF4\r
	42	#define VIRTIO_MMIO_MAGIC 0x74726976 // "virt"\r
	43	\r
	44	\r
	45	//\r
	46	// VirtIo Device Specific Configuration Offsets\r
	47	//\r
	48	#define VIRTIO_DEVICE_SPECIFIC_CONFIGURATION_OFFSET_PCI 20\r
	49	#define VIRTIO_DEVICE_SPECIFIC_CONFIGURATION_OFFSET_PCI_WITH_MSI_X 24\r
	50	#define VIRTIO_DEVICE_SPECIFIC_CONFIGURATION_OFFSET_MMIO 0x100\r
	51	\r
	52	//\r
	53	// PCI VirtIo Header Offsets\r
	54	//\r
	55	#define VIRTIO_PCI_OFFSET_DEVICE_FEATURES 0x00\r
	56	#define VIRTIO_PCI_OFFSET_GUEST_FEATURES 0x04\r
	57	#define VIRTIO_PCI_OFFSET_QUEUE_ADDRESS 0x08\r
	58	#define VIRTIO_PCI_OFFSET_QUEUE_SIZE 0x0C\r
	59	#define VIRTIO_PCI_OFFSET_QUEUE_SELECT 0x0E\r
	60	#define VIRTIO_PCI_OFFSET_QUEUE_NOTIFY 0x10\r
	61	#define VIRTIO_PCI_OFFSET_QUEUE_DEVICE_STATUS 0x12\r
	62	#define VIRTIO_PCI_OFFSET_QUEUE_DEVICE_ISR 0x13\r
	63	\r
	64	//\r
65	// MMIO VirtIo Header Offsets\r
66	//\r
67	#define VIRTIO_MMIO_OFFSET_MAGIC 0x00\r
68	#define VIRTIO_MMIO_OFFSET_VERSION 0x04\r
69	#define VIRTIO_MMIO_OFFSET_DEVICE_ID 0x08\r
70	#define VIRTIO_MMIO_OFFSET_VENDOR_ID 0x0C\r
71	#define VIRTIO_MMIO_OFFSET_HOST_FEATURES 0x10\r
72	#define VIRTIO_MMIO_OFFSET_HOST_FEATURES_SEL 0x14\r
73	#define VIRTIO_MMIO_OFFSET_GUEST_FEATURES 0x20\r
74	#define VIRTIO_MMIO_OFFSET_GUEST_FEATURES_SEL 0x24\r
75	#define VIRTIO_MMIO_OFFSET_GUEST_PAGE_SIZE 0x28\r
76	#define VIRTIO_MMIO_OFFSET_QUEUE_SEL 0x30\r
77	#define VIRTIO_MMIO_OFFSET_QUEUE_NUM_MAX 0x34\r
78	#define VIRTIO_MMIO_OFFSET_QUEUE_NUM 0x38\r
79	#define VIRTIO_MMIO_OFFSET_QUEUE_ALIGN 0x3C\r
80	#define VIRTIO_MMIO_OFFSET_QUEUE_PFN 0x40\r
81	#define VIRTIO_MMIO_OFFSET_QUEUE_NOTIFY 0x50\r
82	#define VIRTIO_MMIO_OFFSET_INTERRUPT_STATUS 0x60\r
83	#define VIRTIO_MMIO_OFFSET_INTERRUPT_ACK 0x64\r
84	#define VIRTIO_MMIO_OFFSET_STATUS 0x70\r
85	\r
86	//\r
87	// Data in the communication area is defined as packed and accessed as\r
88	// volatile.\r
89	//\r
90	// Some structures contain arrays with dynamically determined size. In such\r
91	// cases the array and its sibling fields are replaced with pointers.\r
92	//\r
93	// All indices (variables and fields named *Idx) are free-running and wrap\r
94	// around after 0xFFFF. The queue size reported by the host is always an\r
95	// integral power of 2, not greater than 32768. Actual array indices are\r
96	// consistently calculated by taking the remainder of a given Idx object modulo\r
97	// QueueSize. Since 0x10000 is an integral multiple of the QueueSize, UINT16\r
98	// wraparound is a correct wraparound modulo QueueSize too (it doesn't offset\r
99	// the remainder class).\r
100	//\r
101	// virtio-0.9.5, 2.3.4 Available Ring\r
102	//\r
103	#define VRING_AVAIL_F_NO_INTERRUPT BIT0\r
104	\r
105	typedef struct {\r
106	volatile UINT16 *Flags;\r
107	volatile UINT16 *Idx;\r
108	\r
109	volatile UINT16 *Ring; // QueueSize elements\r
110	volatile UINT16 *UsedEvent; // unused as per negotiation\r
111	} VRING_AVAIL;\r
112	\r
113	\r
114	//\r
115	// virtio-0.9.5, 2.3.5 Used Ring\r
116	//\r
117	#define VRING_USED_F_NO_NOTIFY BIT0\r
118	\r
119	#pragma pack(1)\r
120	typedef struct {\r
121	UINT32 Id;\r
122	UINT32 Len;\r
123	} VRING_USED_ELEM;\r
124	#pragma pack()\r
125	\r
126	typedef struct {\r
127	volatile UINT16 *Flags;\r
128	volatile UINT16 *Idx;\r
129	volatile VRING_USED_ELEM *UsedElem; // QueueSize elements\r
130	volatile UINT16 *AvailEvent; // unused as per negotiation\r
131	} VRING_USED;\r
132	\r
133	\r
134	//\r
135	// virtio-0.9.5, 2.3.2 Descriptor Table\r
136	//\r
137	#define VRING_DESC_F_NEXT BIT0 // more descriptors in this request\r
138	#define VRING_DESC_F_WRITE BIT1 // buffer to be written by the host\r
139	#define VRING_DESC_F_INDIRECT BIT2 // unused\r
140	\r
141	#pragma pack(1)\r
142	typedef struct {\r
143	UINT64 Addr;\r
144	UINT32 Len;\r
145	UINT16 Flags;\r
146	UINT16 Next;\r
147	} VRING_DESC;\r
148	#pragma pack()\r
149	\r
150	typedef struct {\r
151	UINTN NumPages;\r
152	VOID *Base; // deallocate only this field\r
153	volatile VRING_DESC *Desc; // QueueSize elements\r
154	VRING_AVAIL Avail;\r
155	VRING_USED Used;\r
156	UINT16 QueueSize;\r
157	} VRING;\r
158	\r
159	//\r
160	// virtio-0.9.5, 2.2.2.1 Device Status\r
161	//\r
162	#define VSTAT_ACK BIT0\r
163	#define VSTAT_DRIVER BIT1\r
164	#define VSTAT_DRIVER_OK BIT2\r
165	#define VSTAT_FAILED BIT7\r
166	\r
167	//\r
168	// virtio-0.9.5, Appendix B: Reserved (Device-Independent) Feature Bits\r
169	//\r
170	#define VIRTIO_F_NOTIFY_ON_EMPTY BIT24\r
171	#define VIRTIO_F_RING_INDIRECT_DESC BIT28\r
172	#define VIRTIO_F_RING_EVENT_IDX BIT29\r
173	\r
174	\r
175	#endif // _VIRTIO_0_9_5_H_\r