48 lines · yaml
1# SPDX-License-Identifier: GPL-2.0-only2%YAML 1.23---4$id: http://devicetree.org/schemas/powerpc/sleep.yaml#5$schema: http://devicetree.org/meta-schemas/core.yaml#6 7title: PowerPC sleep property8 9maintainers:10 - Rob Herring <robh@kernel.org>11 12description: |13 Devices on SOCs often have mechanisms for placing devices into low-power14 states that are decoupled from the devices' own register blocks. Sometimes,15 this information is more complicated than a cell-index property can16 reasonably describe. Thus, each device controlled in such a manner17 may contain a "sleep" property which describes these connections.18 19 The sleep property consists of one or more sleep resources, each of20 which consists of a phandle to a sleep controller, followed by a21 controller-specific sleep specifier of zero or more cells.22 23 The semantics of what type of low power modes are possible are defined24 by the sleep controller. Some examples of the types of low power modes25 that may be supported are:26 27 - Dynamic: The device may be disabled or enabled at any time.28 - System Suspend: The device may request to be disabled or remain29 awake during system suspend, but will not be disabled until then.30 - Permanent: The device is disabled permanently (until the next hard31 reset).32 33 Some devices may share a clock domain with each other, such that they should34 only be suspended when none of the devices are in use. Where reasonable,35 such nodes should be placed on a virtual bus, where the bus has the sleep36 property. If the clock domain is shared among devices that cannot be37 reasonably grouped in this manner, then create a virtual sleep controller38 (similar to an interrupt nexus, except that defining a standardized39 sleep-map should wait until its necessity is demonstrated).40 41select: true42 43properties:44 sleep:45 $ref: /schemas/types.yaml#/definitions/phandle-array46 47additionalProperties: true48