summaryrefslogtreecommitdiff
path: root/doc/device-tree-bindings/clock/rockchip,rk3368-dmc.txt
blob: 8e7357d53d3e25ba067f473429f98ae1aca10c44 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
RK3368 dynamic memory controller driver
=======================================

The RK3368 DMC (dynamic memory controller) driver supports setup/initialisation
during TPL using configuration data from the DTS (i.e. OF_PLATDATA), based on
the following key configuration data:
  (a) a target-frequency (i.e. operating point) for the memory operation
  (b) a speed-bin (as defined in JESD-79) for the DDR3 used in hardware
  (c) a memory-schedule (i.e. mapping from physical addresses to the address
      pins of the memory bus)

Required properties
-------------------

- compatible: "rockchip,rk3368-dmc"
- reg
    protocol controller (PCTL) address and PHY controller (DDRPHY) address
- rockchip,ddr-speed-bin
    the DDR3 device's speed-bin (as specified according to JESD-79)
        DDR3_800D (5-5-5)
        DDR3_800E (6-6-6)
        DDR3_1066E (6-6-6)
        DDR3_1066F (7-7-7)
        DDR3_1066G (8-8-8)
        DDR3_1333F (7-7-7)
        DDR3_1333G (8-8-8)
        DDR3_1333H (9-9-9)
        DDR3_1333J (10-10-10)
        DDR3_1600G (8-8-8)
        DDR3_1600H (9-9-9)
        DDR3_1600J (10-10-10)
        DDR3_1600K (11-11-11)
        DDR3_1866J (10-10-10)
        DDR3_1866K (11-11-11)
        DDR3_1866L (12-12-12)
        DDR3_1866M (13-13-13)
        DDR3_2133K (11-11-11)
        DDR3_2133L (12-12-12)
        DDR3_2133M (13-13-13)
        DDR3_2133N (14-14-14)
- rockchip,ddr-frequency:
    target DDR clock frequency in Hz (not all frequencies may be supported,
    as there's some cooperation from the clock-driver required)
- rockchip,memory-schedule:
    controls the decoding of physical addresses to DRAM addressing (i.e. how
    the physical address maps onto the address pins/chip-select of the device)
	DMC_MSCH_CBDR: column -> bank -> device -> row
	DMC_MSCH_CBRD: column -> band -> row -> device
	DMC_MSCH_CRBD: column -> row -> band -> device

Example (for DDR3-1600K and 800MHz)
-----------------------------------

	#include <dt-bindings/memory/rk3368-dmc.h>

	dmc: dmc@ff610000 {
	        u-boot,dm-pre-reloc;
		compatible = "rockchip,rk3368-dmc";
		reg = <0 0xff610000 0 0x400
		       0 0xff620000 0 0x400>;
	};

	&dmc {
		rockchip,ddr-speed-bin = <DDR3_1600K>;
		rockchip,ddr-frequency = <800000000>;
		rockchip,memory-schedule = <DMC_MSCH_CBRD>;
	};