Introduction
Onlogic Factor 201 (FR201) is a device based on the Raspberry Pi (RPi) Compute Module 4 (CM4). To use EVE-OS on FR201, build an installer image for Raspberry Pi 4, described as follows, and flash it on a USB stick. Then, to enable FR201's specific subdevices, the boot configuration has to be manually edited.
In summary, generating installer images is the same process for x86 and arm64 generic devices. However, there two important things related to FR201:
- The config.txt must be set up properly (uncomment and comment related lines).
- Custom grub.cfg must be set up properly for devices without eMMC.
Prerequisites
- EVE-OS 14.5.0-lts or greater.
- Only KVM is supported.
- You must have a blank bootable USB stick.
Steps
From EVE-OS version 14.5.0-lts or greater, you can use images from docker hub to build an image for your FR201.
-
To build a raw image, type the following command in your terminal:
docker run lfedge/eve:14.5.0-lts-kvm-arm64 installer_raw > /tmp/eve-arm64-installer.raw
- Flash the /tmp/eve-arm64-installer.raw EVE-OS image onto a USB stick.
-
Edit the file config.txt of the 1st partition of the live/installer image, two lines must be changed, as shown by the following diff syntax:
--- config.txt_OLD 2024-10-21 14:01:02.782670479 +0300
old
+++ config.txt 2024-10-21 14:01:11.042670420 +0300
new
@@ -30,7 +30,7 @@
# but for advantech uno-220 we need to set ce to 0x00
# https://github.com/Advantech-IIoT/UNO-220-POE-/tree/master/srcs/dtbo/tpm#notes
# PS: Comment this line for OnLogic FR201 device-dtoverlay=bcm2711-spi-tpm-slb9670,ce=0x01
old
+#dtoverlay=bcm2711-spi-tpm-slb9670,ce=0x01new
# Disable warning overlays as they don't work well together with linux's graphical output
avoid_warnings=1
@@ -49,4 +49,4 @@
# Uncomment for the following line for OnLogic FR201# Don't forget to disable overlay bcm2711-spi-tpm-slb9670
-#include fr201.txt
old
+include fr201.txtnew
- Boot or install EVE-OS, using the USB 3.0 port. The installer will install EVE-OS on the eMMC drive, using the NVMe as the persist drive. If an OS is already present on those two drives, see the Onlogic documentation on how to erase them and be able to boot from the USB stick.
Caveat for FR201 without eMMC
Some variants of the FR201 don't have an internal eMMC. For these devices, EVE-OS must be installed entirely in the internal NVMe. The following line must be added to the grub.cfg file inside the CONFIG partition of the installer USB stick:
set_global dom0_platform_tweaks "eve_install_disk=sdb"