mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-09-05 20:30:41 +00:00
ba127016c0
This patch rewrites pmc.txt into YAML format. Descriptive texts are expanded or shortened in a few places to better fit today's conventions. The list of compatible strings (and combinations of them) is based on existing device trees in arch/powerpc as well as compatible strings already mentioned in the plain-text version of the binding. One thing I didn't handle are soc-clk@... nodes as seen in arch/powerpc/boot/dts/fsl/pq3-power.dtsi. They are also ignored by Linux drivers. Signed-off-by: J. Neuschäfer <j.ne@posteo.net> Link: https://lore.kernel.org/r/20250417-fslpmc-yaml-v3-1-b3eccd389176@posteo.net Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
153 lines
4.4 KiB
YAML
153 lines
4.4 KiB
YAML
# 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
|
|
- fsl,mpc8641d-pmc
|
|
|
|
description: |
|
|
"fsl,mpc8349-pmc" should be listed for any chip whose PMC is
|
|
compatible. "fsl,mpc8313-pmc" should also be listed for any chip
|
|
whose PMC is compatible, and implies deep-sleep capability.
|
|
|
|
"fsl,mpc8548-pmc" should be listed for any chip whose PMC is
|
|
compatible. "fsl,mpc8536-pmc" should also be listed for any chip
|
|
whose PMC is compatible, and implies deep-sleep capability.
|
|
|
|
"fsl,mpc8641d-pmc" should be listed for any chip whose PMC is
|
|
compatible; all statements below that apply to "fsl,mpc8548-pmc" also
|
|
apply to "fsl,mpc8641d-pmc".
|
|
|
|
Compatibility does not include bit assignments in SCCR/PMCDR/DEVDISR; these
|
|
bit assignments are indicated via the sleep specifier in each device's
|
|
sleep property.
|
|
|
|
reg:
|
|
minItems: 1
|
|
maxItems: 2
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
|
|
fsl,mpc8313-wakeup-timer:
|
|
$ref: /schemas/types.yaml#/definitions/phandle
|
|
description:
|
|
For "fsl,mpc8313-pmc"-compatible devices, this is a phandle to an
|
|
"fsl,gtm" node on which timer 4 can be used as a wakeup source from deep
|
|
sleep.
|
|
|
|
allOf:
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: fsl,mpc8349-pmc
|
|
then:
|
|
properties:
|
|
reg:
|
|
items:
|
|
- description: PMC block
|
|
- description: Clock Configuration block
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- fsl,mpc8548-pmc
|
|
- fsl,mpc8641d-pmc
|
|
then:
|
|
properties:
|
|
reg:
|
|
items:
|
|
- description: 32-byte block beginning with DEVDISR
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/interrupt-controller/irq.h>
|
|
|
|
pmc: power@b00 {
|
|
compatible = "fsl,mpc8377-pmc", "fsl,mpc8349-pmc";
|
|
reg = <0xb00 0x100>, <0xa00 0x100>;
|
|
interrupts = <80 IRQ_TYPE_LEVEL_LOW>;
|
|
};
|
|
|
|
- |
|
|
power@e0070 {
|
|
compatible = "fsl,mpc8548-pmc";
|
|
reg = <0xe0070 0x20>;
|
|
};
|
|
|
|
...
|