Skip to content

WIP: fix(linux): Update boot time guide #649

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.

Sign up for GitHub

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
paresh-bhagat12 wants to merge 1 commit into
base: master
Choose a base branch
from
Open

WIP: fix(linux): Update boot time guide #649

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
100 changes: 74 additions & 26 deletions source/linux/How_to_Guides/Target/How_to_boot_quickly.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -317,7 +317,6 @@
$ cd output
$ cpio -idv < tisdk-tiny-initramfs-am62xx-evm.cpio


2. Edit the kernel config:

.config:
Expand All @@ -335,7 +334,13 @@
General setup ->
Initial RAM filesystem and RAM disk (initramfs/initrd) support ->
Initramfs source file(s)
/path/to/filesystem
/path/to/filesystem or cpio file

Both cpio or filesystem path can be passed to "Initramfs source file". If providing a filesystem path directly, ensure required files and folders are executable. Or make all files executable by running below command:

Check warning on line 339 in source/linux/How_to_Guides/Target/How_to_boot_quickly.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.TermsSuggestions] Depending on the context, consider using 'after', 'later', or 'following' rather than 'below'.

Raw Output:
{"message": "[RedHat.TermsSuggestions] Depending on the context, consider using 'after', 'later', or 'following' rather than 'below'.", "location": {"path": "source/linux/How_to_Guides/Target/How_to_boot_quickly.rst", "range": {"start": {"line": 339, "column": 207}}}, "severity": "INFO"}

Check warning on line 339 in source/linux/How_to_Guides/Target/How_to_boot_quickly.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.TermsSuggestions] Depending on the context, consider using 'executable program' rather than 'executable'.

Raw Output:
{"message": "[RedHat.TermsSuggestions] Depending on the context, consider using 'executable program' rather than 'executable'.", "location": {"path": "source/linux/How_to_Guides/Target/How_to_boot_quickly.rst", "range": {"start": {"line": 339, "column": 185}}}, "severity": "INFO"}

Check warning on line 339 in source/linux/How_to_Guides/Target/How_to_boot_quickly.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.TermsSuggestions] Depending on the context, consider using 'executable program' rather than 'executable'.

Raw Output:
{"message": "[RedHat.TermsSuggestions] Depending on the context, consider using 'executable program' rather than 'executable'.", "location": {"path": "source/linux/How_to_Guides/Target/How_to_boot_quickly.rst", "range": {"start": {"line": 339, "column": 155}}}, "severity": "INFO"}

Check warning on line 339 in source/linux/How_to_Guides/Target/How_to_boot_quickly.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Spelling] Verify the word 'Initramfs'. It is not in the American English spelling dictionary used by Vale.

Raw Output:
{"message": "[RedHat.Spelling] Verify the word 'Initramfs'. It is not in the American English spelling dictionary used by Vale.", "location": {"path": "source/linux/How_to_Guides/Target/How_to_boot_quickly.rst", "range": {"start": {"line": 339, "column": 52}}}, "severity": "WARNING"}

Check warning on line 339 in source/linux/How_to_Guides/Target/How_to_boot_quickly.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.PassiveVoice] 'be passed' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice.

Raw Output:
{"message": "[RedHat.PassiveVoice] 'be passed' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice.", "location": {"path": "source/linux/How_to_Guides/Target/How_to_boot_quickly.rst", "range": {"start": {"line": 339, "column": 38}}}, "severity": "INFO"}

Check warning on line 339 in source/linux/How_to_Guides/Target/How_to_boot_quickly.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Spelling] Verify the word 'cpio'. It is not in the American English spelling dictionary used by Vale.

Raw Output:
{"message": "[RedHat.Spelling] Verify the word 'cpio'. It is not in the American English spelling dictionary used by Vale.", "location": {"path": "source/linux/How_to_Guides/Target/How_to_boot_quickly.rst", "range": {"start": {"line": 339, "column": 10}}}, "severity": "WARNING"}

.. code-block:: console

host$ chmod -R +x /path/to/filesystem
Comment on lines +339 to +343
Copy link
Copy Markdown
Member

@StaticRocket StaticRocket Apr 6, 2026

Choose a reason for hiding this comment

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

This is a horrible idea


3. Rebuild the kernel

Expand Down Expand Up @@ -370,6 +375,15 @@

This removes 52ms from the boot up time.

- Convert file system to cpio file.

Check warning on line 378 in source/linux/How_to_Guides/Target/How_to_boot_quickly.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Spelling] Verify the word 'cpio'. It is not in the American English spelling dictionary used by Vale.

Raw Output:
{"message": "[RedHat.Spelling] Verify the word 'cpio'. It is not in the American English spelling dictionary used by Vale.", "location": {"path": "source/linux/How_to_Guides/Target/How_to_boot_quickly.rst", "range": {"start": {"line": 378, "column": 26}}}, "severity": "WARNING"}

.. code-block:: console

host$ cd <filesystem>
host$ find . | sort | cpio --reproducible -o -H newc -R root:root > ../tisdk-tiny-initramfs-new.cpio

Pass the new cpio file during kernel build.

Check warning on line 385 in source/linux/How_to_Guides/Target/How_to_boot_quickly.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Spelling] Verify the word 'cpio'. It is not in the American English spelling dictionary used by Vale.

Raw Output:
{"message": "[RedHat.Spelling] Verify the word 'cpio'. It is not in the American English spelling dictionary used by Vale.", "location": {"path": "source/linux/How_to_Guides/Target/How_to_boot_quickly.rst", "range": {"start": {"line": 385, "column": 18}}}, "severity": "WARNING"}

Measurements
------------

Expand Down Expand Up @@ -630,51 +644,85 @@

Filesytem time is measured using minicom time stamp. ( Boot Time via minicom - Kernel time by GPIO = Filesystem Time )

Additional notes
----------------
Additional Steps to Test Early Display

Check warning on line 647 in source/linux/How_to_Guides/Target/How_to_boot_quickly.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Additional Steps to Test Early Display'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Additional Steps to Test Early Display'.", "location": {"path": "source/linux/How_to_Guides/Target/How_to_boot_quickly.rst", "range": {"start": {"line": 647, "column": 1}}}, "severity": "INFO"}
--------------------------------------

.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62PX')

.. note::

Ensure that you are not affecting your host computer when making the changes detailed below.
For early display with OLDI panel, disable bridge-hdmi or sii9022 node in device tree.
Also use fdtoverlay command to modify dtb file (base tree) with dtbo overlay for OLDI panel.

- This statically compiled :download:`modetest </files/modetest>` can be added to the filesystem to test out display at boot on an OLDI panel.
- For early display with OLDI panel, disable bridge-hdmi or sii9022 node in device tree.

- `init` is a symbolic link to /sbin/init. Remove the file sbin/init
.. code-block:: file
Copy link
Copy Markdown
Member

@StaticRocket StaticRocket Apr 6, 2026

Choose a reason for hiding this comment

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

Suggested change
.. code-block:: file
.. code-block:: diff


.. code-block:: console
diff --git a/arch/arm64/boot/dts/ti/k3-am62p5-sk.dts b/arch/arm64/boot/dts/ti/k3-am62p5-sk.dts
index e40abe7afe45..70153e592600 100644
--- a/arch/arm64/boot/dts/ti/k3-am62p5-sk.dts
+++ b/arch/arm64/boot/dts/ti/k3-am62p5-sk.dts
@@ -589,6 +589,7 @@ sii9022: bridge-hdmi@3b {
interrupts = <16 IRQ_TYPE_EDGE_FALLING>;
#sound-dai-cells = <0>;
sil,i2s-data-lanes = < 0 >;
+ status = "disabled";

rm <filesystem>/sbin/init
- Also use fdtoverlay command to modify dtb file (base tree) with dtbo overlay for OLDI panel.

- Create a new sbin/init and add the following.
.. code-block:: console

.. code-block:: sh
host$ fdtoverlay -v -i k3-am62p5-sk.dtb -o merged.dtb k3-am62p5-sk-microtips-mf101hie-panel.dtbo

#!/bin/sh
Later rename merged.dtb to k3-am62p5-sk.dtb when generating linux.falcon.appimage.hs_fs.

mount -t proc none /proc
mount -t sysfs none /sys
mount -t devtmpfs dev /dev
- Add statically compiled :download:`modetest </files/modetest>` to filesystem to test out display at boot on an OLDI panel.

# Run modetest in the background
# 40 - connector ID
# 38 - CRTC ID
# 1920x1200 - resolution of panel
(modetest -M tidss -s 40@38:1920x1200 0<&- 2>/tmp/output.log) &
.. code-block:: console

host$ cd <filesystem>
host$ cp ~/Downloads/modetest <filesystem>/usr/bin
host$ chmod +x modetest

exec /sbin/init.sysvinit $*
- `init` is a symbolic link to /sbin/init. Remove the file sbin/init

You can get the connector ID and CRTC ID of your OLDI panel by running :code:`kmsprint` or :code:`modetest -M tidss`
.. code-block:: console

- Make it executable
host$ rm <filesystem>/sbin/init

.. code-block:: console
- Create a new sbin/init and add the following.

.. code-block:: sh

#!/bin/sh

Check warning on line 696 in source/linux/How_to_Guides/Target/How_to_boot_quickly.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Symbols] Do not use the '!' symbol.

Raw Output:
{"message": "[RedHat.Symbols] Do not use the '!' symbol.", "location": {"path": "source/linux/How_to_Guides/Target/How_to_boot_quickly.rst", "range": {"start": {"line": 696, "column": 13}}}, "severity": "INFO"}

mount -t proc none /proc
mount -t sysfs none /sys
mount -t devtmpfs dev /dev

# Run modetest in the background
# 40 - connector ID
# 38 - CRTC ID
# 1920x1200 - resolution of panel
(modetest -M tidss -s 40@38:1920x1200 0<&- 2>/tmp/output.log) &

exec /sbin/init.sysvinit $*

You can get the connector ID and CRTC ID of your OLDI panel by running :code:`kmsprint` or :code:`modetest -M tidss`
Copy link
Copy Markdown
Member

@StaticRocket StaticRocket Apr 6, 2026

Choose a reason for hiding this comment

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

This shouldn't be a part of the code-block


- Make it executable

.. code-block:: console

$ chmod +x <filesystem>/sbin/init

- Convert file system to cpio file.

.. code-block:: console

chmod +x <filesystem>/sbin/init
host$ cd <filesystem>
host$ find . | sort | cpio --reproducible -o -H newc -R root:root > ../tisdk-tiny-initramfs-new.cpio

Pass the new cpio file during kernel build.

.. ifconfig:: CONFIG_part_variant in ('AM62AX')

Expand Down
Loading