From patchwork Fri Jan 20 12:23:26 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Cristian Marussi X-Patchwork-Id: 13109710 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 49C65C25B4E for ; Fri, 20 Jan 2023 12:25:54 +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: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:In-Reply-To:References: List-Owner; bh=k7ORRWJn6nPSf55dyDyJ6tNq/LmRc8EvGV+hzEtTxNg=; b=INg0H2c5aGNwBF ggIYUOAZHk3r0Qkkt5f4CuSlBZSb397fzzSPC6+hPA4kVhcpZiQnOu+DAcLuJe7Xcdt8DES2x2YcX Yrryb6KTq34wrOZ5LgBXH5RwS6qPcyvqLDwzE/p0cNdROw1/40C7cpsjkNtHe4xuuhzai15DAzsSd xXLRCQw4IAVv7NNulSrtPsAB58pP7YRj2aqhww00Y3TmeP/NFpkVjA9EXBBUyDKUo/32VgK3yMW5+ poXw14N12jpmz1bkwjwKI2rXCwrFe//gYYF+kJgcvwbwYoE6wZvhDkgG+emXRFiwmS74yn/GyOKJa X5b2IEQL6yIrYlyppLEw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1pIqR4-00AEge-AB; Fri, 20 Jan 2023 12:23:58 +0000 Received: from foss.arm.com ([217.140.110.172]) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1pIqR1-00AEfv-75 for linux-arm-kernel@lists.infradead.org; Fri, 20 Jan 2023 12:23:56 +0000 Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 5277814BF; Fri, 20 Jan 2023 04:24:33 -0800 (PST) Received: from e120937-lin.. (unknown [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id E73EF3F71A; Fri, 20 Jan 2023 04:23:50 -0800 (PST) From: Cristian Marussi To: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org Cc: sudeep.holla@arm.com, Cristian Marussi , Vincent Guittot Subject: [PATCH] firmware: arm_scmi: Clarify Raw per-channel ABI documentation Date: Fri, 20 Jan 2023 12:23:26 +0000 Message-Id: <20230120122326.1932614-1-cristian.marussi@arm.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230120_042355_340710_A71A7D23 X-CRM114-Status: UNSURE ( 8.62 ) X-CRM114-Notice: Please train this message. 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 Explain more in detail how the per-channel identifier is chosen. Suggested-by: Vincent Guittot Signed-off-by: Cristian Marussi --- Documentation/ABI/testing/debugfs-scmi-raw | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/Documentation/ABI/testing/debugfs-scmi-raw b/Documentation/ABI/testing/debugfs-scmi-raw index 5468ec08c084..b1c505ed444c 100644 --- a/Documentation/ABI/testing/debugfs-scmi-raw +++ b/Documentation/ABI/testing/debugfs-scmi-raw @@ -80,9 +80,13 @@ Description: SCMI Raw synchronous message injection/snooping facility; write Each write to the entry causes one command request to be built and sent while the replies are read back one message at time (receiving an EOF at each message boundary). + Channel identifier matches the SCMI protocol number which + has been associated with this transport channel in the DT + description, with Base protocol number 0x10 being the default + channel for this instance. Note that these per-channel entries rooted at <..>/channels exist only if the transport is configured to have more than - one channel. + one default channel. Users: Debugging, any userspace test suite What: /sys/kernel/debug/scmi//raw/channels//message_async @@ -103,7 +107,11 @@ Description: SCMI Raw asynchronous message injection/snooping facility; write Each write to the entry causes one command request to be built and sent while the replies are read back one message at time (receiving an EOF at each message boundary). + Channel identifier matches the SCMI protocol number which + has been associated with this transport channel in the DT + description, with Base protocol number 0x10 being the default + channel for this instance. Note that these per-channel entries rooted at <..>/channels exist only if the transport is configured to have more than - one channel. + one default channel. Users: Debugging, any userspace test suite