On Thu, Jan 18, 2018 at 03:28:02PM -0700, Lina Iyer wrote: > From: Mahesh Sivasubramanian <msivasub@xxxxxxxxxxxxxx> > > Command DB provides information on shared resources like clocks, > regulators etc., probed at boot by the remote subsytem and made > available in shared memory. > > Cc: devicetree@xxxxxxxxxxxxxxx > Signed-off-by: Mahesh Sivasubramanian <msivasub@xxxxxxxxxxxxxx> > Signed-off-by: Lina Iyer <ilina@xxxxxxxxxxxxxx> > --- > .../devicetree/bindings/arm/msm/cmd-db.txt | 37 ++++++++++++++++++++++ > 1 file changed, 37 insertions(+) > create mode 100644 Documentation/devicetree/bindings/arm/msm/cmd-db.txt > > diff --git a/Documentation/devicetree/bindings/arm/msm/cmd-db.txt b/Documentation/devicetree/bindings/arm/msm/cmd-db.txt > new file mode 100644 > index 000000000000..b56e3e3604d3 > --- /dev/null > +++ b/Documentation/devicetree/bindings/arm/msm/cmd-db.txt > @@ -0,0 +1,37 @@ > +Command DB > +--------- Another strange QCom binding... > + > +Command DB is a database that provides a mapping between resource key and the > +resource address for a system resource managed by a remote processor. The data > +is stored in a shared memory region and is loaded by the remote processor. Is said shared memory described in DT. If so, this should be a child node. Only 8 bytes seems kind of fine grained for putting in DT when it could be implied by the parent shared memory node. > + > +Some of the Qualcomm Technologies Inc SoC's have hardware accelerators for > +controlling shared resources. Depending on the board configuration the shared > +resource properties may change. These properties are dynamically probed by the > +remote processor and made available in the shared memory. The table may change, but does the presence of it or shared memory location (of the pointer) change? > + > +Command DB allows drivers to query resource parameters based on pre-determined > +key strings. > + > +The devicetree representation of the command DB driver should be: > + > +PROPERTIES: > +- compatible: > + Usage: required > + Value type: <string> > + Definition: Should be "qcom,cmd-db" > + > +- reg: > + Usage: required > + Value type: <prop-encoded-array> > + Definition: First element is the base address of shared memory > + Second element is the size of the shared memory region > + Points to the dictionary address that houses the command DB > + start address and the size of the command DB region > + > +Example: > + > + qcom,cmd-db@c3f000c { > + compatible = "qcom,cmd-db"; > + reg = <0xc3f000c 0x8>; > + }; > -- > The Qualcomm Innovation Center, Inc. is a member of the Code Aurora Forum, > a Linux Foundation Collaborative Project > > -- > To unsubscribe from this list: send the line "unsubscribe devicetree" in > the body of a message to majordomo@xxxxxxxxxxxxxxx > More majordomo info at http://vger.kernel.org/majordomo-info.html -- To unsubscribe from this list: send the line "unsubscribe linux-soc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html