devicetree: Add DT_FOREACH_ANCESTOR macro

[rruuaanng]

Add 'DT_FOREACH_ANCESTOR' macro to get a list of
ancestor node of a given node_id.

I've considered that one could use DT_PROP_BY_IDX(node_id, reg, 0) in place of DT_REG_RAW_ADDR(node_id), but only for 32-bit addresses. This could be generalized by adding a different API for retrieving #address-cells and #size-cells, but I think that would be a bit clunky.
I've also thought about using the existing DT_RANGES_* macros to translate and validate addresses manually. This would still require at least the following additions:
DT_REG_RAW_ADDR()
Something like DT_FOREACH_ANCESTOR() for walking up the tree.

from #58860

[rruuaanng]

I noticed that some parts of the documentation have conflicts with the changes. I will fix them after merging this PR.

There is currently only one "generic" for-each macro,

And, there are also some inappropriate func tags.

:c:func:DT_FOREACH_CHILD, which allows iterating over the children of a
devicetree node.

[rruuaanng]

The if here cannot be omitted. The generator will traverse to the root node so that it has a None.

[rruuaanng]

I don't want to add too many properties for testing in the test dts, so I chose to do this. Make it only used to fill in the macro parameters, and then calculate whether the number of nodes it traverses matches.

[rruuaanng]

That is here.

[rruuaanng]

I ran the test on my PC and it performed fine.

 - PASS - [devicetree_api.test_model] duration = 0.001 seconds
 - PASS - [devicetree_api.test_node_child_idx] duration = 0.001 seconds
 - PASS - [devicetree_api.test_node_name] duration = 0.001 seconds
 - PASS - [devicetree_api.test_nodelabel_props] duration = 0.001 seconds
 - PASS - [devicetree_api.test_parent] duration = 0.001 seconds
 - PASS - [devicetree_api.test_parent_nodes_list] duration = 0.001 seconds
 - PASS - [devicetree_api.test_path] duration = 0.001 seconds
 - PASS - [devicetree_api.test_path_props] duration = 0.003 seconds
 - PASS - [devicetree_api.test_phandles] duration = 0.007 seconds
 - PASS - [devicetree_api.test_pinctrl] duration = 0.004 seconds
 - PASS - [devicetree_api.test_pwms] duration = 0.003 seconds
 - PASS - [devicetree_api.test_ranges_empty] duration = 0.002 seconds
 - PASS - [devicetree_api.test_ranges_other] duration = 0.003 seconds
 - PASS - [devicetree_api.test_ranges_pcie] duration = 0.002 seconds
 - PASS - [devicetree_api.test_reg] duration = 0.003 seconds
 - PASS - [devicetree_api.test_reg_64] duration = 0.001 seconds
 - PASS - [devicetree_api.test_reset] duration = 0.002 seconds
 - PASS - [devicetree_api.test_same_node] duration = 0.001 seconds
 - PASS - [devicetree_api.test_string_array_escape] duration = 0.001 seconds
 - PASS - [devicetree_api.test_string_escape] duration = 0.003 seconds
 - PASS - [devicetree_api.test_string_idx_token] duration = 0.003 seconds
 - PASS - [devicetree_api.test_string_idx_unquoted] duration = 0.002 seconds
 - PASS - [devicetree_api.test_string_token] duration = 0.003 seconds
 - PASS - [devicetree_api.test_string_unquoted] duration = 0.003 seconds
 - PASS - [devicetree_api.test_vendor] duration = 0.001 seconds

------ TESTSUITE SUMMARY END ------

===================================================================
PROJECT EXECUTION SUCCESSFUL

[rruuaanng]

To my surprise, it worked fine in my PC, I converted it to a draft and tried to find the cause of the error :(