Show a cover letter.

GET /api/covers/807043/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 807043,
    "url": "http://patchwork.ozlabs.org/api/covers/807043/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/devicetree-bindings/cover/20170829110313.19538-1-sakari.ailus@linux.intel.com/",
    "project": {
        "id": 37,
        "url": "http://patchwork.ozlabs.org/api/projects/37/?format=api",
        "name": "Devicetree Bindings",
        "link_name": "devicetree-bindings",
        "list_id": "devicetree.vger.kernel.org",
        "list_email": "devicetree@vger.kernel.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": "",
        "list_archive_url": "",
        "list_archive_url_format": "",
        "commit_url_format": ""
    },
    "msgid": "<20170829110313.19538-1-sakari.ailus@linux.intel.com>",
    "list_archive_url": null,
    "date": "2017-08-29T11:03:08",
    "name": "[v5,0/5] Unified fwnode endpoint parser",
    "submitter": {
        "id": 65485,
        "url": "http://patchwork.ozlabs.org/api/people/65485/?format=api",
        "name": "Sakari Ailus",
        "email": "sakari.ailus@linux.intel.com"
    },
    "mbox": "http://patchwork.ozlabs.org/project/devicetree-bindings/cover/20170829110313.19538-1-sakari.ailus@linux.intel.com/mbox/",
    "series": [
        {
            "id": 348,
            "url": "http://patchwork.ozlabs.org/api/series/348/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/devicetree-bindings/list/?series=348",
            "date": "2017-08-29T11:03:08",
            "name": "Unified fwnode endpoint parser",
            "version": 5,
            "mbox": "http://patchwork.ozlabs.org/series/348/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/covers/807043/comments/",
    "headers": {
        "Return-Path": "<devicetree-owner@vger.kernel.org>",
        "X-Original-To": "incoming-dt@patchwork.ozlabs.org",
        "Delivered-To": "patchwork-incoming-dt@bilbo.ozlabs.org",
        "Authentication-Results": "ozlabs.org;\n\tspf=none (mailfrom) smtp.mailfrom=vger.kernel.org\n\t(client-ip=209.132.180.67; helo=vger.kernel.org;\n\tenvelope-from=devicetree-owner@vger.kernel.org; receiver=<UNKNOWN>)",
        "Received": [
            "from vger.kernel.org (vger.kernel.org [209.132.180.67])\n\tby ozlabs.org (Postfix) with ESMTP id 3xhQjX0TDVz9t2x\n\tfor <incoming-dt@patchwork.ozlabs.org>;\n\tTue, 29 Aug 2017 21:03:28 +1000 (AEST)",
            "(majordomo@vger.kernel.org) by vger.kernel.org via listexpand\n\tid S1752427AbdH2LDZ (ORCPT\n\t<rfc822;incoming-dt@patchwork.ozlabs.org>);\n\tTue, 29 Aug 2017 07:03:25 -0400",
            "from nblzone-211-213.nblnetworks.fi ([83.145.211.213]:50744 \"EHLO\n\thillosipuli.retiisi.org.uk\" rhost-flags-OK-OK-OK-FAIL)\n\tby vger.kernel.org with ESMTP id S1751615AbdH2LDR (ORCPT\n\t<rfc822; devicetree@vger.kernel.org>); Tue, 29 Aug 2017 07:03:17 -0400",
            "from lanttu.localdomain (unknown\n\t[IPv6:2001:1bc8:1a6:d3d5::e1:1002])\n\tby hillosipuli.retiisi.org.uk (Postfix) with ESMTP id E1C00600ED;\n\tTue, 29 Aug 2017 14:03:13 +0300 (EEST)"
        ],
        "From": "Sakari Ailus <sakari.ailus@linux.intel.com>",
        "To": "linux-media@vger.kernel.org",
        "Cc": "niklas.soderlund@ragnatech.se, robh@kernel.org, hverkuil@xs4all.nl,\n\tlaurent.pinchart@ideasonboard.com, devicetree@vger.kernel.org",
        "Subject": "[PATCH v5 0/5] Unified fwnode endpoint parser",
        "Date": "Tue, 29 Aug 2017 14:03:08 +0300",
        "Message-Id": "<20170829110313.19538-1-sakari.ailus@linux.intel.com>",
        "X-Mailer": "git-send-email 2.11.0",
        "Sender": "devicetree-owner@vger.kernel.org",
        "Precedence": "bulk",
        "List-ID": "<devicetree.vger.kernel.org>",
        "X-Mailing-List": "devicetree@vger.kernel.org"
    },
    "content": "Hi folks,\n\nWe have a large influx of new, unmerged, drivers that are now parsing\nfwnode endpoints and each one of them is doing this a little bit\ndifferently. The needs are still exactly the same for the graph data\nstructure is device independent. This is still a non-trivial task and the\nmajority of the driver implementations are buggy, just buggy in different\nways.\n\nFacilitate parsing endpoints by adding a convenience function for parsing\nthe endpoints, and make the omap3isp and rcar-vin drivers use them as an\nexample.\n\nsince v4:\n\n- Prepend the set with three documentation fixes.\n\n- The driver's async struct must begin with struct v4l2_async_subdev. Fix this\n  for omap3isp and document it.\n\n- Improve documentation for new functions.\n\n- Don't use devm_ family of functions for allocating memory. Introduce\n  v4l2_async_notifier_release() to release memory resources.\n\n- Rework both v4l2_async_notifier_fwnode_parse_endpoints() and\n  v4l2_async_notifier_fwnode_parse_endpoint() and the local functions they\n  call. This should make the code cleaner. Despite the name, for linking\n  and typical usage reasons the functions remain in v4l2-fwnode.c.\n\n- Convert rcar-vin to use v4l2_async_notifier_fwnode_parse_endpoint().\n\n- Use kvmalloc() for allocating the notifier's subdevs array.\n\n- max_subdevs argument for notifier_realloc is now the total maximum\n  number of subdevs, not the number of available subdevs.\n\n- Use fwnode_device_is_available() to make sure the device actually\n  exists.\n\n- Move the note telling v4l2_async_notifier_fwnode_parse_endpoints()\n  should not be used by new drivers to the last patch adding\n  v4l2_async_notifier_fwnode_parse_endpoint().\n\nsince v3:\n\n- Rebase on current mediatree master.\n\nsince v2:\n\n- Rebase on CCP2 support patches.\n\n- Prepend a patch cleaning up omap3isp driver a little.\n\nsince v1:\n\n- The first patch has been merged (it was a bugfix).\n\n- In anticipation that the parsing can take place over several iterations,\n  take the existing number of async sub-devices into account when\n  re-allocating an array of async sub-devices.\n\n- Rework the first patch to better anticipate parsing single endpoint at a\n  time by a driver.\n\n- Add a second patch that adds a function for parsing endpoints one at a\n  time based on port and endpoint numbers.\n\nSakari Ailus (5):\n  v4l: fwnode: Move KernelDoc documentation to the header\n  v4l: async: Add V4L2 async documentation to the documentation build\n  docs-rst: v4l: Include Qualcomm CAMSS in documentation build\n  v4l: fwnode: Support generic parsing of graph endpoints in a device\n  v4l: fwnode: Support generic parsing of graph endpoints in a single\n    port\n\n Documentation/media/kapi/v4l2-async.rst     |   3 +\n Documentation/media/kapi/v4l2-core.rst      |   1 +\n Documentation/media/v4l-drivers/index.rst   |   1 +\n drivers/media/platform/omap3isp/isp.c       | 115 ++++---------\n drivers/media/platform/omap3isp/isp.h       |   5 +-\n drivers/media/platform/rcar-vin/rcar-core.c | 111 ++++--------\n drivers/media/platform/rcar-vin/rcar-dma.c  |  10 +-\n drivers/media/platform/rcar-vin/rcar-v4l2.c |  14 +-\n drivers/media/platform/rcar-vin/rcar-vin.h  |   4 +-\n drivers/media/v4l2-core/v4l2-async.c        |  16 ++\n drivers/media/v4l2-core/v4l2-fwnode.c       | 254 ++++++++++++++++++++--------\n include/media/v4l2-async.h                  |  20 ++-\n include/media/v4l2-fwnode.h                 | 159 ++++++++++++++++-\n 13 files changed, 459 insertions(+), 254 deletions(-)\n create mode 100644 Documentation/media/kapi/v4l2-async.rst"
}