xref: /freebsd-src/sys/contrib/device-tree/Bindings/reserved-memory/qcom,cmd-db.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel VadotCommand DB
2*c66ec88fSEmmanuel Vadot---------
3*c66ec88fSEmmanuel Vadot
4*c66ec88fSEmmanuel VadotCommand DB is a database that provides a mapping between resource key and the
5*c66ec88fSEmmanuel Vadotresource address for a system resource managed by a remote processor. The data
6*c66ec88fSEmmanuel Vadotis stored in a shared memory region and is loaded by the remote processor.
7*c66ec88fSEmmanuel Vadot
8*c66ec88fSEmmanuel VadotSome of the Qualcomm Technologies Inc SoC's have hardware accelerators for
9*c66ec88fSEmmanuel Vadotcontrolling shared resources. Depending on the board configuration the shared
10*c66ec88fSEmmanuel Vadotresource properties may change. These properties are dynamically probed by the
11*c66ec88fSEmmanuel Vadotremote processor and made available in the shared memory.
12*c66ec88fSEmmanuel Vadot
13*c66ec88fSEmmanuel VadotThe bindings for Command DB is specified in the reserved-memory section in
14*c66ec88fSEmmanuel Vadotdevicetree. The devicetree representation of the command DB driver should be:
15*c66ec88fSEmmanuel Vadot
16*c66ec88fSEmmanuel VadotProperties:
17*c66ec88fSEmmanuel Vadot- compatible:
18*c66ec88fSEmmanuel Vadot	Usage: required
19*c66ec88fSEmmanuel Vadot	Value type: <string>
20*c66ec88fSEmmanuel Vadot	Definition: Should be "qcom,cmd-db"
21*c66ec88fSEmmanuel Vadot
22*c66ec88fSEmmanuel Vadot- reg:
23*c66ec88fSEmmanuel Vadot	Usage: required
24*c66ec88fSEmmanuel Vadot	Value type: <prop encoded array>
25*c66ec88fSEmmanuel Vadot	Definition: The register address that points to the actual location of
26*c66ec88fSEmmanuel Vadot		    the Command DB in memory.
27*c66ec88fSEmmanuel Vadot
28*c66ec88fSEmmanuel VadotExample:
29*c66ec88fSEmmanuel Vadot
30*c66ec88fSEmmanuel Vadot	reserved-memory {
31*c66ec88fSEmmanuel Vadot		[...]
32*c66ec88fSEmmanuel Vadot		reserved-memory@85fe0000 {
33*c66ec88fSEmmanuel Vadot			reg = <0x0 0x85fe0000 0x0 0x20000>;
34*c66ec88fSEmmanuel Vadot			compatible = "qcom,cmd-db";
35*c66ec88fSEmmanuel Vadot			no-map;
36*c66ec88fSEmmanuel Vadot		};
37*c66ec88fSEmmanuel Vadot	};
38