VirtioDevice.h

Go to the documentation of this file.

 
#ifndef __VIRTIO_DEVICE_H__
#define __VIRTIO_DEVICE_H__
 
#include <IndustryStandard/Virtio.h>
 
//
// VirtIo Specification Revision: Major[31:24].Minor[23:16].Revision[15:0]
//
#define VIRTIO_SPEC_REVISION(major, minor, revision) \
  ((((major) & 0xFF) << 24) | (((minor) & 0xFF) << 16) | ((revision) & 0xFFFF))
 
#define VIRTIO_DEVICE_PROTOCOL_GUID  {\
  0xfa920010, 0x6785, 0x4941, {0xb6, 0xec, 0x49, 0x8c, 0x57, 0x9f, 0x16, 0x0a }\
  }
 
typedef struct _VIRTIO_DEVICE_PROTOCOL VIRTIO_DEVICE_PROTOCOL;
 
//
// VIRTIO Operation for VIRTIO_MAP_SHARED
//
typedef enum {
  //
  // A read operation from system memory by a bus master
  //
  VirtioOperationBusMasterRead,
  //
  // A write operation to system memory by a bus master
  //
  VirtioOperationBusMasterWrite,
  //
  // Provides both read and write access to system memory by both the
  // processor and a bus master
  //
  VirtioOperationBusMasterCommonBuffer,
} VIRTIO_MAP_OPERATION;
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_DEVICE_READ)(
  IN  VIRTIO_DEVICE_PROTOCOL *This,
  IN  UINTN                  FieldOffset,
  IN  UINTN                  FieldSize,
  IN  UINTN                  BufferSize,
  OUT VOID                   *Buffer
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_DEVICE_WRITE)(
  IN VIRTIO_DEVICE_PROTOCOL *This,
  IN UINTN                  FieldOffset,
  IN UINTN                  FieldSize,
  IN UINT64                 Value
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_GET_DEVICE_FEATURES)(
  IN VIRTIO_DEVICE_PROTOCOL *This,
  OUT UINT64                *DeviceFeatures
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_SET_GUEST_FEATURES)(
  IN VIRTIO_DEVICE_PROTOCOL  *This,
  IN UINT64                   Features
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_SET_QUEUE_ADDRESS)(
  IN VIRTIO_DEVICE_PROTOCOL  *This,
  IN VRING                   *Ring,
  IN UINT64                  RingBaseShift
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_SET_QUEUE_SEL)(
  IN VIRTIO_DEVICE_PROTOCOL  *This,
  IN UINT16                   Index
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_SET_QUEUE_NOTIFY)(
  IN VIRTIO_DEVICE_PROTOCOL  *This,
  IN UINT16                   Index
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_SET_QUEUE_ALIGN)(
  IN VIRTIO_DEVICE_PROTOCOL  *This,
  IN UINT32                   Alignment
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_SET_PAGE_SIZE)(
  IN VIRTIO_DEVICE_PROTOCOL  *This,
  IN UINT32                   PageSize
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_GET_QUEUE_NUM_MAX)(
  IN  VIRTIO_DEVICE_PROTOCOL  *This,
  OUT UINT16                  *QueueNumMax
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_SET_QUEUE_NUM)(
  IN VIRTIO_DEVICE_PROTOCOL  *This,
  IN UINT16                   QueueSize
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_GET_DEVICE_STATUS)(
  IN  VIRTIO_DEVICE_PROTOCOL  *This,
  OUT UINT8                   *DeviceStatus
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_SET_DEVICE_STATUS)(
  IN VIRTIO_DEVICE_PROTOCOL  *This,
  IN UINT8                   DeviceStatus
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_ALLOCATE_SHARED)(
  IN     VIRTIO_DEVICE_PROTOCOL                   *This,
  IN     UINTN                                    Pages,
  IN OUT VOID                                     **HostAddress
  );
 
typedef
VOID
(EFIAPI *VIRTIO_FREE_SHARED)(
  IN  VIRTIO_DEVICE_PROTOCOL                   *This,
  IN  UINTN                                    Pages,
  IN  VOID                                     *HostAddress
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_MAP_SHARED)(
  IN     VIRTIO_DEVICE_PROTOCOL       *This,
  IN     VIRTIO_MAP_OPERATION         Operation,
  IN     VOID                         *HostAddress,
  IN OUT UINTN                        *NumberOfBytes,
  OUT    EFI_PHYSICAL_ADDRESS         *DeviceAddress,
  OUT    VOID                         **Mapping
  );
 
typedef
EFI_STATUS
(EFIAPI *VIRTIO_UNMAP_SHARED)(
  IN  VIRTIO_DEVICE_PROTOCOL    *This,
  IN  VOID                      *Mapping
  );
 
struct _VIRTIO_DEVICE_PROTOCOL {
  //
  // VirtIo Specification Revision encoded with VIRTIO_SPEC_REVISION()
  //
  UINT32                        Revision;
  //
  // From the Virtio Spec
  //
  INT32                         SubSystemDeviceId;
 
  VIRTIO_GET_DEVICE_FEATURES    GetDeviceFeatures;
  VIRTIO_SET_GUEST_FEATURES     SetGuestFeatures;
 
  VIRTIO_SET_QUEUE_ADDRESS      SetQueueAddress;
 
  VIRTIO_SET_QUEUE_SEL          SetQueueSel;
 
  VIRTIO_SET_QUEUE_NOTIFY       SetQueueNotify;
 
  VIRTIO_SET_QUEUE_ALIGN        SetQueueAlign;
  VIRTIO_SET_PAGE_SIZE          SetPageSize;
 
  VIRTIO_GET_QUEUE_NUM_MAX      GetQueueNumMax;
  VIRTIO_SET_QUEUE_NUM          SetQueueNum;
 
  VIRTIO_GET_DEVICE_STATUS      GetDeviceStatus;
  VIRTIO_SET_DEVICE_STATUS      SetDeviceStatus;
 
  //
  // Functions to read/write Device Specific headers
  //
  VIRTIO_DEVICE_WRITE           WriteDevice;
  VIRTIO_DEVICE_READ            ReadDevice;
 
  //
  // Functions to allocate, free, map and unmap shared buffer
  //
  VIRTIO_ALLOCATE_SHARED        AllocateSharedPages;
  VIRTIO_FREE_SHARED            FreeSharedPages;
  VIRTIO_MAP_SHARED             MapSharedBuffer;
  VIRTIO_UNMAP_SHARED           UnmapSharedBuffer;
};
 
extern EFI_GUID  gVirtioDeviceProtocolGuid;
 
#endif