From patchwork Sun Oct 29 19:41:43 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Wolfram Sang X-Patchwork-Id: 159405 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp1830490vqb; Sun, 29 Oct 2023 12:42:16 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEKWHaku3ZoRRkJCkZ5bmOiVXFZ83KiLyXO++epL0BMe9lHL6WvgnDqFJ7ZeAlosn99GxsZ X-Received: by 2002:a05:6e02:160c:b0:357:5e40:6bb5 with SMTP id t12-20020a056e02160c00b003575e406bb5mr11917198ilu.30.1698608536152; Sun, 29 Oct 2023 12:42:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698608536; cv=none; d=google.com; s=arc-20160816; b=aH4ujMkku2PfVYaovFFL5/8vXc8k0auyZs3wO85hsJGmRGk6eznP1WM6c6XBBP5e1B 8VKQzrFCiW2RvTV5ridMeTyhru+c3/15DFdXX9xdWySqe7DNa++3Peo7/iCZi4uUMsuE sm8OS9Cv7nUNXtKEIDNg2WLg2Y6Z17Ej6s8njX3wtAuyZdItvSd7gTYWh+C0ftS2QghM aNELYvcN7+LuONNHQLV1Xzb2HF+nCexbHFEAHYaV234DeYBn056aDUn6ErByemiS6Dyo qgtB1g3ETZgG8E6CjoYUWMs8J1TSIMBrK4ZABqTQ4ShSpby4v/S3PhFnCIIHReN41uua w2Mg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=LD5O2IAfdD+Yr54vXUyuQYqnYv5r+rMuDe76FqaDQBQ=; fh=OAXu+6B60s53cNl9dyQ0pFYr542Omdd5vE01wUx7zG4=; b=UCye7TyCpzZ5R2yRSCGgCRzSDmMHy8aSqx2ezDekr14Oj8QBti8uDI3ErYhlyzIVcN 2f5Cb58k/BjVXSs6eo0IpHlay0dRB5oz+RY96IA9cMDjF8dFzKxT9WY7e7pMzCIPmiAm GQOj2siUqm27JuJLiL6og+eXjzOfRgqJqp2YwKPxu30NGpqJzBhnsIu4dYLn0yLGT1Gg R7ci8aQoBsG2+76JHh/SlF0NTXKM19MpLPA9DIMM7FH28K9ky2Yr88DtbYE+KNKWPoms 2w3S2m5elIFZPlrg9kj4m+ihaYZb42jnfR+urrnOKXmLNLL8PmGzeJK7clGEGg6FMPbH 4nQg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@sang-engineering.com header.s=k1 header.b=g363FmIK; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:2 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from agentk.vger.email (agentk.vger.email. [2620:137:e000::3:2]) by mx.google.com with ESMTPS id q17-20020a639811000000b005b3bcd9d7f8si2135479pgd.808.2023.10.29.12.42.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 29 Oct 2023 12:42:16 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:2 as permitted sender) client-ip=2620:137:e000::3:2; Authentication-Results: mx.google.com; dkim=pass header.i=@sang-engineering.com header.s=k1 header.b=g363FmIK; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:2 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by agentk.vger.email (Postfix) with ESMTP id CCAF6805B9DA; Sun, 29 Oct 2023 12:42:13 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at agentk.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230239AbjJ2TmA (ORCPT + 30 others); Sun, 29 Oct 2023 15:42:00 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:54626 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229512AbjJ2Tl7 (ORCPT ); Sun, 29 Oct 2023 15:41:59 -0400 Received: from mail.zeus03.de (www.zeus03.de [194.117.254.33]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id F127EBC for ; Sun, 29 Oct 2023 12:41:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= sang-engineering.com; h=from:to:cc:subject:date:message-id :mime-version:content-transfer-encoding; s=k1; bh=LD5O2IAfdD+Yr5 4vXUyuQYqnYv5r+rMuDe76FqaDQBQ=; b=g363FmIK5lLbFCaHcaXanA/JeXa07r wevHqTpsBpmWJCz4jrrq0At2xH5KOyXrGDrbU+ftM4uwP4cMZbQ3HeTOWOq0Istd hXO6tLH+hT3uHYgNOJ1gGrY0Yc7XqvRVRlteKimOWBKsK0VcNf9OEbbcJ04TCvfC 7p2DytQ+canICv53uZku+ZUF9zgf1zUbtqmDUX8zw16uRTkeL7rbQ1BRivvfIUj6 3RlRjhIm4CyBMh9KyLXJfcugOUFJL28k0rVpsfKKVYdIeC79BgMrD+MkYsayvHc+ gwM2tNujwIZAVatD6PXEUDrEUDaFveinli9kd6j0F7uS2UbIyG4axljg== Received: (qmail 3891171 invoked from network); 29 Oct 2023 20:41:55 +0100 Received: by mail.zeus03.de with ESMTPSA (TLS_AES_256_GCM_SHA384 encrypted, authenticated); 29 Oct 2023 20:41:55 +0100 X-UD-Smtp-Session: l3s3148p1@mNwjHeAIyOxehhre From: Wolfram Sang To: linux-renesas-soc@vger.kernel.org Cc: Wolfram Sang , Wolfram Sang , linux-i2c@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH RESEND] Documentation: i2c: add fault code for not supporting 10 bit addresses Date: Sun, 29 Oct 2023 20:41:43 +0100 Message-Id: <20231029194143.22512-1-wsa+renesas@sang-engineering.com> X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on agentk.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (agentk.vger.email [0.0.0.0]); Sun, 29 Oct 2023 12:42:13 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1781120144779007385 X-GMAIL-MSGID: 1781120144779007385 Document the specific fault code when 10 bit addresses cannot be supported. It is used for years, only the documentation slipped through the cracks. Signed-off-by: Wolfram Sang --- The original RFC was from late 2014... Documentation/i2c/fault-codes.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Documentation/i2c/fault-codes.rst b/Documentation/i2c/fault-codes.rst index 80b14e718b52..b0864d1268bd 100644 --- a/Documentation/i2c/fault-codes.rst +++ b/Documentation/i2c/fault-codes.rst @@ -39,6 +39,10 @@ Also, codes returned by adapter probe methods follow rules which are specific to their host bus (such as PCI, or the platform bus). +EAFNOSUPPORT + Returned by I2C adapters not supporting 10 bit addresses when + they are requested to use such an address. + EAGAIN Returned by I2C adapters when they lose arbitration in master transmit mode: some other master was transmitting different