From 28b4fdf4a055a0de6fbbc91de60f96ffdf2966f3 Mon Sep 17 00:00:00 2001
From: Georgij Cernysiov <geo.cgv@gmail.com>
Date: Tue, 24 May 2022 17:17:25 +0200
Subject: [PATCH] dts: bindings: mpu: add PPB and IO regions

Extends #43119 with PPB and IO values of
`memory-region-mpu`.

That allows MPU region definition with
PPB or IO attributes in the DTS.

Signed-off-by: Georgij Cernysiov <geo.cgv@gmail.com>
---
 dts/bindings/base/zephyr,memory-region.yaml |  2 ++
 include/zephyr/linker/devicetree_regions.h  | 10 +++++++++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/dts/bindings/base/zephyr,memory-region.yaml b/dts/bindings/base/zephyr,memory-region.yaml
index f31f79cb0f474..bfc1dfee238b1 100644
--- a/dts/bindings/base/zephyr,memory-region.yaml
+++ b/dts/bindings/base/zephyr,memory-region.yaml
@@ -24,6 +24,8 @@ properties:
       - "RAM"
       - "RAM_NOCACHE"
       - "FLASH"
+      - "PPB"
+      - "IO"
     description: |
       Signify that this node should result in a dedicated MPU region. The
       region address and size are taken from the <reg> property, while the MPU
diff --git a/include/zephyr/linker/devicetree_regions.h b/include/zephyr/linker/devicetree_regions.h
index 5c1327e3b8e0a..80c6eff664a14 100644
--- a/include/zephyr/linker/devicetree_regions.h
+++ b/include/zephyr/linker/devicetree_regions.h
@@ -224,12 +224,14 @@
  * to the MPU_FN macro using the 'attr' parameter, in the form
  * REGION_{attr}_ATTR.
  *
- * Currently only three enums are supported for the 'zephyr,memory-region-mpu'
+ * The following enums are supported for the 'zephyr,memory-region-mpu'
  * property:
  *
  *  - RAM
  *  - RAM_NOCACHE
  *  - FLASH
+ *  - PPB
+ *  - IO
  *
  * This means that usually the arch code would provide some macros or defines
  * with the same name of the extended property, that is:
@@ -237,6 +239,8 @@
  *  - REGION_RAM_ATTR
  *  - REGION_RAM_NOCACHE_ATTR
  *  - REGION_FLASH_ATTR
+ *  - REGION_PPB_ATTR
+ *  - REGION_IO_ATTR
  *
  * Example devicetree fragment:
  *
@@ -249,6 +253,10 @@
  *             };
  *     };
  *
+ * For detailed information about MPU region attribute define configuration refer
+ * to the specific architecture MPU header.
+ * For example: include/zephyr/arch/arm/aarch32/mpu/arm_mpu_v7m.h.
+ *
  * The 'attr' parameter of the MPU_FN function will be the extended
  * 'REGION_RAM_NOCACHE_ATTR' token and the arch code will be usually
  * implementing a macro with the same name.