summaryrefslogtreecommitdiff
path: root/zephyr/dts/bindings/power
diff options
context:
space:
mode:
Diffstat (limited to 'zephyr/dts/bindings/power')
-rw-r--r--zephyr/dts/bindings/power/intel,ap-pwr-signal-emul.yaml124
-rw-r--r--zephyr/dts/bindings/power/intel,ap-pwr-test-platform.yaml18
2 files changed, 142 insertions, 0 deletions
diff --git a/zephyr/dts/bindings/power/intel,ap-pwr-signal-emul.yaml b/zephyr/dts/bindings/power/intel,ap-pwr-signal-emul.yaml
new file mode 100644
index 0000000000..1863349892
--- /dev/null
+++ b/zephyr/dts/bindings/power/intel,ap-pwr-signal-emul.yaml
@@ -0,0 +1,124 @@
+ # Copyright 2022 The ChromiumOS Authors
+ # Use of this source code is governed by a BSD-style license that can be
+ # found in the LICENSE file.
+
+description: |
+ Power Signal Emulator Node
+
+ Power signal emulator allows executing AP Power Sequence in a virtual
+ environment by simulating power signals behavior.
+
+ This file defines a node to bind two or more power signals. A node connects
+ one input-signal with one or more output-signals. When a node is loaded and
+ initialized by power signal emulator, its input-signal state will control
+ the value of its children output-signals. Behavior of output-signals are
+ configurable to meet AP power sequence test cases.
+
+ Power Signals direction is determined from emulator node perspective. An input
+ signal in a node, is the one to be monitored by the emulator, while an output
+ signal gets its value altered when corresponding input signal's state changes.
+
+compatible: "intel,ap-pwr-signal-emul"
+
+properties:
+ input-signal:
+ type: phandle
+ required: true
+ description: |
+ Input signal whose value is monitored to control children output-signal`s
+ value.
+
+ assert-value:
+ type: int
+ required: false
+ default: 1
+ description: |
+ Value that indicates `input-signal` must be ASSERTED.
+
+ A power signal state can be ASSERTED or DEASSERTED.`input-signal` is only
+ considered asserted if its new value is equal to `assert-value`, any
+ other value makes it deasserted.
+
+ edge:
+ type: string
+ required: false
+ description: |
+ Controls when to trigger children value change, based on `input-signal`
+ new state.
+
+ EDGE_ACTIVE_ON_ASSERT: Children value changes only when `input-signal`
+ state changes into asserted.
+
+ EDGE_ACTIVE_ON_DEASSERT: Children value changes only when `input-signal`
+ state changes into deasserted.
+
+ EDGE_ACTIVE_ON_DEASSERT: Children value changes everytime `input-signal`
+ state changes.
+
+ default: EDGE_ACTIVE_ON_BOTH
+ enum:
+ - EDGE_ACTIVE_ON_ASSERT
+ - EDGE_ACTIVE_ON_DEASSERT
+ - EDGE_ACTIVE_ON_BOTH
+
+ init-value:
+ type: int
+ required: false
+ description: |
+ Initial value of `input-signal`.
+
+child-binding:
+ description: |
+ Child power signals configuration.
+
+ properties:
+ output-signal:
+ type: phandle
+ required: true
+ description: |
+ Output signal whose value will be controlled by parent `input-signal`
+ state.
+
+ assert-value:
+ type: int
+ required: false
+ default: 1
+ description: |
+ Value that will be assigned to this signal when parent `input-signal`
+ state is asserted.
+
+ assert-delay-ms:
+ type: int
+ required: false
+ default: 10
+ description: |
+ Milliseconds to delay setting this signal to its `assert-value`
+ after `input-signal` is asserted.
+
+ deassert-value:
+ type: int
+ required: false
+ default: 0
+ description: |
+ Value that will be assigned to this signal when parent `input-signal`
+ state is deasserted.
+
+ deassert-delay-ms:
+ type: int
+ required: false
+ default: 10
+ description: |
+ Milliseconds to delay setting this signal to its `deassert-value`
+ after `input-signal` is deasserted.
+
+ init-value:
+ type: int
+ required: false
+ description: |
+ Value set to this power signal when initializing this node.
+
+ invert-value:
+ type: boolean
+ description: |
+ Invert this power signal assertion logic, this applies to both values
+ and delays.
diff --git a/zephyr/dts/bindings/power/intel,ap-pwr-test-platform.yaml b/zephyr/dts/bindings/power/intel,ap-pwr-test-platform.yaml
new file mode 100644
index 0000000000..c2f7e10cd1
--- /dev/null
+++ b/zephyr/dts/bindings/power/intel,ap-pwr-test-platform.yaml
@@ -0,0 +1,18 @@
+ # Copyright 2022 The Chromium OS Authors. All rights reserved.
+ # Use of this source code is governed by a BSD-style license that can be
+ # found in the LICENSE file.
+
+description: |
+ Power Signal Test Platform
+
+ This is a virtual representation of platform comprised of one or more power
+ signal emulator nodes. Test platform is loaded into power signal emulator.
+
+compatible: "intel,ap-pwr-test-platform"
+
+properties:
+ nodes:
+ type: phandles
+ required: true
+ description: |
+ phandle array of power signals nodes to be run by emulator.