L4Re Operating System Framework – Interface and Usage Documentation
Loading...
Searching...
No Matches
virtio.h
1/* SPDX-License-Identifier: GPL-2.0-only or License-Ref-kk-custom */
2/*
3 * Copyright (C) 2013-2022 Kernkonzept GmbH.
4 * Author(s): Alexander Warg <alexander.warg@kernkonzept.com>
5 * Matthias Lange <matthias.lange@kernkonzept.com>
6 *
7 */
8#pragma once
9
28#include <l4/sys/utcb.h>
29#include <l4/sys/ipc.h>
30#include <l4/sys/types.h>
31
34{
35 L4VIRTIO_PROTOCOL = 0,
36};
37
38enum L4virtio_magic
39{
40 L4VIRTIO_MAGIC = 0x74726976
41};
42
43enum L4virtio_vendor
44{
45 L4VIRTIO_VENDOR_KK = 0x44
46};
47
59
80
91
100
110
115{
116 L4VIRTIO_CMD_NONE = 0x00000000,
119 L4VIRTIO_CMD_MASK = 0xff000000,
120};
121
126{
133 l4_uint32_t dev_features_sel;
134 l4_uint32_t _res1[2];
135
136 l4_uint32_t driver_features;
137 l4_uint32_t driver_features_sel;
138
139 /* some L4virtio specific members ... */
143 /* must start at 0x30 (per virtio-mmio layout) */
144 l4_uint32_t queue_sel;
145 l4_uint32_t queue_num_max;
146 l4_uint32_t queue_num;
147 l4_uint32_t _res3[2];
148 l4_uint32_t queue_ready;
149 l4_uint32_t _res4[2];
150
151 l4_uint32_t queue_notify;
152 l4_uint32_t _res5[3];
153
154 l4_uint32_t irq_status;
155 l4_uint32_t irq_ack;
156 l4_uint32_t _res6[2];
157
165 l4_uint32_t _res7[3];
166
167 l4_uint64_t queue_desc;
168 l4_uint32_t _res8[2];
169 l4_uint64_t queue_avail;
170 l4_uint32_t _res9[2];
171 l4_uint64_t queue_used;
172
173 /* use the unused space here for device and driver feature bitmaps */
174 l4_uint32_t dev_features_map[8];
175 l4_uint32_t driver_features_map[8];
176
177 l4_uint32_t _res10[2];
178
183
186 l4_uint32_t generation;
188
226
228
239
245L4_INLINE void *
247{
248 return (void *)(((l4_addr_t)cfg) + 0x100);
249}
250
254L4_INLINE void
255l4virtio_set_feature(l4_uint32_t *feature_map, unsigned feat)
256{
257 unsigned idx = feat / 32;
258
259 if (idx < 8)
260 feature_map[idx] |= 1UL << (feat % 32);
261}
262
266L4_INLINE void
267l4virtio_clear_feature(l4_uint32_t *feature_map, unsigned feat)
268{
269 unsigned idx = feat / 32;
270
271 if (idx < 8)
272 feature_map[idx] &= ~(1UL << (feat % 32));
273}
274
278L4_INLINE unsigned
279l4virtio_get_feature(l4_uint32_t *feature_map, unsigned feat)
280{
281 unsigned idx = feat / 32;
282
283 if (idx >= 8)
284 return 0;
285
286 return feature_map[idx] & (1UL << (feat % 32));
287}
288
294L4_CV int
296
302L4_CV int
304
310L4_CV int
312 l4_uint64_t base, l4_umword_t offset,
314
320L4_CV int
322 l4_addr_t *ds_offset) L4_NOTHROW;
323
329L4_CV int
332
334
unsigned long l4_umword_t
Unsigned machine word.
Definition l4int.h:51
unsigned long l4_addr_t
Address type.
Definition l4int.h:45
unsigned int l4_uint32_t
Unsigned 32bit value.
Definition l4int.h:40
unsigned short int l4_uint16_t
Unsigned 16bit value.
Definition l4int.h:38
unsigned long long l4_uint64_t
Unsigned 64bit value.
Definition l4int.h:42
unsigned long l4_cap_idx_t
Capability selector type.
Definition types.h:358
#define L4_CV
Define calling convention.
Definition linkage.h:44
#define L4_NOTHROW
Mark a function declaration and definition as never throwing an exception.
Definition compiler.h:188
#define L4_INLINE
L4 Inline function attribute.
Definition compiler.h:62
#define EXTERN_C_BEGIN
Start section with C types and functions.
Definition compiler.h:192
#define EXTERN_C_END
End section with C types and functions.
Definition compiler.h:193
L4virtio_feature_bits
L4virtio-specific feature bits.
Definition virtio.h:94
L4virtio_device_status
Virtio device status bits.
Definition virtio.h:83
int l4virtio_set_status(l4_cap_idx_t cap, unsigned status) L4_NOTHROW
int l4virtio_device_notification_irq(l4_cap_idx_t cap, unsigned index, l4_cap_idx_t irq) L4_NOTHROW
L4_virtio_opcodes
Opcodes to setup and configure a device.
Definition virtio.h:52
l4virtio_config_queue_t * l4virtio_config_queues(l4virtio_config_hdr_t const *cfg)
Get the pointer to the first queue config.
Definition virtio.h:235
L4_virtio_cmd
Virtio commands for device configuration.
Definition virtio.h:115
L4_virtio_protocol
L4-VIRTIO protocol number.
Definition virtio.h:34
int l4virtio_config_queue(l4_cap_idx_t cap, unsigned queue) L4_NOTHROW
int l4virtio_device_config_ds(l4_cap_idx_t cap, l4_cap_idx_t config_ds, l4_addr_t *ds_offset) L4_NOTHROW
L4virtio_device_ids
Virtio device IDs as reported in the driver's config space.
Definition virtio.h:62
void * l4virtio_device_config(l4virtio_config_hdr_t const *cfg)
Get the pointer to the device configuration.
Definition virtio.h:246
void l4virtio_clear_feature(l4_uint32_t *feature_map, unsigned feat)
Clear the given feature bit in a feature map.
Definition virtio.h:267
void l4virtio_set_feature(l4_uint32_t *feature_map, unsigned feat)
Set the given feature bit in a feature map.
Definition virtio.h:255
int l4virtio_register_ds(l4_cap_idx_t cap, l4_cap_idx_t ds_cap, l4_uint64_t base, l4_umword_t offset, l4_umword_t size) L4_NOTHROW
unsigned l4virtio_get_feature(l4_uint32_t *feature_map, unsigned feat)
Check if the given bit in a feature map is set.
Definition virtio.h:279
L4_virtio_irq_status
VIRTIO IRQ status codes (l4virtio_config_hdr_t::irq_status).
Definition virtio.h:106
@ L4VIRTIO_FEATURE_CMD_CONFIG
Status and queue config are set via cmd field instead of via IPC.
Definition virtio.h:98
@ L4VIRTIO_FEATURE_VERSION_1
Virtio protocol version 1 supported. Must be 1 for L4virtio.
Definition virtio.h:96
@ L4VIRTIO_STATUS_DRIVER
Guest OS knows how to drive device.
Definition virtio.h:85
@ L4VIRTIO_STATUS_FAILED
Driver detected fatal error.
Definition virtio.h:89
@ L4VIRTIO_STATUS_ACKNOWLEDGE
Guest OS has found device.
Definition virtio.h:84
@ L4VIRTIO_STATUS_FEATURES_OK
Driver has acknowledged feature set.
Definition virtio.h:87
@ L4VIRTIO_STATUS_DRIVER_OK
Driver is set up.
Definition virtio.h:86
@ L4VIRTIO_STATUS_DEVICE_NEEDS_RESET
Device detected fatal error.
Definition virtio.h:88
@ L4VIRTIO_OP_SET_STATUS
Write device status register.
Definition virtio.h:53
@ L4VIRTIO_OP_GET_DEVICE_IRQ
Retrieve device notification IRQ.
Definition virtio.h:57
@ L4VIRTIO_OP_DEVICE_CONFIG
Get device config page.
Definition virtio.h:56
@ L4VIRTIO_OP_CONFIG_QUEUE
Configure queue.
Definition virtio.h:54
@ L4VIRTIO_OP_REGISTER_DS
Register shared memory with device.
Definition virtio.h:55
@ L4VIRTIO_CMD_NONE
No command pending.
Definition virtio.h:116
@ L4VIRTIO_CMD_SET_STATUS
Set the status register.
Definition virtio.h:117
@ L4VIRTIO_CMD_CFG_QUEUE
Configure a queue.
Definition virtio.h:118
@ L4VIRTIO_CMD_MASK
Mask to get command bits.
Definition virtio.h:119
@ L4VIRTIO_ID_SCSI
SCSI host device.
Definition virtio.h:69
@ L4VIRTIO_ID_BLOCK
General block device.
Definition virtio.h:64
@ L4VIRTIO_ID_BALLOON
Memory ballooning device.
Definition virtio.h:67
@ L4VIRTIO_ID_RPMSG
Device using rpmsg protocol.
Definition virtio.h:68
@ L4VIRTIO_ID_INPUT
Input.
Definition virtio.h:74
@ L4VIRTIO_ID_RPROC_SERIAL
Rproc serial device.
Definition virtio.h:71
@ L4VIRTIO_ID_CONSOLE
Simple device for data IO via ports.
Definition virtio.h:65
@ L4VIRTIO_ID_RNG
Entropy source.
Definition virtio.h:66
@ L4VIRTIO_ID_NET
Virtual ethernet card.
Definition virtio.h:63
@ L4VIRTIO_ID_SOCK
Unofficial socket device.
Definition virtio.h:78
@ L4VIRTIO_ID_CRYPTO
Crypto.
Definition virtio.h:76
@ L4VIRTIO_ID_VSOCK
Vsock transport.
Definition virtio.h:75
@ L4VIRTIO_ID_GPU
GPU.
Definition virtio.h:73
@ L4VIRTIO_ID_9P
Device using 9P transport protocol.
Definition virtio.h:70
@ L4VIRTIO_ID_CAIF
Device using CAIF network protocol.
Definition virtio.h:72
@ L4VIRTIO_IRQ_STATUS_VRING
VRING IRQ pending flag.
Definition virtio.h:107
@ L4VIRTIO_IRQ_STATUS_CONFIG
CONFIG IRQ pending flag.
Definition virtio.h:108
Common L4 ABI Data Types.
L4-VIRTIO config header, provided in shared data space.
Definition virtio.h:126
l4_uint32_t vendor
vendor ID
Definition virtio.h:130
l4_uint32_t magic
magic value (must be 'virt').
Definition virtio.h:127
l4_uint32_t dev_features
device features windows selected by device_feature_sel
Definition virtio.h:132
l4_uint32_t queues_offset
offset of virtqueue config array
Definition virtio.h:141
l4_uint32_t device
device ID
Definition virtio.h:129
l4_uint32_t cmd
L4 specific command register polled by the driver iff supported.
Definition virtio.h:185
l4_uint32_t cfg_driver_notify_index
W: Event index to be used for config notifications (device to driver)
Definition virtio.h:180
l4_uint32_t status
Device status register (read-only).
Definition virtio.h:164
l4_uint32_t num_queues
number of virtqueues
Definition virtio.h:140
l4_uint32_t version
VIRTIO version.
Definition virtio.h:128
l4_uint32_t cfg_device_notify_index
R: Event index to be used for config notifications (driver to device)
Definition virtio.h:182
Queue configuration entry.
Definition virtio.h:207
l4_uint16_t device_notify_index
R: Event index to be used by the driver (driver to device)
Definition virtio.h:224
l4_uint16_t driver_notify_index
W: Event index to be used for device notifications (device to driver)
Definition virtio.h:217
l4_uint64_t avail_addr
W: address of available ring.
Definition virtio.h:220
l4_uint64_t desc_addr
W: address of descriptor table.
Definition virtio.h:219
l4_uint64_t used_addr
W: address of used ring.
Definition virtio.h:221
l4_uint16_t ready
RW: queue ready flag (read-write)
Definition virtio.h:214
l4_uint16_t num_max
R: maximum number of descriptors supported by this queue.
Definition virtio.h:209
l4_uint16_t num
RW: number of descriptors configured for this queue.
Definition virtio.h:211