From patchwork Wed Nov 16 10:21:49 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Neil Armstrong X-Patchwork-Id: 20885 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp64522wru; Wed, 16 Nov 2022 02:29:59 -0800 (PST) X-Google-Smtp-Source: AA0mqf6KtP+szlsY7ipsgdeNlKlcYemns/hYA14NHy7b6MKWCNrps9tXBDW5SIFoZQJGr6JbC2f5 X-Received: by 2002:a17:906:3fd4:b0:7ad:95cf:726e with SMTP id k20-20020a1709063fd400b007ad95cf726emr17333450ejj.60.1668594599550; Wed, 16 Nov 2022 02:29:59 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1668594599; cv=none; d=google.com; s=arc-20160816; b=VT9LGUJpHxSI5sq2QlqHl9DjGSpujoI0lpvMw+Rb/FEHRqoRAuIuZ5WpavVBJsrJt4 GD7E8BSF7dcNNjlJtebFMW6wY/4EPbuK1oZez1R4WpVsq291LfqD9lA6x60FmhSvWXfc Xmbrg1hNigzo5Bsp8wkhnRZLHjk32Nk0+FHL6IgMk1sYz0dDB7L3fo8Mfcq5lqQ/OXeU h9S/RrJcOUKByroYYnC76qY17OtCEu1AHJWNVGF7iJ2wQP1Fln9sNZ2vrDkA71itV57p P4kKYFwO76ENlxRP9Bjo3b+MTA9UVjvJBqfDrzJaHMVju+6Mt3V2eUOrKukXooe1/QgG u0tg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:in-reply-to:references:message-id :content-transfer-encoding:mime-version:subject:date:from :dkim-signature; bh=ZzVAeZmGHVgJEk1mN8aP1HtyXLkmqX2nhQXPCT6cTuU=; b=S+Ian8Nr93JthmJlYBm51MDyvevb/rgxEkV6wv66LQF4KGejC0rKFmxfy00o2nojJK 0lkR5a1WVXKwVglcVubLAfYc3XVlDhxaRxm6CLANCgnx4KakwwovqGoHzUvv6i4+HbX2 FX5oDabHBQWzzlPG5JgH9LOnJy6t0nmcyNZPjnEqUWa/9KfljjsDr/WoHUnI689vi4La IOyBE41LeRxGzeLZ21nPThYXlUyKnNe1I6mxjz9J0SdGFMWC+XzQO1rqwHHNZTOgYW34 5demg4z5Y0rx+nfUHV4OJwrk5La88zUp19EvlOro0EsqYjz/Ox76bNybxJ0ucKRcpCl7 QNcQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=PY6DbNBt; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id ga23-20020a1709070c1700b0078e0e850902si13690858ejc.868.2022.11.16.02.29.34; Wed, 16 Nov 2022 02:29:59 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=PY6DbNBt; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S238841AbiKPKW4 (ORCPT + 99 others); Wed, 16 Nov 2022 05:22:56 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55992 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236891AbiKPKVx (ORCPT ); Wed, 16 Nov 2022 05:21:53 -0500 Received: from mail-wr1-x430.google.com (mail-wr1-x430.google.com [IPv6:2a00:1450:4864:20::430]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 44F19220F1 for ; Wed, 16 Nov 2022 02:21:52 -0800 (PST) Received: by mail-wr1-x430.google.com with SMTP id w14so29109575wru.8 for ; Wed, 16 Nov 2022 02:21:52 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=ZzVAeZmGHVgJEk1mN8aP1HtyXLkmqX2nhQXPCT6cTuU=; b=PY6DbNBtnIrOC0If+NnbwkXi4lEoiLW4JHS2tZW1xdp3TZKdRUhJKKypyDtK9OZ2Ql jNm1YMnQscrg9tVYX+9N0xwnHgYGCv4zKyCqPXcN27CjMF4OO8WM6DkQ8lHuEsfoUVkJ Nu25gyIND2qWn/dPbNj58E8FzyD6/FypBhWB9iboODRFstHEl74Px4ooIRHr1oAgrh8k NiEcB2PJFladkoi2+0swKCfuh4Zi6wO/iJkz6j56e61v/kv0Z2VtYMC51AJZLwj3gA0O kSo8ii5v3eAm0hClrCkB4qnL2XXFF4qjEDYyAXvjsMP82MsiFQ/Usr8igLM9pxjeJklC k+NQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=ZzVAeZmGHVgJEk1mN8aP1HtyXLkmqX2nhQXPCT6cTuU=; b=GgBOX8F0EfXgR7OskU9FdgEFb8eOOTo9Ik2AIbslYOYk4zYoZMwdza52Xh6Xx9iTbM CQcgMBl1DPYfZ1XhR5IBb6PvBKYqRlCFBjx+lURMtLvLRyk0es4ZTmZIU72Z0glFRef5 xBHE35eU0OJycz5WI0n4l4wAyUJucmfIz2OI9CYQFn3zNBr5wQYBCfpErdE/IgnH+Y/J RqR9wDMegKDNS+hXrPoH/mqxX6GALRH5fxwvbwveQoikDat5KTM0fDFfNLs6wbY66DV4 UuFt8oY17KE8s19RRG0FDq4o2O/Ntg7GadCrz9NdP/iBHS6LJKjgd47/fJrTszMLX7+7 U7dg== X-Gm-Message-State: ANoB5plWjbIae6ir4ViLm5IvIIT8+BhSApxjQPeljSxm5BdY3H2OZoyM hzF9nz5sQVLdmUHdBydfmKaRmI2vWEWBdg== X-Received: by 2002:adf:b19d:0:b0:236:6fb2:ff91 with SMTP id q29-20020adfb19d000000b002366fb2ff91mr12948000wra.520.1668594110852; Wed, 16 Nov 2022 02:21:50 -0800 (PST) Received: from arrakeen.starnux.net ([2a01:e0a:982:cbb0:52eb:f6ff:feb3:451a]) by smtp.gmail.com with ESMTPSA id o5-20020a05600c510500b003b4ff30e566sm6133615wms.3.2022.11.16.02.21.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 16 Nov 2022 02:21:50 -0800 (PST) From: Neil Armstrong Date: Wed, 16 Nov 2022 11:21:49 +0100 Subject: [PATCH 2/6] dt-bindings: i2c: qcom-geni: document I2C Master Hub serial I2C engine MIME-Version: 1.0 Message-Id: <20221114-narmstrong-sm8550-upstream-i2c-master-hub-v1-2-64449106a148@linaro.org> References: <20221114-narmstrong-sm8550-upstream-i2c-master-hub-v1-0-64449106a148@linaro.org> In-Reply-To: <20221114-narmstrong-sm8550-upstream-i2c-master-hub-v1-0-64449106a148@linaro.org> To: Rob Herring , Konrad Dybcio , Andy Gross , Krzysztof Kozlowski , Bjorn Andersson Cc: linux-i2c@vger.kernel.org, linux-arm-msm@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, Neil Armstrong X-Mailer: b4 0.10.1 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1749648250708394139?= X-GMAIL-MSGID: =?utf-8?q?1749648250708394139?= The I2C Master Hub is a stripped down version of the GENI Serial Engine QUP Wrapper Controller but only supporting I2C serial engines without DMA support. This documents the I2C Serial Engine variant used within the I2C Master Hub Wrapper. This serial engine variant lacks DMA support, and requires a core clock, and since DMA support is lacking, the memory interconnect path isn't needed. Signed-off-by: Neil Armstrong --- .../bindings/i2c/qcom,i2c-geni-qcom.yaml | 61 +++++++++++++++++----- 1 file changed, 49 insertions(+), 12 deletions(-) diff --git a/Documentation/devicetree/bindings/i2c/qcom,i2c-geni-qcom.yaml b/Documentation/devicetree/bindings/i2c/qcom,i2c-geni-qcom.yaml index 0e7ed00562e2..ea2c28e70cf5 100644 --- a/Documentation/devicetree/bindings/i2c/qcom,i2c-geni-qcom.yaml +++ b/Documentation/devicetree/bindings/i2c/qcom,i2c-geni-qcom.yaml @@ -15,13 +15,13 @@ allOf: properties: compatible: - const: qcom,geni-i2c + enum: + - qcom,geni-i2c + - qcom,geni-i2c-master-hub - clocks: - maxItems: 1 + clocks: true - clock-names: - const: se + clock-names: true clock-frequency: default: 100000 @@ -34,14 +34,9 @@ properties: - const: tx - const: rx - interconnects: - maxItems: 3 + interconnects: true - interconnect-names: - items: - - const: qup-core - - const: qup-config - - const: qup-memory + interconnect-names: true interrupts: maxItems: 1 @@ -71,6 +66,48 @@ required: - clock-names - reg +if: + properties: + compatible: + contains: + const: qcom,geni-i2c-master-hub +then: + properties: + clock-names: + items: + - const: se + - const: core + + clocks: + maxItems: 2 + + dmas: false + dma-names: false + + interconnects: + maxItems: 2 + + interconnect-names: + items: + - const: qup-core + - const: qup-config +else: + properties: + clocks: + maxItems: 1 + + clock-names: + const: se + + interconnects: + maxItems: 3 + + interconnect-names: + items: + - const: qup-core + - const: qup-config + - const: qup-memory + unevaluatedProperties: false examples: