From 9b43ac7c768cd212485a5b3fd73a9741b2b37496 Mon Sep 17 00:00:00 2001
From: Gerson Fernando Budke <nandojve@gmail.com>
Date: Wed, 21 Oct 2020 23:12:49 -0300
Subject: [PATCH] include: dt-bindings: Add macros entry point for DTS
 preprocessor

Introduce <dt-bindings/dt-util.h> file.  It wraps <sys/util_macro.h>
file exposing all macro base definitions to DTS preprocessor.  Once it
contains only prepocessor macros, it can be safely included in DTS,
similar way the <dts/arm/<manufacturer>/pinctrl_<manufacturer>_<soc>.h
files are included.

This provides necessary background to elaborate complex constructions
like variable length macros with zero or more elements.

Signed-off-by: Gerson Fernando Budke <nandojve@gmail.com>
---
 include/dt-bindings/dt-util.h | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 include/dt-bindings/dt-util.h

diff --git a/include/dt-bindings/dt-util.h b/include/dt-bindings/dt-util.h
new file mode 100644
index 00000000000..dc5462a2d99
--- /dev/null
+++ b/include/dt-bindings/dt-util.h
@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2020 Gerson Fernando Budke <nandojve@gmail.com>
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef ZEPHYR_INCLUDE_DT_BINDINGS_DT_UTIL_H_
+#define ZEPHYR_INCLUDE_DT_BINDINGS_DT_UTIL_H_
+
+/*
+ * This file exists to keep in-tree DTS clean.  This means, only
+ * #include <dt-bindings/foo.h> form should be included.  The
+ * <dt-bindings/dt-util.h> wraps <sys/util_macro.h> file exposing
+ * all macro base definitions to DTS preprocessor.  It provides
+ * necessary background to elaborate complex constructions like
+ * variable length macros with zero or more elements.
+ */
+
+#include <sys/util_macro.h>
+
+#endif /* ZEPHYR_INCLUDE_DT_BINDINGS_DT_UTIL_H_ */