Questions regarding inconsistencies in retrieving device structures

RE: Questions regarding inconsistencies in retrieving device structures

AHaug — Tue, 21 Jan 2025 14:15:24 GMT

[quote user="Mart"]Would you say these commands are interchangable with eachother? If so, can you provide an example? [/quote]

Some are, but it depends on how they are defined in the devicetree.

You could for instance use GPIO_DT_SPEC_GET(DT_NODELABEL(led_0); instead of GPIO_DT_SPEC_GET(DT_ALIAS(led0), gpios); and get the same device given that the device has both an alias and a nodelabel specified when the device has been defined, which they has for the case of the leds.

I was about to see if I could write down an explanation which broke down the abstraction layers even further, but I believe lesson 2 in the fundamentals academy course breaks it down far better than what I could without spending far too long time on the explanation. See https://academy.nordicsemi.com/courses/nrf-connect-sdk-fundamentals/lessons/lesson-2-reading-buttons-and-controlling-leds/topic/devicetree/ with specific focus on the section regarding "DK devicetree file" roughly around the middle.

In short, the two ways are interchangeable due to

There exists a device in the dts that has a nodelabel
There exists an alias for this device

Let me know if this answers your questions

Kind regards,
Andreas

RE: Questions regarding inconsistencies in retrieving device structures

Mart — Mon, 20 Jan 2025 14:27:38 GMT

Thanks for your answer. This helps a bit.

Though I think the following would help see the differences for me:

Would you say these commands are interchangable with eachother? If so, can you provide an example?

RE: Questions regarding inconsistencies in retrieving device structures

AHaug — Mon, 20 Jan 2025 13:19:42 GMT

Hi,

[quote user=""]I'm following the nordic academic courses, which are very nice by the way![/quote]

We're glad to hear that!

[quote user=""]

The static part, that ofcourse I get but what I do not understand is why there are (already) three different variants of getting my device structure?

sure, I do understand that the three lines are meant for different applications but to me they do kind of the same, right?

Can somebody explain the reason for that and their differences in a bit more detail because it is confusing me.

[/quote]

I see where the confusion comes from. Yes, they mean basically the same, and it is as you say different ways to get your device's structure which often has their own sets of equivalent options. Which you choose depends on how you've defined the device or what type of device it is.

1: This is fetching the device using a nodelabel

2: This is fetching the device using GPIO_DT_SPEC_GET( node_id, prop ), which is from the Zephyr API for gpios, using the device's alias.

3: This is fetching a subdevice, in this case the sensor is a subsensor attached to the I2C bus. You can see a similar api for PWM here: https://docs.nordicsemi.com/bundle/zephyr-apis-latest/page/group_pwm_interface.html

Devicetree has a more expanded (and very helpful) documentation which you can see here: https://docs.nordicsemi.com/bundle/ncs-latest/page/zephyr/build/dts/index.html

Kind regards,
Andreas