[PATCH v2 17/21] dt-bindings: serial: document support for SA8255p

From: Nikunj Kela
Date: Tue Sep 03 2024 - 18:08:42 EST


Add compatibles representing UART support on SA8255p.

Clocks and interconnects are being configured in the firmware VM
on SA8255p platform, therefore making them optional.

CC: Praveen Talari <quic_ptalari@xxxxxxxxxxx>
Signed-off-by: Nikunj Kela <quic_nkela@xxxxxxxxxxx>
---
.../serial/qcom,serial-geni-qcom.yaml | 53 ++++++++++++++++---
1 file changed, 47 insertions(+), 6 deletions(-)

diff --git a/Documentation/devicetree/bindings/serial/qcom,serial-geni-qcom.yaml b/Documentation/devicetree/bindings/serial/qcom,serial-geni-qcom.yaml
index dd33794b3534..b63c984684f3 100644
--- a/Documentation/devicetree/bindings/serial/qcom,serial-geni-qcom.yaml
+++ b/Documentation/devicetree/bindings/serial/qcom,serial-geni-qcom.yaml
@@ -10,14 +10,13 @@ maintainers:
- Andy Gross <agross@xxxxxxxxxx>
- Bjorn Andersson <bjorn.andersson@xxxxxxxxxx>

-allOf:
- - $ref: /schemas/serial/serial.yaml#
-
properties:
compatible:
enum:
- qcom,geni-uart
- qcom,geni-debug-uart
+ - qcom,sa8255p-geni-uart
+ - qcom,sa8255p-geni-debug-uart

clocks:
maxItems: 1
@@ -51,18 +50,49 @@ properties:
- const: sleep

power-domains:
- maxItems: 1
+ minItems: 1
+ maxItems: 2
+
+ power-domain-names:
+ items:
+ - const: power
+ - const: perf

reg:
maxItems: 1

required:
- compatible
- - clocks
- - clock-names
- interrupts
- reg

+allOf:
+ - $ref: /schemas/serial/serial.yaml#
+ - if:
+ properties:
+ compatible:
+ contains:
+ enum:
+ - qcom,sa8255p-geni-uart
+ - qcom,sa8255p-geni-debug-uart
+ then:
+ required:
+ - power-domains
+ - power-domain-names
+
+ properties:
+ power-domains:
+ minItems: 2
+
+ else:
+ required:
+ - clocks
+ - clock-names
+
+ properties:
+ power-domains:
+ maxItems: 1
+
unevaluatedProperties: false

examples:
@@ -83,4 +113,15 @@ examples:
<&gem_noc MASTER_APPSS_PROC 0 &config_noc SLAVE_QUP_0 0>;
interconnect-names = "qup-core", "qup-config";
};
+
+ - |
+ #include <dt-bindings/interrupt-controller/arm-gic.h>
+
+ serial@990000 {
+ compatible = "qcom,sa8255p-geni-uart";
+ reg = <0x990000 0x4000>;
+ interrupts = <GIC_SPI 531 IRQ_TYPE_LEVEL_HIGH>;
+ power-domains = <&scmi11_pd 4>, <&scmi11_dvfs 4>;
+ power-domain-names = "power", "perf";
+ };
...
--
2.34.1