Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On 8/13/18 9:44 PM, Rob Herring wrote:
On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote:
Actions Semi OWL family SoC's provides support for external interrupt
controller to be connected and controlled using SIRQ pins. S500, S700
and S900 provides 3 SIRQ lines and works independently for 3 external
interrupt controllers.
Signed-off-by: Parthiban Nallathambi
Signed-off-by: Saravanan Sekar
---
.../interrupt-controller/actions,owl-sirq.txt | 46 ++
1 file changed, 46 insertions(+)
create mode 100644
Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
diff --git
a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
new file mode 100644
index ..4b8437751331
--- /dev/null
+++
b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
@@ -0,0 +1,46 @@
+Actions Semi Owl SoCs SIRQ interrupt controller
+
+S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC,
+in which external interrupt controller can be connected. 3 SPI's
+45, 46, 47 from GIC are directly exposed as SIRQ. It has
+the following properties:
+
+- inputs three interrupt signal from external interrupt controller
+
+Required properties:
+
+- compatible: should be "actions,owl-sirq"
+- reg: physical base address of the controller and length of memory mapped.
+- interrupt-controller: identifies the node as an interrupt controller
+- #interrupt-cells: specifies the number of cells needed to encode an interrupt
+ source, should be 2.
+- actions,sirq-shared-reg: Applicable for S500 and S700 where SIRQ register
+ details are maintained at same offset/register.
+- actions,sirq-offset: register offset for SIRQ interrupts. When registers are
+ shared, all the three offsets will be same (S500 and S700).
You should have more specific compatible strings if there are
differences and these settings can be implied by them.
This to meant to get the register offset because s500, s700 uses the
same external interrupt controller register to provide three or more
interrupt line. But this is not the case for s900.
So should it be "actions,sirq-offset-reg"?
+- actions,sirq-clk-sel: external interrupt controller can be either
+ connected to 32Khz or 24Mhz external/internal clock. This needs
+ to be configured for per SIRQ line. Failing defaults to 32Khz clock.
What are the valid values?
+
+Example for S900:
+
+sirq: interrupt-controller@e01b {
+ compatible = "actions,owl-sirq";
+ reg = <0 0xe01b 0 0x1000>;
+ interrupt-controller;
+ #interrupt-cells = <2>;
+ actions,sirq-clk-sel = <0 0 0>;
If 0 is 32khz, then having this is pointless. But I can't tell what the
values correspond to.
Thanks, clock selection will be removed and defaults to 24MHz.
+ actions,sirq-offset = <0x200 0x528 0x52c>;
+};
+
+Example for S500 and S700:
+
+sirq: interrupt-controller@e01b {
+ compatible = "actions,owl-sirq";
+ reg = <0 0xe01b 0 0x1000>;
+ interrupt-controller;
+ #interrupt-cells = <2>;
+ actions,sirq-shared-reg;
+ actions,sirq-clk-sel = <0 0 0>;
+ actions,sirq-offset = <0x200 0x200 0x200>;
+};
--
2.14.4
--
Thanks,
Parthiban N
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-22 Fax: (+49)-8142-66989-80 Email: p...@denx.de
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On 8/13/18 9:44 PM, Rob Herring wrote:
On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote:
Actions Semi OWL family SoC's provides support for external interrupt
controller to be connected and controlled using SIRQ pins. S500, S700
and S900 provides 3 SIRQ lines and works independently for 3 external
interrupt controllers.
Signed-off-by: Parthiban Nallathambi
Signed-off-by: Saravanan Sekar
---
.../interrupt-controller/actions,owl-sirq.txt | 46 ++
1 file changed, 46 insertions(+)
create mode 100644
Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
diff --git
a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
new file mode 100644
index ..4b8437751331
--- /dev/null
+++
b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
@@ -0,0 +1,46 @@
+Actions Semi Owl SoCs SIRQ interrupt controller
+
+S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC,
+in which external interrupt controller can be connected. 3 SPI's
+45, 46, 47 from GIC are directly exposed as SIRQ. It has
+the following properties:
+
+- inputs three interrupt signal from external interrupt controller
+
+Required properties:
+
+- compatible: should be "actions,owl-sirq"
+- reg: physical base address of the controller and length of memory mapped.
+- interrupt-controller: identifies the node as an interrupt controller
+- #interrupt-cells: specifies the number of cells needed to encode an interrupt
+ source, should be 2.
+- actions,sirq-shared-reg: Applicable for S500 and S700 where SIRQ register
+ details are maintained at same offset/register.
+- actions,sirq-offset: register offset for SIRQ interrupts. When registers are
+ shared, all the three offsets will be same (S500 and S700).
You should have more specific compatible strings if there are
differences and these settings can be implied by them.
This to meant to get the register offset because s500, s700 uses the
same external interrupt controller register to provide three or more
interrupt line. But this is not the case for s900.
So should it be "actions,sirq-offset-reg"?
+- actions,sirq-clk-sel: external interrupt controller can be either
+ connected to 32Khz or 24Mhz external/internal clock. This needs
+ to be configured for per SIRQ line. Failing defaults to 32Khz clock.
What are the valid values?
+
+Example for S900:
+
+sirq: interrupt-controller@e01b {
+ compatible = "actions,owl-sirq";
+ reg = <0 0xe01b 0 0x1000>;
+ interrupt-controller;
+ #interrupt-cells = <2>;
+ actions,sirq-clk-sel = <0 0 0>;
If 0 is 32khz, then having this is pointless. But I can't tell what the
values correspond to.
Thanks, clock selection will be removed and defaults to 24MHz.
+ actions,sirq-offset = <0x200 0x528 0x52c>;
+};
+
+Example for S500 and S700:
+
+sirq: interrupt-controller@e01b {
+ compatible = "actions,owl-sirq";
+ reg = <0 0xe01b 0 0x1000>;
+ interrupt-controller;
+ #interrupt-cells = <2>;
+ actions,sirq-shared-reg;
+ actions,sirq-clk-sel = <0 0 0>;
+ actions,sirq-offset = <0x200 0x200 0x200>;
+};
--
2.14.4
--
Thanks,
Parthiban N
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-22 Fax: (+49)-8142-66989-80 Email: p...@denx.de
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On 8/13/18 6:34 AM, Manivannan Sadhasivam wrote:
Hi Parthiban,
On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote:
Actions Semi OWL family SoC's provides support for external interrupt
controller to be connected and controlled using SIRQ pins. S500, S700
and S900 provides 3 SIRQ lines and works independently for 3 external
interrupt controllers.
Signed-off-by: Parthiban Nallathambi
Signed-off-by: Saravanan Sekar
---
.../interrupt-controller/actions,owl-sirq.txt | 46 ++
1 file changed, 46 insertions(+)
create mode 100644
Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
diff --git
a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
new file mode 100644
index ..4b8437751331
--- /dev/null
+++
b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
@@ -0,0 +1,46 @@
+Actions Semi Owl SoCs SIRQ interrupt controller
+
+S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC,
+in which external interrupt controller can be connected. 3 SPI's
+45, 46, 47 from GIC are directly exposed as SIRQ. It has
+the following properties:
We should really document the driver here. What it does? and how the
hierarchy is handled with GIC? etc...
+
+- inputs three interrupt signal from external interrupt controller
+
+Required properties:
+
+- compatible: should be "actions,owl-sirq"
+- reg: physical base address of the controller and length of memory mapped.
...length of memory mapped region?
Yes it is.
+- interrupt-controller: identifies the node as an interrupt controller
+- #interrupt-cells: specifies the number of cells needed to encode an interrupt
+ source, should be 2.
+- actions,sirq-shared-reg: Applicable for S500 and S700 where SIRQ register
+ details are maintained at same offset/register.
+- actions,sirq-offset: register offset for SIRQ interrupts. When registers are
+ shared, all the three offsets will be same (S500 and S700).
+- actions,sirq-clk-sel: external interrupt controller can be either
+ connected to 32Khz or 24Mhz external/internal clock. This needs
Hertz should be specified as Hz.
+ to be configured for per SIRQ line. Failing defaults to 32Khz clock.
What value needs to be specified for selecting 24MHz clock? You should
mention the available options this property supports.
Ok, this property will be removed here and leave to default 24MHz for
all the SoC's.
+
+Example for S900:
+
+sirq: interrupt-controller@e01b {
+ compatible = "actions,owl-sirq";
+ reg = <0 0xe01b 0 0x1000>;
could be: reg = <0x0 0xe01b 0x0 0x1000>;
Agreed!
+ interrupt-controller;
+ #interrupt-cells = <2>;
+ actions,sirq-clk-sel = <0 0 0>;
+ actions,sirq-offset = <0x200 0x528 0x52c>;
+};
+
+Example for S500 and S700:
+
+sirq: interrupt-controller@e01b {
+ compatible = "actions,owl-sirq";
+ reg = <0 0xe01b 0 0x1000>;
For S500, reg base is 0xb01b.
Yes, agreed!
Thanks,
Parthi
Thanks
Mani
+ interrupt-controller;
+ #interrupt-cells = <2>;
+ actions,sirq-shared-reg;
+ actions,sirq-clk-sel = <0 0 0>;
+ actions,sirq-offset = <0x200 0x200 0x200>;
+};
--
2.14.4
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On 8/13/18 6:34 AM, Manivannan Sadhasivam wrote:
Hi Parthiban,
On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote:
Actions Semi OWL family SoC's provides support for external interrupt
controller to be connected and controlled using SIRQ pins. S500, S700
and S900 provides 3 SIRQ lines and works independently for 3 external
interrupt controllers.
Signed-off-by: Parthiban Nallathambi
Signed-off-by: Saravanan Sekar
---
.../interrupt-controller/actions,owl-sirq.txt | 46 ++
1 file changed, 46 insertions(+)
create mode 100644
Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
diff --git
a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
new file mode 100644
index ..4b8437751331
--- /dev/null
+++
b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
@@ -0,0 +1,46 @@
+Actions Semi Owl SoCs SIRQ interrupt controller
+
+S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC,
+in which external interrupt controller can be connected. 3 SPI's
+45, 46, 47 from GIC are directly exposed as SIRQ. It has
+the following properties:
We should really document the driver here. What it does? and how the
hierarchy is handled with GIC? etc...
+
+- inputs three interrupt signal from external interrupt controller
+
+Required properties:
+
+- compatible: should be "actions,owl-sirq"
+- reg: physical base address of the controller and length of memory mapped.
...length of memory mapped region?
Yes it is.
+- interrupt-controller: identifies the node as an interrupt controller
+- #interrupt-cells: specifies the number of cells needed to encode an interrupt
+ source, should be 2.
+- actions,sirq-shared-reg: Applicable for S500 and S700 where SIRQ register
+ details are maintained at same offset/register.
+- actions,sirq-offset: register offset for SIRQ interrupts. When registers are
+ shared, all the three offsets will be same (S500 and S700).
+- actions,sirq-clk-sel: external interrupt controller can be either
+ connected to 32Khz or 24Mhz external/internal clock. This needs
Hertz should be specified as Hz.
+ to be configured for per SIRQ line. Failing defaults to 32Khz clock.
What value needs to be specified for selecting 24MHz clock? You should
mention the available options this property supports.
Ok, this property will be removed here and leave to default 24MHz for
all the SoC's.
+
+Example for S900:
+
+sirq: interrupt-controller@e01b {
+ compatible = "actions,owl-sirq";
+ reg = <0 0xe01b 0 0x1000>;
could be: reg = <0x0 0xe01b 0x0 0x1000>;
Agreed!
+ interrupt-controller;
+ #interrupt-cells = <2>;
+ actions,sirq-clk-sel = <0 0 0>;
+ actions,sirq-offset = <0x200 0x528 0x52c>;
+};
+
+Example for S500 and S700:
+
+sirq: interrupt-controller@e01b {
+ compatible = "actions,owl-sirq";
+ reg = <0 0xe01b 0 0x1000>;
For S500, reg base is 0xb01b.
Yes, agreed!
Thanks,
Parthi
Thanks
Mani
+ interrupt-controller;
+ #interrupt-cells = <2>;
+ actions,sirq-shared-reg;
+ actions,sirq-clk-sel = <0 0 0>;
+ actions,sirq-offset = <0x200 0x200 0x200>;
+};
--
2.14.4
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote:
> Actions Semi OWL family SoC's provides support for external interrupt
> controller to be connected and controlled using SIRQ pins. S500, S700
> and S900 provides 3 SIRQ lines and works independently for 3 external
> interrupt controllers.
>
> Signed-off-by: Parthiban Nallathambi
> Signed-off-by: Saravanan Sekar
> ---
> .../interrupt-controller/actions,owl-sirq.txt | 46
> ++
> 1 file changed, 46 insertions(+)
> create mode 100644
> Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
>
> diff --git
> a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> new file mode 100644
> index ..4b8437751331
> --- /dev/null
> +++
> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> @@ -0,0 +1,46 @@
> +Actions Semi Owl SoCs SIRQ interrupt controller
> +
> +S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC,
> +in which external interrupt controller can be connected. 3 SPI's
> +45, 46, 47 from GIC are directly exposed as SIRQ. It has
> +the following properties:
> +
> +- inputs three interrupt signal from external interrupt controller
> +
> +Required properties:
> +
> +- compatible: should be "actions,owl-sirq"
> +- reg: physical base address of the controller and length of memory mapped.
> +- interrupt-controller: identifies the node as an interrupt controller
> +- #interrupt-cells: specifies the number of cells needed to encode an
> interrupt
> + source, should be 2.
> +- actions,sirq-shared-reg: Applicable for S500 and S700 where SIRQ register
> + details are maintained at same offset/register.
> +- actions,sirq-offset: register offset for SIRQ interrupts. When registers
> are
> + shared, all the three offsets will be same (S500 and S700).
You should have more specific compatible strings if there are
differences and these settings can be implied by them.
> +- actions,sirq-clk-sel: external interrupt controller can be either
> + connected to 32Khz or 24Mhz external/internal clock. This needs
> + to be configured for per SIRQ line. Failing defaults to 32Khz clock.
What are the valid values?
> +
> +Example for S900:
> +
> +sirq: interrupt-controller@e01b {
> + compatible = "actions,owl-sirq";
> + reg = <0 0xe01b 0 0x1000>;
> + interrupt-controller;
> + #interrupt-cells = <2>;
> + actions,sirq-clk-sel = <0 0 0>;
If 0 is 32khz, then having this is pointless. But I can't tell what the
values correspond to.
> + actions,sirq-offset = <0x200 0x528 0x52c>;
> +};
> +
> +Example for S500 and S700:
> +
> +sirq: interrupt-controller@e01b {
> + compatible = "actions,owl-sirq";
> + reg = <0 0xe01b 0 0x1000>;
> + interrupt-controller;
> + #interrupt-cells = <2>;
> + actions,sirq-shared-reg;
> + actions,sirq-clk-sel = <0 0 0>;
> + actions,sirq-offset = <0x200 0x200 0x200>;
> +};
> --
> 2.14.4
>
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote:
> Actions Semi OWL family SoC's provides support for external interrupt
> controller to be connected and controlled using SIRQ pins. S500, S700
> and S900 provides 3 SIRQ lines and works independently for 3 external
> interrupt controllers.
>
> Signed-off-by: Parthiban Nallathambi
> Signed-off-by: Saravanan Sekar
> ---
> .../interrupt-controller/actions,owl-sirq.txt | 46
> ++
> 1 file changed, 46 insertions(+)
> create mode 100644
> Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
>
> diff --git
> a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> new file mode 100644
> index ..4b8437751331
> --- /dev/null
> +++
> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> @@ -0,0 +1,46 @@
> +Actions Semi Owl SoCs SIRQ interrupt controller
> +
> +S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC,
> +in which external interrupt controller can be connected. 3 SPI's
> +45, 46, 47 from GIC are directly exposed as SIRQ. It has
> +the following properties:
> +
> +- inputs three interrupt signal from external interrupt controller
> +
> +Required properties:
> +
> +- compatible: should be "actions,owl-sirq"
> +- reg: physical base address of the controller and length of memory mapped.
> +- interrupt-controller: identifies the node as an interrupt controller
> +- #interrupt-cells: specifies the number of cells needed to encode an
> interrupt
> + source, should be 2.
> +- actions,sirq-shared-reg: Applicable for S500 and S700 where SIRQ register
> + details are maintained at same offset/register.
> +- actions,sirq-offset: register offset for SIRQ interrupts. When registers
> are
> + shared, all the three offsets will be same (S500 and S700).
You should have more specific compatible strings if there are
differences and these settings can be implied by them.
> +- actions,sirq-clk-sel: external interrupt controller can be either
> + connected to 32Khz or 24Mhz external/internal clock. This needs
> + to be configured for per SIRQ line. Failing defaults to 32Khz clock.
What are the valid values?
> +
> +Example for S900:
> +
> +sirq: interrupt-controller@e01b {
> + compatible = "actions,owl-sirq";
> + reg = <0 0xe01b 0 0x1000>;
> + interrupt-controller;
> + #interrupt-cells = <2>;
> + actions,sirq-clk-sel = <0 0 0>;
If 0 is 32khz, then having this is pointless. But I can't tell what the
values correspond to.
> + actions,sirq-offset = <0x200 0x528 0x52c>;
> +};
> +
> +Example for S500 and S700:
> +
> +sirq: interrupt-controller@e01b {
> + compatible = "actions,owl-sirq";
> + reg = <0 0xe01b 0 0x1000>;
> + interrupt-controller;
> + #interrupt-cells = <2>;
> + actions,sirq-shared-reg;
> + actions,sirq-clk-sel = <0 0 0>;
> + actions,sirq-offset = <0x200 0x200 0x200>;
> +};
> --
> 2.14.4
>
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On Mon, Aug 13, 2018 at 02:45:47PM +0530, Manivannan Sadhasivam wrote: > On Mon, Aug 13, 2018 at 08:51:54AM +0100, Marc Zyngier wrote: > > On 13/08/18 05:34, Manivannan Sadhasivam wrote: > > > Hi Parthiban, > > > > > > On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote: > > >> Actions Semi OWL family SoC's provides support for external interrupt > > >> controller to be connected and controlled using SIRQ pins. S500, S700 > > >> and S900 provides 3 SIRQ lines and works independently for 3 external > > >> interrupt controllers. > > >> > > >> Signed-off-by: Parthiban Nallathambi > > >> Signed-off-by: Saravanan Sekar > > >> --- > > >> .../interrupt-controller/actions,owl-sirq.txt | 46 > > >> ++ > > >> 1 file changed, 46 insertions(+) > > >> create mode 100644 > > >> Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > > >> > > >> diff --git > > >> a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > > >> > > >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > > >> new file mode 100644 > > >> index ..4b8437751331 > > >> --- /dev/null > > >> +++ > > >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > > >> @@ -0,0 +1,46 @@ > > >> +Actions Semi Owl SoCs SIRQ interrupt controller > > >> + > > >> +S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC, > > >> +in which external interrupt controller can be connected. 3 SPI's > > >> +45, 46, 47 from GIC are directly exposed as SIRQ. It has > > >> +the following properties: > > > > > > We should really document the driver here. What it does? and how the > > > hierarchy is handled with GIC? etc... > > > > Absolutely not. This should document the binding, irrespective of the > > operating system. The word "driver" is completely out of place here. > > > > Oops, my bad. I meant to say that we should add it as a description in the > commit message. > ...commit message of the driver patch (to be more explicit) > Thanks, > Mani > > > Thanks, > > > > M. > > -- > > Jazz is not dead. It just smells funny...
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On Mon, Aug 13, 2018 at 02:45:47PM +0530, Manivannan Sadhasivam wrote: > On Mon, Aug 13, 2018 at 08:51:54AM +0100, Marc Zyngier wrote: > > On 13/08/18 05:34, Manivannan Sadhasivam wrote: > > > Hi Parthiban, > > > > > > On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote: > > >> Actions Semi OWL family SoC's provides support for external interrupt > > >> controller to be connected and controlled using SIRQ pins. S500, S700 > > >> and S900 provides 3 SIRQ lines and works independently for 3 external > > >> interrupt controllers. > > >> > > >> Signed-off-by: Parthiban Nallathambi > > >> Signed-off-by: Saravanan Sekar > > >> --- > > >> .../interrupt-controller/actions,owl-sirq.txt | 46 > > >> ++ > > >> 1 file changed, 46 insertions(+) > > >> create mode 100644 > > >> Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > > >> > > >> diff --git > > >> a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > > >> > > >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > > >> new file mode 100644 > > >> index ..4b8437751331 > > >> --- /dev/null > > >> +++ > > >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > > >> @@ -0,0 +1,46 @@ > > >> +Actions Semi Owl SoCs SIRQ interrupt controller > > >> + > > >> +S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC, > > >> +in which external interrupt controller can be connected. 3 SPI's > > >> +45, 46, 47 from GIC are directly exposed as SIRQ. It has > > >> +the following properties: > > > > > > We should really document the driver here. What it does? and how the > > > hierarchy is handled with GIC? etc... > > > > Absolutely not. This should document the binding, irrespective of the > > operating system. The word "driver" is completely out of place here. > > > > Oops, my bad. I meant to say that we should add it as a description in the > commit message. > ...commit message of the driver patch (to be more explicit) > Thanks, > Mani > > > Thanks, > > > > M. > > -- > > Jazz is not dead. It just smells funny...
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On Mon, Aug 13, 2018 at 08:51:54AM +0100, Marc Zyngier wrote: > On 13/08/18 05:34, Manivannan Sadhasivam wrote: > > Hi Parthiban, > > > > On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote: > >> Actions Semi OWL family SoC's provides support for external interrupt > >> controller to be connected and controlled using SIRQ pins. S500, S700 > >> and S900 provides 3 SIRQ lines and works independently for 3 external > >> interrupt controllers. > >> > >> Signed-off-by: Parthiban Nallathambi > >> Signed-off-by: Saravanan Sekar > >> --- > >> .../interrupt-controller/actions,owl-sirq.txt | 46 > >> ++ > >> 1 file changed, 46 insertions(+) > >> create mode 100644 > >> Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > >> > >> diff --git > >> a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > >> > >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > >> new file mode 100644 > >> index ..4b8437751331 > >> --- /dev/null > >> +++ > >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > >> @@ -0,0 +1,46 @@ > >> +Actions Semi Owl SoCs SIRQ interrupt controller > >> + > >> +S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC, > >> +in which external interrupt controller can be connected. 3 SPI's > >> +45, 46, 47 from GIC are directly exposed as SIRQ. It has > >> +the following properties: > > > > We should really document the driver here. What it does? and how the > > hierarchy is handled with GIC? etc... > > Absolutely not. This should document the binding, irrespective of the > operating system. The word "driver" is completely out of place here. > Oops, my bad. I meant to say that we should add it as a description in the commit message. Thanks, Mani > Thanks, > > M. > -- > Jazz is not dead. It just smells funny...
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On Mon, Aug 13, 2018 at 08:51:54AM +0100, Marc Zyngier wrote: > On 13/08/18 05:34, Manivannan Sadhasivam wrote: > > Hi Parthiban, > > > > On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote: > >> Actions Semi OWL family SoC's provides support for external interrupt > >> controller to be connected and controlled using SIRQ pins. S500, S700 > >> and S900 provides 3 SIRQ lines and works independently for 3 external > >> interrupt controllers. > >> > >> Signed-off-by: Parthiban Nallathambi > >> Signed-off-by: Saravanan Sekar > >> --- > >> .../interrupt-controller/actions,owl-sirq.txt | 46 > >> ++ > >> 1 file changed, 46 insertions(+) > >> create mode 100644 > >> Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > >> > >> diff --git > >> a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > >> > >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > >> new file mode 100644 > >> index ..4b8437751331 > >> --- /dev/null > >> +++ > >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt > >> @@ -0,0 +1,46 @@ > >> +Actions Semi Owl SoCs SIRQ interrupt controller > >> + > >> +S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC, > >> +in which external interrupt controller can be connected. 3 SPI's > >> +45, 46, 47 from GIC are directly exposed as SIRQ. It has > >> +the following properties: > > > > We should really document the driver here. What it does? and how the > > hierarchy is handled with GIC? etc... > > Absolutely not. This should document the binding, irrespective of the > operating system. The word "driver" is completely out of place here. > Oops, my bad. I meant to say that we should add it as a description in the commit message. Thanks, Mani > Thanks, > > M. > -- > Jazz is not dead. It just smells funny...
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On 13/08/18 05:34, Manivannan Sadhasivam wrote: > Hi Parthiban, > > On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote: >> Actions Semi OWL family SoC's provides support for external interrupt >> controller to be connected and controlled using SIRQ pins. S500, S700 >> and S900 provides 3 SIRQ lines and works independently for 3 external >> interrupt controllers. >> >> Signed-off-by: Parthiban Nallathambi >> Signed-off-by: Saravanan Sekar >> --- >> .../interrupt-controller/actions,owl-sirq.txt | 46 >> ++ >> 1 file changed, 46 insertions(+) >> create mode 100644 >> Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt >> >> diff --git >> a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt >> >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt >> new file mode 100644 >> index ..4b8437751331 >> --- /dev/null >> +++ >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt >> @@ -0,0 +1,46 @@ >> +Actions Semi Owl SoCs SIRQ interrupt controller >> + >> +S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC, >> +in which external interrupt controller can be connected. 3 SPI's >> +45, 46, 47 from GIC are directly exposed as SIRQ. It has >> +the following properties: > > We should really document the driver here. What it does? and how the > hierarchy is handled with GIC? etc... Absolutely not. This should document the binding, irrespective of the operating system. The word "driver" is completely out of place here. Thanks, M. -- Jazz is not dead. It just smells funny...
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
On 13/08/18 05:34, Manivannan Sadhasivam wrote: > Hi Parthiban, > > On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote: >> Actions Semi OWL family SoC's provides support for external interrupt >> controller to be connected and controlled using SIRQ pins. S500, S700 >> and S900 provides 3 SIRQ lines and works independently for 3 external >> interrupt controllers. >> >> Signed-off-by: Parthiban Nallathambi >> Signed-off-by: Saravanan Sekar >> --- >> .../interrupt-controller/actions,owl-sirq.txt | 46 >> ++ >> 1 file changed, 46 insertions(+) >> create mode 100644 >> Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt >> >> diff --git >> a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt >> >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt >> new file mode 100644 >> index ..4b8437751331 >> --- /dev/null >> +++ >> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt >> @@ -0,0 +1,46 @@ >> +Actions Semi Owl SoCs SIRQ interrupt controller >> + >> +S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC, >> +in which external interrupt controller can be connected. 3 SPI's >> +45, 46, 47 from GIC are directly exposed as SIRQ. It has >> +the following properties: > > We should really document the driver here. What it does? and how the > hierarchy is handled with GIC? etc... Absolutely not. This should document the binding, irrespective of the operating system. The word "driver" is completely out of place here. Thanks, M. -- Jazz is not dead. It just smells funny...
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
Hi Parthiban,
On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote:
> Actions Semi OWL family SoC's provides support for external interrupt
> controller to be connected and controlled using SIRQ pins. S500, S700
> and S900 provides 3 SIRQ lines and works independently for 3 external
> interrupt controllers.
>
> Signed-off-by: Parthiban Nallathambi
> Signed-off-by: Saravanan Sekar
> ---
> .../interrupt-controller/actions,owl-sirq.txt | 46
> ++
> 1 file changed, 46 insertions(+)
> create mode 100644
> Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
>
> diff --git
> a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> new file mode 100644
> index ..4b8437751331
> --- /dev/null
> +++
> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> @@ -0,0 +1,46 @@
> +Actions Semi Owl SoCs SIRQ interrupt controller
> +
> +S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC,
> +in which external interrupt controller can be connected. 3 SPI's
> +45, 46, 47 from GIC are directly exposed as SIRQ. It has
> +the following properties:
We should really document the driver here. What it does? and how the
hierarchy is handled with GIC? etc...
> +
> +- inputs three interrupt signal from external interrupt controller
> +
> +Required properties:
> +
> +- compatible: should be "actions,owl-sirq"
> +- reg: physical base address of the controller and length of memory mapped.
...length of memory mapped region?
> +- interrupt-controller: identifies the node as an interrupt controller
> +- #interrupt-cells: specifies the number of cells needed to encode an
> interrupt
> + source, should be 2.
> +- actions,sirq-shared-reg: Applicable for S500 and S700 where SIRQ register
> + details are maintained at same offset/register.
> +- actions,sirq-offset: register offset for SIRQ interrupts. When registers
> are
> + shared, all the three offsets will be same (S500 and S700).
> +- actions,sirq-clk-sel: external interrupt controller can be either
> + connected to 32Khz or 24Mhz external/internal clock. This needs
Hertz should be specified as Hz.
> + to be configured for per SIRQ line. Failing defaults to 32Khz clock.
What value needs to be specified for selecting 24MHz clock? You should
mention the available options this property supports.
> +
> +Example for S900:
> +
> +sirq: interrupt-controller@e01b {
> + compatible = "actions,owl-sirq";
> + reg = <0 0xe01b 0 0x1000>;
could be: reg = <0x0 0xe01b 0x0 0x1000>;
> + interrupt-controller;
> + #interrupt-cells = <2>;
> + actions,sirq-clk-sel = <0 0 0>;
> + actions,sirq-offset = <0x200 0x528 0x52c>;
> +};
> +
> +Example for S500 and S700:
> +
> +sirq: interrupt-controller@e01b {
> + compatible = "actions,owl-sirq";
> + reg = <0 0xe01b 0 0x1000>;
For S500, reg base is 0xb01b.
Thanks
Mani
> + interrupt-controller;
> + #interrupt-cells = <2>;
> + actions,sirq-shared-reg;
> + actions,sirq-clk-sel = <0 0 0>;
> + actions,sirq-offset = <0x200 0x200 0x200>;
> +};
> --
> 2.14.4
>
Re: [PATCH v2 1/3] dt-bindings: interrupt-controller: Actions external interrupt controller
Hi Parthiban,
On Sun, Aug 12, 2018 at 02:22:13PM +0200, Parthiban Nallathambi wrote:
> Actions Semi OWL family SoC's provides support for external interrupt
> controller to be connected and controlled using SIRQ pins. S500, S700
> and S900 provides 3 SIRQ lines and works independently for 3 external
> interrupt controllers.
>
> Signed-off-by: Parthiban Nallathambi
> Signed-off-by: Saravanan Sekar
> ---
> .../interrupt-controller/actions,owl-sirq.txt | 46
> ++
> 1 file changed, 46 insertions(+)
> create mode 100644
> Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
>
> diff --git
> a/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> new file mode 100644
> index ..4b8437751331
> --- /dev/null
> +++
> b/Documentation/devicetree/bindings/interrupt-controller/actions,owl-sirq.txt
> @@ -0,0 +1,46 @@
> +Actions Semi Owl SoCs SIRQ interrupt controller
> +
> +S500, S700 and S900 SoC's from Actions provides 3 SPI's from GIC,
> +in which external interrupt controller can be connected. 3 SPI's
> +45, 46, 47 from GIC are directly exposed as SIRQ. It has
> +the following properties:
We should really document the driver here. What it does? and how the
hierarchy is handled with GIC? etc...
> +
> +- inputs three interrupt signal from external interrupt controller
> +
> +Required properties:
> +
> +- compatible: should be "actions,owl-sirq"
> +- reg: physical base address of the controller and length of memory mapped.
...length of memory mapped region?
> +- interrupt-controller: identifies the node as an interrupt controller
> +- #interrupt-cells: specifies the number of cells needed to encode an
> interrupt
> + source, should be 2.
> +- actions,sirq-shared-reg: Applicable for S500 and S700 where SIRQ register
> + details are maintained at same offset/register.
> +- actions,sirq-offset: register offset for SIRQ interrupts. When registers
> are
> + shared, all the three offsets will be same (S500 and S700).
> +- actions,sirq-clk-sel: external interrupt controller can be either
> + connected to 32Khz or 24Mhz external/internal clock. This needs
Hertz should be specified as Hz.
> + to be configured for per SIRQ line. Failing defaults to 32Khz clock.
What value needs to be specified for selecting 24MHz clock? You should
mention the available options this property supports.
> +
> +Example for S900:
> +
> +sirq: interrupt-controller@e01b {
> + compatible = "actions,owl-sirq";
> + reg = <0 0xe01b 0 0x1000>;
could be: reg = <0x0 0xe01b 0x0 0x1000>;
> + interrupt-controller;
> + #interrupt-cells = <2>;
> + actions,sirq-clk-sel = <0 0 0>;
> + actions,sirq-offset = <0x200 0x528 0x52c>;
> +};
> +
> +Example for S500 and S700:
> +
> +sirq: interrupt-controller@e01b {
> + compatible = "actions,owl-sirq";
> + reg = <0 0xe01b 0 0x1000>;
For S500, reg base is 0xb01b.
Thanks
Mani
> + interrupt-controller;
> + #interrupt-cells = <2>;
> + actions,sirq-shared-reg;
> + actions,sirq-clk-sel = <0 0 0>;
> + actions,sirq-offset = <0x200 0x200 0x200>;
> +};
> --
> 2.14.4
>
