[PATCH v5 05/10] dt-bindings: media: Add amlogic,c3-isp.yaml

Keke Li via B4 Relay posted 10 patches 1 year, 1 month ago
There is a newer version of this series
[PATCH v5 05/10] dt-bindings: media: Add amlogic,c3-isp.yaml
Posted by Keke Li via B4 Relay 1 year, 1 month ago
From: Keke Li <keke.li@amlogic.com>

c3-isp is used to process raw image.

Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Signed-off-by: Keke Li <keke.li@amlogic.com>
---
 .../devicetree/bindings/media/amlogic,c3-isp.yaml  | 92 ++++++++++++++++++++++
 MAINTAINERS                                        |  6 ++
 2 files changed, 98 insertions(+)

diff --git a/Documentation/devicetree/bindings/media/amlogic,c3-isp.yaml b/Documentation/devicetree/bindings/media/amlogic,c3-isp.yaml
new file mode 100644
index 000000000000..a33060ac47cb
--- /dev/null
+++ b/Documentation/devicetree/bindings/media/amlogic,c3-isp.yaml
@@ -0,0 +1,92 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/media/amlogic,c3-isp.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Amlogic C3 Image Signal Processing Unit
+
+maintainers:
+  - Keke Li <keke.li@amlogic.com>
+
+description:
+  Amlogic ISP is the RAW image processing module
+  and supports three channels image output.
+
+properties:
+  compatible:
+    enum:
+      - amlogic,c3-isp
+
+  reg:
+    maxItems: 1
+
+  reg-names:
+    items:
+      - const: isp
+
+  power-domains:
+    maxItems: 1
+
+  clocks:
+    maxItems: 2
+
+  clock-names:
+    items:
+      - const: vapb
+      - const: isp0
+
+  assigned-clocks: true
+
+  assigned-clock-rates: true
+
+  interrupts:
+    maxItems: 1
+
+  port:
+    $ref: /schemas/graph.yaml#/properties/port
+    description: input port node.
+
+required:
+  - compatible
+  - reg
+  - reg-names
+  - power-domains
+  - clocks
+  - clock-names
+  - interrupts
+  - port
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/arm-gic.h>
+    #include <dt-bindings/clock/amlogic,c3-peripherals-clkc.h>
+    #include <dt-bindings/power/amlogic,c3-pwrc.h>
+
+    soc {
+        #address-cells = <2>;
+        #size-cells = <2>;
+
+        isp: isp@ff000000 {
+            compatible = "amlogic,c3-isp";
+            reg = <0x0 0xff000000 0x0 0xf000>;
+            reg-names = "isp";
+            power-domains = <&pwrc PWRC_C3_ISP_TOP_ID>;
+            clocks = <&clkc_periphs CLKID_VAPB>,
+                     <&clkc_periphs CLKID_ISP0>;
+            clock-names = "vapb", "isp0";
+            assigned-clocks = <&clkc_periphs CLKID_VAPB>,
+                              <&clkc_periphs CLKID_ISP0>;
+            assigned-clock-rates = <0>, <400000000>;
+            interrupts = <GIC_SPI 145 IRQ_TYPE_EDGE_RISING>;
+
+            port {
+                c3_isp_in: endpoint {
+                    remote-endpoint = <&c3_adap_out>;
+                };
+            };
+        };
+    };
+...
diff --git a/MAINTAINERS b/MAINTAINERS
index 2ef79d99e088..bdf8b24c773f 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -1243,6 +1243,12 @@ F:	Documentation/devicetree/bindings/perf/amlogic,g12-ddr-pmu.yaml
 F:	drivers/perf/amlogic/
 F:	include/soc/amlogic/
 
+AMLOGIC ISP DRIVER
+M:	Keke Li <keke.li@amlogic.com>
+L:	linux-media@vger.kernel.org
+S:	Maintained
+F:	Documentation/devicetree/bindings/media/amlogic,c3-isp.yaml
+
 AMLOGIC MIPI ADAPTER DRIVER
 M:	Keke Li <keke.li@amlogic.com>
 L:	linux-media@vger.kernel.org

-- 
2.47.1
Re: [PATCH v5 05/10] dt-bindings: media: Add amlogic,c3-isp.yaml
Posted by Krzysztof Kozlowski 1 year, 1 month ago
On 27/12/2024 08:09, Keke Li via B4 Relay wrote:
> +
> +  clocks:
> +    maxItems: 2
> +
> +  clock-names:
> +    items:
> +      - const: vapb
> +      - const: isp0
> +
> +  assigned-clocks: true
> +
> +  assigned-clock-rates: true

No, drop these. Request re-review if you add new properties.

Best regards,
Krzysztof
Re: [PATCH v5 05/10] dt-bindings: media: Add amlogic,c3-isp.yaml
Posted by Jacopo Mondi 1 year ago
On Fri, Dec 27, 2024 at 08:22:22AM +0100, Krzysztof Kozlowski wrote:
> On 27/12/2024 08:09, Keke Li via B4 Relay wrote:
> > +
> > +  clocks:
> > +    maxItems: 2
> > +
> > +  clock-names:
> > +    items:
> > +      - const: vapb
> > +      - const: isp0
> > +
> > +  assigned-clocks: true
> > +
> > +  assigned-clock-rates: true
>
> No, drop these. Request re-review if you add new properties.

Why ?

I think the patches should be re-checked and it's fair to ask to drop
the rb tag. But the idea that patches once reviewed should not be
modified between two different versions of the same set seems really..
debatable ?

>
> Best regards,
> Krzysztof
>
Re: [PATCH v5 05/10] dt-bindings: media: Add amlogic,c3-isp.yaml
Posted by Krzysztof Kozlowski 1 year ago
On 22/01/2025 14:38, Jacopo Mondi wrote:
> On Fri, Dec 27, 2024 at 08:22:22AM +0100, Krzysztof Kozlowski wrote:
>> On 27/12/2024 08:09, Keke Li via B4 Relay wrote:
>>> +
>>> +  clocks:
>>> +    maxItems: 2
>>> +
>>> +  clock-names:
>>> +    items:
>>> +      - const: vapb
>>> +      - const: isp0
>>> +
>>> +  assigned-clocks: true
>>> +
>>> +  assigned-clock-rates: true
>>
>> No, drop these. Request re-review if you add new properties.
> 
> Why ?
> 
> I think the patches should be re-checked and it's fair to ask to drop
> the rb tag.

So I asked.

> But the idea that patches once reviewed should not be
> modified between two different versions of the same set seems really..
> debatable ?
No one said that. If you want to modify, no problem, but drop the tag.
You cannot sneak new properties while keeping the review tag.


Best regards,
Krzysztof
Re: [PATCH v5 05/10] dt-bindings: media: Add amlogic,c3-isp.yaml
Posted by Keke Li 1 year, 1 month ago
Hi Krzysztof

Thanks for your reply

On 2024/12/27 15:22, Krzysztof Kozlowski wrote:
> [ EXTERNAL EMAIL ]
>
> On 27/12/2024 08:09, Keke Li via B4 Relay wrote:
>> +
>> +  clocks:
>> +    maxItems: 2
>> +
>> +  clock-names:
>> +    items:
>> +      - const: vapb
>> +      - const: isp0
>> +
>> +  assigned-clocks: true
>> +
>> +  assigned-clock-rates: true
> No, drop these. Request re-review if you add new properties.


OK, will request re-review

Thanks

>
> Best regards,
> Krzysztof