root/drivers/media/platform/xilinx/xilinx-vipp.c

DEFINITIONS

1. to_xvip_entity
2. xvip_graph_find_entity
3. xvip_graph_build_one
4. xvip_graph_find_dma
5. xvip_graph_build_dma
6. xvip_graph_notify_complete
7. xvip_graph_notify_bound
8. xvip_graph_parse_one
9. xvip_graph_parse
10. xvip_graph_dma_init_one
11. xvip_graph_dma_init
12. xvip_graph_cleanup
13. xvip_graph_init
14. xvip_composite_v4l2_cleanup
15. xvip_composite_v4l2_init
16. xvip_composite_probe
17. xvip_composite_remove

   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  * Xilinx Video IP Composite Device
   4  *
   5  * Copyright (C) 2013-2015 Ideas on Board
   6  * Copyright (C) 2013-2015 Xilinx, Inc.
   7  *
   8  * Contacts: Hyun Kwon <hyun.kwon@xilinx.com>
   9  *           Laurent Pinchart <laurent.pinchart@ideasonboard.com>
  10  */
  11 
  12 #include <linux/list.h>
  13 #include <linux/module.h>
  14 #include <linux/of.h>
  15 #include <linux/of_graph.h>
  16 #include <linux/platform_device.h>
  17 #include <linux/slab.h>
  18 
  19 #include <media/v4l2-async.h>
  20 #include <media/v4l2-common.h>
  21 #include <media/v4l2-device.h>
  22 #include <media/v4l2-fwnode.h>
  23 
  24 #include "xilinx-dma.h"
  25 #include "xilinx-vipp.h"
  26 
  27 #define XVIPP_DMA_S2MM                          0
  28 #define XVIPP_DMA_MM2S                          1
  29 
  30 /**
  31  * struct xvip_graph_entity - Entity in the video graph
  32  * @asd: subdev asynchronous registration information
  33  * @entity: media entity, from the corresponding V4L2 subdev
  34  * @subdev: V4L2 subdev
  35  */
  36 struct xvip_graph_entity {
  37         struct v4l2_async_subdev asd; /* must be first */
  38         struct media_entity *entity;
  39         struct v4l2_subdev *subdev;
  40 };
  41 
  42 static inline struct xvip_graph_entity *
  43 to_xvip_entity(struct v4l2_async_subdev *asd)
  44 {
  45         return container_of(asd, struct xvip_graph_entity, asd);
  46 }
  47 
  48 /* -----------------------------------------------------------------------------
  49  * Graph Management
  50  */
  51 
  52 static struct xvip_graph_entity *
  53 xvip_graph_find_entity(struct xvip_composite_device *xdev,
  54                        const struct fwnode_handle *fwnode)
  55 {
  56         struct xvip_graph_entity *entity;
  57         struct v4l2_async_subdev *asd;
  58 
  59         list_for_each_entry(asd, &xdev->notifier.asd_list, asd_list) {
  60                 entity = to_xvip_entity(asd);
  61                 if (entity->asd.match.fwnode == fwnode)
  62                         return entity;
  63         }
  64 
  65         return NULL;
  66 }
  67 
  68 static int xvip_graph_build_one(struct xvip_composite_device *xdev,
  69                                 struct xvip_graph_entity *entity)
  70 {
  71         u32 link_flags = MEDIA_LNK_FL_ENABLED;
  72         struct media_entity *local = entity->entity;
  73         struct media_entity *remote;
  74         struct media_pad *local_pad;
  75         struct media_pad *remote_pad;
  76         struct xvip_graph_entity *ent;
  77         struct v4l2_fwnode_link link;
  78         struct fwnode_handle *ep = NULL;
  79         int ret = 0;
  80 
  81         dev_dbg(xdev->dev, "creating links for entity %s\n", local->name);
  82 
  83         while (1) {
  84                 /* Get the next endpoint and parse its link. */
  85                 ep = fwnode_graph_get_next_endpoint(entity->asd.match.fwnode,
  86                                                     ep);
  87                 if (ep == NULL)
  88                         break;
  89 
  90                 dev_dbg(xdev->dev, "processing endpoint %p\n", ep);
  91 
  92                 ret = v4l2_fwnode_parse_link(ep, &link);
  93                 if (ret < 0) {
  94                         dev_err(xdev->dev, "failed to parse link for %p\n",
  95                                 ep);
  96                         continue;
  97                 }
  98 
  99                 /* Skip sink ports, they will be processed from the other end of
 100                  * the link.
 101                  */
 102                 if (link.local_port >= local->num_pads) {
 103                         dev_err(xdev->dev, "invalid port number %u for %p\n",
 104                                 link.local_port, link.local_node);
 105                         v4l2_fwnode_put_link(&link);
 106                         ret = -EINVAL;
 107                         break;
 108                 }
 109 
 110                 local_pad = &local->pads[link.local_port];
 111 
 112                 if (local_pad->flags & MEDIA_PAD_FL_SINK) {
 113                         dev_dbg(xdev->dev, "skipping sink port %p:%u\n",
 114                                 link.local_node, link.local_port);
 115                         v4l2_fwnode_put_link(&link);
 116                         continue;
 117                 }
 118 
 119                 /* Skip DMA engines, they will be processed separately. */
 120                 if (link.remote_node == of_fwnode_handle(xdev->dev->of_node)) {
 121                         dev_dbg(xdev->dev, "skipping DMA port %p:%u\n",
 122                                 link.local_node, link.local_port);
 123                         v4l2_fwnode_put_link(&link);
 124                         continue;
 125                 }
 126 
 127                 /* Find the remote entity. */
 128                 ent = xvip_graph_find_entity(xdev, link.remote_node);
 129                 if (ent == NULL) {
 130                         dev_err(xdev->dev, "no entity found for %p\n",
 131                                 link.remote_node);
 132                         v4l2_fwnode_put_link(&link);
 133                         ret = -ENODEV;
 134                         break;
 135                 }
 136 
 137                 remote = ent->entity;
 138 
 139                 if (link.remote_port >= remote->num_pads) {
 140                         dev_err(xdev->dev, "invalid port number %u on %p\n",
 141                                 link.remote_port, link.remote_node);
 142                         v4l2_fwnode_put_link(&link);
 143                         ret = -EINVAL;
 144                         break;
 145                 }
 146 
 147                 remote_pad = &remote->pads[link.remote_port];
 148 
 149                 v4l2_fwnode_put_link(&link);
 150 
 151                 /* Create the media link. */
 152                 dev_dbg(xdev->dev, "creating %s:%u -> %s:%u link\n",
 153                         local->name, local_pad->index,
 154                         remote->name, remote_pad->index);
 155 
 156                 ret = media_create_pad_link(local, local_pad->index,
 157                                                remote, remote_pad->index,
 158                                                link_flags);
 159                 if (ret < 0) {
 160                         dev_err(xdev->dev,
 161                                 "failed to create %s:%u -> %s:%u link\n",
 162                                 local->name, local_pad->index,
 163                                 remote->name, remote_pad->index);
 164                         break;
 165                 }
 166         }
 167 
 168         fwnode_handle_put(ep);
 169         return ret;
 170 }
 171 
 172 static struct xvip_dma *
 173 xvip_graph_find_dma(struct xvip_composite_device *xdev, unsigned int port)
 174 {
 175         struct xvip_dma *dma;
 176 
 177         list_for_each_entry(dma, &xdev->dmas, list) {
 178                 if (dma->port == port)
 179                         return dma;
 180         }
 181 
 182         return NULL;
 183 }
 184 
 185 static int xvip_graph_build_dma(struct xvip_composite_device *xdev)
 186 {
 187         u32 link_flags = MEDIA_LNK_FL_ENABLED;
 188         struct device_node *node = xdev->dev->of_node;
 189         struct media_entity *source;
 190         struct media_entity *sink;
 191         struct media_pad *source_pad;
 192         struct media_pad *sink_pad;
 193         struct xvip_graph_entity *ent;
 194         struct v4l2_fwnode_link link;
 195         struct device_node *ep = NULL;
 196         struct xvip_dma *dma;
 197         int ret = 0;
 198 
 199         dev_dbg(xdev->dev, "creating links for DMA engines\n");
 200 
 201         while (1) {
 202                 /* Get the next endpoint and parse its link. */
 203                 ep = of_graph_get_next_endpoint(node, ep);
 204                 if (ep == NULL)
 205                         break;
 206 
 207                 dev_dbg(xdev->dev, "processing endpoint %pOF\n", ep);
 208 
 209                 ret = v4l2_fwnode_parse_link(of_fwnode_handle(ep), &link);
 210                 if (ret < 0) {
 211                         dev_err(xdev->dev, "failed to parse link for %pOF\n",
 212                                 ep);
 213                         continue;
 214                 }
 215 
 216                 /* Find the DMA engine. */
 217                 dma = xvip_graph_find_dma(xdev, link.local_port);
 218                 if (dma == NULL) {
 219                         dev_err(xdev->dev, "no DMA engine found for port %u\n",
 220                                 link.local_port);
 221                         v4l2_fwnode_put_link(&link);
 222                         ret = -EINVAL;
 223                         break;
 224                 }
 225 
 226                 dev_dbg(xdev->dev, "creating link for DMA engine %s\n",
 227                         dma->video.name);
 228 
 229                 /* Find the remote entity. */
 230                 ent = xvip_graph_find_entity(xdev, link.remote_node);
 231                 if (ent == NULL) {
 232                         dev_err(xdev->dev, "no entity found for %pOF\n",
 233                                 to_of_node(link.remote_node));
 234                         v4l2_fwnode_put_link(&link);
 235                         ret = -ENODEV;
 236                         break;
 237                 }
 238 
 239                 if (link.remote_port >= ent->entity->num_pads) {
 240                         dev_err(xdev->dev, "invalid port number %u on %pOF\n",
 241                                 link.remote_port,
 242                                 to_of_node(link.remote_node));
 243                         v4l2_fwnode_put_link(&link);
 244                         ret = -EINVAL;
 245                         break;
 246                 }
 247 
 248                 if (dma->pad.flags & MEDIA_PAD_FL_SOURCE) {
 249                         source = &dma->video.entity;
 250                         source_pad = &dma->pad;
 251                         sink = ent->entity;
 252                         sink_pad = &sink->pads[link.remote_port];
 253                 } else {
 254                         source = ent->entity;
 255                         source_pad = &source->pads[link.remote_port];
 256                         sink = &dma->video.entity;
 257                         sink_pad = &dma->pad;
 258                 }
 259 
 260                 v4l2_fwnode_put_link(&link);
 261 
 262                 /* Create the media link. */
 263                 dev_dbg(xdev->dev, "creating %s:%u -> %s:%u link\n",
 264                         source->name, source_pad->index,
 265                         sink->name, sink_pad->index);
 266 
 267                 ret = media_create_pad_link(source, source_pad->index,
 268                                                sink, sink_pad->index,
 269                                                link_flags);
 270                 if (ret < 0) {
 271                         dev_err(xdev->dev,
 272                                 "failed to create %s:%u -> %s:%u link\n",
 273                                 source->name, source_pad->index,
 274                                 sink->name, sink_pad->index);
 275                         break;
 276                 }
 277         }
 278 
 279         of_node_put(ep);
 280         return ret;
 281 }
 282 
 283 static int xvip_graph_notify_complete(struct v4l2_async_notifier *notifier)
 284 {
 285         struct xvip_composite_device *xdev =
 286                 container_of(notifier, struct xvip_composite_device, notifier);
 287         struct xvip_graph_entity *entity;
 288         struct v4l2_async_subdev *asd;
 289         int ret;
 290 
 291         dev_dbg(xdev->dev, "notify complete, all subdevs registered\n");
 292 
 293         /* Create links for every entity. */
 294         list_for_each_entry(asd, &xdev->notifier.asd_list, asd_list) {
 295                 entity = to_xvip_entity(asd);
 296                 ret = xvip_graph_build_one(xdev, entity);
 297                 if (ret < 0)
 298                         return ret;
 299         }
 300 
 301         /* Create links for DMA channels. */
 302         ret = xvip_graph_build_dma(xdev);
 303         if (ret < 0)
 304                 return ret;
 305 
 306         ret = v4l2_device_register_subdev_nodes(&xdev->v4l2_dev);
 307         if (ret < 0)
 308                 dev_err(xdev->dev, "failed to register subdev nodes\n");
 309 
 310         return media_device_register(&xdev->media_dev);
 311 }
 312 
 313 static int xvip_graph_notify_bound(struct v4l2_async_notifier *notifier,
 314                                    struct v4l2_subdev *subdev,
 315                                    struct v4l2_async_subdev *unused)
 316 {
 317         struct xvip_composite_device *xdev =
 318                 container_of(notifier, struct xvip_composite_device, notifier);
 319         struct xvip_graph_entity *entity;
 320         struct v4l2_async_subdev *asd;
 321 
 322         /* Locate the entity corresponding to the bound subdev and store the
 323          * subdev pointer.
 324          */
 325         list_for_each_entry(asd, &xdev->notifier.asd_list, asd_list) {
 326                 entity = to_xvip_entity(asd);
 327 
 328                 if (entity->asd.match.fwnode != subdev->fwnode)
 329                         continue;
 330 
 331                 if (entity->subdev) {
 332                         dev_err(xdev->dev, "duplicate subdev for node %p\n",
 333                                 entity->asd.match.fwnode);
 334                         return -EINVAL;
 335                 }
 336 
 337                 dev_dbg(xdev->dev, "subdev %s bound\n", subdev->name);
 338                 entity->entity = &subdev->entity;
 339                 entity->subdev = subdev;
 340                 return 0;
 341         }
 342 
 343         dev_err(xdev->dev, "no entity for subdev %s\n", subdev->name);
 344         return -EINVAL;
 345 }
 346 
 347 static const struct v4l2_async_notifier_operations xvip_graph_notify_ops = {
 348         .bound = xvip_graph_notify_bound,
 349         .complete = xvip_graph_notify_complete,
 350 };
 351 
 352 static int xvip_graph_parse_one(struct xvip_composite_device *xdev,
 353                                 struct fwnode_handle *fwnode)
 354 {
 355         struct fwnode_handle *remote;
 356         struct fwnode_handle *ep = NULL;
 357         int ret = 0;
 358 
 359         dev_dbg(xdev->dev, "parsing node %p\n", fwnode);
 360 
 361         while (1) {
 362                 struct v4l2_async_subdev *asd;
 363 
 364                 ep = fwnode_graph_get_next_endpoint(fwnode, ep);
 365                 if (ep == NULL)
 366                         break;
 367 
 368                 dev_dbg(xdev->dev, "handling endpoint %p\n", ep);
 369 
 370                 remote = fwnode_graph_get_remote_port_parent(ep);
 371                 if (remote == NULL) {
 372                         ret = -EINVAL;
 373                         goto err_notifier_cleanup;
 374                 }
 375 
 376                 fwnode_handle_put(ep);
 377 
 378                 /* Skip entities that we have already processed. */
 379                 if (remote == of_fwnode_handle(xdev->dev->of_node) ||
 380                     xvip_graph_find_entity(xdev, remote)) {
 381                         fwnode_handle_put(remote);
 382                         continue;
 383                 }
 384 
 385                 asd = v4l2_async_notifier_add_fwnode_subdev(
 386                         &xdev->notifier, remote,
 387                         sizeof(struct xvip_graph_entity));
 388                 fwnode_handle_put(remote);
 389                 if (IS_ERR(asd)) {
 390                         ret = PTR_ERR(asd);
 391                         goto err_notifier_cleanup;
 392                 }
 393         }
 394 
 395         return 0;
 396 
 397 err_notifier_cleanup:
 398         v4l2_async_notifier_cleanup(&xdev->notifier);
 399         fwnode_handle_put(ep);
 400         return ret;
 401 }
 402 
 403 static int xvip_graph_parse(struct xvip_composite_device *xdev)
 404 {
 405         struct xvip_graph_entity *entity;
 406         struct v4l2_async_subdev *asd;
 407         int ret;
 408 
 409         /*
 410          * Walk the links to parse the full graph. Start by parsing the
 411          * composite node and then parse entities in turn. The list_for_each
 412          * loop will handle entities added at the end of the list while walking
 413          * the links.
 414          */
 415         ret = xvip_graph_parse_one(xdev, of_fwnode_handle(xdev->dev->of_node));
 416         if (ret < 0)
 417                 return 0;
 418 
 419         list_for_each_entry(asd, &xdev->notifier.asd_list, asd_list) {
 420                 entity = to_xvip_entity(asd);
 421                 ret = xvip_graph_parse_one(xdev, entity->asd.match.fwnode);
 422                 if (ret < 0) {
 423                         v4l2_async_notifier_cleanup(&xdev->notifier);
 424                         break;
 425                 }
 426         }
 427 
 428         return ret;
 429 }
 430 
 431 static int xvip_graph_dma_init_one(struct xvip_composite_device *xdev,
 432                                    struct device_node *node)
 433 {
 434         struct xvip_dma *dma;
 435         enum v4l2_buf_type type;
 436         const char *direction;
 437         unsigned int index;
 438         int ret;
 439 
 440         ret = of_property_read_string(node, "direction", &direction);
 441         if (ret < 0)
 442                 return ret;
 443 
 444         if (strcmp(direction, "input") == 0)
 445                 type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 446         else if (strcmp(direction, "output") == 0)
 447                 type = V4L2_BUF_TYPE_VIDEO_OUTPUT;
 448         else
 449                 return -EINVAL;
 450 
 451         of_property_read_u32(node, "reg", &index);
 452 
 453         dma = devm_kzalloc(xdev->dev, sizeof(*dma), GFP_KERNEL);
 454         if (dma == NULL)
 455                 return -ENOMEM;
 456 
 457         ret = xvip_dma_init(xdev, dma, type, index);
 458         if (ret < 0) {
 459                 dev_err(xdev->dev, "%pOF initialization failed\n", node);
 460                 return ret;
 461         }
 462 
 463         list_add_tail(&dma->list, &xdev->dmas);
 464 
 465         xdev->v4l2_caps |= type == V4L2_BUF_TYPE_VIDEO_CAPTURE
 466                          ? V4L2_CAP_VIDEO_CAPTURE : V4L2_CAP_VIDEO_OUTPUT;
 467 
 468         return 0;
 469 }
 470 
 471 static int xvip_graph_dma_init(struct xvip_composite_device *xdev)
 472 {
 473         struct device_node *ports;
 474         struct device_node *port;
 475         int ret;
 476 
 477         ports = of_get_child_by_name(xdev->dev->of_node, "ports");
 478         if (ports == NULL) {
 479                 dev_err(xdev->dev, "ports node not present\n");
 480                 return -EINVAL;
 481         }
 482 
 483         for_each_child_of_node(ports, port) {
 484                 ret = xvip_graph_dma_init_one(xdev, port);
 485                 if (ret < 0) {
 486                         of_node_put(port);
 487                         return ret;
 488                 }
 489         }
 490 
 491         return 0;
 492 }
 493 
 494 static void xvip_graph_cleanup(struct xvip_composite_device *xdev)
 495 {
 496         struct xvip_dma *dmap;
 497         struct xvip_dma *dma;
 498 
 499         v4l2_async_notifier_unregister(&xdev->notifier);
 500         v4l2_async_notifier_cleanup(&xdev->notifier);
 501 
 502         list_for_each_entry_safe(dma, dmap, &xdev->dmas, list) {
 503                 xvip_dma_cleanup(dma);
 504                 list_del(&dma->list);
 505         }
 506 }
 507 
 508 static int xvip_graph_init(struct xvip_composite_device *xdev)
 509 {
 510         int ret;
 511 
 512         /* Init the DMA channels. */
 513         ret = xvip_graph_dma_init(xdev);
 514         if (ret < 0) {
 515                 dev_err(xdev->dev, "DMA initialization failed\n");
 516                 goto done;
 517         }
 518 
 519         /* Parse the graph to extract a list of subdevice DT nodes. */
 520         ret = xvip_graph_parse(xdev);
 521         if (ret < 0) {
 522                 dev_err(xdev->dev, "graph parsing failed\n");
 523                 goto done;
 524         }
 525 
 526         if (list_empty(&xdev->notifier.asd_list)) {
 527                 dev_err(xdev->dev, "no subdev found in graph\n");
 528                 goto done;
 529         }
 530 
 531         /* Register the subdevices notifier. */
 532         xdev->notifier.ops = &xvip_graph_notify_ops;
 533 
 534         ret = v4l2_async_notifier_register(&xdev->v4l2_dev, &xdev->notifier);
 535         if (ret < 0) {
 536                 dev_err(xdev->dev, "notifier registration failed\n");
 537                 goto done;
 538         }
 539 
 540         ret = 0;
 541 
 542 done:
 543         if (ret < 0)
 544                 xvip_graph_cleanup(xdev);
 545 
 546         return ret;
 547 }
 548 
 549 /* -----------------------------------------------------------------------------
 550  * Media Controller and V4L2
 551  */
 552 
 553 static void xvip_composite_v4l2_cleanup(struct xvip_composite_device *xdev)
 554 {
 555         v4l2_device_unregister(&xdev->v4l2_dev);
 556         media_device_unregister(&xdev->media_dev);
 557         media_device_cleanup(&xdev->media_dev);
 558 }
 559 
 560 static int xvip_composite_v4l2_init(struct xvip_composite_device *xdev)
 561 {
 562         int ret;
 563 
 564         xdev->media_dev.dev = xdev->dev;
 565         strscpy(xdev->media_dev.model, "Xilinx Video Composite Device",
 566                 sizeof(xdev->media_dev.model));
 567         xdev->media_dev.hw_revision = 0;
 568 
 569         media_device_init(&xdev->media_dev);
 570 
 571         xdev->v4l2_dev.mdev = &xdev->media_dev;
 572         ret = v4l2_device_register(xdev->dev, &xdev->v4l2_dev);
 573         if (ret < 0) {
 574                 dev_err(xdev->dev, "V4L2 device registration failed (%d)\n",
 575                         ret);
 576                 media_device_cleanup(&xdev->media_dev);
 577                 return ret;
 578         }
 579 
 580         return 0;
 581 }
 582 
 583 /* -----------------------------------------------------------------------------
 584  * Platform Device Driver
 585  */
 586 
 587 static int xvip_composite_probe(struct platform_device *pdev)
 588 {
 589         struct xvip_composite_device *xdev;
 590         int ret;
 591 
 592         xdev = devm_kzalloc(&pdev->dev, sizeof(*xdev), GFP_KERNEL);
 593         if (!xdev)
 594                 return -ENOMEM;
 595 
 596         xdev->dev = &pdev->dev;
 597         INIT_LIST_HEAD(&xdev->dmas);
 598         v4l2_async_notifier_init(&xdev->notifier);
 599 
 600         ret = xvip_composite_v4l2_init(xdev);
 601         if (ret < 0)
 602                 return ret;
 603 
 604         ret = xvip_graph_init(xdev);
 605         if (ret < 0)
 606                 goto error;
 607 
 608         platform_set_drvdata(pdev, xdev);
 609 
 610         dev_info(xdev->dev, "device registered\n");
 611 
 612         return 0;
 613 
 614 error:
 615         xvip_composite_v4l2_cleanup(xdev);
 616         return ret;
 617 }
 618 
 619 static int xvip_composite_remove(struct platform_device *pdev)
 620 {
 621         struct xvip_composite_device *xdev = platform_get_drvdata(pdev);
 622 
 623         xvip_graph_cleanup(xdev);
 624         xvip_composite_v4l2_cleanup(xdev);
 625 
 626         return 0;
 627 }
 628 
 629 static const struct of_device_id xvip_composite_of_id_table[] = {
 630         { .compatible = "xlnx,video" },
 631         { }
 632 };
 633 MODULE_DEVICE_TABLE(of, xvip_composite_of_id_table);
 634 
 635 static struct platform_driver xvip_composite_driver = {
 636         .driver = {
 637                 .name = "xilinx-video",
 638                 .of_match_table = xvip_composite_of_id_table,
 639         },
 640         .probe = xvip_composite_probe,
 641         .remove = xvip_composite_remove,
 642 };
 643 
 644 module_platform_driver(xvip_composite_driver);
 645 
 646 MODULE_AUTHOR("Laurent Pinchart <laurent.pinchart@ideasonboard.com>");
 647 MODULE_DESCRIPTION("Xilinx Video IP Composite Driver");
 648 MODULE_LICENSE("GPL v2");