Documentation/devicetree/bindings/memory-controllers/ddr/jedec,sdram-channel.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/memory-controllers/ddr/jedec,sdram-channel.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/memory-controllers/ddr/jedec,sdram-channel.yaml
Extension
.yaml
Size
4242 bytes
Lines
161
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: configuration, schema, or hardware description
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/memory-controllers/ddr/jedec,sdram-channel.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: SDRAM channel with chip/rank topology description

description:
  A memory channel of SDRAM memory like DDR SDRAM or LPDDR SDRAM is a completely
  independent set of pins (DQ, CA, CS, CK, etc.) that connect one or more memory
  chips to a host system. The main purpose of this node is to overall memory
  topology of the system, including the amount of individual memory chips and
  the ranks per chip.

maintainers:
  - Julius Werner <jwerner@chromium.org>

properties:
  $nodename:
    pattern: "sdram-channel-[0-9]+$"

  compatible:
    enum:
      - jedec,ddr4-channel
      - jedec,lpddr2-channel
      - jedec,lpddr3-channel
      - jedec,lpddr4-channel
      - jedec,lpddr5-channel

  io-width:
    description:
      The number of DQ pins in the channel. If this number is different
      from (a multiple of) the io-width of the SDRAM chip, that means that
      multiple instances of that type of chip are wired in parallel on this
      channel (with the channel's DQ pins split up between the different
      chips, and the CA, CS, etc. pins of the different chips all shorted
      together).  This means that the total physical memory controlled by a
      channel is equal to the sum of the densities of each rank on the
      connected SDRAM chip, times the io-width of the channel divided by
      the io-width of the SDRAM chip.
    enum:
      - 8
      - 16
      - 32
      - 64
      - 128

  "#address-cells":
    const: 1

  "#size-cells":
    const: 0

patternProperties:
  "^rank@[0-9]+$":
    type: object
    description:
      Each physical SDRAM chip may have one or more ranks. Ranks are
      internal but fully independent sub-units of the chip. Each SDRAM bus
      transaction on the channel targets exactly one rank, based on the
      state of the CS pins. Different ranks may have different densities and
      timing requirements.
    required:
      - reg

allOf:
  - if:
      properties:
        compatible:

Annotation

Implementation Notes