Documentation/devicetree/bindings/powerpc/fsl/pmc.yaml
Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/powerpc/fsl/pmc.yaml
File Facts
- System
- Linux kernel
- Corpus path
Documentation/devicetree/bindings/powerpc/fsl/pmc.yaml- Extension
.yaml- Size
- 4537 bytes
- Lines
- 153
- 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.
- Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
Dependency Surface
dt-bindings/interrupt-controller/irq.h
Detected Declarations
- No top-level syscall, struct, function, initcall, or export declaration detected by the generator.
Annotated Snippet
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/powerpc/fsl/pmc.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Power Management Controller
maintainers:
- J. Neuschäfer <j.ne@posteo.net>
description: |
The Power Management Controller in several MPC8xxx SoCs helps save power by
controlling chip-wide low-power states as well as peripheral clock gating.
Sleep of peripheral devices is configured by the `sleep` property, for
example `sleep = <&pmc 0x00000030>`. Any cells after the &pmc phandle are
called a sleep specifier.
For "fsl,mpc8349-pmc", sleep specifiers consist of one cell. For each bit that
is set in the cell, the corresponding bit in SCCR will be saved and cleared
on suspend, and restored on resume. This sleep controller supports disabling
and resuming devices at any time.
For "fsl,mpc8536-pmc", sleep specifiers consist of three cells, the third of
which will be ORed into PMCDR upon suspend, and cleared from PMCDR upon
resume. The first two cells are as described for fsl,mpc8548-pmc. This
sleep controller only supports disabling devices during system sleep, or
permanently.
For "fsl,mpc8548-pmc" or "fsl,mpc8641d-pmc", Sleep specifiers consist of one
or two cells, the first of which will be ORed into DEVDISR (and the second
into DEVDISR2, if present -- this cell should be zero or absent if the
hardware does not have DEVDISR2) upon a request for permanent device
disabling. This sleep controller does not support configuring devices to
disable during system sleep (unless supported by another compatible match),
or dynamically.
properties:
compatible:
oneOf:
- items:
- const: fsl,mpc8315-pmc
- const: fsl,mpc8313-pmc
- const: fsl,mpc8349-pmc
- items:
- enum:
- fsl,mpc8313-pmc
- fsl,mpc8323-pmc
- fsl,mpc8360-pmc
- fsl,mpc8377-pmc
- fsl,mpc8378-pmc
- fsl,mpc8379-pmc
- const: fsl,mpc8349-pmc
- items:
- const: fsl,p1022-pmc
- const: fsl,mpc8536-pmc
- const: fsl,mpc8548-pmc
- items:
- enum:
- fsl,mpc8536-pmc
- fsl,mpc8568-pmc
- fsl,mpc8569-pmc
- const: fsl,mpc8548-pmc
- enum:
- fsl,mpc8548-pmc
Annotation
- Immediate include surface: `dt-bindings/interrupt-controller/irq.h`.
- Atlas domain: Support Tooling And Documentation / Documentation.
- Implementation status: atlas-only.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.