Zephyr Project API 4.2.99
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
virtio.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2024 Antmicro <www.antmicro.com>
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
13#ifndef ZEPHYR_VIRTIO_VIRTIO_H_
14#define ZEPHYR_VIRTIO_VIRTIO_H_
15#include <zephyr/device.h>
16#include "virtio/virtqueue.h"
17
18#ifdef __cplusplus
19extern "C" {
20#endif
21
38 uint16_t queue_idx, uint16_t max_queue_size, void *opaque
39);
40
44__subsystem struct virtio_driver_api {
45 struct virtq *(*get_virtqueue)(const struct device *dev, uint16_t queue_idx);
46 void (*notify_virtqueue)(const struct device *dev, uint16_t queue_idx);
47 void *(*get_device_specific_config)(const struct device *dev);
48 bool (*read_device_feature_bit)(const struct device *dev, int bit);
49 int (*write_driver_feature_bit)(const struct device *dev, int bit, bool value);
50 int (*commit_feature_bits)(const struct device *dev);
52 const struct device *dev, uint16_t num_queues, virtio_enumerate_queues cb,
53 void *opaque
54 );
55 void (*finalize_init)(const struct device *dev);
56};
57
65static inline struct virtq *virtio_get_virtqueue(const struct device *dev, uint16_t queue_idx)
66{
67 const struct virtio_driver_api *api = dev->api;
68
69 return api->get_virtqueue(dev, queue_idx);
70}
71
82static inline void virtio_notify_virtqueue(const struct device *dev, uint16_t queue_idx)
83{
84 const struct virtio_driver_api *api = dev->api;
85
86 api->notify_virtqueue(dev, queue_idx);
87}
88
95static inline void *virtio_get_device_specific_config(const struct device *dev)
96{
97 const struct virtio_driver_api *api = dev->api;
98
99 return api->get_device_specific_config(dev);
100}
101
109static inline bool virtio_read_device_feature_bit(const struct device *dev, int bit)
110{
111 const struct virtio_driver_api *api = dev->api;
112
113 return api->read_device_feature_bit(dev, bit);
114}
115
124static inline int virtio_write_driver_feature_bit(const struct device *dev, int bit, bool value)
125{
126 const struct virtio_driver_api *api = dev->api;
127
128 return api->write_driver_feature_bit(dev, bit, value);
129}
130
137static inline int virtio_commit_feature_bits(const struct device *dev)
138{
139 const struct virtio_driver_api *api = dev->api;
140
141 return api->commit_feature_bits(dev);
142}
143
153static inline int virtio_init_virtqueues(
154 const struct device *dev, uint16_t num_queues, virtio_enumerate_queues cb, void *opaque)
155{
156 const struct virtio_driver_api *api = dev->api;
157
158 return api->init_virtqueues(dev, num_queues, cb, opaque);
159}
160
166static inline void virtio_finalize_init(const struct device *dev)
167{
168 const struct virtio_driver_api *api = dev->api;
169
170 api->finalize_init(dev);
171}
172
177#ifdef __cplusplus
178}
179#endif
180
181#endif /* ZEPHYR_VIRTIO_VIRTIO_H_ */
static void * virtio_get_device_specific_config(const struct device *dev)
Returns device specific config.
Definition virtio.h:95
static void virtio_finalize_init(const struct device *dev)
Finalizes initialization of the virtio device.
Definition virtio.h:166
static struct virtq * virtio_get_virtqueue(const struct device *dev, uint16_t queue_idx)
Returns virtqueue at given idx.
Definition virtio.h:65
static bool virtio_read_device_feature_bit(const struct device *dev, int bit)
Returns feature bit offered by virtio device.
Definition virtio.h:109
static int virtio_commit_feature_bits(const struct device *dev)
Commits feature bits.
Definition virtio.h:137
static int virtio_write_driver_feature_bit(const struct device *dev, int bit, bool value)
Sets feature bit.
Definition virtio.h:124
uint16_t(* virtio_enumerate_queues)(uint16_t queue_idx, uint16_t max_queue_size, void *opaque)
Callback used during virtqueue enumeration.
Definition virtio.h:37
static void virtio_notify_virtqueue(const struct device *dev, uint16_t queue_idx)
Notifies virtqueue.
Definition virtio.h:82
static int virtio_init_virtqueues(const struct device *dev, uint16_t num_queues, virtio_enumerate_queues cb, void *opaque)
Initializes virtqueues.
Definition virtio.h:153
#define bool
Definition stdbool.h:13
__UINT16_TYPE__ uint16_t
Definition stdint.h:89
Runtime device structure (in ROM) per driver instance.
Definition device.h:510
const void * api
Address of the API structure exposed by the device instance.
Definition device.h:516
Virtio api structure.
Definition virtio.h:44
void(* finalize_init)(const struct device *dev)
Definition virtio.h:55
void(* notify_virtqueue)(const struct device *dev, uint16_t queue_idx)
Definition virtio.h:46
struct virtq *(* get_virtqueue)(const struct device *dev, uint16_t queue_idx)
Definition virtio.h:45
bool(* read_device_feature_bit)(const struct device *dev, int bit)
Definition virtio.h:48
void *(* get_device_specific_config)(const struct device *dev)
Definition virtio.h:47
int(* commit_feature_bits)(const struct device *dev)
Definition virtio.h:50
int(* init_virtqueues)(const struct device *dev, uint16_t num_queues, virtio_enumerate_queues cb, void *opaque)
Definition virtio.h:51
int(* write_driver_feature_bit)(const struct device *dev, int bit, bool value)
Definition virtio.h:49
virtqueue
Definition virtqueue.h:148