From mboxrd@z Thu Jan 1 00:00:00 1970 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 686D1C05027 for ; Fri, 3 Feb 2023 21:07:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:In-Reply-To: Content-Transfer-Encoding:Content-Type:MIME-Version:References:Message-ID: Subject:Cc:To:From:Date:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=1M3uCygjl6A7JEgAG4k6+cW+0sg8+m53vsWpI9AOYpU=; b=r9FcF5W+RPu6GwqW058IswoH9E d5AYzvAMLad0A/qi99NcEOQk413HxmEMz82CScjL7VwYHgpAcKQLR8TpMC0QloC9+vKWprRZLS8q2 iI42b0umJqNQnzHqlekgc1laZ0iY2Qdqe5RMKCRXQa61VaOu+UVLJ93BPWNeAthnNjC7T5IdTTZI7 CurFF2vAg7terG2OISEN4oP51CJy8PQYqqTU+7gw/la+T0MT4jh0CqUFWXvIQiCuOc1e+6ErPpkkX LlZuEwubywyR9+t34d5MflEC9RnQi27+lDs1spGC4cdo8vxfqXQvCGCVg+BZmoz/VGpJWSS8VJ/w6 xMSeJnvQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1pO3HA-003bTw-09; Fri, 03 Feb 2023 21:07:16 +0000 Received: from mail-oi1-f169.google.com ([209.85.167.169]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1pO3H3-003bQm-2A; Fri, 03 Feb 2023 21:07:10 +0000 Received: by mail-oi1-f169.google.com with SMTP id r205so5244603oib.9; Fri, 03 Feb 2023 13:06:56 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=1M3uCygjl6A7JEgAG4k6+cW+0sg8+m53vsWpI9AOYpU=; b=bK8kVSgp46hHtz9lE/IRAn37f9noCiZ6tRhJkf7RLKjqXtX6iZOFsgRcWmBafe9gNy /PqeSdPv7IyOLHRG1Jv/Sk6KFic9hZo7QQo1YGmzDFIOYFb/FmI/tvWczxXkCIV5FX/A EJRiT1yvzsQMJI7soFaRjN//dGi00xYD2D/cNWveK39Q8FaDBx6bXxvEa9afgDpmYWZd HOKohKJ+PjNJC8jHodW8+9fA4TsssYLzD5RsKkES7hfAvAksAd7gPZqvidfMJUY2FTpy vBWEPGr+C3zwVQHTGQumPR5EoiJ+iBICMGW+njCjTdv7ygykwfE3C9tsqdFLVbDWx8Ob 6Ovg== X-Gm-Message-State: AO0yUKVXQvHKuDuC7mRV4Emx5hymJwdgcJdTx6oSZQKHGKeaSA2/fXsd zrqEvgrHOU16Vt2aZl4Cqg== X-Google-Smtp-Source: AK7set+H/nG7YyvidvAYYh3VYdVW5g3Srm/T1GZeEAdyv/8iFdAFcD9Vzx0MLXCuqnk5RWAl3H/0OQ== X-Received: by 2002:a05:6808:1187:b0:35e:d286:2317 with SMTP id j7-20020a056808118700b0035ed2862317mr6590582oil.25.1675458415510; Fri, 03 Feb 2023 13:06:55 -0800 (PST) Received: from robh_at_kernel.org (66-90-144-107.dyn.grandenetworks.net. [66.90.144.107]) by smtp.gmail.com with ESMTPSA id m38-20020a05683032a600b0068d56f93d73sm1598677ott.26.2023.02.03.13.06.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 03 Feb 2023 13:06:55 -0800 (PST) Received: (nullmailer pid 893142 invoked by uid 1000); Fri, 03 Feb 2023 21:06:54 -0000 Date: Fri, 3 Feb 2023 15:06:54 -0600 From: Rob Herring To: =?utf-8?B?UmFmYcWCIE1pxYJlY2tp?= Cc: Srinivas Kandagatla , Krzysztof Kozlowski , Matthias Brugger , Kunihiko Hayashi , Masami Hiramatsu , linux-mediatek@lists.infradead.org, linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, =?utf-8?B?UmFmYcWCIE1pxYJlY2tp?= Subject: Re: [PATCH 1/4] dt-bindings: nvmem: mmio: new binding for MMIO accessible NVMEM devices Message-ID: <20230203210654.GA877968-robh@kernel.org> References: <20230201064717.18410-1-zajec5@gmail.com> <20230201064717.18410-2-zajec5@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20230201064717.18410-2-zajec5@gmail.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230203_130709_140265_C95202A3 X-CRM114-Status: GOOD ( 22.51 ) X-BeenThere: linux-mediatek@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-mediatek" Errors-To: linux-mediatek-bounces+linux-mediatek=archiver.kernel.org@lists.infradead.org On Wed, Feb 01, 2023 at 07:47:14AM +0100, Rafał Miłecki wrote: > From: Rafał Miłecki > > With the NVMEM layouts binding in place we should now use: > 1. NVMEM device access bindings > 2. NVMEM content description bindings > > This binding allows describing NVMEM devices that can be MMIO accessed. > > Signed-off-by: Rafał Miłecki > --- > .../devicetree/bindings/nvmem/mmio.yaml | 46 +++++++++++++++++++ > 1 file changed, 46 insertions(+) > create mode 100644 Documentation/devicetree/bindings/nvmem/mmio.yaml > > diff --git a/Documentation/devicetree/bindings/nvmem/mmio.yaml b/Documentation/devicetree/bindings/nvmem/mmio.yaml > new file mode 100644 > index 000000000000..27e3f6142769 > --- /dev/null > +++ b/Documentation/devicetree/bindings/nvmem/mmio.yaml > @@ -0,0 +1,46 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/nvmem/mmio.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: MMIO access based NVMEM > + > +description: | > + This binding describes simple NVMEM devices that can be accessed by using MMIO > + (memory-mapped I/O access). > + > + It's a generic solution for providing NVMEM content access. The way of > + handling actual content may be device specific and can be described using a > + proper layout. Please add some guidance based on the discussion about when this should and shouldn't be used. Specifically, anything with potential write accesses should use a device specific compatible and not the generic one. > + > +maintainers: > + - Rafał Miłecki > + > +allOf: > + - $ref: nvmem.yaml# > + > +properties: > + compatible: > + const: mmio-nvmem > + > + reg: > + maxItems: 1 > + > + reg-io-width: > + description: | > + The size (in bytes) of the IO accesses that should be performed > + on the device. > + enum: [1, 2, 4, 8] > + > +required: > + - reg > + > +unevaluatedProperties: false > + > +examples: > + - | > + nvmem@10000 { > + compatible = "mmio-nvmem"; > + reg = <0x10000000 0x10000>; > + }; > -- > 2.34.1 > From mboxrd@z Thu Jan 1 00:00:00 1970 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 491EFC05027 for ; Fri, 3 Feb 2023 21:08:16 +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:In-Reply-To:MIME-Version:References: Message-ID:Subject:Cc:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=uBXxtLKHS4fkxCxmbvR2dXOobVyKxaDOpiQlS2ZnlI8=; b=0hV0JFy/l0ch9B 52cj+fXj+aZ4pPTyj1xeGsmnQIZA6O1+IkzKaNeEI9Az0fFEMs+JzWBRDtmv8cLwF5WXnl4DbCk97 ZXVHypFsrtAFMBegdBuZkGguXLF6EVPDXxPkDyoIvhUXKTpI95Q+qKmfE2sZEnX85JSJUMGZUmsDe sO/jYcjGFlbCmnJ+UCOAXORrZ9zkPrMCvF/ujFhQL0WRaAJwIsO81XvpFM+RNMissvUnGUIC3zinE 1f0pQQ7uyPKmEWRZ3+Bno/569C9JmcfRLQFSSmrZsxmylHlOIeZtEqOWNidFokEi8L969E6WQ//Py BVYmThRqJl5cxrPv7CIg==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1pO3HB-003bU9-DL; Fri, 03 Feb 2023 21:07:18 +0000 Received: from mail-oi1-f169.google.com ([209.85.167.169]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1pO3H3-003bQm-2A; Fri, 03 Feb 2023 21:07:10 +0000 Received: by mail-oi1-f169.google.com with SMTP id r205so5244603oib.9; Fri, 03 Feb 2023 13:06:56 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=1M3uCygjl6A7JEgAG4k6+cW+0sg8+m53vsWpI9AOYpU=; b=bK8kVSgp46hHtz9lE/IRAn37f9noCiZ6tRhJkf7RLKjqXtX6iZOFsgRcWmBafe9gNy /PqeSdPv7IyOLHRG1Jv/Sk6KFic9hZo7QQo1YGmzDFIOYFb/FmI/tvWczxXkCIV5FX/A EJRiT1yvzsQMJI7soFaRjN//dGi00xYD2D/cNWveK39Q8FaDBx6bXxvEa9afgDpmYWZd HOKohKJ+PjNJC8jHodW8+9fA4TsssYLzD5RsKkES7hfAvAksAd7gPZqvidfMJUY2FTpy vBWEPGr+C3zwVQHTGQumPR5EoiJ+iBICMGW+njCjTdv7ygykwfE3C9tsqdFLVbDWx8Ob 6Ovg== X-Gm-Message-State: AO0yUKVXQvHKuDuC7mRV4Emx5hymJwdgcJdTx6oSZQKHGKeaSA2/fXsd zrqEvgrHOU16Vt2aZl4Cqg== X-Google-Smtp-Source: AK7set+H/nG7YyvidvAYYh3VYdVW5g3Srm/T1GZeEAdyv/8iFdAFcD9Vzx0MLXCuqnk5RWAl3H/0OQ== X-Received: by 2002:a05:6808:1187:b0:35e:d286:2317 with SMTP id j7-20020a056808118700b0035ed2862317mr6590582oil.25.1675458415510; Fri, 03 Feb 2023 13:06:55 -0800 (PST) Received: from robh_at_kernel.org (66-90-144-107.dyn.grandenetworks.net. [66.90.144.107]) by smtp.gmail.com with ESMTPSA id m38-20020a05683032a600b0068d56f93d73sm1598677ott.26.2023.02.03.13.06.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 03 Feb 2023 13:06:55 -0800 (PST) Received: (nullmailer pid 893142 invoked by uid 1000); Fri, 03 Feb 2023 21:06:54 -0000 Date: Fri, 3 Feb 2023 15:06:54 -0600 From: Rob Herring To: =?utf-8?B?UmFmYcWCIE1pxYJlY2tp?= Cc: Srinivas Kandagatla , Krzysztof Kozlowski , Matthias Brugger , Kunihiko Hayashi , Masami Hiramatsu , linux-mediatek@lists.infradead.org, linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, =?utf-8?B?UmFmYcWCIE1pxYJlY2tp?= Subject: Re: [PATCH 1/4] dt-bindings: nvmem: mmio: new binding for MMIO accessible NVMEM devices Message-ID: <20230203210654.GA877968-robh@kernel.org> References: <20230201064717.18410-1-zajec5@gmail.com> <20230201064717.18410-2-zajec5@gmail.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20230201064717.18410-2-zajec5@gmail.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230203_130709_140265_C95202A3 X-CRM114-Status: GOOD ( 22.51 ) 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: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org T24gV2VkLCBGZWIgMDEsIDIwMjMgYXQgMDc6NDc6MTRBTSArMDEwMCwgUmFmYcWCIE1pxYJlY2tp IHdyb3RlOgo+IEZyb206IFJhZmHFgiBNacWCZWNraSA8cmFmYWxAbWlsZWNraS5wbD4KPiAKPiBX aXRoIHRoZSBOVk1FTSBsYXlvdXRzIGJpbmRpbmcgaW4gcGxhY2Ugd2Ugc2hvdWxkIG5vdyB1c2U6 Cj4gMS4gTlZNRU0gZGV2aWNlIGFjY2VzcyBiaW5kaW5ncwo+IDIuIE5WTUVNIGNvbnRlbnQgZGVz Y3JpcHRpb24gYmluZGluZ3MKPiAKPiBUaGlzIGJpbmRpbmcgYWxsb3dzIGRlc2NyaWJpbmcgTlZN RU0gZGV2aWNlcyB0aGF0IGNhbiBiZSBNTUlPIGFjY2Vzc2VkLgo+IAo+IFNpZ25lZC1vZmYtYnk6 IFJhZmHFgiBNacWCZWNraSA8cmFmYWxAbWlsZWNraS5wbD4KPiAtLS0KPiAgLi4uL2RldmljZXRy ZWUvYmluZGluZ3MvbnZtZW0vbW1pby55YW1sICAgICAgIHwgNDYgKysrKysrKysrKysrKysrKysr Kwo+ICAxIGZpbGUgY2hhbmdlZCwgNDYgaW5zZXJ0aW9ucygrKQo+ICBjcmVhdGUgbW9kZSAxMDA2 NDQgRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL252bWVtL21taW8ueWFtbAo+IAo+ IGRpZmYgLS1naXQgYS9Eb2N1bWVudGF0aW9uL2RldmljZXRyZWUvYmluZGluZ3MvbnZtZW0vbW1p by55YW1sIGIvRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL252bWVtL21taW8ueWFt bAo+IG5ldyBmaWxlIG1vZGUgMTAwNjQ0Cj4gaW5kZXggMDAwMDAwMDAwMDAwLi4yN2UzZjYxNDI3 NjkKPiAtLS0gL2Rldi9udWxsCj4gKysrIGIvRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRp bmdzL252bWVtL21taW8ueWFtbAo+IEBAIC0wLDAgKzEsNDYgQEAKPiArIyBTUERYLUxpY2Vuc2Ut SWRlbnRpZmllcjogKEdQTC0yLjAtb25seSBPUiBCU0QtMi1DbGF1c2UpCj4gKyVZQU1MIDEuMgo+ ICstLS0KPiArJGlkOiBodHRwOi8vZGV2aWNldHJlZS5vcmcvc2NoZW1hcy9udm1lbS9tbWlvLnlh bWwjCj4gKyRzY2hlbWE6IGh0dHA6Ly9kZXZpY2V0cmVlLm9yZy9tZXRhLXNjaGVtYXMvY29yZS55 YW1sIwo+ICsKPiArdGl0bGU6IE1NSU8gYWNjZXNzIGJhc2VkIE5WTUVNCj4gKwo+ICtkZXNjcmlw dGlvbjogfAo+ICsgIFRoaXMgYmluZGluZyBkZXNjcmliZXMgc2ltcGxlIE5WTUVNIGRldmljZXMg dGhhdCBjYW4gYmUgYWNjZXNzZWQgYnkgdXNpbmcgTU1JTwo+ICsgIChtZW1vcnktbWFwcGVkIEkv TyBhY2Nlc3MpLgo+ICsKPiArICBJdCdzIGEgZ2VuZXJpYyBzb2x1dGlvbiBmb3IgcHJvdmlkaW5n IE5WTUVNIGNvbnRlbnQgYWNjZXNzLiBUaGUgd2F5IG9mCj4gKyAgaGFuZGxpbmcgYWN0dWFsIGNv bnRlbnQgbWF5IGJlIGRldmljZSBzcGVjaWZpYyBhbmQgY2FuIGJlIGRlc2NyaWJlZCB1c2luZyBh Cj4gKyAgcHJvcGVyIGxheW91dC4KClBsZWFzZSBhZGQgc29tZSBndWlkYW5jZSBiYXNlZCBvbiB0 aGUgZGlzY3Vzc2lvbiBhYm91dCB3aGVuIHRoaXMgc2hvdWxkIAphbmQgc2hvdWxkbid0IGJlIHVz ZWQuIFNwZWNpZmljYWxseSwgYW55dGhpbmcgd2l0aCBwb3RlbnRpYWwgd3JpdGUgCmFjY2Vzc2Vz IHNob3VsZCB1c2UgYSBkZXZpY2Ugc3BlY2lmaWMgY29tcGF0aWJsZSBhbmQgbm90IHRoZSBnZW5l cmljIApvbmUuCgo+ICsKPiArbWFpbnRhaW5lcnM6Cj4gKyAgLSBSYWZhxYIgTWnFgmVja2kgPHJh ZmFsQG1pbGVja2kucGw+Cj4gKwo+ICthbGxPZjoKPiArICAtICRyZWY6IG52bWVtLnlhbWwjCj4g Kwo+ICtwcm9wZXJ0aWVzOgo+ICsgIGNvbXBhdGlibGU6Cj4gKyAgICBjb25zdDogbW1pby1udm1l bQo+ICsKPiArICByZWc6Cj4gKyAgICBtYXhJdGVtczogMQo+ICsKPiArICByZWctaW8td2lkdGg6 Cj4gKyAgICBkZXNjcmlwdGlvbjogfAo+ICsgICAgICBUaGUgc2l6ZSAoaW4gYnl0ZXMpIG9mIHRo ZSBJTyBhY2Nlc3NlcyB0aGF0IHNob3VsZCBiZSBwZXJmb3JtZWQKPiArICAgICAgb24gdGhlIGRl dmljZS4KPiArICAgIGVudW06IFsxLCAyLCA0LCA4XQo+ICsKPiArcmVxdWlyZWQ6Cj4gKyAgLSBy ZWcKPiArCj4gK3VuZXZhbHVhdGVkUHJvcGVydGllczogZmFsc2UKPiArCj4gK2V4YW1wbGVzOgo+ ICsgIC0gfAo+ICsgICAgbnZtZW1AMTAwMDAgewo+ICsgICAgICAgIGNvbXBhdGlibGUgPSAibW1p by1udm1lbSI7Cj4gKyAgICAgICAgcmVnID0gPDB4MTAwMDAwMDAgMHgxMDAwMD47Cj4gKyAgICB9 Owo+IC0tIAo+IDIuMzQuMQo+IAoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX18KbGludXgtYXJtLWtlcm5lbCBtYWlsaW5nIGxpc3QKbGludXgtYXJtLWtlcm5l bEBsaXN0cy5pbmZyYWRlYWQub3JnCmh0dHA6Ly9saXN0cy5pbmZyYWRlYWQub3JnL21haWxtYW4v bGlzdGluZm8vbGludXgtYXJtLWtlcm5lbAo=