xref: /freebsd/sys/contrib/device-tree/Bindings/soc/rockchip/grf.txt (revision bdd1243df58e60e85101c09001d9812a789b6bc4)
1* Rockchip General Register Files (GRF)
2
3The general register file will be used to do static set by software, which
4is composed of many registers for system control.
5
6From RK3368 SoCs, the GRF is divided into two sections,
7- GRF, used for general non-secure system,
8- SGRF, used for general secure system,
9- PMUGRF, used for always on system
10
11On RK3328 SoCs, the GRF adds a section for USB2PHYGRF,
12
13ON RK3308 SoC, the GRF is divided into four sections:
14- GRF, used for general non-secure system,
15- SGRF, used for general secure system,
16- DETECTGRF, used for audio codec system,
17- COREGRF, used for pvtm,
18
19Required Properties:
20
21- compatible: GRF should be one of the following:
22   - "rockchip,px30-grf", "syscon": for px30
23   - "rockchip,rk3036-grf", "syscon": for rk3036
24   - "rockchip,rk3066-grf", "syscon": for rk3066
25   - "rockchip,rk3188-grf", "syscon": for rk3188
26   - "rockchip,rk3228-grf", "syscon": for rk3228
27   - "rockchip,rk3288-grf", "syscon": for rk3288
28   - "rockchip,rk3308-grf", "syscon": for rk3308
29   - "rockchip,rk3328-grf", "syscon": for rk3328
30   - "rockchip,rk3368-grf", "syscon": for rk3368
31   - "rockchip,rk3399-grf", "syscon": for rk3399
32   - "rockchip,rv1108-grf", "syscon": for rv1108
33- compatible: DETECTGRF should be one of the following:
34   - "rockchip,rk3308-detect-grf", "syscon": for rk3308
35- compatilbe: COREGRF should be one of the following:
36   - "rockchip,rk3308-core-grf", "syscon": for rk3308
37- compatible: PMUGRF should be one of the following:
38   - "rockchip,px30-pmugrf", "syscon": for px30
39   - "rockchip,rk3368-pmugrf", "syscon": for rk3368
40   - "rockchip,rk3399-pmugrf", "syscon": for rk3399
41- compatible: SGRF should be one of the following:
42   - "rockchip,rk3288-sgrf", "syscon": for rk3288
43- compatible: USB2PHYGRF should be one of the following:
44   - "rockchip,px30-usb2phy-grf", "syscon": for px30
45   - "rockchip,rk3328-usb2phy-grf", "syscon": for rk3328
46- compatible: USBGRF should be one of the following:
47   - "rockchip,rv1108-usbgrf", "syscon": for rv1108
48- reg: physical base address of the controller and length of memory mapped
49  region.
50
51Example: GRF and PMUGRF of RK3399 SoCs
52
53	pmugrf: syscon@ff320000 {
54		compatible = "rockchip,rk3399-pmugrf", "syscon";
55		reg = <0x0 0xff320000 0x0 0x1000>;
56	};
57
58	grf: syscon@ff770000 {
59		compatible = "rockchip,rk3399-grf", "syscon";
60		reg = <0x0 0xff770000 0x0 0x10000>;
61	};
62