From patchwork Fri Dec 30 13:50:30 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13084498 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org 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 smtp.lore.kernel.org (Postfix) with ESMTPS id 7ED14C4167B for ; Fri, 30 Dec 2022 18:43:41 +0000 (UTC) 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:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version: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=3lcNfwQVQJCxQopeGm+pE0ad/GRzrEVIXxh6Iw8nA1Q=; b=I5RlQpna5yAaGu VWqJFTNs7YIv5mjdxkTnWq1X4MagAzo1k+p35Oc9hp+0oz58/UZQuzMXzHmJrS0nmvjFkTBuLkgvM 7pNYnpIHgA1t/9QmesHxE99RJDUP3iz6Pay2VqG1rTatS8IZE5k3MxrSwwnOE/+7FFaZHEeHo3VoQ 1gU4q8vd3RB5ZzugHXgR7W8dXK0bSMLidi3VNfr6kfEp9f5Pcg5p9mRZ0K16k8yu1TJ9dBt9eBh1x NcEADDET0g6DENyynjexlexrUCJo8jYZXSs9/JXaLrG2nKlOEoO/a01o0o0mxlYVmTi9QwFUPnl12 S4tqhAl+pTClOVpnkbSw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1pBKKV-00CJ8B-Di; Fri, 30 Dec 2022 18:42:08 +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 1pBFmn-009g8W-TB for linux-arm-kernel@lists.infradead.org; Fri, 30 Dec 2022 13:51:08 +0000 Received: by mail-pl1-x632.google.com with SMTP id m4so21942177pls.4 for ; Fri, 30 Dec 2022 05:50:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=dB9r5V5aeX+alSFvpbQYK5BT2uyrb/7da7XO94Paajo=; b=WUSik7yBmMMh1VTE7/8Qwg2PPJyKs04E9WkVjrx3i6haMANv60RXsP+4V5bVX/epYE ia7TGFVmhPxkmQYCvu6Uq2ThC4aX1jCVrueRLQEL7CS+capdrm7X+JAh90f3lsSsPp2r BLDCYug6P1tfE6K3dHgXgHcjbpJaEv5usy9sRujZDoDa3CBnKwAKZYQf5zqD1+FYj0RM XIoKUXHHyzfEgrI6JVQkzpMkmoUml47ZnUwmVEDcTgjVPS6Hh+qtfzgWofeh/TNyuxWt yinGb6F7pxRGLj74Vs29UzNoAHtrcBKoqzBUglMIlbRunZB6W7qiyN0o8BO6KVN5ou7J NOVQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=dB9r5V5aeX+alSFvpbQYK5BT2uyrb/7da7XO94Paajo=; b=Pt788UKRHjT/Id/8w3ZzoqwK4VwYkdXyQzWssK+UrehP5ZipqjK8e8Heskly6e+ouy 39HCZT1ZWNQdQlF7J72fxOlaz4Adnatkop3X47dwPcF7vQ03J3TSQeUnB1NAr1GV1tce eZ58kK5sj0jRBKSyPH+ozWBm7u0z6zJcSBoNbPsvH491vVyGl2l0tB0udocKjP57cUR1 nUdTGAdb5Jh1d6YIxaCqP/eimXJs6He0YLfPj31UwE3A5mxHvG4rpz4suRglfZebEVyR bcGxTAkXc7zNtivXyv2URIkZrF6c+MvWcWvThe1XIztF7yq7478AW7eJ7VQtOrw9yw2P D8IA== X-Gm-Message-State: AFqh2kqpOTv6H1r1Lt5e/E8zaQM5vDl19Z++01TbIDLOWRkah8/WpDy7 p8ivnyghwDi6Nc/F4JcJXBY= X-Google-Smtp-Source: AMrXdXuL5qzcwQeSJj1OOSBSORrTV+WFAHk7IxKJk003dcSYs6+xcWYpB2Ykdqp/m+Z2buN35rzG1Q== X-Received: by 2002:a17:902:c7d2:b0:192:ab25:45b8 with SMTP id r18-20020a170902c7d200b00192ab2545b8mr2508458pla.58.1672408255483; Fri, 30 Dec 2022 05:50:55 -0800 (PST) Received: from debian.me (subs02-180-214-232-7.three.co.id. [180.214.232.7]) by smtp.gmail.com with ESMTPSA id n2-20020a170902e54200b001887e30b9ddsm14893593plf.257.2022.12.30.05.50.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 30 Dec 2022 05:50:54 -0800 (PST) Received: by debian.me (Postfix, from userid 1000) id 14B4E100AD6; Fri, 30 Dec 2022 20:50:50 +0700 (WIB) From: Bagas Sanjaya To: linux-arm-msm@vger.kernel.org, linux-kernel@vger.kernel.org, Linux Documentation , Linux ARM , Devicetree Cc: Souradeep Chowdhury , Alex Elder , Bjorn Andersson , Andy Gross , Konrad Dybcio , Krzysztof Kozlowski , Rob Herring , Sai Prakash Ranjan , Sibi Sankar , Rajendra Nayak , Vinod Koul , Bagas Sanjaya , kernel test robot Subject: [PATCH 1/2] soc: qcom: dcc: Fix examples list on /sys/kernel/debug/dcc/.../[list-number]/config documentation Date: Fri, 30 Dec 2022 20:50:30 +0700 Message-Id: <20221230135030.17002-2-bagasdotme@gmail.com> X-Mailer: git-send-email 2.39.0 In-Reply-To: <20221230135030.17002-1-bagasdotme@gmail.com> References: <20221230135030.17002-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=4153; i=bagasdotme@gmail.com; h=from:subject; bh=izZVMy8lCwMk1GHgkPp8APZotOXlfQy4ZKvqzrJFgNg=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDMnr3iybfMt95utwgaCjix7ZOdtdfuM07bXUyibtHqb9U4Qu yZwu6yhlYRDjYpAVU2SZlMjXdHqXkciF9rWOMHNYmUCGMHBxCsBE4o4xMvya3y1pXrS8ezbzYvMsn2 +SxxwM7nOtXGpbaHx36o9Uu5eMDDc1FHbI/L/3Jli/O939w5PlU9pqjkjsNmWbKzsvfc2OTG4A X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20221230_055102_094251_8A1EB1ED X-CRM114-Status: GOOD ( 14.63 ) 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: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org kernel test robot reported htmldocs warnings: Documentation/ABI/testing/debugfs-driver-dcc:34: WARNING: Unexpected indentation. Documentation/ABI/testing/debugfs-driver-dcc:34: WARNING: Block quote ends without a blank line; unexpected unindent. Fix these by fixing numbered list syntax on description of /sys/kernel/debug/dcc/.../[list-number]/config, including adding blank line separators as appropriate. Link: https://lore.kernel.org/linux-doc/202212300426.eMLsZsvA-lkp@intel.com/ Fixes: 4cbe60cf5ad622 ("soc: qcom: dcc: Add driver support for Data Capture and Compare unit(DCC)") Reported-by: kernel test robot Signed-off-by: Bagas Sanjaya Acked-by:Souradeep Chowdhury --- Documentation/ABI/testing/debugfs-driver-dcc | 63 +++++++++++++------- 1 file changed, 41 insertions(+), 22 deletions(-) diff --git a/Documentation/ABI/testing/debugfs-driver-dcc b/Documentation/ABI/testing/debugfs-driver-dcc index a4680950205931..a00f4502885b58 100644 --- a/Documentation/ABI/testing/debugfs-driver-dcc +++ b/Documentation/ABI/testing/debugfs-driver-dcc @@ -44,35 +44,54 @@ Description: example user can jump to list x only after list y is configured and enabled. The format for entering all types of instructions are explained in examples as - follows. - Example: - i)Read Type Instruction + follows: + + i) Read Type Instruction + echo R <1> <2> <3> >/sys/kernel/debug/dcc/../[list-number]/config + 1->Address to be considered for reading the value. + 2->The word count of the addresses, read n words starting from address <1>. Each word is of 32 bits. If not entered 1 is considered. + 3->Can be 'apb' or 'ahb' which indicates if it is apb or ahb bus respectively. If not entered ahb is considered. - ii)Write Type Instruction - echo W <1> <2> <3> > /sys/kernel/debug/dcc/../[list-number]/config - 1->Address to be considered for writing the value. - 2->The value that needs to be written at the location. - 3->Can be a 'apb' or 'ahb' which indicates if it is apb or ahb - but respectively. - iii)Read Modify Write type instruction - echo RW <1> <2> <3> > /sys/kernel/debug/dcc/../[list-number]/config - 1->The address which needs to be considered for read then write. - 2->The value that needs to be written on the address. - 3->The mask of the value to be written. - iv)Loop Type Instruction - echo L <1> <2> <3> > /sys/kernel/debug/dcc/../[list-number]/config - 1->The loop count, the number of times the value of the addresses will be - captured. - 2->The address count, total number of addresses to be entered in this - instruction. - 3->The series of addresses to be entered separated by a space like - ... and so on. + + ii) Write Type Instruction + + echo W <1> <2> <3> > /sys/kernel/debug/dcc/../[list-number]/config + + 1->Address to be considered for writing the value. + + 2->The value that needs to be written at the location. + + 3->Can be a 'apb' or 'ahb' which indicates if it is apb or ahb + but respectively. + + iii) Read Modify Write type instruction + + echo RW <1> <2> <3> > /sys/kernel/debug/dcc/../[list-number]/config + + 1->The address which needs to be considered for read then write. + + 2->The value that needs to be written on the address. + + 3->The mask of the value to be written. + + iv) Loop Type Instruction + + echo L <1> <2> <3> > /sys/kernel/debug/dcc/../[list-number]/config + + 1->The loop count, the number of times the value of the addresses will be + captured. + + 2->The address count, total number of addresses to be entered in this + instruction. + + 3->The series of addresses to be entered separated by a space like + ... and so on. What: /sys/kernel/debug/dcc/.../[list-number]/enable Date: December 2022