README: update Onlogic FR201 installation and boot configuration#5664
Merged
rene merged 1 commit intolf-edge:masterfrom Mar 11, 2026
Merged
README: update Onlogic FR201 installation and boot configuration#5664rene merged 1 commit intolf-edge:masterfrom
rene merged 1 commit intolf-edge:masterfrom
Conversation
rene
reviewed
Mar 10, 2026
| Onlogic Factor 201 (FR201) is a device based on the Raspberry Pi Compute Module 4 (CM4). To use EVE on FR201, build a live or installer image for Raspberry Pi 4, as described below and flash it on a USB stick. Then, to enable FR201's specific subdevices, the boot configuration has to be manually edited. | ||
| Onlogic Factor 201 (FR201) is a device based on the Raspberry Pi Compute Module 4 (CM4). There are two methods to install EVE on the FR201: flashing a live image directly using rpiboot, or using the USB installer. | ||
|
|
||
| #### Method 1: Direct installation using rpiboot (recommended) |
Contributor
There was a problem hiding this comment.
I don't think this is the recommended procedure, it requires open the device, set specific jumpers. Let's just provide the options and let users decide which one fits better for their requirements. So I would remove the (recommended) from the title.
rene
reviewed
Mar 10, 2026
| installer USB stick: | ||
|
|
||
| ```sh | ||
| set_global dom0_platform_tweaks "eve_install_disk=sdb rootdelay=10" |
Contributor
There was a problem hiding this comment.
Don't remove the rootdelay=10. I think you just need to provide some explanation like the following:
- In certain hardware configurations (particularly when dealing with various USB stick controller speeds or slower NVMe initialization) the kernel may fail to recognize the bootable device within the standard 10-second timeout provided by
rootdelay=10. To resolve persistent detection issues, you can replacerootdelay=10with therootwaitparameter in the kernel command line.
Then you keep the warning below.....
Update the documentation for the Onlogic FR201 to include a recommended direct installation method using `rpiboot`. This allows flashing EVE directly to the internal eMMC or NVMe storage from a host machine, bypassing the need for a USB installer. Additionally: - Clarify the USB installer workflow and required `config.txt` edits. - For devices without eMMC, switch from `rootdelay=10` to `rootwait` in the boot configuration to improve NVMe detection reliability. - Add a warning regarding the potential for `rootwait` to cause indefinite boot stalls if the target disk is not detected. Signed-off-by: Othonas Soultatos <othonas.s@gmail.com>
rene
approved these changes
Mar 11, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Update the documentation for the Onlogic FR201 to include a recommended direct installation method using
rpiboot. This allows flashing EVE directly to the internal eMMC or NVMe storage from a host machine, bypassing the need for a USB installer.Additionally:
config.txtedits.rootdelay=10torootwaitin the boot configuration to improve NVMe detection reliability.rootwaitto cause indefinite boot stalls if the target disk is not detected.PR dependencies
None
How to test and validate this PR
Documentation edits, nothing to test
Changelog notes
Updated documentation of how EVE can be installed in Onlogic FR201 and FR202 devices.
PR Backports
Checklist
And the last but not least:
check them.