L4Re Operating System Framework
Interface and Usage Documentation
All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
virtio.h
1/* SPDX-License-Identifier: MIT */
2/*
3 * Copyright (C) 2013-2022, 2024 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/compiler.h>
29#include <l4/sys/utcb.h>
30#include <l4/sys/ipc.h>
31#include <l4/sys/types.h>
32
35{
36 L4VIRTIO_PROTOCOL = 0,
37};
38
39enum L4virtio_magic
40{
41 L4VIRTIO_MAGIC = 0x74726976
42};
43
44enum L4virtio_vendor
45{
46 L4VIRTIO_VENDOR_KK = 0x44
47};
48
60
85
96
105
115
128
133{
134 /* Virtio(0x00): device config */
140 /* Virtio(0x10): device features */
142 l4_uint32_t dev_features_sel;
143 l4_uint32_t _res1[2];
144
145 /* Virtio(0x20): driver features */
146 l4_uint32_t driver_features;
147 l4_uint32_t driver_features_sel;
148
149 /* L4Virtio(0x28): L4 queue */
153 /* Virtio(0x30): queue status */
154 l4_uint32_t queue_sel;
155 l4_uint32_t queue_num_max;
156 l4_uint32_t queue_num;
157 l4_uint32_t _res3[2];
158 l4_uint32_t queue_ready;
159 l4_uint32_t _res4[2];
160
161 /* Virtio(0x50): queue notify */
162 l4_uint32_t queue_notify;
163 l4_uint32_t _res5[3];
164
165 /* Virtio(0x60): interrupt handling */
166 l4_uint32_t irq_status;
167 l4_uint32_t irq_ack;
168 l4_uint32_t _res6[2];
169
170 /* Virtio(0x70): Device status register (read-only). The register must be
171 * written using l4virtio_set_status(). */
172 l4_uint32_t status;
173
174 /* L4Virtio(0x74): W: Event index to be used for config notifications (device to driver) */
175 l4_uint32_t cfg_driver_notify_index;
176 /* L4Virtio(0x78): R: Event index to be used for config notifications (driver to device) */
177 l4_uint32_t cfg_device_notify_index;
178
179 /* L4Virtio(0x7c) L4 specific command register polled by the driver iff supported */
180 l4_uint32_t cmd;
181
182 /* Virtio(0x80): queue descriptors */
183 l4_uint64_t queue_desc;
184 l4_uint32_t _res8[2];
185 l4_uint64_t queue_avail;
186 l4_uint32_t _res9[2];
187 l4_uint64_t queue_used;
188
189 l4_uint32_t _res10[1];
190
191 /* Virtio(0xac): shared memory region */
192 l4_uint32_t shm_sel;
193 l4_uint64_t shm_len;
194 l4_uint64_t shm_base;
195
196 /* L4Virtio(0xc0): use the unused space here for device and driver feature bitmaps */
197 l4_uint32_t dev_features_map[6];
198 l4_uint32_t _res11[2];
199 l4_uint32_t driver_features_map[6];
200 l4_uint32_t _res12[1];
201
202 /* Virtio(0xfc): config generation */
203 l4_uint32_t generation;
205
243
245
256
262L4_INLINE void *
264{
265 return (void *)(((l4_addr_t)cfg) + 0x100);
266}
267
271L4_INLINE void
272l4virtio_set_feature(l4_uint32_t *feature_map, unsigned feat)
273{
274 unsigned idx = feat / 32;
275
276 if (idx < 8)
277 feature_map[idx] |= 1UL << (feat % 32);
278}
279
283L4_INLINE void
284l4virtio_clear_feature(l4_uint32_t *feature_map, unsigned feat)
285{
286 unsigned idx = feat / 32;
287
288 if (idx < 8)
289 feature_map[idx] &= ~(1UL << (feat % 32));
290}
291
295L4_INLINE unsigned
296l4virtio_get_feature(l4_uint32_t *feature_map, unsigned feat)
297{
298 unsigned idx = feat / 32;
299
300 if (idx >= 8)
301 return 0;
302
303 return feature_map[idx] & (1UL << (feat % 32));
304}
305
311L4_CV int
313
319L4_CV int
321
327L4_CV int
329 l4_uint64_t base, l4_umword_t offset,
331
337L4_CV int
339 l4_addr_t *ds_offset) L4_NOTHROW;
340
346L4_CV int
349
351
L4 compiler related defines.
unsigned long l4_umword_t
Unsigned machine word.
Definition l4int.h:40
unsigned long l4_addr_t
Address type.
Definition l4int.h:34
unsigned int l4_uint32_t
Unsigned 32bit value.
Definition l4int.h:29
unsigned short int l4_uint16_t
Unsigned 16bit value.
Definition l4int.h:27
unsigned long long l4_uint64_t
Unsigned 64bit value.
Definition l4int.h:31
unsigned long l4_cap_idx_t
Capability selector type.
Definition types.h:336
#define L4_CV
Define calling convention.
Definition linkage.h:33
#define L4_NOTHROW
Mark a function declaration and definition as never throwing an exception.
Definition compiler.h:161
#define L4_INLINE
L4 Inline function attribute.
Definition compiler.h:51
#define L4_BEGIN_DECLS
Start section with C types and functions.
Definition compiler.h:165
#define L4_END_DECLS
End section with C types and functions.
Definition compiler.h:166
L4virtio_feature_bits
L4virtio-specific feature bits.
Definition virtio.h:99
L4virtio_device_status
Virtio device status bits.
Definition virtio.h:88
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:53
L4_virtio_cmd
Virtio commands for device configuration.
Definition virtio.h:120
L4_virtio_protocol
L4-VIRTIO protocol number.
Definition virtio.h:35
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:63
void * l4virtio_device_config(l4virtio_config_hdr_t const *cfg)
Get the pointer to the device configuration.
Definition virtio.h:263
L4_BEGIN_DECLS l4virtio_config_queue_t * l4virtio_config_queues(l4virtio_config_hdr_t const *cfg)
Get the pointer to the first queue config.
Definition virtio.h:252
void l4virtio_clear_feature(l4_uint32_t *feature_map, unsigned feat)
Clear the given feature bit in a feature map.
Definition virtio.h:284
void l4virtio_set_feature(l4_uint32_t *feature_map, unsigned feat)
Set the given feature bit in a feature map.
Definition virtio.h:272
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:296
L4_virtio_irq_status
VIRTIO IRQ status codes (l4virtio_config_hdr_t::irq_status).
Definition virtio.h:111
@ L4VIRTIO_FEATURE_CMD_CONFIG
Status and queue config are set via cmd field instead of via IPC.
Definition virtio.h:103
@ L4VIRTIO_FEATURE_VERSION_1
Virtio protocol version 1 supported. Must be 1 for L4virtio.
Definition virtio.h:101
@ L4VIRTIO_STATUS_DRIVER
Guest OS knows how to drive device.
Definition virtio.h:90
@ L4VIRTIO_STATUS_FAILED
Driver detected fatal error.
Definition virtio.h:94
@ L4VIRTIO_STATUS_ACKNOWLEDGE
Guest OS has found device.
Definition virtio.h:89
@ L4VIRTIO_STATUS_FEATURES_OK
Driver has acknowledged feature set.
Definition virtio.h:92
@ L4VIRTIO_STATUS_DRIVER_OK
Driver is set up.
Definition virtio.h:91
@ L4VIRTIO_STATUS_DEVICE_NEEDS_RESET
Device detected fatal error.
Definition virtio.h:93
@ L4VIRTIO_OP_SET_STATUS
Write device status register.
Definition virtio.h:54
@ L4VIRTIO_OP_GET_DEVICE_IRQ
Retrieve device notification IRQ.
Definition virtio.h:58
@ L4VIRTIO_OP_DEVICE_CONFIG
Get device config page.
Definition virtio.h:57
@ L4VIRTIO_OP_CONFIG_QUEUE
Configure queue.
Definition virtio.h:55
@ L4VIRTIO_OP_REGISTER_DS
Register shared memory with device.
Definition virtio.h:56
@ L4VIRTIO_CMD_NOTIFY_QUEUE
Configure a queue.
Definition virtio.h:125
@ L4VIRTIO_CMD_NONE
No command pending.
Definition virtio.h:121
@ L4VIRTIO_CMD_SET_STATUS
Set the status register.
Definition virtio.h:122
@ L4VIRTIO_CMD_CFG_QUEUE
Configure a queue.
Definition virtio.h:123
@ L4VIRTIO_CMD_MASK
Mask to get command bits.
Definition virtio.h:126
@ L4VIRTIO_CMD_CFG_CHANGED
Device config changed.
Definition virtio.h:124
@ L4VIRTIO_ID_SCSI
SCSI host device.
Definition virtio.h:70
@ L4VIRTIO_ID_BLOCK
General block device.
Definition virtio.h:65
@ L4VIRTIO_ID_BALLOON
Memory ballooning device.
Definition virtio.h:68
@ L4VIRTIO_ID_RPMSG
Device using rpmsg protocol.
Definition virtio.h:69
@ L4VIRTIO_ID_INPUT
Input.
Definition virtio.h:75
@ L4VIRTIO_ID_RPROC_SERIAL
Rproc serial device.
Definition virtio.h:72
@ L4VIRTIO_ID_CONSOLE
Simple device for data IO via ports.
Definition virtio.h:66
@ L4VIRTIO_ID_FS
FS.
Definition virtio.h:78
@ L4VIRTIO_ID_RNG
Entropy source.
Definition virtio.h:67
@ L4VIRTIO_ID_NET
Virtual ethernet card.
Definition virtio.h:64
@ L4VIRTIO_ID_SOCK
Unofficial socket device.
Definition virtio.h:83
@ L4VIRTIO_ID_CRYPTO
Crypto.
Definition virtio.h:77
@ L4VIRTIO_ID_GPIO
Gpio device.
Definition virtio.h:81
@ L4VIRTIO_ID_VSOCK
Vsock transport.
Definition virtio.h:76
@ L4VIRTIO_ID_GPU
GPU.
Definition virtio.h:74
@ L4VIRTIO_ID_I2C
I2C device.
Definition virtio.h:80
@ L4VIRTIO_ID_9P
Device using 9P transport protocol.
Definition virtio.h:71
@ L4VIRTIO_ID_CAIF
Device using CAIF network protocol.
Definition virtio.h:73
@ L4VIRTIO_ID_SCMI
Scmi device.
Definition virtio.h:79
@ L4VIRTIO_IRQ_STATUS_VRING
VRING IRQ pending flag.
Definition virtio.h:112
@ L4VIRTIO_IRQ_STATUS_CONFIG
CONFIG IRQ pending flag.
Definition virtio.h:113
Common L4 ABI Data Types.
L4-VIRTIO config header, provided in shared data space.
Definition virtio.h:133
l4_uint32_t vendor
vendor ID
Definition virtio.h:138
l4_uint32_t magic
magic value (must be 'virt').
Definition virtio.h:135
l4_uint32_t dev_features
device features windows selected by device_feature_sel
Definition virtio.h:141
l4_uint32_t queues_offset
offset of virtqueue config array
Definition virtio.h:151
l4_uint32_t device
device ID
Definition virtio.h:137
l4_uint32_t num_queues
number of virtqueues
Definition virtio.h:150
l4_uint32_t version
VIRTIO version.
Definition virtio.h:136
Queue configuration entry.
Definition virtio.h:224
l4_uint16_t device_notify_index
R: Event index to be used by the driver (driver to device)
Definition virtio.h:241
l4_uint16_t driver_notify_index
W: Event index to be used for device notifications (device to driver)
Definition virtio.h:234
l4_uint64_t avail_addr
W: address of available ring.
Definition virtio.h:237
l4_uint64_t desc_addr
W: address of descriptor table.
Definition virtio.h:236
l4_uint64_t used_addr
W: address of used ring.
Definition virtio.h:238
l4_uint16_t ready
RW: queue ready flag (read-write)
Definition virtio.h:231
l4_uint16_t num_max
R: maximum number of descriptors supported by this queue.
Definition virtio.h:226
l4_uint16_t num
RW: number of descriptors configured for this queue.
Definition virtio.h:228