Thread (36 messages) 36 messages, 6 authors, 2024-11-08

Re: [PATCH 8/9] dt-bindings: Add documentation for Photonicat PMU

From: Krzysztof Kozlowski <krzk@kernel.org>
Date: 2024-09-08 08:14:02
Also in: linux-devicetree, linux-hwmon, linux-leds, linux-pm, linux-rockchip, linux-rtc, linux-watchdog, lkml

On 07/09/2024 16:27, Junhao Xie wrote:
quoted
quoted
+
[...]
quoted
quoted
+  local-address:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    minimum: 1
+    maximum: 127
+    default: 1
+    description: CPU board address
Address of what? In which notation? It's part of this hardware.
Photonicat's MCU protocol documentation says it supports multiple hosts.
But Photonicat only uses one.
Is it necessary to remove local-address and use a fixed address?
I don't understand what this "address" is for.
quoted
quoted
+
+  remote-address:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    minimum: 1
+    maximum: 127
+    default: 1
+    description: PMU board address
Eee, no. Your board knows its address. You do not have to tell it.
I will remove remote-address.
quoted
[...]
quoted
quoted
+
+patternProperties:
+  '^leds-(status)':
That's not a pattern.
I originally wanted to keep it for extensions, but it didn't seem like a good idea.
I will move it to properties.
quoted
quoted
+    $ref: /schemas/leds/ariaboard,photonicat-pmu-leds.yaml
+
+  '^supply-(battery|charger)$':
+    $ref: /schemas/power/supply/ariaboard,photonicat-pmu-supply.yaml
Why two nodes?
quoted
+
+required:
+  - compatible
+
+additionalProperties: false
+
+examples:
+  - |
+      serial {
+          photonicat-pmu {
+              compatible = "ariaboard,photonicat-pmu";
+              current-speed = <115200>;
+              local-address = <1>;
+              remote-address = <1>;
+
+              supply-battery {
+                  compatible = "ariaboard,photonicat-pmu-supply";
+                  label = "battery";
Nope, drop label.
quoted
+                  type = "battery";
No, there is no type property.
There are two supplies here, one is the charger and the other is the battery.
Is it necessary to change to use different compatible ones like
ariaboard,photonicat-pmu-battery and ariaboard,photonicat-pmu-charger?
Are the devices different? Why do you even need the type?
quoted
Missing monitored battery.
I will add it.
quoted
quoted
+              };
+
[...]
quoted
quoted
+
+              watchdog {
+                  compatible = "ariaboard,photonicat-pmu-watchdog";
+              };
These are seriously redundant and useless nodes.  There is nothing
beneficial from the nodes above - they are all empty, without resources.
Drop all of them.
How should I describe these devices? Using mfd_cell?
You mean drivers? MFD or auxiliary bus.

Best regards,
Krzysztof

Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help