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

Andy Yan
2015-11-19T01:17:37Z

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@rock-chips.com>
>>
>> ---
>>
>> 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
>>
>>
>
>