diff mbox

[2/2] DT: nvmem: Add NXP LPC18xx EEPROM memory binding documentation

Message ID 1445004426-6271-3-git-send-email-ariel@vanguardiasur.com.ar (mailing list archive)
State New, archived
Headers show

Commit Message

Ariel D'Alessandro Oct. 16, 2015, 2:07 p.m. UTC
Add the devicetree binding document for NXP LPC18xx EEPROM memory.

Signed-off-by: Ariel D'Alessandro <ariel@vanguardiasur.com.ar>
---
 .../devicetree/bindings/nvmem/lpc18xx_eeprom.txt   | 26 ++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt

Comments

Ezequiel Garcia Oct. 16, 2015, 3:41 p.m. UTC | #1
+DT bindings maintainers

As per the documentation in
Documentation/devicetree/bindings/submitting-patches.txt
this binding should be patch 1/2.

On 16 October 2015 at 11:07, Ariel D'Alessandro
<ariel@vanguardiasur.com.ar> wrote:
> Add the devicetree binding document for NXP LPC18xx EEPROM memory.
>
> Signed-off-by: Ariel D'Alessandro <ariel@vanguardiasur.com.ar>
> ---
>  .../devicetree/bindings/nvmem/lpc18xx_eeprom.txt   | 26 ++++++++++++++++++++++
>  1 file changed, 26 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
>
> diff --git a/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt b/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
> new file mode 100644
> index 0000000..372ff8c
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
> @@ -0,0 +1,26 @@
> +* NXP LPC18xx EEPROM memory NVMEM driver
> +
> +Required properties:
> +  - compatible: Should be "nxp,lpc1850-eeprom"

Correct me if I'm wrong, but I believe not all LPC18xx/43xx devices
have an EEPROM.

Isn't it restricted to LPC18x7/LPC43x7 devices?
Should the compatible be nxp,lpc1857-eeprom to avoid confusion?
Joachim Eastwood Oct. 16, 2015, 5:09 p.m. UTC | #2
On 16 October 2015 at 17:41, Ezequiel Garcia
<ezequiel@vanguardiasur.com.ar> wrote:
> +DT bindings maintainers
>
> As per the documentation in
> Documentation/devicetree/bindings/submitting-patches.txt
> this binding should be patch 1/2.
>
> On 16 October 2015 at 11:07, Ariel D'Alessandro
> <ariel@vanguardiasur.com.ar> wrote:
>> Add the devicetree binding document for NXP LPC18xx EEPROM memory.
>>
>> Signed-off-by: Ariel D'Alessandro <ariel@vanguardiasur.com.ar>
>> ---
>>  .../devicetree/bindings/nvmem/lpc18xx_eeprom.txt   | 26 ++++++++++++++++++++++
>>  1 file changed, 26 insertions(+)
>>  create mode 100644 Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
>>
>> diff --git a/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt b/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
>> new file mode 100644
>> index 0000000..372ff8c
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
>> @@ -0,0 +1,26 @@
>> +* NXP LPC18xx EEPROM memory NVMEM driver
>> +
>> +Required properties:
>> +  - compatible: Should be "nxp,lpc1850-eeprom"
>
> Correct me if I'm wrong, but I believe not all LPC18xx/43xx devices
> have an EEPROM.
>
> Isn't it restricted to LPC18x7/LPC43x7 devices?

The EEPROM can only be found on Flash devices. Flashless devices
doesn't have the EEPROM.


> Should the compatible be nxp,lpc1857-eeprom to avoid confusion?

Yes, please. The EEPROM doesn't exist on LPC1850 so please use the
compatibility string from Ezequiel.


regards,
Joachim Eastwood
Ariel D'Alessandro Oct. 16, 2015, 6:45 p.m. UTC | #3
Ezequiel, Joachim, all,

El 16/10/15 a las 14:09, Joachim Eastwood escribió:
> On 16 October 2015 at 17:41, Ezequiel Garcia
> <ezequiel@vanguardiasur.com.ar> wrote:
>> +DT bindings maintainers
>>
>> As per the documentation in
>> Documentation/devicetree/bindings/submitting-patches.txt
>> this binding should be patch 1/2.

I see. I'll modify that.

>>
>> On 16 October 2015 at 11:07, Ariel D'Alessandro
>> <ariel@vanguardiasur.com.ar> wrote:
>>> Add the devicetree binding document for NXP LPC18xx EEPROM memory.
>>>
>>> Signed-off-by: Ariel D'Alessandro <ariel@vanguardiasur.com.ar>
>>> ---
>>>  .../devicetree/bindings/nvmem/lpc18xx_eeprom.txt   | 26 ++++++++++++++++++++++
>>>  1 file changed, 26 insertions(+)
>>>  create mode 100644 Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
>>>
>>> diff --git a/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt b/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
>>> new file mode 100644
>>> index 0000000..372ff8c
>>> --- /dev/null
>>> +++ b/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
>>> @@ -0,0 +1,26 @@
>>> +* NXP LPC18xx EEPROM memory NVMEM driver
>>> +
>>> +Required properties:
>>> +  - compatible: Should be "nxp,lpc1850-eeprom"
>>
>> Correct me if I'm wrong, but I believe not all LPC18xx/43xx devices
>> have an EEPROM.
>>
>> Isn't it restricted to LPC18x7/LPC43x7 devices?
> 
> The EEPROM can only be found on Flash devices. Flashless devices
> doesn't have the EEPROM.

Yes, you're right. LPC1850 is wrong, sorry.
The UM10430 (LPC18xx User Manual) says that LPC18(5|3|2|1)(7|5|3|2)
parts have flash and that the LPC185x/3x parts with flash also include
the 16 kB EEPROM. I'll add this info in a new set of patches v2.

> 
> 
>> Should the compatible be nxp,lpc1857-eeprom to avoid confusion?
> 
> Yes, please. The EEPROM doesn't exist on LPC1850 so please use the
> compatibility string from Ezequiel.

OK. I'll fix this. Is there any reason for using lpc1857 instead of a
different available one?

Thanks!
Joachim Eastwood Oct. 18, 2015, 9:23 p.m. UTC | #4
On 16 October 2015 at 20:45, Ariel D'Alessandro
<ariel@vanguardiasur.com.ar> wrote:
> Ezequiel, Joachim, all,
>
> El 16/10/15 a las 14:09, Joachim Eastwood escribió:
>> On 16 October 2015 at 17:41, Ezequiel Garcia
>> <ezequiel@vanguardiasur.com.ar> wrote:
>>> +DT bindings maintainers
>>>
>>> As per the documentation in
>>> Documentation/devicetree/bindings/submitting-patches.txt
>>> this binding should be patch 1/2.
>
> I see. I'll modify that.
>
>>>
>>> On 16 October 2015 at 11:07, Ariel D'Alessandro
>>> <ariel@vanguardiasur.com.ar> wrote:
>>>> Add the devicetree binding document for NXP LPC18xx EEPROM memory.
>>>>
>>>> Signed-off-by: Ariel D'Alessandro <ariel@vanguardiasur.com.ar>
>>>> ---
>>>>  .../devicetree/bindings/nvmem/lpc18xx_eeprom.txt   | 26 ++++++++++++++++++++++
>>>>  1 file changed, 26 insertions(+)
>>>>  create mode 100644 Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
>>>>
>>>> diff --git a/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt b/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
>>>> new file mode 100644
>>>> index 0000000..372ff8c
>>>> --- /dev/null
>>>> +++ b/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
>>>> @@ -0,0 +1,26 @@
>>>> +* NXP LPC18xx EEPROM memory NVMEM driver
>>>> +
>>>> +Required properties:
>>>> +  - compatible: Should be "nxp,lpc1850-eeprom"
>>>
>>> Correct me if I'm wrong, but I believe not all LPC18xx/43xx devices
>>> have an EEPROM.
>>>
>>> Isn't it restricted to LPC18x7/LPC43x7 devices?
>>
>> The EEPROM can only be found on Flash devices. Flashless devices
>> doesn't have the EEPROM.
>
> Yes, you're right. LPC1850 is wrong, sorry.
> The UM10430 (LPC18xx User Manual) says that LPC18(5|3|2|1)(7|5|3|2)
> parts have flash and that the LPC185x/3x parts with flash also include
> the 16 kB EEPROM. I'll add this info in a new set of patches v2.
>
>>
>>
>>> Should the compatible be nxp,lpc1857-eeprom to avoid confusion?
>>
>> Yes, please. The EEPROM doesn't exist on LPC1850 so please use the
>> compatibility string from Ezequiel.
>
> OK. I'll fix this. Is there any reason for using lpc1857 instead of a
> different available one?

The lpc1850 was once chosen since it was the device that was
applicable to most peripherals and it is the flashless "top model". So
for peripherals found only on devices with flash use the top model
there; lpc1857. That's the only half good reason I can give.

Note that I have also started to use lpc1857 on the mtd driver for the
internal flash that I am working on.


regards,
Joachim Eastwood
diff mbox

Patch

diff --git a/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt b/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
new file mode 100644
index 0000000..372ff8c
--- /dev/null
+++ b/Documentation/devicetree/bindings/nvmem/lpc18xx_eeprom.txt
@@ -0,0 +1,26 @@ 
+* NXP LPC18xx EEPROM memory NVMEM driver
+
+Required properties:
+  - compatible: Should be "nxp,lpc1850-eeprom"
+  - reg: Must contain an entry with the physical base address and length
+    for each entry in reg-names.
+  - reg-names: Must include the following entries.
+    - reg: EEPROM registers.
+    - mem: EEPROM address space.
+  - clocks: Must contain an entry for each entry in clock-names.
+  - clock-names: Must include the following entries.
+    - eeprom: EEPROM operating clock.
+  - interrupts: Should contain EEPROM interrupt.
+
+Example:
+
+  eeprom: eeprom@4000e000 {
+    compatible = "nxp,lpc1850-eeprom";
+    reg = <0x4000e000 0x1000>,
+          <0x20040000 0x4000>;
+    reg-names = "reg", "mem";
+    clocks = <&ccu1 CLK_CPU_EEPROM>;
+    clock-names = "eeprom";
+    resets = <&rgu 27>;
+    interrupts = <4>;
+  };