1 /* SPDX-License-Identifier: BSD-3-Clause
13 #include <sys/types.h>
14 #include <sys/queue.h>
16 #include <rte_byteorder.h>
18 #include <rte_debug.h>
20 #include <rte_memory.h>
21 #include <rte_memcpy.h>
22 #include <rte_memzone.h>
24 #include <rte_per_lcore.h>
25 #include <rte_lcore.h>
26 #include <rte_atomic.h>
27 #include <rte_branch_prediction.h>
28 #include <rte_common.h>
29 #include <rte_malloc.h>
30 #include <rte_errno.h>
32 #include "rte_rawdev.h"
33 #include "rte_rawdev_pmd.h"
35 /* dynamic log identifier */
36 int librawdev_logtype;
38 struct rte_rawdev rte_rawdevices[RTE_RAWDEV_MAX_DEVS];
40 struct rte_rawdev *rte_rawdevs = &rte_rawdevices[0];
42 static struct rte_rawdev_global rawdev_globals = {
46 struct rte_rawdev_global *rte_rawdev_globals = &rawdev_globals;
48 /* Raw device, northbound API implementation */
49 uint8_t __rte_experimental
50 rte_rawdev_count(void)
52 return rte_rawdev_globals->nb_devs;
55 uint16_t __rte_experimental
56 rte_rawdev_get_dev_id(const char *name)
63 for (i = 0; i < rte_rawdev_globals->nb_devs; i++)
64 if ((strcmp(rte_rawdevices[i].name, name)
66 (rte_rawdevices[i].attached ==
72 int __rte_experimental
73 rte_rawdev_socket_id(uint16_t dev_id)
75 struct rte_rawdev *dev;
77 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
78 dev = &rte_rawdevs[dev_id];
80 return dev->socket_id;
83 int __rte_experimental
84 rte_rawdev_info_get(uint16_t dev_id, struct rte_rawdev_info *dev_info)
86 struct rte_rawdev *rawdev;
88 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
89 RTE_FUNC_PTR_OR_ERR_RET(dev_info, -EINVAL);
94 rawdev = &rte_rawdevs[dev_id];
96 RTE_FUNC_PTR_OR_ERR_RET(*rawdev->dev_ops->dev_info_get, -ENOTSUP);
97 (*rawdev->dev_ops->dev_info_get)(rawdev, dev_info->dev_private);
101 dev_info->driver_name = rawdev->driver_name;
102 dev_info->device = rawdev->device;
108 int __rte_experimental
109 rte_rawdev_configure(uint16_t dev_id, struct rte_rawdev_info *dev_conf)
111 struct rte_rawdev *dev;
114 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
115 RTE_FUNC_PTR_OR_ERR_RET(dev_conf, -EINVAL);
117 dev = &rte_rawdevs[dev_id];
119 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_configure, -ENOTSUP);
123 "device %d must be stopped to allow configuration", dev_id);
127 /* Configure the device */
128 diag = (*dev->dev_ops->dev_configure)(dev, dev_conf->dev_private);
130 RTE_RDEV_ERR("dev%d dev_configure = %d", dev_id, diag);
137 int __rte_experimental
138 rte_rawdev_queue_conf_get(uint16_t dev_id,
140 rte_rawdev_obj_t queue_conf)
142 struct rte_rawdev *dev;
144 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
145 dev = &rte_rawdevs[dev_id];
147 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_def_conf, -ENOTSUP);
148 (*dev->dev_ops->queue_def_conf)(dev, queue_id, queue_conf);
152 int __rte_experimental
153 rte_rawdev_queue_setup(uint16_t dev_id,
155 rte_rawdev_obj_t queue_conf)
157 struct rte_rawdev *dev;
159 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
160 dev = &rte_rawdevs[dev_id];
162 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_setup, -ENOTSUP);
163 return (*dev->dev_ops->queue_setup)(dev, queue_id, queue_conf);
166 int __rte_experimental
167 rte_rawdev_queue_release(uint16_t dev_id, uint16_t queue_id)
169 struct rte_rawdev *dev;
171 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
172 dev = &rte_rawdevs[dev_id];
174 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_release, -ENOTSUP);
175 return (*dev->dev_ops->queue_release)(dev, queue_id);
178 int __rte_experimental
179 rte_rawdev_get_attr(uint16_t dev_id,
180 const char *attr_name,
181 uint64_t *attr_value)
183 struct rte_rawdev *dev;
185 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
186 dev = &rte_rawdevs[dev_id];
188 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->attr_get, -ENOTSUP);
189 return (*dev->dev_ops->attr_get)(dev, attr_name, attr_value);
192 int __rte_experimental
193 rte_rawdev_set_attr(uint16_t dev_id,
194 const char *attr_name,
195 const uint64_t attr_value)
197 struct rte_rawdev *dev;
199 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
200 dev = &rte_rawdevs[dev_id];
202 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->attr_set, -ENOTSUP);
203 return (*dev->dev_ops->attr_set)(dev, attr_name, attr_value);
206 int __rte_experimental
207 rte_rawdev_dump(uint16_t dev_id, FILE *f)
209 struct rte_rawdev *dev;
211 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
212 dev = &rte_rawdevs[dev_id];
214 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dump, -ENOTSUP);
215 return (*dev->dev_ops->dump)(dev, f);
218 int __rte_experimental
219 rte_rawdev_start(uint16_t dev_id)
221 struct rte_rawdev *dev;
224 RTE_RDEV_DEBUG("Start dev_id=%" PRIu8, dev_id);
226 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
227 dev = &rte_rawdevs[dev_id];
228 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_start, -ENOTSUP);
230 if (dev->started != 0) {
231 RTE_RDEV_ERR("Device with dev_id=%" PRIu8 "already started",
236 diag = (*dev->dev_ops->dev_start)(dev);
245 void __rte_experimental
246 rte_rawdev_stop(uint16_t dev_id)
248 struct rte_rawdev *dev;
250 RTE_RDEV_DEBUG("Stop dev_id=%" PRIu8, dev_id);
252 RTE_RAWDEV_VALID_DEVID_OR_RET(dev_id);
253 dev = &rte_rawdevs[dev_id];
255 RTE_FUNC_PTR_OR_RET(*dev->dev_ops->dev_stop);
257 if (dev->started == 0) {
258 RTE_RDEV_ERR("Device with dev_id=%" PRIu8 "already stopped",
263 (*dev->dev_ops->dev_stop)(dev);
267 int __rte_experimental
268 rte_rawdev_close(uint16_t dev_id)
270 struct rte_rawdev *dev;
272 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
273 dev = &rte_rawdevs[dev_id];
275 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_close, -ENOTSUP);
276 /* Device must be stopped before it can be closed */
277 if (dev->started == 1) {
278 RTE_RDEV_ERR("Device %u must be stopped before closing",
283 return (*dev->dev_ops->dev_close)(dev);
286 int __rte_experimental
287 rte_rawdev_reset(uint16_t dev_id)
289 struct rte_rawdev *dev;
291 RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
292 dev = &rte_rawdevs[dev_id];
294 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_reset, -ENOTSUP);
295 /* Reset is not dependent on state of the device */
296 return (*dev->dev_ops->dev_reset)(dev);
299 static inline uint8_t
300 rte_rawdev_find_free_device_index(void)
304 for (dev_id = 0; dev_id < RTE_RAWDEV_MAX_DEVS; dev_id++) {
305 if (rte_rawdevs[dev_id].attached ==
310 return RTE_RAWDEV_MAX_DEVS;
313 struct rte_rawdev * __rte_experimental
314 rte_rawdev_pmd_allocate(const char *name, size_t dev_priv_size, int socket_id)
316 struct rte_rawdev *rawdev;
319 if (rte_rawdev_pmd_get_named_dev(name) != NULL) {
320 RTE_RDEV_ERR("Event device with name %s already allocated!",
325 dev_id = rte_rawdev_find_free_device_index();
326 if (dev_id == RTE_RAWDEV_MAX_DEVS) {
327 RTE_RDEV_ERR("Reached maximum number of raw devices");
331 rawdev = &rte_rawdevs[dev_id];
333 rawdev->dev_private = rte_zmalloc_socket("rawdev private",
337 if (!rawdev->dev_private) {
338 RTE_RDEV_ERR("Unable to allocate memory to Skeleton dev");
343 rawdev->dev_id = dev_id;
344 rawdev->socket_id = socket_id;
346 snprintf(rawdev->name, RTE_RAWDEV_NAME_MAX_LEN, "%s", name);
348 rawdev->attached = RTE_RAWDEV_ATTACHED;
349 rawdev_globals.nb_devs++;
354 int __rte_experimental
355 rte_rawdev_pmd_release(struct rte_rawdev *rawdev)
362 ret = rte_rawdev_close(rawdev->dev_id);
366 rawdev->attached = RTE_RAWDEV_DETACHED;
367 rawdev_globals.nb_devs--;
370 rawdev->socket_id = 0;
371 rawdev->dev_ops = NULL;
372 if (rawdev->dev_private) {
373 rte_free(rawdev->dev_private);
374 rawdev->dev_private = NULL;
380 RTE_INIT(librawdev_init_log);
383 librawdev_init_log(void)
385 librawdev_logtype = rte_log_register("lib.rawdev");
386 if (librawdev_logtype >= 0)
387 rte_log_set_level(librawdev_logtype, RTE_LOG_INFO);