bsp: imx9: Add BSP manual for i.MX 91/93 FPSC by FPlohl · Pull Request #449 · phytec/doc-bsp-yocto

FPlohl · 2026-04-16T10:09:25Z

Adds the HEAD & PD26.1.0 BSP manual for the phyFLEX-i.MX 93 FPSC-Gamma along with supporting documentation. Also adds substitutions for the U-Boot eMMC devno inside bsp/imx-common/installing-os.rsti

tremmet · 2026-04-17T06:36:28Z

We have a duplicate of this file for every Libra board I guess. Why not move this to a more generic place and rename it to something like gpios-libra.rsti. Use the https://github.com/phytec/doc-bsp-yocto/blob/main/source/bsp/imx8/imx8mp-fpsc/gpios.rsti as reference as I just updated it for .2 Libra revision.
So all SoMs using Libra can reuse the file.

This would mean the base gpios.rsti also needs to be generic, since different SoMs have different addresses, number of GPIO banks, and GPIOs per bank.

I suggest we create a generic gpios.rsti and update all manuals to use that instead. I can open a separate PR for this, but is the current state good enough for now?

cstoidner · 2026-05-11T12:42:09Z

+resistors are activated or not. In this case, the internal resistors are
+disabled.


In this case, the internal resistors are disabled.

This is wrong. Correct would be: "In this case, the internal pull ups are activated."

cstoidner · 2026-05-11T12:47:50Z

+*  SoM Detection EEPROM (write-protected)
+
+   *  Bus: I2C-1
+   *  Address: 0x51


This is wrong. Correct address for SoM factory eeprom is 0x50.

cstoidner · 2026-05-11T12:50:34Z

+*  User EEPROM
+
+   *  Bus: I2C-1
+   *  Address: 0x50


This is wrong. Correct address for SoM user eeprom is 0x51.

cstoidner · 2026-05-11T13:09:06Z

+.. |ref-bootswitch| replace:: :ref:`bootmode switch (S1) <imx91-93-fpsc-head-bootswitch>`
+.. |ref-bsp-images| replace:: :ref:`BSP Images <imx91-93-fpsc-head-images>`
+.. |ref-debugusbconnector| replace:: :ref:`(X14) <imx91-93-fpsc-head-components>`
+.. |ref-dt| replace:: :ref:`device tree <imx91-93-fpsc-head-device-tree>`
+.. |ref-supported-hardware| replace:: :ref:`Supported Hardware <imx91-93-fpsc-head-supported-hardware>`
+.. |ref-getting-started| replace:: :ref:`Getting Started <imx91-93-fpsc-head-getting-started>`
+.. |ref-network| replace:: :ref:`Network Environment Customization <imx91-93-fpsc-head-network>`
+.. |ref-setup-network-host| replace:: :ref:`Setup Network Host <imx91-93-fpsc-head-development>`
+.. |ref-usb-otg| replace:: :ref:`X18 <imx91-93-fpsc-head-components>`
+.. |ref-build-uboot| replace:: :ref:`Build U-Boot <imx91-93-fpsc-head-development-build-uboot>`
+.. |ref-format-sd| replace:: :ref:`Resizing ext4 Root Filesystem  <imx91-93-fpsc-head-format-sd>`


Those references point to the head, not to the release.

cstoidner · 2026-05-11T13:10:13Z

+.. |ref-serial| replace:: :ref:`X27 <imx91-93-fpsc-head-components>`
+.. |ref-S5| replace:: :ref:`S5 <imx91-93-fpsc-head-components>`


Those refs point to the head.

cstoidner · 2026-05-11T13:11:41Z

+.. |som| replace:: phyFLEX-|soc| FPSC-Gamma
+.. |debug-uart| replace:: ttyLP3
+.. |serial-uart| replace:: ttyLP1
+.. |bluetooth-uart| replace:: UART3


Bluetooth is connected via USB on the imx93 libra.

cstoidner · 2026-05-11T13:14:37Z

+   imx93-phyflex-libra-rdk-fpsc-lvds-ph128800t006-zhc01.dtbo
+   imx93-phyflex-libra-rdk-fpsc-peb-av-10.dtbo
+   imx93-phyflex-libra-rdk-fpsc-peb-av-12.dtbo
+   imx93-phyflex-libra-rdk-fpsc-vm016.dtbo
+   imx93-phyflex-libra-rdk-fpsc-vm020.dtbo


The term "-fpsc" is not part of those filenames.

cstoidner · 2026-05-13T07:51:45Z

+            :scale: 400%
+
+            SPI NOR flash
+


We dont have a jtag boot mode.

cstoidner · 2026-05-13T07:55:33Z

+
+   imx93-phyflex-libra-rdk-fpsc-lvds-ph128800t006-zhc01.dtbo
+   imx93-phyflex-libra-rdk-fpsc-peb-av-10.dtbo
+   imx93-phyflex-libra-rdk-fpsc-peb-av-12.dtbo


This is named
imx93-phyflex-libra-rdk-peb-av-12-ph128800t006-zhc01.dtbo

cstoidner · 2026-05-13T08:22:26Z

@@ -0,0 +1,513 @@
+.. Download links


Most of the comments from the file 'head.rst' also apply to this file.
Please dont forget to apply/fix them also here in that file 'pd26.1.0.rst'.

cstoidner · 2026-05-15T08:58:37Z

+.. list-table::
+
+   *  -  .. figure:: /bsp/images/dipswitch-tristate-4-pppp.svg
+            :scale: 400%
+
+            Internal fuses
+
+      -  .. figure:: /bsp/images/dipswitch-tristate-4-mppp.svg
+            :scale: 400%
+
+            USB serial download
+
+   *  -  .. figure:: /bsp/images/dipswitch-tristate-4-pmpp.svg
+            :scale: 400%
+
+            e.MMC
+
+      -  .. figure:: /bsp/images/dipswitch-tristate-4-mmpp.svg
+            :scale: 400%
+
+            SD card
+
+   *  -  .. figure:: /bsp/images/dipswitch-tristate-4-pmmp.svg
+            :scale: 400%
+
+            SPI NOR flash
+
+      -  .. figure:: /bsp/images/dipswitch-tristate-4-mmmm.svg
+            :scale: 400%
+
+            JTAG mode


There are three things to mention here:

the boot mode for SPI NOR is wrong

we dont have a JTAG mode

onwards PCB revision 1618.3 the modes are inverted

Therefore please consider the change below:

Suggested change

.. list-table::

* - .. figure:: /bsp/images/dipswitch-tristate-4-pppp.svg

:scale: 400%

Internal fuses

- .. figure:: /bsp/images/dipswitch-tristate-4-mppp.svg

:scale: 400%

USB serial download

* - .. figure:: /bsp/images/dipswitch-tristate-4-pmpp.svg

:scale: 400%

e.MMC

- .. figure:: /bsp/images/dipswitch-tristate-4-mmpp.svg

:scale: 400%

SD card

* - .. figure:: /bsp/images/dipswitch-tristate-4-pmmp.svg

:scale: 400%

SPI NOR flash

- .. figure:: /bsp/images/dipswitch-tristate-4-mmmm.svg

:scale: 400%

JTAG mode

.. list-table::

* - .. figure:: /bsp/images/dipswitch-tristate-4-mmmm.svg

:scale: 400%

Internal fuses

- .. figure:: /bsp/images/dipswitch-tristate-4-pmmm.svg

:scale: 400%

USB serial download

* - .. figure:: /bsp/images/dipswitch-tristate-4-mpmm.svg

:scale: 400%

e.MMC

- .. figure:: /bsp/images/dipswitch-tristate-4-ppmm.svg

:scale: 400%

SD card

* - .. figure:: /bsp/images/dipswitch-tristate-4-mmpm.svg

:scale: 400%

SPI NOR flash

- .. none

:scale: 400%

.. note::

In the |sbc| PCB revision 1618.2, all boot mode switches are inverted.

This means for rev 1618.2 that in the illustration above, each switch's

(+) position must be used instead of the (-) position, and vice versa.

And I already created the newly needed dipswitch images for "source/bsp/images/":

source/bsp/images/dipswitch-tristate-4-mpmm.svg:

source/bsp/images/dipswitch-tristate-4-pmmm.svg:

source/bsp/images/dipswitch-tristate-4-ppmm.svg:

I've added the three images to the main branch: ea04af4 But I had to recreate them. @cstoidner Yours are somehow broken, when I opened them.

Replace hardcoded eMMC device number ("2") in U-Boot command examples with existing |u-boot-emmc-devno| substitution. Apply this consistently across all relevant code blocks and enable substitutions where required. Signed-off-by: Florijan Plohl <florijan.plohl@norik.com>

Add the HEAD BSP manual for the phyFLEX-i.MX 93 FPSC-Gamma along with supporting documentation. The imx91 variant of the SoM is not yet available, however prepare the bsp manual's foldername to add the imx91 later. Signed-off-by: Florijan Plohl <florijan.plohl@norik.com>

Add documentation notes for the PD26.1.0 i.MX91/93 FPSC release. Signed-off-by: Florijan Plohl <florijan.plohl@norik.com>

FPlohl requested review from cstoidner and pfiser April 16, 2026 10:09

FPlohl requested review from BHahn42618, tremmet and ymoog as code owners April 16, 2026 10:09

tremmet requested changes Apr 17, 2026

View reviewed changes

FPlohl force-pushed the WIP/florijan.plohl@norik.com/imx93-phyflex-doc branch from 482c136 to a52f379 Compare April 20, 2026 10:45

FPlohl requested a review from tremmet April 21, 2026 11:24

tremmet previously approved these changes May 5, 2026

View reviewed changes

cstoidner requested changes May 11, 2026

View reviewed changes

cstoidner reviewed May 11, 2026

View reviewed changes

cstoidner reviewed May 15, 2026

View reviewed changes

FPlohl added 3 commits May 15, 2026 13:04

bsp: imx9: imx91-93-fpsc: Add PD26.1.0 release documentation

ac80564

Add documentation notes for the PD26.1.0 i.MX91/93 FPSC release. Signed-off-by: Florijan Plohl <florijan.plohl@norik.com>

FPlohl dismissed tremmet’s stale review via ac80564 May 27, 2026 07:43

FPlohl force-pushed the WIP/florijan.plohl@norik.com/imx93-phyflex-doc branch from a52f379 to ac80564 Compare May 27, 2026 07:43

		resistors are activated or not. In this case, the internal resistors are
		disabled.

		.. \|ref-serial\| replace:: :ref:`X27 <imx91-93-fpsc-head-components>`
		.. \|ref-S5\| replace:: :ref:`S5 <imx91-93-fpsc-head-components>`

Conversation

FPlohl commented Apr 16, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

FPlohl Apr 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

FPlohl Apr 20, 2026 •

edited

Loading