ap_pwrseq: Implement AP power sequencer driver underlying framework

This CL establishes an underlaying framework to easily add or extend
AP Power Sequence routines, it is designed to follow the zephyr's State
Machine Framework (SMF).

This CL includes the following:
- Macros definition to incorporate state machine action handlers
  implementation for all three levels: Application, chipset and
  architecture.
- Devicetree binding declaration to allow creating additional powert
  states.
- Implementation of API's to interact with state machine.

BUG=b:217952699
BRANCH=none
TEST=zmake build

Signed-off-by: Bernardo Perez Priego <bernardo.perez.priego@intel.com>
Change-Id: Ic9ee7b81795d43eea8bb1ed3d78bd2cc2f5df0e1
Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/platform/ec/+/4098524
Reviewed-by: Peter Marheine <pmarheine@chromium.org>

1 files changed, 23 insertions, 0 deletions

diff --git a/zephyr/dts/bindings/power/ap-pwrseq-sub-states.yaml b/zephyr/dts/bindings/power/ap-pwrseq-sub-states.yaml
new file mode 100644
index 0000000000..f6570be9fb
--- /dev/null
+++ b/zephyr/dts/bindings/power/ap-pwrseq-sub-states.yaml
@@ -0,0 +1,23 @@
+# Copyright 2022 Intel Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+description: |
+  Define additional substates to be included in state machine.
+compatible: "ap-pwrseq-sub-states"
+
+description: |
+  String array of additional substates, use corresponding macros to provide
+  action handlers.
+properties:
+  chipset:
+    type: string-array
+    required: false
+    description: |
+      User defined power subtstates, use AP_POWER_CHIPSET_SUB_STATE_DEFINE, to define
+      substate action handler functions.
+  application:
+    type: string-array
+    required: false
+    description: |
+      User defined power subtstates, use AP_POWER_APP_SUB_STATE_DEFINE, to define
+      substate action handler functions.