385 lines
13 KiB
YAML
385 lines
13 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
# %YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/memory-controllers/rockchip,rk3399-dmc.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Rockchip rk3399 DMC (Dynamic Memory Controller) device
|
|
|
|
maintainers:
|
|
- Brian Norris <briannorris@chromium.org>
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- rockchip,rk3399-dmc
|
|
|
|
devfreq-events:
|
|
$ref: /schemas/types.yaml#/definitions/phandle
|
|
description:
|
|
Node to get DDR loading. Refer to
|
|
Documentation/devicetree/bindings/devfreq/event/rockchip,dfi.yaml.
|
|
|
|
clocks:
|
|
maxItems: 1
|
|
|
|
clock-names:
|
|
items:
|
|
- const: dmc_clk
|
|
|
|
operating-points-v2: true
|
|
|
|
center-supply:
|
|
description:
|
|
DMC regulator supply.
|
|
|
|
rockchip,pmu:
|
|
$ref: /schemas/types.yaml#/definitions/phandle
|
|
description:
|
|
Phandle to the syscon managing the "PMU general register files".
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
description:
|
|
The CPU interrupt number. It should be a DCF interrupt. When DDR DVFS
|
|
finishes, a DCF interrupt is triggered.
|
|
|
|
rockchip,ddr3_speed_bin:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
For values, reference include/dt-bindings/clock/rk3399-ddr.h. Selects the
|
|
DDR3 cl-trp-trcd type. It must be set according to "Speed Bin" in DDR3
|
|
datasheet; DO NOT use a smaller "Speed Bin" than specified for the DDR3
|
|
being used.
|
|
|
|
rockchip,pd_idle:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
Configure the PD_IDLE value. Defines the power-down idle period in which
|
|
memories are placed into power-down mode if bus is idle for PD_IDLE DFI
|
|
clock cycles.
|
|
See also rockchip,pd-idle-ns.
|
|
|
|
rockchip,sr_idle:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
Configure the SR_IDLE value. Defines the self-refresh idle period in
|
|
which memories are placed into self-refresh mode if bus is idle for
|
|
SR_IDLE * 1024 DFI clock cycles (DFI clocks freq is half of DRAM clock).
|
|
See also rockchip,sr-idle-ns.
|
|
default: 0
|
|
|
|
rockchip,sr_mc_gate_idle:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
Defines the memory self-refresh and controller clock gating idle period.
|
|
Memories are placed into self-refresh mode and memory controller clock
|
|
arg gating started if bus is idle for sr_mc_gate_idle*1024 DFI clock
|
|
cycles.
|
|
See also rockchip,sr-mc-gate-idle-ns.
|
|
|
|
rockchip,srpd_lite_idle:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
Defines the self-refresh power down idle period in which memories are
|
|
placed into self-refresh power down mode if bus is idle for
|
|
srpd_lite_idle * 1024 DFI clock cycles. This parameter is for LPDDR4
|
|
only.
|
|
See also rockchip,srpd-lite-idle-ns.
|
|
|
|
rockchip,standby_idle:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
Defines the standby idle period in which memories are placed into
|
|
self-refresh mode. The controller, pi, PHY and DRAM clock will be gated
|
|
if bus is idle for standby_idle * DFI clock cycles.
|
|
See also rockchip,standby-idle-ns.
|
|
|
|
rockchip,dram_dll_dis_freq:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: |
|
|
Defines the DDR3 DLL bypass frequency in MHz. When DDR frequency is less
|
|
than DRAM_DLL_DISB_FREQ, DDR3 DLL will be bypassed.
|
|
Note: if DLL was bypassed, the odt will also stop working.
|
|
|
|
rockchip,phy_dll_dis_freq:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: |
|
|
Defines the PHY dll bypass frequency in MHz (Mega Hz). When DDR frequency
|
|
is less than DRAM_DLL_DISB_FREQ, PHY DLL will be bypassed.
|
|
Note: PHY DLL and PHY ODT are independent.
|
|
|
|
rockchip,auto_pd_dis_freq:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
Defines the auto PD disable frequency in MHz.
|
|
|
|
rockchip,ddr3_odt_dis_freq:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
minimum: 1000000 # In case anyone thought this was MHz.
|
|
description:
|
|
When the DRAM type is DDR3, this parameter defines the ODT disable
|
|
frequency in Hz. When the DDR frequency is less then ddr3_odt_dis_freq,
|
|
the ODT on the DRAM side and controller side are both disabled.
|
|
|
|
rockchip,ddr3_drv:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is DDR3, this parameter defines the DRAM side drive
|
|
strength in ohms.
|
|
default: 40
|
|
|
|
rockchip,ddr3_odt:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is DDR3, this parameter defines the DRAM side ODT
|
|
strength in ohms.
|
|
default: 120
|
|
|
|
rockchip,phy_ddr3_ca_drv:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is DDR3, this parameter defines the phy side CA line
|
|
(including command line, address line and clock line) drive strength.
|
|
default: 40
|
|
|
|
rockchip,phy_ddr3_dq_drv:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is DDR3, this parameter defines the PHY side DQ line
|
|
(including DQS/DQ/DM line) drive strength.
|
|
default: 40
|
|
|
|
rockchip,phy_ddr3_odt:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is DDR3, this parameter defines the PHY side ODT
|
|
strength.
|
|
default: 240
|
|
|
|
rockchip,lpddr3_odt_dis_freq:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
minimum: 1000000 # In case anyone thought this was MHz.
|
|
description:
|
|
When the DRAM type is LPDDR3, this parameter defines then ODT disable
|
|
frequency in Hz. When DDR frequency is less then ddr3_odt_dis_freq, the
|
|
ODT on the DRAM side and controller side are both disabled.
|
|
|
|
rockchip,lpddr3_drv:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is LPDDR3, this parameter defines the DRAM side drive
|
|
strength in ohms.
|
|
default: 34
|
|
|
|
rockchip,lpddr3_odt:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is LPDDR3, this parameter defines the DRAM side ODT
|
|
strength in ohms.
|
|
default: 240
|
|
|
|
rockchip,phy_lpddr3_ca_drv:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is LPDDR3, this parameter defines the PHY side CA line
|
|
(including command line, address line and clock line) drive strength.
|
|
default: 40
|
|
|
|
rockchip,phy_lpddr3_dq_drv:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is LPDDR3, this parameter defines the PHY side DQ line
|
|
(including DQS/DQ/DM line) drive strength.
|
|
default: 40
|
|
|
|
rockchip,phy_lpddr3_odt:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When dram type is LPDDR3, this parameter define the phy side odt
|
|
strength, default value is 240.
|
|
|
|
rockchip,lpddr4_odt_dis_freq:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
minimum: 1000000 # In case anyone thought this was MHz.
|
|
description:
|
|
When the DRAM type is LPDDR4, this parameter defines the ODT disable
|
|
frequency in Hz. When the DDR frequency is less then ddr3_odt_dis_freq,
|
|
the ODT on the DRAM side and controller side are both disabled.
|
|
|
|
rockchip,lpddr4_drv:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is LPDDR4, this parameter defines the DRAM side drive
|
|
strength in ohms.
|
|
default: 60
|
|
|
|
rockchip,lpddr4_dq_odt:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is LPDDR4, this parameter defines the DRAM side ODT on
|
|
DQS/DQ line strength in ohms.
|
|
default: 40
|
|
|
|
rockchip,lpddr4_ca_odt:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is LPDDR4, this parameter defines the DRAM side ODT on
|
|
CA line strength in ohms.
|
|
default: 40
|
|
|
|
rockchip,phy_lpddr4_ca_drv:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is LPDDR4, this parameter defines the PHY side CA line
|
|
(including command address line) drive strength.
|
|
default: 40
|
|
|
|
rockchip,phy_lpddr4_ck_cs_drv:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is LPDDR4, this parameter defines the PHY side clock
|
|
line and CS line drive strength.
|
|
default: 80
|
|
|
|
rockchip,phy_lpddr4_dq_drv:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is LPDDR4, this parameter defines the PHY side DQ line
|
|
(including DQS/DQ/DM line) drive strength.
|
|
default: 80
|
|
|
|
rockchip,phy_lpddr4_odt:
|
|
deprecated: true
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description:
|
|
When the DRAM type is LPDDR4, this parameter defines the PHY side ODT
|
|
strength.
|
|
default: 60
|
|
|
|
rockchip,pd-idle-ns:
|
|
description:
|
|
Configure the PD_IDLE value in nanoseconds. Defines the power-down idle
|
|
period in which memories are placed into power-down mode if bus is idle
|
|
for PD_IDLE nanoseconds.
|
|
|
|
rockchip,sr-idle-ns:
|
|
description:
|
|
Configure the SR_IDLE value in nanoseconds. Defines the self-refresh idle
|
|
period in which memories are placed into self-refresh mode if bus is idle
|
|
for SR_IDLE nanoseconds.
|
|
default: 0
|
|
|
|
rockchip,sr-mc-gate-idle-ns:
|
|
description:
|
|
Defines the memory self-refresh and controller clock gating idle period in nanoseconds.
|
|
Memories are placed into self-refresh mode and memory controller clock
|
|
arg gating started if bus is idle for sr_mc_gate_idle nanoseconds.
|
|
|
|
rockchip,srpd-lite-idle-ns:
|
|
description:
|
|
Defines the self-refresh power down idle period in which memories are
|
|
placed into self-refresh power down mode if bus is idle for
|
|
srpd_lite_idle nanoseconds. This parameter is for LPDDR4 only.
|
|
|
|
rockchip,standby-idle-ns:
|
|
description:
|
|
Defines the standby idle period in which memories are placed into
|
|
self-refresh mode. The controller, pi, PHY and DRAM clock will be gated
|
|
if bus is idle for standby_idle nanoseconds.
|
|
|
|
rockchip,pd-idle-dis-freq-hz:
|
|
description:
|
|
Defines the power-down idle disable frequency in Hz. When the DDR
|
|
frequency is greater than pd-idle-dis-freq, power-down idle is disabled.
|
|
See also rockchip,pd-idle-ns.
|
|
|
|
rockchip,sr-idle-dis-freq-hz:
|
|
description:
|
|
Defines the self-refresh idle disable frequency in Hz. When the DDR
|
|
frequency is greater than sr-idle-dis-freq, self-refresh idle is
|
|
disabled. See also rockchip,sr-idle-ns.
|
|
|
|
rockchip,sr-mc-gate-idle-dis-freq-hz:
|
|
description:
|
|
Defines the self-refresh and memory-controller clock gating disable
|
|
frequency in Hz. When the DDR frequency is greater than
|
|
sr-mc-gate-idle-dis-freq, the clock will not be gated when idle. See also
|
|
rockchip,sr-mc-gate-idle-ns.
|
|
|
|
rockchip,srpd-lite-idle-dis-freq-hz:
|
|
description:
|
|
Defines the self-refresh power down idle disable frequency in Hz. When
|
|
the DDR frequency is greater than srpd-lite-idle-dis-freq, memory will
|
|
not be placed into self-refresh power down mode when idle. See also
|
|
rockchip,srpd-lite-idle-ns.
|
|
|
|
rockchip,standby-idle-dis-freq-hz:
|
|
description:
|
|
Defines the standby idle disable frequency in Hz. When the DDR frequency
|
|
is greater than standby-idle-dis-freq, standby idle is disabled. See also
|
|
rockchip,standby-idle-ns.
|
|
|
|
required:
|
|
- compatible
|
|
- devfreq-events
|
|
- clocks
|
|
- clock-names
|
|
- operating-points-v2
|
|
- center-supply
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/clock/rk3399-cru.h>
|
|
#include <dt-bindings/interrupt-controller/arm-gic.h>
|
|
memory-controller {
|
|
compatible = "rockchip,rk3399-dmc";
|
|
devfreq-events = <&dfi>;
|
|
rockchip,pmu = <&pmu>;
|
|
interrupts = <GIC_SPI 1 IRQ_TYPE_LEVEL_HIGH>;
|
|
clocks = <&cru SCLK_DDRC>;
|
|
clock-names = "dmc_clk";
|
|
operating-points-v2 = <&dmc_opp_table>;
|
|
center-supply = <&ppvar_centerlogic>;
|
|
rockchip,pd-idle-ns = <160>;
|
|
rockchip,sr-idle-ns = <10240>;
|
|
rockchip,sr-mc-gate-idle-ns = <40960>;
|
|
rockchip,srpd-lite-idle-ns = <61440>;
|
|
rockchip,standby-idle-ns = <81920>;
|
|
rockchip,ddr3_odt_dis_freq = <333000000>;
|
|
rockchip,lpddr3_odt_dis_freq = <333000000>;
|
|
rockchip,lpddr4_odt_dis_freq = <333000000>;
|
|
rockchip,pd-idle-dis-freq-hz = <1000000000>;
|
|
rockchip,sr-idle-dis-freq-hz = <1000000000>;
|
|
rockchip,sr-mc-gate-idle-dis-freq-hz = <1000000000>;
|
|
rockchip,srpd-lite-idle-dis-freq-hz = <0>;
|
|
rockchip,standby-idle-dis-freq-hz = <928000000>;
|
|
};
|