Custom board revision/extension with new Zephyr hardware model

RE: Custom board revision/extension with new Zephyr hardware model

Hieu — Tue, 25 Jun 2024 12:39:57 GMT

Would you like to also check this with the Zephyr community? Board revision management are mostly if not all Zephyr, so the community there might have better ideas.

RE: Custom board revision/extension with new Zephyr hardware model

dethredic — Fri, 21 Jun 2024 20:40:28 GMT

The overlay files are in the "boards" folder, just a typo.

I still find it a little unfortunate that applications can't define a custom revision anymore. I'll think about it over the weekend and maybe see how much work creating new boards is going to be.

RE: Custom board revision/extension with new Zephyr hardware model

Hieu — Fri, 21 Jun 2024 20:10:57 GMT

Yes, exactly something like that. Since we are doing something different from the concept called Revision in Zephyr, it might be better to use a different term though. Perhaps variant, or model.

This is of course not what most projects do usually, so I understand why you call it a little hacky.

If you want a more mainstream solution, for the Kconfig part, you can create a new Kconfig for just the project and add a "Kconfig description 'overlay'" to set the default value of other configs differently.
But I can't think of anything for Devicetree...

By the way, regarding the setup that works for you in 2.4, are the overlay files under the "build" folder or the "boards" folder? I think it should be "boards?"

RE: Custom board revision/extension with new Zephyr hardware model

dethredic — Fri, 21 Jun 2024 18:24:00 GMT

I got this working, but it feels super hacky:

set(REVISIONS "foo_v4" "bar_v1")
if (NOT MY_CUSTOM_REVISION IN_LIST REVISIONS)
    message(FATAL_ERROR "Revision '${MY_CUSTOM_REVISION}' is invalid. Accepted revisions: ${REVISIONS}")
endif()

set(DTC_OVERLAY_FILE ${CMAKE_CURRENT_SOURCE_DIR}/boards/nrf5340dk_nrf5340_cpuapp_${MY_CUSTOM_REVISION}.overlay)
set(EXTRA_CONF_FILE ${CMAKE_CURRENT_SOURCE_DIR}/boards/nrf5340dk_nrf5340_cpuapp_${MY_CUSTOM_REVISION}.conf)

Then I can build with

west build -b nrf5340dk/nrf5340/cpuapp -- -DMY_CUSTOM_REVISION=foo_v4

Any suggestions on a better way to do this without creating a new board would be welcome

RE: Custom board revision/extension with new Zephyr hardware model

dethredic — Fri, 21 Jun 2024 12:40:19 GMT

I think that would work, at least as a short term solution. Are you suggesting that I ignore the official revision field and just add a custom "REVISION" (or similar) cmake that will set DTC_OVERLAY_FILE/ EXTRA_CONF_FILE?

RE: Custom board revision/extension with new Zephyr hardware model

Hieu — Fri, 21 Jun 2024 11:20:11 GMT

I haven't looked into overriding YAML file yet. However, if the changes are simple like just some pins and configs, and you don't mind tweaking CMake, then there is an alternative. You can add a CMake argument, and tweak CMakeLists.txt to include new Devicetree or Kconfig overlay files based on that argument.

Is this an alternative for you?

Talking about biting the bullet, using a workspace application is an option too. Though I can see that the downsides from updating the SDK are all still there.

RE: Custom board revision/extension with new Zephyr hardware model

dethredic — Thu, 20 Jun 2024 12:48:43 GMT

My application is a "freestanding application", so changing the SDK isn't a viable option since every developer on the project would need follow suit. I would also lose these changes when updating the SDK. Is there maybe a way to override / extend the board's YAML file from my application?

I liked the idea of just using a revision of the nrf5340dk because:

It's way simpler, only 2 files are needed to tweak some pins / add some configs
I would get updates / fixes automatically as the SDK gets updated

If there is no longer a way to use a custom revision without updating the SDK then I guess I will bite the bullet and implement a custom board

RE: Custom board revision/extension with new Zephyr hardware model

Hieu — Thu, 20 Jun 2024 11:40:49 GMT

Hi dethredic,

You shouldn't have to tweak CMakeLists.txt to make use of the board revision feature.

I wonder if it's just because you haven't updated the nrf5340dk board's YAML file? See: Board Porting Guide — Zephyr Project Documentation.

If you are concerned about changing the SDK files too much, perhaps you can consider using custom board files.

Hieu