4  * SPDX-License-Identifier: Apache-2.0
18  * If the prop exists, this expands to DT_ENUM_UPPER_TOKEN(node_id, prop).
24  * @param prop lowercase-and-underscores property name
28 #define NPCX_DT_PROP_ENUM_OR(node_id, prop, default_value) \  argument
29 	COND_CODE_1(DT_NODE_HAS_PROP(node_id, prop), \
30 		    (DT_STRING_UPPER_TOKEN(node_id, prop)), (default_value))
36  * @param prop lowercase-and-underscores property name
40 #define NPCX_DT_INST_PROP_ENUM_OR(inst, prop, default_value) \  argument
41 	NPCX_DT_PROP_ENUM_OR(DT_DRV_INST(inst), prop, default_value)
44  * @brief Construct a npcx_clk_cfg item from first item in 'clocks' prop which
45  * type is 'phandle-array' to handle "clock-cells" in current driver.
73  * @param i index of clocks prop which type is 'phandle-array'
98  * @brief Length of 'clocks' property which type is 'phandle-array'
101  * @return length of 'clocks' property which type is 'phandle-array'
109  * @param child child index in UTIL_LISTIFY extension.
113 #define NPCX_DT_CLK_CFG_ITEMS_FUNC(child, inst) \  argument
114 					NPCX_DT_CLK_CFG_ITEM_BY_IDX(inst, child)
123  *			clocks = <&pcc NPCX_CLOCK_BUS_APB3 NPCX_PWDWN_CTL5 3>,
170  * @brief Get phandle from 'wui-maps' prop which type is 'phandles' at index 'i'
173  * @param i index of 'wui-maps' prop which type is 'phandles'
174  * @return phandle from 'wui-maps' prop at index 'i'
180  * @brief Construct a npcx_wui structure from wui-maps property at index 'i'
183  * @param i index of 'wui-maps' prop which type is 'phandles'
196  * @brief Length of npcx_wui structures in 'wui-maps' property
199  * @return length of 'wui-maps' prop which type is 'phandles'
206  * @param child child index in UTIL_LISTIFY extension.
210 #define NPCX_DT_WUI_ITEMS_FUNC(child, inst) NPCX_DT_WUI_ITEM_BY_IDX(inst, child)  argument
219  *			uart-rx = <&wui_cr_sin1>;
224  *			wui-maps = <&wui_io00 &wui_io01 &wui_io02 &wui_io03
252  * @brief Get the index prop from parent MIWU device node.
254  * @param child index in UTIL_LISTIFY extension.
255  * @return 'index' prop value of the node which compatible type is
256  * "nuvoton,npcx-miwu".
258 #define NPCX_DT_MIWU_IRQ_TABLE_IDX(child) \  argument
259 	DT_PROP(DT_PHANDLE(DT_PARENT(child), parent), index)
265  * @param child index in UTIL_LISTIFY extension.
269 #define NPCX_DT_MIWU_IRQ_CONNECT_IMPL_CHILD_FUNC(child) \  argument
270 	NPCX_DT_MIWU_IRQ_CONNECT_IMPL_CHILD_FUNC_OBJ(child);
272 #define NPCX_DT_MIWU_IRQ_CONNECT_IMPL_CHILD_FUNC_OBJ(child) \  argument
274 		IRQ_CONNECT(DT_PROP(child, irq),		               \
275 			DT_PROP(child, irq_prio),		               \
276 			NPCX_MIWU_ISR_FUNC(NPCX_DT_MIWU_IRQ_TABLE_IDX(child)), \
277 			DT_PROP(child, group_mask),                            \
279 		irq_enable(DT_PROP(child, irq));                               \
283  * @brief Get a child node from path '/npcx-espi-vws-map/name'.
285  * @param name a path which name is /npcx-espi-vws-map/'name'.
286  * @return child node identifier with that path.
292  * @brief Get phandle from vw-wui property of child node with that path.
294  * @param name path which name is /npcx-espi-vws-map/'name'.
295  * @return phandle from "vw-wui" prop of child node with that path.
301  * @brief Construct a npcx_wui structure from vw-wui property of a child node
304  * @param name a path which name is /npcx-espi-vws-map/'name'.
317  * a child node with that path.
320  * @param name a path which name is /npcx-espi-vws-map/'name'.
335  * a child node with that path.
338  * @param name a path which name is /npcx-espi-vws-map/'name'.
351  * @brief Construct a npcx_lvol structure from 'lvol-maps' property at index 'i'.
354  * @param prop Low voltage configurations property name. (i.e. 'lvol-maps')
361  * @brief Length of npcx_lvol structures in 'lvol-maps' property
364  * @return length of 'lvol-maps' prop which type is 'phandles'
369  * @brief Construct a npcx_lvol structure from 'lvol-maps' property at index 'i'.
372  * @param prop Low voltage configurations property name. (i.e. 'lvol-maps')
375 #define NPCX_DT_LVOL_ITEMS_INIT(node_id, prop, idx)				\  argument
377 	  .ctrl = DT_PHA(DT_PROP_BY_IDX(node_id, prop, idx), lvols, ctrl),	\
378 	  .bit = DT_PHA(DT_PROP_BY_IDX(node_id, prop, idx), lvols, bit),	\
382  * @brief Macro function to construct a list of npcx_lvol items  from 'lvol-maps'
396  * @return TRUE - if the host interface is configured by booter,
397  *         FALSE - otherwise.