xref: /freebsd-src/sys/contrib/device-tree/Bindings/hwlock/qcom-hwspinlock.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel VadotQualcomm Hardware Mutex Block:
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotThe hardware block provides mutexes utilized between different processors on
4*c66ec88fSEmmanuel Vadotthe SoC as part of the communication protocol used by these processors.
5*c66ec88fSEmmanuel Vadot
6*c66ec88fSEmmanuel Vadot- compatible:
7*c66ec88fSEmmanuel Vadot	Usage: required
8*c66ec88fSEmmanuel Vadot	Value type: <string>
9*c66ec88fSEmmanuel Vadot	Definition: must be one of:
10*c66ec88fSEmmanuel Vadot		    "qcom,sfpb-mutex",
11*c66ec88fSEmmanuel Vadot		    "qcom,tcsr-mutex"
12*c66ec88fSEmmanuel Vadot
13*c66ec88fSEmmanuel Vadot- syscon:
14*c66ec88fSEmmanuel Vadot	Usage: required
15*c66ec88fSEmmanuel Vadot	Value type: <prop-encoded-array>
16*c66ec88fSEmmanuel Vadot	Definition: one cell containing:
17*c66ec88fSEmmanuel Vadot		    syscon phandle
18*c66ec88fSEmmanuel Vadot		    offset of the hwmutex block within the syscon
19*c66ec88fSEmmanuel Vadot		    stride of the hwmutex registers
20*c66ec88fSEmmanuel Vadot
21*c66ec88fSEmmanuel Vadot- #hwlock-cells:
22*c66ec88fSEmmanuel Vadot	Usage: required
23*c66ec88fSEmmanuel Vadot	Value type: <u32>
24*c66ec88fSEmmanuel Vadot	Definition: must be 1, the specified cell represent the lock id
25*c66ec88fSEmmanuel Vadot		    (hwlock standard property, see hwlock.txt)
26*c66ec88fSEmmanuel Vadot
27*c66ec88fSEmmanuel VadotExample:
28*c66ec88fSEmmanuel Vadot
29*c66ec88fSEmmanuel Vadot	tcsr_mutex_block: syscon@fd484000 {
30*c66ec88fSEmmanuel Vadot		compatible = "syscon";
31*c66ec88fSEmmanuel Vadot		reg = <0xfd484000 0x2000>;
32*c66ec88fSEmmanuel Vadot	};
33*c66ec88fSEmmanuel Vadot
34*c66ec88fSEmmanuel Vadot	hwlock@fd484000 {
35*c66ec88fSEmmanuel Vadot		compatible = "qcom,tcsr-mutex";
36*c66ec88fSEmmanuel Vadot		syscon = <&tcsr_mutex_block 0 0x80>;
37*c66ec88fSEmmanuel Vadot
38*c66ec88fSEmmanuel Vadot		#hwlock-cells = <1>;
39*c66ec88fSEmmanuel Vadot	};
40