Re: [PATCH v3 2/5] dt-bindings: soc: add document for rockchip reboot notifier driver

From: Andy Yan
Date: Wed Nov 18 2015 - 20:17:53 EST


Hi Rob:

On 2015å11æ19æ 06:59, Rob Herring wrote:
On Wed, Nov 18, 2015 at 05:53:30PM +0800, Andy Yan wrote:
Add devicetree binding document for rockchip reboot nofifier driver
Just reading the subject this is way too specific to the Linux driver
needs rather than a h/w description. Please don't create fake DT nodes
just to bind to drivers. Whatever &pmu is is probably what should have
the DT node. Let the driver for it create child devices if you need
that.

This is note a fake DT nodes, we really need it to tell the driver
which register to use to store the reboot mode. Because rockchip
use different register file to store the reboot mode on different
platform, on rk3066,rk3188, rk3288,it use one of the PMU register, on
the incoming RK3036, it use one of the GRF register, and it use one of
the PMUGRF register for arm64 platform rk3368. On the other hand, the
PMU/GRF/PMUGRF register file are mapped as "syscon", then referenced
by other DT nodes by phandle. So maybe let it as a separate DT node here
is better.

Rob
Signed-off-by: Andy Yan <andy.yan@xxxxxxxxxxxxxx>

---

Changes in v3:
- add dt binding

Changes in v2: None

.../bindings/soc/rockchip/rockchip-reboot.txt | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
create mode 100644 Documentation/devicetree/bindings/soc/rockchip/rockchip-reboot.txt

diff --git a/Documentation/devicetree/bindings/soc/rockchip/rockchip-reboot.txt b/Documentation/devicetree/bindings/soc/rockchip/rockchip-reboot.txt
new file mode 100644
index 0000000..6f69c8d
--- /dev/null
+++ b/Documentation/devicetree/bindings/soc/rockchip/rockchip-reboot.txt
@@ -0,0 +1,18 @@
+Rockchip reboot notifier driver
+
+This driver get reboot mode arguments from userspace
+and stores it in special register. Then the bootloader
+will read it and take different action according the
+argument stored.
+
+Required properties:
+- compatible: should be "rockchip,reboot"
+- regmap: this is phandle to the register map node
+- offset: offset in the register map for the storage register (in bytes)
+
+Examples:
+ reboot {
+ compatible = "rockchip,reboot";
+ regmap = <&pmu>;
+ offset = <0x94>;
+ };
--
1.9.1






--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/