RE: [EXT] Re: [1/2] dt-bindings: rtc: pcf85263/pcf85363: add some properties
From: Biwen Li
Date: Fri Aug 30 2019 - 06:11:11 EST
>
> On 30/08/2019 17:17:19+0800, Biwen Li wrote:
> > Add some properties for pcf85263/pcf85363 as follows:
> > - interrupt-output-pin: string type
> > - quartz-load-capacitance: integer type
> > - quartz-drive-strength: integer type
> > - quartz-low-jitter: bool type
> > - wakeup-source: bool type
> >
> > Signed-off-by: Martin Fuzzey <mfuzzey@xxxxxxxxxxx>
> > Signed-off-by: Biwen Li <biwen.li@xxxxxxx>
> > ---
> > .../devicetree/bindings/rtc/pcf85363.txt | 31
> +++++++++++++++++++
> > include/dt-bindings/rtc/pcf85363.h | 15 +++++++++
> > 2 files changed, 46 insertions(+)
> > create mode 100644 include/dt-bindings/rtc/pcf85363.h
> >
> > diff --git a/Documentation/devicetree/bindings/rtc/pcf85363.txt
> > b/Documentation/devicetree/bindings/rtc/pcf85363.txt
> > index 94adc1cf93d9..d83359990bd7 100644
> > --- a/Documentation/devicetree/bindings/rtc/pcf85363.txt
> > +++ b/Documentation/devicetree/bindings/rtc/pcf85363.txt
> > @@ -8,10 +8,41 @@ Required properties:
> > Optional properties:
> > - interrupts: IRQ line for the RTC (not implemented).
> >
> > +- interrupt-output-pin: The interrupt output pin must be
> > + "NONE", "INTA" or "INTB", default value is "NONE"
> > +
>
> default value can't be none if there is an interrupts property. Also, both pins
> can be enabled at the same time and this binding would prevent that.
> Finally, it may also be desirable to have some interrupts on one pin and
> other interrupts on another pin e.g. alarms and timestamping on INTA going
> to the SoC and only alarms on INTB going to a PMIC.
Ok, got it, I will correct it on v2.
>
> > +- quartz-load-capacitance: The internal capacitor to select for the quartz:
> > + PCF85263_QUARTZCAP_7pF [0]
> > + PCF85263_QUARTZCAP_6pF [1]
> > + PCF85263_QUARTZCAP_12p5pF [2] DEFAULT
> > +
>
> The correct generic property is quartz-load-femtofarads.
I will replace it on v2.
>
> > +- quartz-drive-strength: Drive strength for the quartz:
> > + PCF85263_QUARTZDRIVE_NORMAL [0] DEFAULT
> > + PCF85263_QUARTZDRIVE_LOW [1]
> > + PCF85263_QUARTZDRIVE_HIGH [2]
> > +
>
> This has to take a value in ohm to be generic and then you don't need the
> include file.
I will adjust it on v2.
>
> > +- quartz-low-jitter: Boolean property, if present enables low jitter
> > +mode
> > + which reduces jitter at the cost of increased power consumption.
> > +
>
> I think that property needs to be nxp specific.
I will replace it with nxp,quartz-low-jitter on v2.
>
> > +- wakeup-source: Boolean property, mark the chip as a wakeup source,
> > + independently of the availability of an IRQ line connected to the SoC.
> > + This is useful if the IRQ line is connected to a PMIC or other
> > +circuit
> > + that can power up the device rather than to a normal SOC interrupt.
> > +
>
> This is already defined in bindings/power/wakeup-source.txt I guess you can
> simply refer to it.
I will correct it on v2.
>
> > Example:
> >
> > pcf85363: pcf85363@51 {
> > compatible = "nxp,pcf85363";
> > reg = <0x51>;
> > +
> > + interrupt-parent = <&gpio1>;
> > + interrupts = <18 IRQ_TYPE_EDGE_FALLING>;
> > +
> > + #include <dt-bindings/rtc/pcf85363.h>
> > + wakeup-source;
> > + interrupt-output-pin = "INTA";
> > + quartz-load-capacitance = <PCF85363_QUARTZCAP_12p5pF>;
> > + quartz-drive-strength = <PCF85363_QUARTZDRIVE_LOW>;
> > + quartz-low-jitter;
> > };
> >
> > diff --git a/include/dt-bindings/rtc/pcf85363.h
> > b/include/dt-bindings/rtc/pcf85363.h
> > new file mode 100644
> > index 000000000000..2c06c28eb5ff
> > --- /dev/null
> > +++ b/include/dt-bindings/rtc/pcf85363.h
> > @@ -0,0 +1,15 @@
> > +/* SPDX-License-Identifier: GPL-2.0 */ #ifndef
> > +_DT_BINDINGS_RTC_PCF85363_H #define
> _DT_BINDINGS_RTC_PCF85363_H
> > +
> > +/* Quartz capacitance */
> > +#define PCF85363_QUARTZCAP_7pF 0
> > +#define PCF85363_QUARTZCAP_6pF 1
> > +#define PCF85363_QUARTZCAP_12p5pF 2
> > +
> > +/* Quartz drive strength */
> > +#define PCF85363_QUARTZDRIVE_NORMAL 0
> > +#define PCF85363_QUARTZDRIVE_LOW 1
> > +#define PCF85363_QUARTZDRIVE_HIGH 2
> > +
> > +#endif /* _DT_BINDINGS_RTC_PCF85363_H */
> > --
> > 2.17.1
> >
>
> --
> Alexandre Belloni, Bootlin
> Embedded Linux and Kernel engineering
> https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fbootl
> in.com&data=02%7C01%7Cbiwen.li%40nxp.com%7C0a2e5b50f8fc45a
> ef6a208d72d2ebe2e%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0
> %7C637027551094795780&sdata=PMMS6PMBPkuuIYgMJFmtOaoD%
> 2B7fCO3eZvOtlYhTEL5w%3D&reserved=0