[PATCH v2 1/3] dt-bindings: reset: Scope the compatible to VO subsystem explicitly

[Yao Zi]

The reset controller driver for the TH1520 was using the generic
compatible string "thead,th1520-reset". However, the controller
described by this compatible only manages the resets for the Video
Output (VO) subsystem.

Using a generic compatible is confusing as it implies control over all
reset units on the SoC. This could lead to conflicts if support for
other reset controllers on the TH1520 is added in the future like AP.

Let's introduce a new compatible string, "thead,th1520-reset-vo", to
explicitly scope the controller to VO-subsystem. The old one is marked
as deprecated.

Fixes: 30e7573babdc ("dt-bindings: reset: Add T-HEAD TH1520 SoC Reset Controller")
Cc: stable at vger.kernel.org
Reported-by: Icenowy Zheng <uwu at icenowy.me>
Co-developed-by: Michal Wilczynski <m.wilczynski at samsung.com>
Signed-off-by: Michal Wilczynski <m.wilczynski at samsung.com>
Signed-off-by: Yao Zi <ziyao at disroot.org>
---
 .../bindings/reset/thead,th1520-reset.yaml      | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/Documentation/devicetree/bindings/reset/thead,th1520-reset.yaml b/Documentation/devicetree/bindings/reset/thead,th1520-reset.yaml
index f2e91d0add7a..3930475dcc04 100644
--- a/Documentation/devicetree/bindings/reset/thead,th1520-reset.yaml
+++ b/Documentation/devicetree/bindings/reset/thead,th1520-reset.yaml
@@ -15,8 +15,11 @@ maintainers:
 
 properties:
   compatible:
-    enum:
-      - thead,th1520-reset
+    oneOf:
+      - enum:
+          - thead,th1520-reset-vo
+      - const: thead,th1520-reset
+        deprecated: true
 
   reg:
     maxItems: 1
@@ -33,12 +36,8 @@ additionalProperties: false
 
 examples:
   - |
-    soc {
-      #address-cells = <2>;
-      #size-cells = <2>;
-      rst: reset-controller at ffef528000 {
-        compatible = "thead,th1520-reset";
-        reg = <0xff 0xef528000 0x0 0x1000>;
+    reset-controller at ffef528000 {
+        compatible = "thead,th1520-reset-vo";
+        reg = <0xef528000 0x1000>;
         #reset-cells = <1>;
-      };
     };
-- 
2.50.1