Skip to content

doc: update dt macros grammar and tests #37

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 8 commits into
base: dt_map_properties
Choose a base branch
from
Open

doc: update dt macros grammar and tests #37

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
e09c8fb
sys: util: Add `GET_ARGS_FIRST_N` to get the first N of the args
soburi Jan 4, 2025
1c6134a
tests: unit: util: Add test for `GET_ARGS_FIRST_N`
soburi Jan 18, 2025
1c7f328
dts: bindings: Change `*-map-mask` and `*-map-pass-thru` as array type.
soburi Mar 25, 2025
f60e301
dts: bindings: Add interrupt-nexus and io-channel-nexus base bindings
soburi Mar 25, 2025
a1b09ac
scripts: dts: Add handling for `*-map` property
soburi Mar 23, 2025
71eaaa8
scripts: dts: devicetree: tests: Add a map property test
soburi Sep 20, 2025
6ace2ed
tests: lib: devicetree: api: Add map property tests
soburi Apr 13, 2025
814f4a9
doc: update dt macros grammar and tests
soburi Oct 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions doc/build/dts/macros.bnf
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,10 +106,20 @@ node-macro =/ %s"DT_N" path-id %s"_ORD"
node-macro =/ %s"DT_N" path-id %s"_PATH"
; The node's name@unit-addr, as a string literal
node-macro =/ %s"DT_N" path-id %s"_FULL_NAME"
; The node's name@unit-addr without surrounding quotes.
node-macro =/ %s"DT_N" path-id %s"_FULL_NAME_UNQUOTED"
; Tokenized variants of the node's name@unit-addr.
node-macro =/ %s"DT_N" path-id %s"_FULL_NAME_TOKEN"
node-macro =/ %s"DT_N" path-id %s"_FULL_NAME_UPPER_TOKEN"
; The dependency ordinals of a node's requirements (direct dependencies).
node-macro =/ %s"DT_N" path-id %s"_REQUIRES_ORDS"
; The dependency ordinals of a node supports (reverse direct dependencies).
node-macro =/ %s"DT_N" path-id %s"_SUPPORTS_ORDS"
; Helper macros that iterate over the node's ancestors.
node-macro =/ %s"DT_N" path-id %s"_FOREACH_ANCESTOR"
; Node specific hash and sortable dependency strings.
node-macro =/ %s"DT_N" path-id %s"_HASH"
node-macro =/ %s"DT_N" path-id %s"_ORD_STR_SORTABLE"

; --------------------------------------------------------------------
; pinctrl-macro: a macro related to the pinctrl properties in a node
Expand Down Expand Up @@ -341,6 +351,7 @@ other-macro =/ %s"DT_FOREACH_OKAY_INST_" dt-name
other-macro =/ %s"DT_FOREACH_OKAY_INST_VARGS_" dt-name
; E.g.: #define DT_CHOSEN_zephyr_flash
other-macro =/ %s"DT_CHOSEN_" dt-name
other-macro =/ %s"DT_CHOSEN_" dt-name %s"_EXISTS"
; Declares that a compatible has at least one node on a bus.
; Example:
;
Expand All @@ -355,6 +366,11 @@ other-macro =/ %s"DT_COMPAT_HAS_OKAY_" dt-name
; property to a fixed-partitions node. See the flash map API docs
; for an example.
other-macro =/ %s"DT_COMPAT_" dt-name %s"_LABEL_" dt-name
; Helper macros expanded while iterating over nodes.
other-macro =/ %s"DT_FOREACH_VARGS_HELPER"
other-macro =/ %s"DT_FOREACH_OKAY_VARGS_HELPER"
; Removes brackets while expanding variadic helper macros.
other-macro =/ %s"DT_DEBRACKET_INTERNAL"

; --------------------------------------------------------------------
; alternate-id: another way to specify a node besides a path-id
Expand Down
Loading
Loading