From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-15.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id CEC78C47E4D for ; Thu, 15 Jul 2021 09:25:09 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id BABA76115B for ; Thu, 15 Jul 2021 09:25:09 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S240884AbhGOJ2B (ORCPT ); Thu, 15 Jul 2021 05:28:01 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39446 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S240908AbhGOJ17 (ORCPT ); Thu, 15 Jul 2021 05:27:59 -0400 Received: from mail-pl1-x631.google.com (mail-pl1-x631.google.com [IPv6:2607:f8b0:4864:20::631]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C4C55C061762; Thu, 15 Jul 2021 02:25:06 -0700 (PDT) Received: by mail-pl1-x631.google.com with SMTP id e14so150863plh.8; Thu, 15 Jul 2021 02:25:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=nuloZLenal/UheIEhaBZVdFRbceClqyoioQrDZ98xwM=; b=YX6Dv7CoBYCPBMVzgSnETwLBtpDq3GHnrDQWprPjwKYVdT8DjPy/lxOP8RSBnB0XbH z9k6L3NBuo3qPRyMB6i2S9A5X/BKcNZnbbHyI+SPaTOAdZ+nN9/wQOsQGCVO23XIkCh4 Q+ZBIIaQSA2Xqbv5D8mXvVw3jDc4NoZbUNoD4TVY+PwV3pmmTB8DlovyBvUjHFam1bl+ 7W1OWL2LJLKAKeYbQpTjwZeuwHvCGZQWI2ntWFHF+VM+F5qL2LBy8DcNJeVfVC9XV/a2 ACFhTKYcM0usP9v4RynjvsbP+zDoqtESZMq5rBrtpWyEPnlvHeMdPPpzzoUQSeoHjRAQ CCdg== 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:in-reply-to :references; bh=nuloZLenal/UheIEhaBZVdFRbceClqyoioQrDZ98xwM=; b=ERd+R87Iy+XTvoN8umxQZ1MjVCiF3PZ/Su50jkFqSzlN7ok6aMBEqiORTJBme2QfI0 6pDsa+6uY05CYAQZ4Q/DRdmMJfv0m/7CfrdLwBO0H0TM4ghWGV8BDHEs7BemY+3EYhLc YswkMW8rbAeKGgIhyn0T9EEQItxofCd3vhj7E6ecfDe9Kbcp3KLZfRCA42BqBQTYD4yT iHVknyP7MfLjKklp7qjN+exbZbcK2p3SIaGxHQlOVBZs8Uc9OSoXjBrxWsi8KcXVwpW+ 6Am2ACvwUu5Avuxy/WSysue/djKWMmvAW7rejtrJ7n+jjsmO8C02+iGsXvl5QJ52cAGP zxkA== X-Gm-Message-State: AOAM533Ti3J9BbsqzS5nx7u5rA4w6oECrWXcvyPU6EDOE9AkZCAWHaCI I57wCrDSF44gBboYzpkl30U= X-Google-Smtp-Source: ABdhPJzlKUuZqqZ0SeRjLt0pUzE1LDwnOSdCyljcnofT5mqCIEhUZDeISmb/o2e79VB5I+2NfDmrrg== X-Received: by 2002:a17:902:6acb:b029:fc:4d8c:cfba with SMTP id i11-20020a1709026acbb02900fc4d8ccfbamr2633129plt.29.1626341106357; Thu, 15 Jul 2021 02:25:06 -0700 (PDT) Received: from fmin-OptiPlex-7060.nreal.work ([137.59.103.165]) by smtp.gmail.com with ESMTPSA id 11sm6662503pge.7.2021.07.15.02.25.02 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Thu, 15 Jul 2021 02:25:06 -0700 (PDT) From: dillon.minfei@gmail.com To: mchehab@kernel.org, mchehab+huawei@kernel.org, hverkuil-cisco@xs4all.nl, ezequiel@collabora.com, gnurou@gmail.com, pihsun@chromium.org, mcoquelin.stm32@gmail.com, alexandre.torgue@foss.st.com, mturquette@baylibre.com, sboyd@kernel.org, robh+dt@kernel.org Cc: patrice.chotard@foss.st.com, hugues.fruchet@foss.st.com, linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, linux-stm32@st-md-mailman.stormreply.com, linux-arm-kernel@lists.infradead.org, linux-clk@vger.kernel.org, devicetree@vger.kernel.org, Dillon Min Subject: [PATCH v2 7/9] media: docs: add doc for the stm32 dma2d driver Date: Thu, 15 Jul 2021 17:24:16 +0800 Message-Id: <1626341068-20253-8-git-send-email-dillon.minfei@gmail.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1626341068-20253-1-git-send-email-dillon.minfei@gmail.com> References: <1626341068-20253-1-git-send-email-dillon.minfei@gmail.com> Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Dillon Min add stm32-uapi.rst for stm32's dma2d driver, explain the details of ioctl V4L2_CID_DMA2D_R2M_MODE, V4L2_CID_DMA2D_R2M_COLOR. Signed-off-by: Dillon Min --- v2: introduce the stm32-uapi.rst to explain the detail of dma2d's ioctl. .../userspace-api/media/drivers/index.rst | 1 + .../userspace-api/media/drivers/stm32-uapi.rst | 22 ++++++++++++++++++++++ 2 files changed, 23 insertions(+) create mode 100644 Documentation/userspace-api/media/drivers/stm32-uapi.rst diff --git a/Documentation/userspace-api/media/drivers/index.rst b/Documentation/userspace-api/media/drivers/index.rst index 12e3c512d718..ce42915d48f4 100644 --- a/Documentation/userspace-api/media/drivers/index.rst +++ b/Documentation/userspace-api/media/drivers/index.rst @@ -38,4 +38,5 @@ For more details see the file COPYING in the source distribution of Linux. max2175 meye-uapi omap3isp-uapi + stm32-uapi uvcvideo diff --git a/Documentation/userspace-api/media/drivers/stm32-uapi.rst b/Documentation/userspace-api/media/drivers/stm32-uapi.rst new file mode 100644 index 000000000000..d7a4f717387d --- /dev/null +++ b/Documentation/userspace-api/media/drivers/stm32-uapi.rst @@ -0,0 +1,22 @@ +.. SPDX-License-Identifier: GPL-2.0 + +STM32 Chrom-Art 2D Graphics Accelerator unit (DMA2D) driver +================================================ + +The DMA2D driver implements the following driver-specific controls: + +``V4L2_CID_DMA2D_R2M_MODE`` +------------------------- + Enable/Disable the Register-To-Memory mode, filling a part or the + whole of a destination image with a specific color. + + 1 for enable, 0 for disable. + +``V4L2_CID_DMA2D_R2M_COLOR`` +------------------------------- + Set the color to fill a part or the whole of a destination image. + only used under Register-To-Memory mode, to set the DMA2D_OCOLR register + (RED, GREEN, BLUE) which is: + + 31 .. 24 23 .. 16 15 .. 8 7 .. 0 + ALPHA[7:0] RED[7:0] GREEN[7:0] BLUE[7:0] -- 2.7.4 From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.8 required=3.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED,DKIM_SIGNED,DKIM_VALID,FREEMAIL_FORGED_FROMDOMAIN, FREEMAIL_FROM,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id B078DC07E96 for ; Thu, 15 Jul 2021 09:34:17 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 71513613B5 for ; Thu, 15 Jul 2021 09:34:17 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 71513613B5 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=gmail.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:MIME-Version:List-Subscribe:List-Help: List-Post:List-Archive:List-Unsubscribe:List-Id:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=QERnn8zT6r+hNASYhBuiPyBKksGzQdRKv+MCszCIsAA=; b=auqg5fJ1IffxcF c3ZotfIiK/WYOM8zUkQR/EuZ+1FggxebvZ110E+XvSgik2/n3ooQSx/hyXQNg6WcyduhUNbdfF3iu AEZUX99ocTsA8cRqpDWjMqS9c50/sRI4WkOViCSFSxrt5V+Ba0lQz6/f8BVs83qRhYWplA3KKB4/9 XEXfaOTAAcghzvdO575uDzm+77wdgY1Ep7biljPATwkaJn5RtlLP8jGq9vmsFMkgxqhCcf/+hGxD1 xQb/cajxZCCHmuBR2waYQr0Ydijmol9MTbZhCRyLZYaMpYTd7P7ZMunMRC5szRjchIsB1v9K3qQyZ iklG7yhI95fYg6BGaabw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1m3xhp-000CGU-U7; Thu, 15 Jul 2021 09:30:58 +0000 Received: from mail-pl1-x632.google.com ([2607:f8b0:4864:20::632]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1m3xcB-0009vG-Ep for linux-arm-kernel@lists.infradead.org; Thu, 15 Jul 2021 09:25:10 +0000 Received: by mail-pl1-x632.google.com with SMTP id v14so2892648plg.9 for ; Thu, 15 Jul 2021 02:25:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=nuloZLenal/UheIEhaBZVdFRbceClqyoioQrDZ98xwM=; b=YX6Dv7CoBYCPBMVzgSnETwLBtpDq3GHnrDQWprPjwKYVdT8DjPy/lxOP8RSBnB0XbH z9k6L3NBuo3qPRyMB6i2S9A5X/BKcNZnbbHyI+SPaTOAdZ+nN9/wQOsQGCVO23XIkCh4 Q+ZBIIaQSA2Xqbv5D8mXvVw3jDc4NoZbUNoD4TVY+PwV3pmmTB8DlovyBvUjHFam1bl+ 7W1OWL2LJLKAKeYbQpTjwZeuwHvCGZQWI2ntWFHF+VM+F5qL2LBy8DcNJeVfVC9XV/a2 ACFhTKYcM0usP9v4RynjvsbP+zDoqtESZMq5rBrtpWyEPnlvHeMdPPpzzoUQSeoHjRAQ CCdg== 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:in-reply-to :references; bh=nuloZLenal/UheIEhaBZVdFRbceClqyoioQrDZ98xwM=; b=gmh1a9ph1DFVZIxFjNQVoteVv/eQpL4fIGroVioc+amyb9o8odDPP+iMhmPJHkXTWq g2OEe6+7hyvUay9vTObYkd1yvk296Lg64qvu2mlerxjHkZzNk45IKnI6vhR2pl9Tgrga TPaTAmWAx6CaGjw8yDFYA64Cor91ERJg0BCDJChrC6vPkyH4UzTWHCvKTUe3ciR78Is3 +5182gM5/YxCvXNBbJ4ZvpeZZlYOPyYE3Sx9LmfZSpbdnj9G73HSZdJ95difagabR9VJ vS+dZG/N2jv02SZN2gO4fyXZZiT4WZzPVMw4mRy5ClzyeA5/x66+8CcC8bel83JjNH96 R4/A== X-Gm-Message-State: AOAM530r6+eQPjusQhcIdM+Cndoh/QQ0V8N4OX4BOa/YHcGtCOf2/XU7 FDRmxyrHSXu4LboX04q8JWA= X-Google-Smtp-Source: ABdhPJzlKUuZqqZ0SeRjLt0pUzE1LDwnOSdCyljcnofT5mqCIEhUZDeISmb/o2e79VB5I+2NfDmrrg== X-Received: by 2002:a17:902:6acb:b029:fc:4d8c:cfba with SMTP id i11-20020a1709026acbb02900fc4d8ccfbamr2633129plt.29.1626341106357; Thu, 15 Jul 2021 02:25:06 -0700 (PDT) Received: from fmin-OptiPlex-7060.nreal.work ([137.59.103.165]) by smtp.gmail.com with ESMTPSA id 11sm6662503pge.7.2021.07.15.02.25.02 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Thu, 15 Jul 2021 02:25:06 -0700 (PDT) From: dillon.minfei@gmail.com To: mchehab@kernel.org, mchehab+huawei@kernel.org, hverkuil-cisco@xs4all.nl, ezequiel@collabora.com, gnurou@gmail.com, pihsun@chromium.org, mcoquelin.stm32@gmail.com, alexandre.torgue@foss.st.com, mturquette@baylibre.com, sboyd@kernel.org, robh+dt@kernel.org Cc: patrice.chotard@foss.st.com, hugues.fruchet@foss.st.com, linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, linux-stm32@st-md-mailman.stormreply.com, linux-arm-kernel@lists.infradead.org, linux-clk@vger.kernel.org, devicetree@vger.kernel.org, Dillon Min Subject: [PATCH v2 7/9] media: docs: add doc for the stm32 dma2d driver Date: Thu, 15 Jul 2021 17:24:16 +0800 Message-Id: <1626341068-20253-8-git-send-email-dillon.minfei@gmail.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1626341068-20253-1-git-send-email-dillon.minfei@gmail.com> References: <1626341068-20253-1-git-send-email-dillon.minfei@gmail.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210715_022507_580895_F95E1F73 X-CRM114-Status: GOOD ( 17.23 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org From: Dillon Min add stm32-uapi.rst for stm32's dma2d driver, explain the details of ioctl V4L2_CID_DMA2D_R2M_MODE, V4L2_CID_DMA2D_R2M_COLOR. Signed-off-by: Dillon Min --- v2: introduce the stm32-uapi.rst to explain the detail of dma2d's ioctl. .../userspace-api/media/drivers/index.rst | 1 + .../userspace-api/media/drivers/stm32-uapi.rst | 22 ++++++++++++++++++++++ 2 files changed, 23 insertions(+) create mode 100644 Documentation/userspace-api/media/drivers/stm32-uapi.rst diff --git a/Documentation/userspace-api/media/drivers/index.rst b/Documentation/userspace-api/media/drivers/index.rst index 12e3c512d718..ce42915d48f4 100644 --- a/Documentation/userspace-api/media/drivers/index.rst +++ b/Documentation/userspace-api/media/drivers/index.rst @@ -38,4 +38,5 @@ For more details see the file COPYING in the source distribution of Linux. max2175 meye-uapi omap3isp-uapi + stm32-uapi uvcvideo diff --git a/Documentation/userspace-api/media/drivers/stm32-uapi.rst b/Documentation/userspace-api/media/drivers/stm32-uapi.rst new file mode 100644 index 000000000000..d7a4f717387d --- /dev/null +++ b/Documentation/userspace-api/media/drivers/stm32-uapi.rst @@ -0,0 +1,22 @@ +.. SPDX-License-Identifier: GPL-2.0 + +STM32 Chrom-Art 2D Graphics Accelerator unit (DMA2D) driver +================================================ + +The DMA2D driver implements the following driver-specific controls: + +``V4L2_CID_DMA2D_R2M_MODE`` +------------------------- + Enable/Disable the Register-To-Memory mode, filling a part or the + whole of a destination image with a specific color. + + 1 for enable, 0 for disable. + +``V4L2_CID_DMA2D_R2M_COLOR`` +------------------------------- + Set the color to fill a part or the whole of a destination image. + only used under Register-To-Memory mode, to set the DMA2D_OCOLR register + (RED, GREEN, BLUE) which is: + + 31 .. 24 23 .. 16 15 .. 8 7 .. 0 + ALPHA[7:0] RED[7:0] GREEN[7:0] BLUE[7:0] -- 2.7.4 _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel