Skip to content

i.MX93 BSP documentation update for PD24.2.1 #283

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.

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 13 commits into
base: main
Choose a base branch
from

Conversation

pfiser
Copy link
Contributor

@pfiser pfiser commented Mar 28, 2025

Update documentation for the i.MX93 PD24.2.1 release.

Changelog:

  • update component version (Linux, U-Boot, Yocto, etc.)
  • update line references in device-tree URL links
  • rename SoM option extension overlays (unified with i.MX91)
  • add phyboard-nash rev 1616.2
  • improve WLAN/BT chapter for both boards (Segin uses PEB-WLBT-05, Nash uses PEB-WLBT-07)
  • add mlan0 interface name note for PEB-WLBT-07 wireless adapter
  • drop PEB-WLBT-05 specifics in general wireless-network.rsti chapter
  • update CAN-FD chapter due to BSP changes
  • update GPIO chapter due to BSP changes (libgpiod v2 was already part of previous release, so fix it now)
  • update EEPROM chapter due to libgpiod v2 changes
  • drop "BOOT/bootenv.txt" in favor of "/boot/bootenv.txt" in display.rsti chapter

@pfiser pfiser marked this pull request as ready for review April 1, 2025 11:16
@pfiser pfiser requested a review from jonas-rem April 1, 2025 11:17
pfiser added 5 commits April 7, 2025 08:04
Add initial documentation notes for the PD24.2.1 i.MX93 release based
on previous PD24.2.0 i.MX93 release.

Signed-off-by: Primoz Fiser <[email protected]>
Change all component versions according to PD24.2.1 release.

Signed-off-by: Primoz Fiser <[email protected]>
In PD24.2.1 release, SOM option extension overlays have been unified
with i.MX91 and thus have to be renamed.

Signed-off-by: Primoz Fiser <[email protected]>
Add phyBOARD-Nash rev 1616.2 to the list of baseboard revisions for the
bootmode switches.

Signed-off-by: Primoz Fiser <[email protected]>
Add additional PEB-WLBT-07 WiFI/BT overlay for Nash board available in
PD24.2.1 release.

Signed-off-by: Primoz Fiser <[email protected]>
@pfiser pfiser force-pushed the WIP/pfiser/imx93-pd24.2.1 branch from 207f4ed to a73d0a9 Compare April 7, 2025 06:04
Copy link
Collaborator

@jonas-rem jonas-rem left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The partition of incremental changes into many commits is great and made reviewing much easier.

The release adds support for imx91, correct? Is this manual for one unified BSP that supports both variants? Or will there be a second manual targeted at the imx91?

The Phytec website currently lists two separate releases:

  1. BSP-Yocto-NXP-i.MX91-PD24.2.1
  2. BSP-Yocto-NXP-i.MX93-PD24.2.1

Unrelated to this PR: There is no HEAD version for the imx93 platform. Does it make sense to add one to make changes for future releases easier?

pfiser added 8 commits April 8, 2025 08:45
Since PD24.2.1 release, WiFi/BT is now supported on both i.MX93 based
boards. On phyBOARD-Segin-i.MX93 we use PEB-WLBT-05 while on the
phyBOARD-Nash-i.MX93 we use the PEB-WLBT-07 adapter. Create separate
chapters for each wireless/bluetooth adapter.

Lastly, dissolve wireless-network.rsti for PD24.2.0 release since BT was
not supported yet with that release, nor was there support for Nash.

Signed-off-by: Primoz Fiser <[email protected]>
Drop URL to pdf information specific to PEB-WLBT-05. This chapter should
be kept generic as possible. Information about used WLAN/BT module is
already provided in the SOM specific wireless-network.rsti files. This
enables us to reuse the chapter for other adapters.

Signed-off-by: Primoz Fiser <[email protected]>
Since meta-ampliphy commit c5ff1f027afe ("recipes-core: systemd: Use
Wildcard to Match CAN .network Files") we use wildcards to match CAN
interfaces. Additionally, CAN-FD (flexible datarate) is enabled by
default in the BSP. Thus update the CANFD chapter and dissolve for
previous releases.

Signed-off-by: Primoz Fiser <[email protected]>
Since yocto scarthgap (PD24.2.0), BSP contains libgpiod version 2. The
cmdline interface has changed and we need to update the gpios chapter
accordingly. Also provide workaround for gpioset demonize with -t0
switch as it is quite useful. Last but not least, we don't use kernel
config fragments anymore thus update chapter on how to enable GPIO via
sysfs. Finally, dissolve GPIOs chapter for older releases.

Signed-off-by: Primoz Fiser <[email protected]>
Since yocto scarthgap (PD24.2.0), BSP contains libgpiod version 2. Thus
to disable EEPROM write protection one needs to use slightly different
cmdline interface parameters. Thus dissolve eeprom chapter for older
mickledore releases while updating and expanding for the newer scarthgap
based releases.

Signed-off-by: Primoz Fiser <[email protected]>
Rework text a bit and make it clear that overlays are enabled in the
/boot/bootenv.txt file (BOOT doesn't make any sense).

Signed-off-by: Primoz Fiser <[email protected]>
With PEB-WLBT-07, the interface name is not wlan0 but instead mlan0.
Since we compile documentation for both i.MX93 boards from the same
sources we cannot use substitution e.g. |wlan-interface|. Thus resort to
a note, that users should substitute wlan0 with mlan0 manually when
following the chapters on configuring the wireless network interface.

Signed-off-by: Primoz Fiser <[email protected]>
Specify correct release PD24.2.0 for PEB-WLBT-05 wireless adapter. It is
not correct to write PD24.2 by simply omitting the minor version number
(.0) from full string PD24.2.0.

Signed-off-by: Primoz Fiser <[email protected]>
@pfiser
Copy link
Contributor Author

pfiser commented Apr 8, 2025

The partition of incremental changes into many commits is great and made reviewing much easier.

@jonas-rem Thanks. I also prefer it like that.

The release adds support for imx91, correct? Is this manual for one unified BSP that supports both variants? Or will there be a second manual targeted at the imx91?

@cstoidner is compiling document for imx91.

It will be a separate document from the imx93.

The Phytec website currently lists two separate releases:

  1. BSP-Yocto-NXP-i.MX91-PD24.2.1
  2. BSP-Yocto-NXP-i.MX93-PD24.2.1

Unrelated to this PR: There is no HEAD version for the imx93 platform. Does it make sense to add one to make changes for future releases easier?

@jonas-rem That a good idea, I think we can discuss that on the next imx93 team meeting.

@pfiser pfiser force-pushed the WIP/pfiser/imx93-pd24.2.1 branch from a73d0a9 to 854585a Compare April 8, 2025 07:07
@jonas-rem jonas-rem self-requested a review April 8, 2025 07:46
@jonas-rem
Copy link
Collaborator

I'll would still wait for a review from someone from the i.mx93 team until merging.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants