drivers/event/dsw/dsw_evdev.c

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright(c) 2018 Ericsson AB
   3  */
   4
   5 #include <stdbool.h>
   6
   7 #include <rte_cycles.h>
   8 #include <rte_eventdev_pmd.h>
   9 #include <rte_eventdev_pmd_vdev.h>
  10 #include <rte_random.h>
  11 #include <rte_ring_elem.h>
  12
  13 #include "dsw_evdev.h"
  14
  15 #define EVENTDEV_NAME_DSW_PMD event_dsw
  16
  17 static int
  18 dsw_port_setup(struct rte_eventdev *dev, uint8_t port_id,
  19                const struct rte_event_port_conf *conf)
  20 {
  21         struct dsw_evdev *dsw = dsw_pmd_priv(dev);
  22         struct dsw_port *port;
  23         struct rte_event_ring *in_ring;
  24         struct rte_ring *ctl_in_ring;
  25         char ring_name[RTE_RING_NAMESIZE];
  26
  27         port = &dsw->ports[port_id];
  28
  29         *port = (struct dsw_port) {
  30                 .id = port_id,
  31                 .dsw = dsw,
  32                 .dequeue_depth = conf->dequeue_depth,
  33                 .enqueue_depth = conf->enqueue_depth,
  34                 .new_event_threshold = conf->new_event_threshold
  35         };
  36
  37         snprintf(ring_name, sizeof(ring_name), "dsw%d_p%u", dev->data->dev_id,
  38                  port_id);
  39
  40         in_ring = rte_event_ring_create(ring_name, DSW_IN_RING_SIZE,
  41                                         dev->data->socket_id,
  42                                         RING_F_SC_DEQ|RING_F_EXACT_SZ);
  43
  44         if (in_ring == NULL)
  45                 return -ENOMEM;
  46
  47         snprintf(ring_name, sizeof(ring_name), "dswctl%d_p%u",
  48                  dev->data->dev_id, port_id);
  49
  50         ctl_in_ring = rte_ring_create_elem(ring_name,
  51                                            sizeof(struct dsw_ctl_msg),
  52                                            DSW_CTL_IN_RING_SIZE,
  53                                            dev->data->socket_id,
  54                                            RING_F_SC_DEQ|RING_F_EXACT_SZ);
  55
  56         if (ctl_in_ring == NULL) {
  57                 rte_event_ring_free(in_ring);
  58                 return -ENOMEM;
  59         }
  60
  61         port->in_ring = in_ring;
  62         port->ctl_in_ring = ctl_in_ring;
  63
  64         rte_atomic16_init(&port->load);
  65         rte_atomic32_init(&port->immigration_load);
  66
  67         port->load_update_interval =
  68                 (DSW_LOAD_UPDATE_INTERVAL * rte_get_timer_hz()) / US_PER_S;
  69
  70         port->migration_interval =
  71                 (DSW_MIGRATION_INTERVAL * rte_get_timer_hz()) / US_PER_S;
  72
  73         dev->data->ports[port_id] = port;
  74
  75         return 0;
  76 }
  77
  78 static void
  79 dsw_port_def_conf(struct rte_eventdev *dev __rte_unused,
  80                   uint8_t port_id __rte_unused,
  81                   struct rte_event_port_conf *port_conf)
  82 {
  83         *port_conf = (struct rte_event_port_conf) {
  84                 .new_event_threshold = 1024,
  85                 .dequeue_depth = DSW_MAX_PORT_DEQUEUE_DEPTH / 4,
  86                 .enqueue_depth = DSW_MAX_PORT_ENQUEUE_DEPTH / 4
  87         };
  88 }
  89
  90 static void
  91 dsw_port_release(void *p)
  92 {
  93         struct dsw_port *port = p;
  94
  95         rte_event_ring_free(port->in_ring);
  96         rte_ring_free(port->ctl_in_ring);
  97 }
  98
  99 static int
 100 dsw_queue_setup(struct rte_eventdev *dev, uint8_t queue_id,
 101                 const struct rte_event_queue_conf *conf)
 102 {
 103         struct dsw_evdev *dsw = dsw_pmd_priv(dev);
 104         struct dsw_queue *queue = &dsw->queues[queue_id];
 105
 106         if (RTE_EVENT_QUEUE_CFG_ALL_TYPES & conf->event_queue_cfg)
 107                 return -ENOTSUP;
 108
 109         /* SINGLE_LINK is better off treated as TYPE_ATOMIC, since it
 110          * avoid the "fake" TYPE_PARALLEL flow_id assignment. Since
 111          * the queue will only have a single serving port, no
 112          * migration will ever happen, so the extra TYPE_ATOMIC
 113          * migration overhead is avoided.
 114          */
 115         if (RTE_EVENT_QUEUE_CFG_SINGLE_LINK & conf->event_queue_cfg)
 116                 queue->schedule_type = RTE_SCHED_TYPE_ATOMIC;
 117         else {
 118                 if (conf->schedule_type == RTE_SCHED_TYPE_ORDERED)
 119                         return -ENOTSUP;
 120                 /* atomic or parallel */
 121                 queue->schedule_type = conf->schedule_type;
 122         }
 123
 124         queue->num_serving_ports = 0;
 125
 126         return 0;
 127 }
 128
 129 static void
 130 dsw_queue_def_conf(struct rte_eventdev *dev __rte_unused,
 131                    uint8_t queue_id __rte_unused,
 132                    struct rte_event_queue_conf *queue_conf)
 133 {
 134         *queue_conf = (struct rte_event_queue_conf) {
 135                 .nb_atomic_flows = 4096,
 136                 .schedule_type = RTE_SCHED_TYPE_ATOMIC,
 137                 .priority = RTE_EVENT_DEV_PRIORITY_NORMAL
 138         };
 139 }
 140
 141 static void
 142 dsw_queue_release(struct rte_eventdev *dev __rte_unused,
 143                   uint8_t queue_id __rte_unused)
 144 {
 145 }
 146
 147 static void
 148 queue_add_port(struct dsw_queue *queue, uint16_t port_id)
 149 {
 150         queue->serving_ports[queue->num_serving_ports] = port_id;
 151         queue->num_serving_ports++;
 152 }
 153
 154 static bool
 155 queue_remove_port(struct dsw_queue *queue, uint16_t port_id)
 156 {
 157         uint16_t i;
 158
 159         for (i = 0; i < queue->num_serving_ports; i++)
 160                 if (queue->serving_ports[i] == port_id) {
 161                         uint16_t last_idx = queue->num_serving_ports - 1;
 162                         if (i != last_idx)
 163                                 queue->serving_ports[i] =
 164                                         queue->serving_ports[last_idx];
 165                         queue->num_serving_ports--;
 166                         return true;
 167                 }
 168         return false;
 169 }
 170
 171 static int
 172 dsw_port_link_unlink(struct rte_eventdev *dev, void *port,
 173                      const uint8_t queues[], uint16_t num, bool link)
 174 {
 175         struct dsw_evdev *dsw = dsw_pmd_priv(dev);
 176         struct dsw_port *p = port;
 177         uint16_t i;
 178         uint16_t count = 0;
 179
 180         for (i = 0; i < num; i++) {
 181                 uint8_t qid = queues[i];
 182                 struct dsw_queue *q = &dsw->queues[qid];
 183                 if (link) {
 184                         queue_add_port(q, p->id);
 185                         count++;
 186                 } else {
 187                         bool removed = queue_remove_port(q, p->id);
 188                         if (removed)
 189                                 count++;
 190                 }
 191         }
 192
 193         return count;
 194 }
 195
 196 static int
 197 dsw_port_link(struct rte_eventdev *dev, void *port, const uint8_t queues[],
 198               const uint8_t priorities[] __rte_unused, uint16_t num)
 199 {
 200         return dsw_port_link_unlink(dev, port, queues, num, true);
 201 }
 202
 203 static int
 204 dsw_port_unlink(struct rte_eventdev *dev, void *port, uint8_t queues[],
 205                 uint16_t num)
 206 {
 207         return dsw_port_link_unlink(dev, port, queues, num, false);
 208 }
 209
 210 static void
 211 dsw_info_get(struct rte_eventdev *dev __rte_unused,
 212              struct rte_event_dev_info *info)
 213 {
 214         *info = (struct rte_event_dev_info) {
 215                 .driver_name = DSW_PMD_NAME,
 216                 .max_event_queues = DSW_MAX_QUEUES,
 217                 .max_event_queue_flows = DSW_MAX_FLOWS,
 218                 .max_event_queue_priority_levels = 1,
 219                 .max_event_priority_levels = 1,
 220                 .max_event_ports = DSW_MAX_PORTS,
 221                 .max_event_port_dequeue_depth = DSW_MAX_PORT_DEQUEUE_DEPTH,
 222                 .max_event_port_enqueue_depth = DSW_MAX_PORT_ENQUEUE_DEPTH,
 223                 .max_num_events = DSW_MAX_EVENTS,
 224                 .event_dev_cap = RTE_EVENT_DEV_CAP_BURST_MODE|
 225                 RTE_EVENT_DEV_CAP_DISTRIBUTED_SCHED|
 226                 RTE_EVENT_DEV_CAP_NONSEQ_MODE|
 227                 RTE_EVENT_DEV_CAP_MULTIPLE_QUEUE_PORT
 228         };
 229 }
 230
 231 static int
 232 dsw_configure(const struct rte_eventdev *dev)
 233 {
 234         struct dsw_evdev *dsw = dsw_pmd_priv(dev);
 235         const struct rte_event_dev_config *conf = &dev->data->dev_conf;
 236         int32_t min_max_in_flight;
 237
 238         dsw->num_ports = conf->nb_event_ports;
 239         dsw->num_queues = conf->nb_event_queues;
 240
 241         /* Avoid a situation where consumer ports are holding all the
 242          * credits, without making use of them.
 243          */
 244         min_max_in_flight = conf->nb_event_ports * DSW_PORT_MAX_CREDITS;
 245
 246         dsw->max_inflight = RTE_MAX(conf->nb_events_limit, min_max_in_flight);
 247
 248         return 0;
 249 }
 250
 251
 252 static void
 253 initial_flow_to_port_assignment(struct dsw_evdev *dsw)
 254 {
 255         uint8_t queue_id;
 256         for (queue_id = 0; queue_id < dsw->num_queues; queue_id++) {
 257                 struct dsw_queue *queue = &dsw->queues[queue_id];
 258                 uint16_t flow_hash;
 259                 for (flow_hash = 0; flow_hash < DSW_MAX_FLOWS; flow_hash++) {
 260                         uint8_t port_idx =
 261                                 rte_rand() % queue->num_serving_ports;
 262                         uint8_t port_id =
 263                                 queue->serving_ports[port_idx];
 264                         dsw->queues[queue_id].flow_to_port_map[flow_hash] =
 265                                 port_id;
 266                 }
 267         }
 268 }
 269
 270 static int
 271 dsw_start(struct rte_eventdev *dev)
 272 {
 273         struct dsw_evdev *dsw = dsw_pmd_priv(dev);
 274         uint16_t i;
 275         uint64_t now;
 276
 277         rte_atomic32_init(&dsw->credits_on_loan);
 278
 279         initial_flow_to_port_assignment(dsw);
 280
 281         now = rte_get_timer_cycles();
 282         for (i = 0; i < dsw->num_ports; i++) {
 283                 dsw->ports[i].measurement_start = now;
 284                 dsw->ports[i].busy_start = now;
 285         }
 286
 287         return 0;
 288 }
 289
 290 static void
 291 dsw_port_drain_buf(uint8_t dev_id, struct rte_event *buf, uint16_t buf_len,
 292                    eventdev_stop_flush_t flush, void *flush_arg)
 293 {
 294         uint16_t i;
 295
 296         for (i = 0; i < buf_len; i++)
 297                 flush(dev_id, buf[i], flush_arg);
 298 }
 299
 300 static void
 301 dsw_port_drain_paused(uint8_t dev_id, struct dsw_port *port,
 302                       eventdev_stop_flush_t flush, void *flush_arg)
 303 {
 304         dsw_port_drain_buf(dev_id, port->paused_events, port->paused_events_len,
 305                            flush, flush_arg);
 306 }
 307
 308 static void
 309 dsw_port_drain_out(uint8_t dev_id, struct dsw_evdev *dsw, struct dsw_port *port,
 310                    eventdev_stop_flush_t flush, void *flush_arg)
 311 {
 312         uint16_t dport_id;
 313
 314         for (dport_id = 0; dport_id < dsw->num_ports; dport_id++)
 315                 if (dport_id != port->id)
 316                         dsw_port_drain_buf(dev_id, port->out_buffer[dport_id],
 317                                            port->out_buffer_len[dport_id],
 318                                            flush, flush_arg);
 319 }
 320
 321 static void
 322 dsw_port_drain_in_ring(uint8_t dev_id, struct dsw_port *port,
 323                        eventdev_stop_flush_t flush, void *flush_arg)
 324 {
 325         struct rte_event ev;
 326
 327         while (rte_event_ring_dequeue_burst(port->in_ring, &ev, 1, NULL))
 328                 flush(dev_id, ev, flush_arg);
 329 }
 330
 331 static void
 332 dsw_drain(uint8_t dev_id, struct dsw_evdev *dsw,
 333           eventdev_stop_flush_t flush, void *flush_arg)
 334 {
 335         uint16_t port_id;
 336
 337         if (flush == NULL)
 338                 return;
 339
 340         for (port_id = 0; port_id < dsw->num_ports; port_id++) {
 341                 struct dsw_port *port = &dsw->ports[port_id];
 342
 343                 dsw_port_drain_out(dev_id, dsw, port, flush, flush_arg);
 344                 dsw_port_drain_paused(dev_id, port, flush, flush_arg);
 345                 dsw_port_drain_in_ring(dev_id, port, flush, flush_arg);
 346         }
 347 }
 348
 349 static void
 350 dsw_stop(struct rte_eventdev *dev)
 351 {
 352         struct dsw_evdev *dsw = dsw_pmd_priv(dev);
 353         uint8_t dev_id;
 354         eventdev_stop_flush_t flush;
 355         void *flush_arg;
 356
 357         dev_id = dev->data->dev_id;
 358         flush = dev->dev_ops->dev_stop_flush;
 359         flush_arg = dev->data->dev_stop_flush_arg;
 360
 361         dsw_drain(dev_id, dsw, flush, flush_arg);
 362 }
 363
 364 static int
 365 dsw_close(struct rte_eventdev *dev)
 366 {
 367         struct dsw_evdev *dsw = dsw_pmd_priv(dev);
 368
 369         dsw->num_ports = 0;
 370         dsw->num_queues = 0;
 371
 372         return 0;
 373 }
 374
 375 static struct rte_eventdev_ops dsw_evdev_ops = {
 376         .port_setup = dsw_port_setup,
 377         .port_def_conf = dsw_port_def_conf,
 378         .port_release = dsw_port_release,
 379         .queue_setup = dsw_queue_setup,
 380         .queue_def_conf = dsw_queue_def_conf,
 381         .queue_release = dsw_queue_release,
 382         .port_link = dsw_port_link,
 383         .port_unlink = dsw_port_unlink,
 384         .dev_infos_get = dsw_info_get,
 385         .dev_configure = dsw_configure,
 386         .dev_start = dsw_start,
 387         .dev_stop = dsw_stop,
 388         .dev_close = dsw_close,
 389         .xstats_get = dsw_xstats_get,
 390         .xstats_get_names = dsw_xstats_get_names,
 391         .xstats_get_by_name = dsw_xstats_get_by_name
 392 };
 393
 394 static int
 395 dsw_probe(struct rte_vdev_device *vdev)
 396 {
 397         const char *name;
 398         struct rte_eventdev *dev;
 399         struct dsw_evdev *dsw;
 400
 401         name = rte_vdev_device_name(vdev);
 402
 403         dev = rte_event_pmd_vdev_init(name, sizeof(struct dsw_evdev),
 404                                       rte_socket_id());
 405         if (dev == NULL)
 406                 return -EFAULT;
 407
 408         dev->dev_ops = &dsw_evdev_ops;
 409         dev->enqueue = dsw_event_enqueue;
 410         dev->enqueue_burst = dsw_event_enqueue_burst;
 411         dev->enqueue_new_burst = dsw_event_enqueue_new_burst;
 412         dev->enqueue_forward_burst = dsw_event_enqueue_forward_burst;
 413         dev->dequeue = dsw_event_dequeue;
 414         dev->dequeue_burst = dsw_event_dequeue_burst;
 415
 416         if (rte_eal_process_type() != RTE_PROC_PRIMARY)
 417                 return 0;
 418
 419         dsw = dev->data->dev_private;
 420         dsw->data = dev->data;
 421
 422         return 0;
 423 }
 424
 425 static int
 426 dsw_remove(struct rte_vdev_device *vdev)
 427 {
 428         const char *name;
 429
 430         name = rte_vdev_device_name(vdev);
 431         if (name == NULL)
 432                 return -EINVAL;
 433
 434         return rte_event_pmd_vdev_uninit(name);
 435 }
 436
 437 static struct rte_vdev_driver evdev_dsw_pmd_drv = {
 438         .probe = dsw_probe,
 439         .remove = dsw_remove
 440 };
 441
 442 RTE_PMD_REGISTER_VDEV(EVENTDEV_NAME_DSW_PMD, evdev_dsw_pmd_drv);