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 From patchwork Fri Dec 30 13:50:31 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13084499 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 863DCC4167B for ; Fri, 30 Dec 2022 18:43:44 +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=TluUXAJCkfLmUZvNrXroB9fQc6qrHLHlgot13Oe87mY=; b=fhpkyV8Lbsj1zk dp/eSbOtaKM1xWQo5a22KMvr1uClWgr+JMiFvjaR7hy1BXNLG5aIhby21mb6WDf9aeP5HwQhas7G4 a/dZHRC31UQuSNK9ETdXcdZ90mRo33Es9PL3y6TCAp3P3/tdA6sVdlzLgpyH5KMhttjPkb2d/pwYW Iw9KJXD3XM4APJw3Js68McrcolihSsAD3rLhjGlo1Et/+QH/azzR/am/uvh70UMObZEhw3TWY2N/H cm6RdFHeG/iQdw8lj+2uEOKAbdOOM8GqWedF4McLy98Hibe++A5MTftOc5V+3SWYabTJ4xFRk+Dnc QoYz9O3G0uC2l48KjXFw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1pBKK3-00CIxA-5t; Fri, 30 Dec 2022 18:41:39 +0000 Received: from mail-pl1-x633.google.com ([2607:f8b0:4864:20::633]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1pBFmo-009g8t-NL for linux-arm-kernel@lists.infradead.org; Fri, 30 Dec 2022 13:51:09 +0000 Received: by mail-pl1-x633.google.com with SMTP id n4so21954858plp.1 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=7AfeuljETMDUgPPbrwTbLySPR/cbksFJWNX7W4kX5JM=; b=J597vT6vhaSDd4vCZaraJ8cvBmp8WX0JSQgHi7aSRcZ57ijFVHicButvWKPDFn/Qr6 7ZOvc7PA0C/ZBo1y8Qz42EjEol2RLF1QjSAlfLrpMZ7tdfpmLFWB7cERhzM2m26WtK8R 3RbzTyS0/xGpXnYtnFMlbLYR8E1cPxUPjk+kzw3iUyycS14UR40X4j4iSRMFi/Jsv5e7 l6fSZTepHRfvPaOfUuqkiQEgEMxNwj/w4ZbKYNQp5K41e/1mP66a8Icx68leErLuGUfy RgcgGlEJ/y5eEn/LCcW4vS+imrXoZIIvKmZ685jGdarD4/+GADJzH/Ca+/buIJkVSFJe My4w== 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=7AfeuljETMDUgPPbrwTbLySPR/cbksFJWNX7W4kX5JM=; b=otisvowlu1gWeO6ksyh862qxV4MVF0VcWD6zBXuqV8ysmdMmfEoGcd+rh8OpyS7H/V W4xxX1/kyQu/rXu64VT67YB31ehr6KBwzNod+bfWXb13VQqfs8IYX6JaGvoO5s3oGfWQ iyIwZs05K64jTxRxHnIRQLAS1dCf10+C40xMWSbTsCrVU9wsNFhTsTSIQ4Xhm+wd/PPn Pltulip0Io8yn1MHYHmJ2f17H+9wT//q+AAK7UCA+yFVsId1Ypp7s56AahbagT2xQ6Hv vlt4mRXdtoMX9sEjEQDuWmRr8mgrqCPZ7+aFcWhn6sDzHQANXkxa7K6carFlaJ08X53R pV/Q== X-Gm-Message-State: AFqh2kruEzFeUs9OP8EMnkyOFvSsuCS+FhVGQcEJIJQtUNbsIuHxFBwJ UhF/I+leQRSajsSJgmTlzOs= X-Google-Smtp-Source: AMrXdXv4Xqrw76sAxYeGOKudDkN2Ffdd26WUsHygJXEsgs5JzPnno/o2FroyslYnYkaPyoBeYLZ+2g== X-Received: by 2002:a05:6a20:6a91:b0:ad:5a4d:95b5 with SMTP id bi17-20020a056a206a9100b000ad5a4d95b5mr51509674pzb.40.1672408256244; Fri, 30 Dec 2022 05:50:56 -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 y136-20020a62ce8e000000b005672daedc8fsm13621058pfg.81.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 2D812103FEE; 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 Subject: [PATCH 2/2] soc: qcom: dcc: rewrite description of dcc sysfs files Date: Fri, 30 Dec 2022 20:50:31 +0700 Message-Id: <20221230135030.17002-3-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=7900; i=bagasdotme@gmail.com; h=from:subject; bh=+poq8oGC+A48bxzOI4iT9QbeLRZ90WOVvj28TIMcLIg=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDMnr3iy7/VTmfcHWJ1veOQfMP7ak0fu2KmPt3I9fzIx5suMd Y9P8O0pZGMS4GGTFFFkmJfI1nd5lJHKhfa0jzBxWJpAhDFycAjARl0pGhkVts+wVmeV4Ht9oi1/dIt LY1jhlj53Vcd5J0vw3tTaX7mP477jj+R69A/eUw9L7D29kYqib3nD6tOd83f3nH7O8mD7RhgEA 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_858650_687EB6EC X-CRM114-Status: GOOD ( 28.71 ) 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 The description of dcc sysfs files is somewhat confusing and not effective. Rewrite it to be clear. While at it, also use literal code block for config sysfs examples and remove redundant examples that are obvious. Signed-off-by: Bagas Sanjaya Acked-by:Souradeep Chowdhury --- Documentation/ABI/testing/debugfs-driver-dcc | 142 ++++++++++--------- 1 file changed, 76 insertions(+), 66 deletions(-) diff --git a/Documentation/ABI/testing/debugfs-driver-dcc b/Documentation/ABI/testing/debugfs-driver-dcc index a00f4502885b58..27ed5919d21b9c 100644 --- a/Documentation/ABI/testing/debugfs-driver-dcc +++ b/Documentation/ABI/testing/debugfs-driver-dcc @@ -3,115 +3,125 @@ Date: December 2022 Contact: Souradeep Chowdhury Description: This file is used to check the status of the dcc - hardware if it's ready to take the inputs. A 'Y' - here indicates dcc is in a ready condition. - Example: - cat /sys/kernel/debug/dcc/.../ready + hardware if it's ready to receive user configurations. + A 'Y' here indicates dcc is ready. What: /sys/kernel/debug/dcc/.../trigger Date: December 2022 Contact: Souradeep Chowdhury Description: This is the debugfs interface for manual software - triggers. The user can simply enter a 1 against - the debugfs file and enable a manual trigger. - Example: - echo 1 > /sys/kernel/debug/dcc/.../trigger + triggers. The trigger can be invoked by writing '1' + to the file. What: /sys/kernel/debug/dcc/.../config_reset Date: December 2022 Contact: Souradeep Chowdhury Description: This file is used to reset the configuration of - a dcc driver to the default configuration. This - means that all the previous addresses stored in - the driver gets removed and user needs to enter - the address values from the start. - Example: - echo 1 > /sys/kernel/debug/dcc/../config_reset + a dcc driver to the default configuration. When '1' + is written to the file, all the previous addresses + stored in the driver gets removed and users need to + reconfigure addresses again. What: /sys/kernel/debug/dcc/.../[list-number]/config Date: December 2022 Contact: Souradeep Chowdhury Description: This stores the addresses of the registers which - should be read in case of a hardware crash or - manual software triggers. The addresses entered here - are considered under all the 4 types of dcc - instructions Read type, Write type, Read Modify Write - type and Loop type. The lists need to be configured - sequentially and not in a overlapping manner. As an - 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: + can be read in case of a hardware crash or manual + software triggers. The input addresses type + can be one of following dcc instructions: read, + write, read-write, and loop type. The lists need to + be configured sequentially and not in a overlapping + manner; e.g. users can jump to list x only after + list y is configured and enabled. The input format for + each type is as follows: - i) Read Type Instruction + i) Read instruction - echo R <1> <2> <3> >/sys/kernel/debug/dcc/../[list-number]/config + :: - 1->Address to be considered for reading the value. + echo R >/sys/kernel/debug/dcc/../[list-number]/config - 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. + where: - 3->Can be 'apb' or 'ahb' which indicates if it is apb or ahb - bus respectively. If not entered ahb is considered. + + The address to be read. - ii) Write Type Instruction + + The addresses word count, starting from address <1>. + Each word is 32 bits (4 bytes). If omitted, defaulted + to 1. - echo W <1> <2> <3> > /sys/kernel/debug/dcc/../[list-number]/config + + The bus type, which can be either 'apb' or 'ahb'. + The default is 'ahb' if leaved out. - 1->Address to be considered for writing the value. + ii) Write instruction - 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. + echo W > /sys/kernel/debug/dcc/../[list-number]/config - iii) Read Modify Write type instruction + where: - echo RW <1> <2> <3> > /sys/kernel/debug/dcc/../[list-number]/config + + The address to be written. - 1->The address which needs to be considered for read then write. + + The value to be written at . - 2->The value that needs to be written on the address. + + The bus type, which can be either 'apb' or 'ahb'. - 3->The mask of the value to be written. + iii) Read-write instruction - iv) Loop Type Instruction + :: - echo L <1> <2> <3> > /sys/kernel/debug/dcc/../[list-number]/config + echo RW > /sys/kernel/debug/dcc/../[list-number]/config - 1->The loop count, the number of times the value of the addresses will be - captured. + where: - 2->The address count, total number of addresses to be entered in this - instruction. + + The address to be read and written. - 3->The series of addresses to be entered separated by a space like - ... and so on. + + The value to be written at . + + + The value mask. + + iv) Loop instruction + + :: + + echo L
... > /sys/kernel/debug/dcc/../[list-number]/config + + where: + + + Number of iterations + +
+ total number of addresses to be written + +
+ Space-separated list of addresses. What: /sys/kernel/debug/dcc/.../[list-number]/enable Date: December 2022 Contact: Souradeep Chowdhury Description: This debugfs interface is used for enabling the - the dcc hardware. Enable file is kept under the - directory list number for which the user wants - to enable it. For example if the user wants to - enable list 1, then he should go for - echo 1 > /sys/kernel/debug/dcc/.../1/enable. - On enabling the dcc, all the addresses entered + the dcc hardware. A file named "enable" is in the + directory list number where users can enable/disable + the specific list by writing boolean (1 or 0) to the + file. + + On enabling the dcc, all the addresses specified by the user for the corresponding list is written into dcc sram which is read by the dcc hardware - on manual or crash induced triggers. Lists should - be enabled sequentially.For example after configuring - addresses for list 1 and enabling it, a user can - proceed to enable list 2 or vice versa. - Example: - echo 0 > /sys/kernel/debug/dcc/.../[list-number]/enable - (disable dcc for the corresponding list number) - echo 1 > /sys/kernel/debug/dcc/.../[list-number]/enable - (enable dcc for the corresponding list number) + on manual or crash induced triggers. Lists must + be configured and enabled sequentially, e.g. list + 2 can only be enabled when list 1 have so.