Cover Letter Detail
Show a cover letter.
GET /api/covers/18768/?format=api
{ "id": 18768, "url": "https://patchwork.libcamera.org/api/covers/18768/?format=api", "web_url": "https://patchwork.libcamera.org/cover/18768/", "project": { "id": 1, "url": "https://patchwork.libcamera.org/api/projects/1/?format=api", "name": "libcamera", "link_name": "libcamera", "list_id": "libcamera_core", "list_email": "libcamera-devel@lists.libcamera.org", "web_url": "", "scm_url": "", "webscm_url": "" }, "msgid": "<20230629144915.597188-1-Alexander.Gordeev@opensynergy.com>", "date": "2023-06-29T14:49:14", "name": "[libcamera-devel,RFC,v8,0/1] Virtio video device specification", "submitter": { "id": 167, "url": "https://patchwork.libcamera.org/api/people/167/?format=api", "name": "Alexander Gordeev", "email": "Alexander.Gordeev@opensynergy.com" }, "mbox": "https://patchwork.libcamera.org/cover/18768/mbox/", "series": [ { "id": 3944, "url": "https://patchwork.libcamera.org/api/series/3944/?format=api", "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=3944", "date": "2023-06-29T14:49:15", "name": "Virtio video device specification", "version": 8, "mbox": "https://patchwork.libcamera.org/series/3944/mbox/" } ], "comments": "https://patchwork.libcamera.org/api/covers/18768/comments/", "headers": { "Return-Path": "<libcamera-devel-bounces@lists.libcamera.org>", "X-Original-To": "parsemail@patchwork.libcamera.org", "Delivered-To": "parsemail@patchwork.libcamera.org", "Received": [ "from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 4A6FEC3295\n\tfor <parsemail@patchwork.libcamera.org>;\n\tThu, 29 Jun 2023 15:08:07 +0000 (UTC)", "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 3CD63628C3;\n\tThu, 29 Jun 2023 17:08:06 +0200 (CEST)", "from repost01.tmes.trendmicro.eu (repost01.tmes.trendmicro.eu\n\t[18.185.115.122])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 62BB1628C1\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu, 29 Jun 2023 16:49:51 +0200 (CEST)", "from 104.47.7.174_.trendmicro.com (unknown [172.21.199.100])\n\tby repost01.tmes.trendmicro.eu (Postfix) with SMTP id 244D210001234; \n\tThu, 29 Jun 2023 14:49:51 +0000 (UTC)", "from DEU01-BE0-obe.outbound.protection.outlook.com (unknown\n\t[104.47.7.174])\n\tby repre01.tmes.trendmicro.eu (Trend Micro Email Security) with\n\tESMTPS id AE4621000031D; Thu, 29 Jun 2023 14:49:38 +0000 (UTC)" ], "DKIM-Signature": [ "v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1688051286;\n\tbh=0vYK3F+00qzY6tgYrDYn2jmyyaCVmzedj4Tjbgvevhw=;\n\th=To:Date:Subject:List-Id:List-Unsubscribe:List-Archive:List-Post:\n\tList-Help:List-Subscribe:From:Reply-To:Cc:From;\n\tb=2jzlQtMTySWUgvADjpnNa7oWhgq0+16P53Q2XJMVOepzz0BP+77OJtEV7VQxNk9YI\n\tdt/c8JHq4uxd7ELI3S+nipo7wotbWNB0+g1Cx97Ur82F0g1WPtrHlCsg7dP/mzAVdC\n\tZ0x5OeHFw4iDDSjhNqUMdpy/XqfvyuPZnm0KQYffBN7PhQ8uxVg4XmafFyyxBBDkYL\n\t7lv6Xibv27oqe3YyyYGl/HnPkQhDG+AYk250UcZ9w7wd5XHFbgmbcTJNPWwPu3cFpb\n\t9v1kgPAb8V4kXwdhfXyFI80LgXOcWD5nyEepPFiGxUEwdX3Z5lodZAVXRUMoqOO4v2\n\tAlXKSx8nf4+Tg==", "v=1; a=rsa-sha256; c=simple/simple; d=opensynergy.com;\n\ts=TM-DKIM-20210503141657; t=1688050191;\n\tbh=0vYK3F+00qzY6tgYrDYn2jmyyaCVmzedj4Tjbgvevhw=; l=3149;\n\th=From:To:Date;\n\tb=Ymn84sk52EWKJPWWXE3j/OJeeocbKwETMnMIoqNFqO6fqWp9/uYYbkQNYp58rexc0\n\tqbQqFl6hHDzjfI7XSdIZCnTDYXKODPy73krAY3d2piHVSWeV4r5SHVngyq4WkfmMZm\n\tq9eBkcCVkUt7x+yFf4ry+teuGojZAcfhE7eh7SwucOf2VO5rbz7+VRsIJS4JXnEmyi\n\tgZW8BUNrAb9d1rWip/Z1TY422pykWdyB0rHvJov1DfvQUuGHR+rbXSDMB9hwPddVPv\n\t4vFN4ys41owTVDd2IrBime44UBPHOZnNilQwTEx769nTEbftqwdvBw2evC59mwWgRC\n\tFrXUM2kmHwP9w==" ], "Authentication-Results": "lancelot.ideasonboard.com; dkim=pass (2048-bit key; \n\tunprotected) header.d=opensynergy.com\n\theader.i=@opensynergy.com\n\theader.b=\"Ymn84sk5\"; dkim-atps=neutral", "X-TM-MAIL-RECEIVED-TIME": "1688050178.713000", "X-TM-MAIL-UUID": "67d40f0c-723f-4a07-8140-b912dc22be84", "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n\tb=JoHXcDuy99jLDXURhUlzN4gyxFPzpfAW/RjP7u1MabxjTigrWqk3G2PhkgdUkxFAV/Je+bf7ZEQSvR2R8G+SJiisScaB36bmX9vaSraYfts8OQGROgpu99NrbacZenCrOIjzOJoqvtWWOOm3OuL+++mhxo4JLnarEXD6BKeG+zy6yhPi5B0A0LjWHM97nnyrhSZUcnkozkyu3uLy40WoFMzGLX6s+KskZ8okOAYqeApCnEZcHfzjrjlAdA0hI6yNZmbWPEIvvKgQCNKYqIUYnpWuATZmaIkQt/h5REs6wcNzKUcpWrLTz/ktFnRIf/vQY7Cpv3GCH+ti33fWT2H3uQ==", "ARC-Message-Signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n\ts=arcselector9901;\n\th=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;\n\tbh=uXE0H22iw+cpckPfVbWhUzcsGOxy+sHiyyCjodERnMY=;\n\tb=noXSRX0VcBc0eXPqSbBIeIu0R7ksQ++yaTlV6rYl7iveNve/k/urq3P0vbGcZLqzshcgD8EyCi22CYU224HzKjTawxZK0fOs2OEdfc5UOGYW0KLkevS7mSSKYdknxhvPWLwgUkvShPzRP7SxNqpavTuq7c4y6AJwzBAInX3YjFx7N3zQ26uuBRH6fNAMxqdIiv6Mi14cCZrzEr7BQO/5dWaDVqRE4MMCj0p6eyemujGAO/GA5BMiSSup56eiYdyyFk9BZ7LQFKrYo0bkjBt7nThlCX9PMO094IWNK/93b1gAw9G5J/NLG03xjDC5NxtUhOcnIQJTh2hKV2GeDEa7iw==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n\t217.66.60.4) smtp.rcpttodomain=chromium.org\n\tsmtp.mailfrom=opensynergy.com; \n\tdmarc=pass (p=quarantine sp=quarantine pct=100) action=none\n\theader.from=opensynergy.com; dkim=none (message not signed); arc=none", "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 217.66.60.4)\n\tsmtp.mailfrom=opensynergy.com; dkim=none (message not signed)\n\theader.d=none;dmarc=pass action=none header.from=opensynergy.com;", "Received-SPF": "Pass (protection.outlook.com: domain of opensynergy.com\n\tdesignates 217.66.60.4 as permitted sender)\n\treceiver=protection.outlook.com; \n\tclient-ip=217.66.60.4; helo=SR-MAIL-03.open-synergy.com; pr=C", "To": "virtio-comment@lists.oasis-open.org,\n\tvirtio-dev@lists.oasis-open.org", "Date": "Thu, 29 Jun 2023 16:49:14 +0200", "Message-Id": "<20230629144915.597188-1-Alexander.Gordeev@opensynergy.com>", "X-Mailer": "git-send-email 2.34.1", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "X-EOPAttributedMessage": "0", "X-MS-PublicTrafficType": "Email", "X-MS-TrafficTypeDiagnostic": "VI1EUR05FT039:EE_|FR0P281MB2046:EE_", "Content-Type": "text/plain", "X-MS-Office365-Filtering-Correlation-Id": "0bf81e8f-0f0a-4dbe-b644-08db78b00f99", "X-MS-Exchange-SenderADCheck": "1", "X-MS-Exchange-AntiSpam-Relay": "0", "X-Microsoft-Antispam": "BCL:0;", "X-Microsoft-Antispam-Message-Info": "zX2xceQkmOiDI1mEwvCjEjCRe+ZctXd5Dxrfzho9lSMu7dzcifEGX8+h/12j1PfzA8vbfbPpDxZ+DHc2wQOcEigZAJHl1LNcesaSypJGONx7UDeRPh6fmuMQKsWH21KX+RkB9hg/dVKHFM3DJgjEJLmjdp2dfdj25hA5A0iu0MIB1tE+mah4twICr6MG4vYtv7paeEGuRQyEnRlXkNwPOikjAP5Yu5E4vI7MAu+BZil3eVuIxTNrIqycBHL5bpcFIZfzg9y1XkqAk1DwCS8YZi7nwdPKm4jDtAu2FV1HSmXT+3ogHpJoguEOXa+83ALQ6LzBHoAWDq9iTnIKLKUvhnc/tuDX8GhsrRWyRsqyyj6TWUCbYGmJ/du71pBoV//dfrEdP9HkSd6UUze/yP8/5Q+Imtzi4pC/CodYLtr6EnUkz62eCvZFX3JZB68E+Y7C8oUHA/KgBVe7elPFJiTVKe23Bwc8gsCt5hm7tRzjFfIQ9lKJJw1e/rYO+jaHHfAWR0yCv6LMKwZbJY0CqNCd56Gss0lrBMjozhgHKpBXIMHtq0GHT1OQ3aAZZie5xrq+chsIguU4J+8B3z4VgKmvJtHpazcDjgyb3T6jFXO9mtIrvgEa7sJlBYqGEcgHceUHsobmfjY1xYfaPCvMzojAQC7LrewaO28j0aaDpkEGogXNZulBvH6lHKIQxPyhdr8bVfSMTgtOWiarzH0U2lo6zklY90Wmyggn3W5++aWnIx7fKjz7qXIXsTVBpFPsPOCvBjhV3HFLkgsCbad+au/OOg==", "X-Forefront-Antispam-Report": "CIP:217.66.60.4; CTRY:DE; LANG:en; SCL:1; SRV:; \n\tIPV:NLI; SFV:NSPM; H:SR-MAIL-03.open-synergy.com;\n\tPTR:InfoDomainNonexistent; CAT:NONE;\n\tSFS:(13230028)(396003)(376002)(39840400004)(346002)(136003)(451199021)(46966006)(36840700001)(7416002)(5930299015)(1076003)(5660300002)(336012)(4326008)(316002)(70206006)(478600001)(36756003)(70586007)(8676002)(8936002)(2906002)(186003)(54906003)(966005)(36860700001)(42186006)(40480700001)(41300700001)(82310400005)(86362001)(81166007)(47076005)(26005)(2616005)(83380400001)(36900700001);\n\tDIR:OUT; SFP:1102; ", "X-OriginatorOrg": "opensynergy.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "29 Jun 2023 14:49:37.3585\n\t(UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "0bf81e8f-0f0a-4dbe-b644-08db78b00f99", "X-MS-Exchange-CrossTenant-Id": "800fae25-9b1b-4edc-993d-c939c4e84a64", "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "TenantId=800fae25-9b1b-4edc-993d-c939c4e84a64;\n\tIp=[217.66.60.4]; \n\tHelo=[SR-MAIL-03.open-synergy.com]", "X-MS-Exchange-CrossTenant-AuthSource": "VI1EUR05FT039.eop-eur05.prod.protection.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous", "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "FR0P281MB2046", "X-TM-AS-ERS": "104.47.7.174-0.0.0.0", "X-TMASE-Version": "StarCloud-1.3-9.1.1011-27722.000", "X-TMASE-Result": "10--13.217400-4.000000", "X-TMASE-MatchedRID": "xXA8JSLb31tKqT77NMMyNxZu3Ax5Ngq859KGlOljPvu4xpDSsMYz9Ik+\n\tek903bmdJIE8B+MatXg0MlZvaRoxGC6T4pgCl/M6R6eMmpdkcdk6Cu19Vtgyg//cMgrTjbBkRQc\n\tXrCueZFhpO0BOxhTlbJA/ATZ0Yg5D0GDK5hZjJXyB7KF1cYE+v/emg0BhV6PFu5fROEbKeImvU1\n\ttCOC5lhTIs3LEAaA7XSE3uK2tLdI1NOAGUOSRGeF7YyKSX4fHjFQ/jDVQKXn4eyPVZe0RJiUkgG\n\tAfseSYI2agkMppXv0n2CX+DNSvaTpVqXn8k6sIeju2XlcEx9HQFgK3XHdr3w4loy91GB/ZEB0lB\n\tbq8327NXoinqR4tvX6Wz+FpE58Tnk/dA6P3T5Fuw0Dfrl0kL6wjIhAT2d4YVyEYRIXZC1hLpS1H\n\tJaayLrp6fQ44SVZDd6xA0Ava73nBHnLDmms99+BEuOqgkm3/1h7z+gmKKj0oDf6I8jFx+tgxKJh\n\tlMXnCqcYO7LzLWqS5krrVhD7Q0DkmcU+PbeIu4GrcQV6ODggA/FSuCUJL71oRUjoIe39qe", "X-TMASE-XGENCLOUD": "63fc4136-7300-4884-b1b5-fe214e3d4904-0-0-200-0", "X-TM-Deliver-Signature": "E20E4B2E1F2FAFE8063F4F07ED9B9661", "X-TM-Addin-Auth": "VzlyViWVjvreRq2jAlTwoTktHB4Ho5ISkitaE0gRjobWlTcvBcoo7FvhCQp\n\tmVsk50NE5mQ3+HxUDNOTk1pKfopxjKVGMM8D1RuxoUxYePHY36dB9ztQeqLNiloSE98p0Jh/Zjo\n\tNsvI/waMsFTPSNlthdAoupefPv9Z0v1/f4/+7IC3czAvDnUzDk8vPzUEGEIY10AW4/oDkKqVf0q\n\tEnN7tjUBZCjkxf5cnPsdrf8N4Qik+JG0UbyLBf3PmM/46VNuHBF5baIN+XoxOi/TjbkeKu3meYT\n\tlEqCQJ7eOOKwrGAHzXYwHgWy5owzp5lE6Kia.t7kmS6ReXbQ3us1rnwxn9AffsQCChUxohIKm43\n\tLwVrB6EYZlfqhGKuYkACBR3mEnKGyaHZo8FqjacPojkifyNZsw+DjRRqpW0xZuvEMdM/nCWOf97\n\talY759K5Z31JrC2hYG4HoHvUMirIEDdknuLzM9qhmnF1jJBiXO0fqn8dOKQZDxjR4wMnxr6bvYr\n\tFS1G3ThoVVM/AujSKXh+D7lj9T+FMrfSfnaU0gnWq9Wk0KBI0MZDbPexv6Z7vCKczITuBMguhxh\n\tf3lhmWmIii5opOSx87+IcwiLausIhaJmbuSQwAYumRf7QI8t84T1bR3XQt4IH/1dBhx2Fu5UVnw\n\tDqBQ==", "X-TM-Addin-ProductCode": "EMS", "X-Mailman-Approved-At": "Thu, 29 Jun 2023 17:08:04 +0200", "Subject": "[libcamera-devel] [RFC PATCH v8 0/1] Virtio video device\n\tspecification", "X-BeenThere": "libcamera-devel@lists.libcamera.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "<libcamera-devel.lists.libcamera.org>", "List-Unsubscribe": "<https://lists.libcamera.org/options/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=unsubscribe>", "List-Archive": "<https://lists.libcamera.org/pipermail/libcamera-devel/>", "List-Post": "<mailto:libcamera-devel@lists.libcamera.org>", "List-Help": "<mailto:libcamera-devel-request@lists.libcamera.org?subject=help>", "List-Subscribe": "<https://lists.libcamera.org/listinfo/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=subscribe>", "From": "Alexander Gordeev via libcamera-devel\n\t<libcamera-devel@lists.libcamera.org>", "Reply-To": "Alexander Gordeev <Alexander.Gordeev@opensynergy.com>", "Cc": "Albert Esteve <aesteve@redhat.com>, hmazur@google.com,\n\t\"Michael S . Tsirkin\" <mst@redhat.com>,\n\tDaniel Almeida <daniel.almeida@collabora.com>,\n\tMarcin Wojtas <mwojtas@google.com>, libcamera-devel@lists.libcamera.org, \n\tbgrzesik@google.com, Andrew Gazizov <andrew.gazizov@opensynergy.com>, \n\tEnric Balletbo i Serra <eballetb@redhat.com>,\n\tGustavo Padovan <gustavo.padovan@collabora.com>,\n\tKeiichi Watanabe <keiichiw@chromium.org>, zyta@google.com,\n\tlinux-media@vger.kernel.org,\n\tAlexander Gordeev <Alexander.Gordeev@opensynergy.com>,\n\talex.bennee@linaro.org, \n\tmikrawczyk@google.com, Matti.Moell@opensynergy.com,\n\tAlexandre Courbot <acourbot@chromium.org>,\n\tCornelia Huck <cohuck@redhat.com>, bag@semihalf.com, srosek@google.com,\n\tEnrico Granata <egranata@google.com>", "Errors-To": "libcamera-devel-bounces@lists.libcamera.org", "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>" }, "content": "Hi,\n\nThis is the 8th version of virtio-video device patch. Feedback would be very\nappreciated.\n\nThe main change coming with this draft is the introduction of background\noperations and delayed responses to commands (the term is taken from the SCMI\nspec) over eventq. Now most of the commands work like this. The only\nexceptions are STREAM_CREATE and RESOURCE_ATTACH_BACKING commands. This should\nhelp avoid commandq descriptors exhaustion. Also I introduced \"in band\" and\n\"out of band\" handling of SET_PARAMS command. Out of band is the way how it\nwas done before i.e. the command is handled immediately after dequeuing from\ncommandq. In band means putting it into device's INPUT queue so that it can\nbe executed precisely after a certain input resource and before the next one.\nThese two changes allowed me to represent the events as a custom case of the\ndelayed responses. Also this enables processing resolution changes embedded in\nthe stream and coming from outside in the same way. I think this makes it\npossible to implement V4L2 Requests API.\n\nQuestions for discussion/roadmap:\n1. It looks like the current way of describing the device capabilities is not\nvery well extendable. I'd like to change it again. The goal is that after\nadding new generic parameters/new codecs/new codec parameters and covering\nthem with the feature flags the format of the device response doesn't depend\nthat much on the enabled flags. My current idea is to convert this into a\nserie of descriptors with offsets and sizes, so that the device can then\nsimply adjust offsets and sizes, but keep that layout the same. Any ideas here\nwould be appreciated.\n2. Since draft v7 the device is expected to provide all and every one of its\ncapabilities as a response to the DEVICE_QUERY_CAPS command. Maybe the device\nshouldn't adjust the parameters itself now?\n3. I think the last piece, that is missing completely, is QoS. How can the\ndevice indicate to the driver, that it is saturated? How could the device be\nshared between multiple guests in a fair way?\n\nFull PDF: https://drive.google.com/file/d/1uPg4kxThlNPBSiC4b5veyFz4OFGytU7v/view?usp=sharing\nPDF with the video section only: https://drive.google.com/file/d/1iW3MbseRZLovlxpc4XAF8VTvhQ_Tww6q/view?usp=sharing\n\nChangelog v7 -> v8:\n* Added the delayed responses to commands sent on the eventq.\n* Added the in band STREAM_SET_PARAMS command handling.\n* Implemented device events using the newly added delayed responses.\n\nAlexander Gordeev (1):\n virtio-video: Add virtio video device specification\n\n conformance.tex | 4 +\n content.tex | 1 +\n device-types/video/description.tex | 2040 +++++++++++++++++++++\n device-types/video/device-conformance.tex | 22 +\n device-types/video/driver-conformance.tex | 16 +\n introduction.tex | 21 +\n 6 files changed, 2104 insertions(+)\n create mode 100644 device-types/video/description.tex\n create mode 100644 device-types/video/device-conformance.tex\n create mode 100644 device-types/video/driver-conformance.tex" }