Skip to content

Conversation

@jmenti
Copy link
Collaborator

@jmenti jmenti commented Nov 20, 2025

This fixes a few miscellaneous user guides for am335/am437 devices including:

  • MMC command in UG-Memory-OMAP.
  • UART boot instructions
  • UFS block rendering
  • Document new beaglebone green ECO platform
  • Fix DT paths in build guides
  • Fix expected locations of zImage and DT files in SD card partitions
  • Hide fitImage instructions for am335/am437 devices
  • Fix supported platform links for am65x
  • Fix notes for eMMC in MMCSD u-boot guide

Update includes:
- boot-time measurement
- beaglebone_green_eco-gp performance numbers

Signed-off-by: Judith Mendez <jm@ti.com>
Update includes:
- boot-time measurement
- MMCSD perf
- UBOOT MMCSD perf

Signed-off-by: Judith Mendez <jm@ti.com>
Update includes:
- boot-time measurement

Signed-off-by: Judith Mendez <jm@ti.com>
@github-actions
Copy link

New issues found with check_toc_txt.py:

WARNING:root:File not in any toc: source/linux/Foundational_Components/Kernel/Fit-Image-Guide.rst

Currently, titles are not rendered for AM65X performance guide, this is
due to Linux performance guide including the RT Linux performance guide
and thus messing with title hierarchy. To fix this, include both performace
guides from the toc tree and only reference the RT linux performace guide
without an explicit include.

Signed-off-by: Judith Mendez <jm@ti.com>
MMC command cannot be used to select USER partitions, so
fix mmc dev command in UG-Memory-OMAP.

Signed-off-by: Judith Mendez <jm@ti.com>
Fixup file names and instructions on UART boot for am335/am437
devices.

Signed-off-by: Judith Mendez <jm@ti.com>
block in UFS guide do not get rendered correctly, so
fix each block and use code-block:: console syntax.

While here, also fixup and remove unecessary whitespace.

Signed-off-by: Judith Mendez <jm@ti.com>
New platform beaglebone green ECO board is supported in 11.02
release, so add DT file and u-boot defconfig in build guides
to build for this board.

Signed-off-by: Judith Mendez <jm@ti.com>
In 6.12 Linux kernel version, DT path is now in arch/arm/boot/dtb/ti/omap
so update kernel build user guide with new DT path.

Also update expected path where zImage and DT file are loaded from for
SD card boot, which should be from "boot" partition.

Signed-off-by: Judith Mendez <jm@ti.com>
Not all platforms may support FitImage boot or may have missing
documentation, so factor out the fitImage steps into its own file:
_Fit_Image_Guide.rst and only explicitly include for non am335/am437
devices.

Signed-off-by: Judith Mendez <jm@ti.com>
AM65X GP EVM is no longer on ti.com, fixup links, but do not completely
remove since benchmarking still happens on these boards.

Update links for beaglebone black as well and add beaglebone green
ECO as the new supported platform.

Signed-off-by: Judith Mendez <jm@ti.com>
AM335 EVM does have an eMMC flash, remove wrong note for this.

For am335* devices, ROM does not support booting from eMMC boot/boot1
hardware partitions, only from eMMC UDA. Make a note of this in MMCSD
u-boot guide.

Signed-off-by: Judith Mendez <jm@ti.com>
.. include:: /linux/Foundational_Components/Kernel/_Fit_Image_Guide.rst

Refer to :ref:`top-level-makefile`
|
Copy link
Member

Choose a reason for hiding this comment

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

Please refrain from adding useless line breaks.

sudo cp arch/arm/boot/zImage /media/rootfs/boot
arch/arm/boot/dts/am335x-boneblack.dtb /media/rootfs/boot
sudo cp arch/arm/boot/zImage $boot
arch/arm/boot/dts/ti/omap/am335x-boneblack.dtb $boot
Copy link
Member

Choose a reason for hiding this comment

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

Isn't this incorrect now? Don't the legacy devices also use $boot/dtb/ti directory structures now?

to SATA in the `previous section <UG-SATA.html>`__.
One additional command to initialize all ufs devices is:
Universal Flash Subsystem (UFS) devices show up as scsi devices similar to SATA
in the `previous section <UG-SATA.html>`__. One additional command to initialize
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
in the `previous section <UG-SATA.html>`__. One additional command to initialize
in the :ref:`previous section <UG-SATA>`. One additional command to initialize

@StaticRocket
Copy link
Member

I'd like to see some of those paths being updated changed to use the :file: role in the future...

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.

8 participants