Received: by 2002:ac0:a5b6:0:0:0:0:0 with SMTP id m51-v6csp728788imm; Tue, 5 Jun 2018 03:36:13 -0700 (PDT) X-Google-Smtp-Source: ADUXVKKjP44qv6GACCqz+bzD3/GhRQrS5+Y2L4MUUDLiR19YSxiHeu781TAROAOGVOGVGl36XMVq X-Received: by 2002:a63:8048:: with SMTP id j69-v6mr20720844pgd.429.1528194973438; Tue, 05 Jun 2018 03:36:13 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1528194973; cv=none; d=google.com; s=arc-20160816; b=kyrOmAFKZ4zDYFH9n+w1eQLT2G9mcfVD4vAlE/VABncBh0kY0Q22vxNkiLhANPNQ30 LbR6etgC+Dfq5wczG6ZCxJ8jE6NfD4Zfo8oZXsFdcWgC/KEtSMS1TvwwUHN2lKOjWNwK iwzg+Ti7cIU1e+w0xTFOO8DKPzHe2mlgNgbTVPfaB9lsUSub43WEzY11qv3aohrSznFF LvHKMVDjK8i22LnymuDIcTq3mcwik4FT4U/0eKMm5oH/6Ilg+inbeTRMDyeQQxQfdZP9 7GR9sNgyPSWmxm6JuvrGeSBvfGUsttOlLwkDZC0Lsm2x3XT9spvxtzGBIYlb1B5aMifr PLbw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature :arc-authentication-results; bh=FnzikeMhP5IqMuQR9zgnEWPIUHt++LOQb14cKwUThzw=; b=FWDo55uEh5mzGcYI1yMWRgcXcoOuk+kzLLj8sMI2zNzOZMkkDqgtNj3uaK+gHxvDPM NB27A7dEsvAnwRMs65Li4YQK9GjZV+xi6fhJamqn5ocGwvtVZLAWJ9D9iRnNWwUXRJAx AiIwiCmms6PKMDiXAXO33p4dmWwECysCudb3YhwSaI+D3JvFT6u8jayJwni6J6bWMoJs AwaS7rDeRXFuOdIIunWybmoceOngfDMwXAmXlX0lhUEXHQUHtpXHO2raX3f6rNbqHtKX 7FfoQYFCaLsHPVlIV4Qu7XqQBC0ohq0pe74F3AC96sLGRZxYbtddQ6OxJzx9NphSnWVe wVxQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@chromium.org header.s=google header.b=hPw12k4I; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=chromium.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id g19-v6si479724pfi.212.2018.06.05.03.35.59; Tue, 05 Jun 2018 03:36:13 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@chromium.org header.s=google header.b=hPw12k4I; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=chromium.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751723AbeFEKdj (ORCPT + 99 others); Tue, 5 Jun 2018 06:33:39 -0400 Received: from mail-pg0-f65.google.com ([74.125.83.65]:35440 "EHLO mail-pg0-f65.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751534AbeFEKdh (ORCPT ); Tue, 5 Jun 2018 06:33:37 -0400 Received: by mail-pg0-f65.google.com with SMTP id 15-v6so994218pge.2 for ; Tue, 05 Jun 2018 03:33:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=FnzikeMhP5IqMuQR9zgnEWPIUHt++LOQb14cKwUThzw=; b=hPw12k4I1MQqYjO4yEyFbSC0NNR+uopg/By2Fcm+0qSsY7MBRCqot82R68uB62h6z6 lP/fqyjrzNP2By1njvDi5keGrkt2RpXz9dZXiRF1HLzuTSOnnYyIU+S9kP1QwJnc9nPP xWzCZ4f+YRMWBh69+Td17X1jCWMjk4IYP4P14= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=FnzikeMhP5IqMuQR9zgnEWPIUHt++LOQb14cKwUThzw=; b=DpL1eWryCDMPLafc9B4z6TQu4lgtDZnNfdPfDfHxaO8ysvtEl6j/xRoDcAyuB/d2Zj okfDhPCCjMxo3EkBbUguBrubLLN8g7LSD5KS0Le2fL7mLmJxtwaiqs7D/x2MszUPUB4w au/p9Sf/l8Q1zjVWny6dXxgYffh0jXTwT4Q4PRIVx+NnEhtReaGx5Q2oiVVZgF8keAg0 +FcBUCq7RnOAvgAErZCwScmPhhYS9nw7mS1uDqGDD/VkSYTBxZmlqoxvaGTmrfW7vJFY Ov840Por5mQ2OHP0RiX6N6AVj8FbMvP4OY1Jw32Pw+glO6RKpyAVehyu8jUzs4I6+cdZ bZ/Q== X-Gm-Message-State: ALKqPwf76h1ziIbf0S+zErjXbz0LuGyiiGQsCRr4NG0f897TU3Z7zi8v usUzSepPkLRdPS17xu9IdJHDuA== X-Received: by 2002:a63:7341:: with SMTP id d1-v6mr19999339pgn.404.1528194816752; Tue, 05 Jun 2018 03:33:36 -0700 (PDT) Received: from tfiga.tok.corp.google.com ([2401:fa00:4:4:4631:2dd2:b960:1b41]) by smtp.gmail.com with ESMTPSA id u70-v6sm100996848pfk.121.2018.06.05.03.33.32 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 05 Jun 2018 03:33:35 -0700 (PDT) From: Tomasz Figa To: linux-media@vger.kernel.org Cc: linux-kernel@vger.kernel.org, Mauro Carvalho Chehab , Hans Verkuil , =?UTF-8?q?Pawe=C5=82=20O=C5=9Bciak?= , Alexandre Courbot , Kamil Debski , Andrzej Hajda , Kyungmin Park , Jeongtae Park , Philipp Zabel , Tiffany Lin , Andrew-CT Chen , Stanimir Varbanov , Todor Tomov , Nicolas Dufresne , Paul Kocialkowski , Laurent Pinchart , Tomasz Figa Subject: [RFC PATCH 0/2] Document the V4L2 (stateful) Codec API Date: Tue, 5 Jun 2018 19:33:26 +0900 Message-Id: <20180605103328.176255-1-tfiga@chromium.org> X-Mailer: git-send-email 2.17.1.1185.g55be947832-goog MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org This series attempts to add the documentation of what was discussed during Media Workshops at LinuxCon Europe 2012 in Barcelona and then later Embedded Linux Conference Europe 2014 in Düsseldorf and then eventually written down by Pawel Osciak and tweaked a bit by Chrome OS video team (but mostly in a cosmetic way or making the document more precise), during the several years of Chrome OS using the APIs in production. Note that most, if not all, of the API is already implemented in existing mainline drivers, such as s5p-mfc or mtk-vcodec. Intention of this series is just to formalize what we already have. It is an initial conversion from Google Docs to RST, so formatting is likely to need some further polishing. It is also the first time for me to create such long RST documention. I could not find any other instance of similar userspace sequence specifications among our Media documents, so I mostly followed what was there in the source. Feel free to suggest a better format. Much of credits should go to Pawel Osciak, for writing most of the original text. Tomasz Figa (2): media: docs-rst: Add decoder UAPI specification to Codec Interfaces media: docs-rst: Add encoder UAPI specification to Codec Interfaces Documentation/media/uapi/v4l/dev-codec.rst | 1084 ++++++++++++++++++++ Documentation/media/uapi/v4l/v4l2.rst | 14 +- 2 files changed, 1097 insertions(+), 1 deletion(-) -- 2.17.1.1185.g55be947832-goog