Factor FR201 and FR202 Technical Resources

This article also applies to the IGN801(FR201) and IGN802 (FR202).

Manuals and Downloads

FR201 – User Manual

FR202 – User Manual

Raspberry PI Imager

Raspberry Pi Firmware Tool (for eMMC)

Configuration Files (required when installing an OS):

Bullseye 32bit files- Download
Bullseye 64bit files – Download

Bookworm 32bit files- Download
Bookworm 64bit files – Download

**If installing to FR202, you will need to add the lines to the config.txt file noted in the FR202 Demo Program section below for Bullseye.

Frequently Asked Questions (FAQ)

System Setup

• To get started, connect a keyboard, mouse, and monitor before powering up the system.
• If you purchased the standard 60 watt power supply, it will be pre-wired and ready for use.

• For the dinrail power supply, connect the wires as shown below. V+ to the red wire, V- to the black.

First Boot

This section covers what to expect the first time you power your system on.

No OS

If you did not select an operating system when ordering, the system will boot up to a diagnostic splash screen. You can install an operating system using the steps further down on this page.

Raspberry Pi OS

Raspberry Pi OS (Lite)

The Lite version of Raspberry PI OS (Raspbian) boots straight to a login prompt.

• Log in with the following credentials:
• username: pi
• password: raspberry

• You will be prompted to change the default password on first login. re-enter “raspberry” as the current password, and then set your new password.
• The system is now ready for use.

Ubuntu Desktop

Ubuntu Server

Ubuntu server boots straight to a login prompt.

• Log in with the following credentials:
• username: ubuntu
• password: ubuntu

• You will be prompted to change the default password on first login. re-enter “ubuntu” as the current password, and then set your new password.
• The system is now ready for use.

Disassembly

FR201 Disassembly

• You now have access to the FR200 motherboard. Components such as the TPM, storage drives, and wireless modules

• It is recommended not to disassemble the unit any further unless absolutely necessary. Further disassembly has greater potential to cause warranty voiding damage. Use caution.

• Re-install the module by lining up the screw holes. Gently pop it down into the sockets.
• Note: the screws will not line up if the module is rotate 180 degrees.

---

FR202 Disassembly

• You will now have access to the I/O board. This connects to the FR202 motherboard via the Raspberry Pi GPIO connector (shown below on the LEFT). Note that models with LCD screens will have the x2 additional connectors (shown below on the RIGHT).
  
  Remove the x4 5mm hex standoffs to loosen the I/O board. You can now disconnect the GPIO connector to get access to the FR202 motherboard.
  
  *Note: If your system has an LCD, be careful of the x2 additional connectors on the right.

• You now have access to the FR200 motherboard. Components such as the TPM, storage drives, and wireless modules

---

Installing Operating Systems

Factor series systems currently support Ubuntu 20.04, Ubuntu 22.04, and Raspberry Pi OS (Bullseye and Bookworm) OSes. Other OSes or versions may not install or function properly.

Follow the steps below to install one of these operating systems. Make sure to verify if your system has eMMC storage or not. Many systems shipped from OnLogic have the OS installed onto the M.2 SATA drive.

---

Installing Ubuntu to SATA M.2 Storage

A USB flash drive smaller than the system’s storage is required for this method. Example: The Factor system has 32GB storage. The flash drive must be 16GB or smaller.

The Factor series systems are compatible with Ubuntu versions 20.04 and 22.04 (both Desktop and Server). Other versions are not supported and may present errors during installation or general use. You can review the supported OS in the FAQs section above.

• Download the the zipped file below and copy them to the boot partition, overwriting the existing two files

Ubuntu Config Files: Download

Log in to the newly installed OS. See default credentials here. (typically ubuntu/ubuntu)

• We will now clone the flash drive onto the desired storage drives. Following the example above, run a DD command:

• Install to M.2: sudo dd if=/dev/sda of=/dev/sdb status=progress
• Install to eMMC: sudo dd if=/dev/sda of=/dev/mmcblk0 status=progress

• Shut down the system and unplug your flash drive.
• Power the system back on and it will boot up into the operating system. The installation is now complete.

32Bit Ubuntu Desktop

32bit Ubuntu Desktop can not be installed directly. You must first install Ubuntu Server using one of the methods above. Once server is up and running, the following procedure will install the desktop environment.

---

Wiping the eMMC or SATA M.2 storage drive

The CM4 module has a hardcoded boot order of eMMC > SATA M.2 > USB. This can be problematic if the image on the eMMC or SATA M.2 becomes corrupted or needs to be erased for other reasons. The simple solution is to erase the boot partition. This can be done one of two ways.

Wiping eMMC using another computer

Note that this method can only by used to wipe eMMC storage, not a SATA M.2

Wiping eMMC or SATA M.2 using DD

If the Linux image on the Factor unit is still bootable, you can use the terminal to erase the boot partition.

• Run the lsblk command to list the storage devices
• In this example, the boot partition is stored on /dev/mmcblk0p1
• The following command will copy zeroes over that partition, effectively wiping it and preventing the Pi from booting to it.

sudo dd if=/dev/zero of=/dev/mmcblk0 status=progress

A SATA M.2 storage drive will likely show up as sdb, so this command will wipe the M.2’s boot partition:

sudo dd if=/dev/zero of=/dev/sdb status=progress

Once the drive wipe has completed, proceed to one of the operating system installation guides on this page.

---

Factor Series Features

Setting the Serial Mode (RS232/RS422/RS485)

The FR200 series serial mode can be controlled by configuring the embedded FTDI EEPROM. You will need to install the utility before updating the serial mode.

Installing the EEPROM Tool

• Install required libraries: sudo apt install libconfuse-dev libusb-1.0-0-dev
  and build tools: sudo apt install cmake build-essential
• Download the latest libFTDI Source .tar.bz2 from the Intra2Net page here:
  https://www.intra2net.com/en/developer/libftdi/download.php|
  Example:
  wget https://www.intra2net.com/en/developer/libftdi/download/libftdi1-1.5.tar.bz2
• Extract the download to a folder.
  Example:
  tar -xf libftdi1-1.5.tar.bz2
• Build the library and the FTDI EEPROM tool:
  • mkdir libftdi1-1.5/build && cd libftdi1-1.5/build
  • cmake -DCMAKE_INSTALL_PREFIX="/usr" ../
  • make && sudo make install
• Alternatively, you can also clone libFTDI with git: git clone git://developer.intra2net.com/libftdi

Setting the Configuration

• Download the configuration file for your required mode:
  • RS232 – wget static.onlogic.com/resources/firmware/documentation/configs/FR200_RS232.conf
  • RS422 – wget static.onlogic.com/resources/firmware/documentation/configs/FR200_RS422.conf
  • RS485 – wget static.onlogic.com/resources/firmware/documentation/configs/FR200_RS485.conf
• Flash the EEPROM image: sudo ftdi_eeprom --flash-eeprom FR200_<protocol>.conf
  • RS232 Example: sudo ftdi_eeprom --flash-eeprom FR200_RS232.conf
• Reboot for changes to take effect: sudo shutdown -r now

With the serial port configuration enabled, the port will now enumerate as /dev/ttyUSB[x], where [x] is the port number. This is typically /dev/ttyUSB0, but may be enumerated differently depending on other USB devices connected. You can also identify the serial port chip via the hardware ID, which is F81439A.

TPM

The TPM is an optional Nuvoton-based hardware add-on for the FR200 series systems.

You can download the required Device Tree files and Readme installation instructions from here:

FR200 Series TPM Files

PoE

Important notes about Factor PoE (Power Over Ethernet) PD setup and the various revisions of the module.

• Do not connect both power inputs at the same time. Only connect x1 power connection (either PoE OR terminal block).
• Review specific details in the specific models below
  

ADP125

The ADP125 is an isolated PoE PD (powered device) modules. Factor series systems configured and shipped in August 2024 or later have this version of the module. This offers isolation/protection from transient voltage of up to 100KV.

ADP122

Important notes about Factor PoE (Power Over Ethernet) setup when using the ADP122 addon module:

• Do not connect both power inputs at the same time. Only connect x1 power connection (either PoE OR terminal block).
  

The ADP122 is a non-isolated PoE PD (powered device) module. The FR200 product family provides a ground scheme that isolates digital and chassis ground. Downstream equipment may modify this ground scheme by shorting chassis and digital ground together within the cabling or attached circuitry. Downstream or upstream devices that depend on isolated digital and shield/chassis grounds may experience performance degradation as a result of this equipment.

In the event of a break in ground scheme due to installation environment and connected equipment, there is no safety concern.  However, equipment that depends on ground isolation for protection or measurement may experience loss of performance including, but not limited to, inaccuracy of power measurement or power delivery or equipment damage.

You can review additional details in the Errata document below:

---

FR202 Features

Functions listed in this FR202 Features section are in addition to the Factor Series Features section above, and for the FR202 system only. The below features and not available on the FR201 platform.

Note: For the best experience, always update to the latest firmware version before testing these commands.

Firmware Updates

Version	Release Date	Link	Release Notes
1.3.1.0	09/15/2023	Download	Improves the stability of the “byte mode” protocol
1.2.5.1	Initial launch	Download	Initial launch

Digital IO (DIO)

The FR202 Digital IO is connected to the CM4 via a virtual USB-CDC-ACM serial port; you can see that the USB device is detected using lsusb and OnLogic’s USB Vendor ID:

lsusb -d 353f:

Data can be sent to the device over its virtual serial port, which will be available in /dev :

ls /dev | grep ACM

The serial port can operate either as an interactive UART terminal, or as an endpoint for raw byte commands.

UART Terminal

The FR202’s UART shell supports line editing, history, and TAB completion. Digital inputs and outputs are collected into groups, and dio commands are performed on those groups.

For instance, DO_G0 is “Digital Output Group 0”. A complete list of devices can be produced by running device list. Once you have selected a device, dio commands may be run:

Subcommand	Example	Description
set	dio set DO_G0 0 true	Set the logical state of a digital output to true or false
get	dio get DO_G0 output 0	Get the current logical state of a digital input or ouput
num	dio num DO_G0 ouputs	Report the number of input/output pins available to an IO bank
mode	dio mode DO_G0 open-drain	Configure digital outputs to source or sink current, when supported
pwm	dio pwm DO_G0 0 1000000 50	Set an output as PWM with period in microseconds, and duty in percent
edge	dio edge DO_G0 0	Get the number of rising and falling edges detected by a digital input

To exit the interactive terminal and enter byte-processing mode, run the byte_mode command.

For information about other terminal commands, see: Shell Commands

Front Display

Demo Application

A sample application demonstrating some simple features of the display is provided for each of the supported Operating systems here:

On systems pre-installed with an OS from OnLogic, the display demo files are located under /usr/sbin/demo-display and /etc/systemd/system/demo-display.service

Pieces of this sample package are referenced in the display sections following. It also ships on all OnLogic-provided Pi OS and Ubuntu software images, enabled by default. To disable it, run sudo systemctl disable demo-display from a terminal window.

If you have deployed Bookworm onto your Factor unit since receiving it you may see the demo program not work right away. If you see this behavior please type `raspi-config` in the Linux terminal, select `Interface Options` then select `I2C` and enable it.

Display IC Part Numbers

Display Controller:    ST7789V

Controlling the Backlight

Touch Controller:      ST1633i

Display backlight is controlled by an i2c expander at 0x3C on I2C1. 

The OnLogic-provided utility “fr202-i2c” can control the backlight with the commands:

Enable: fr202-i2c set p7v6_shdn 0

Disable: fr202-i2c set p7v6_shdn 1

A list of other controllable signals is available in the help text for the tool. It is provided with the display code samples as well as 

The backlight can also be enabled using the i2ctools utilities as follows:

Configure GPIO IC: i2cset -y 1 0x3c 0x03 0x81

Enable: i2cset -y 1 0x3c 0x01 0xbf

Disable: i2cset -y 1 0x3c 0x01 0xff

Images, Text, and Touch via Python

pip install st7789

apt install python3-rpi.gpio python3-spidev python3-pil python3-numpy 

The provided python example “demo-display” demonstrates the use of Python’s PIL and the ST7789 display library to display static images and text. It runs as a service in OnLogic-provided Pi OS and Ubuntu installations as well.

Video via Python

pip install opencv-python

apt install libatlas-base-dev

pip install -U numpy

The separately provided example “st7789-video” demonstrates the use of opencv’s video library to show a video on-screen. By default, the sample is configured to read and display a video called “test.avi” in the same folder as the application. A video is not provided.

ADC (Analog/Digital Converter)

The ADC is attached to SPI 4 CS0. Look for this device name in your OS hardware list.
Example: /dev/spidev4.0 

The ADC part number is LTC2448; a description of the SPI protocol can be found in the device manual here.

An example of accessing the ADC can be found in the FR202-demo program as well. You can download it from here. Search for “adc” in the demo-display file for examples.

All ADC channels are differential and configured as follows:
ANALOG IN 0: Channel 0+1

ANALOG IN 1: Channel 2+3

ANALOG IN 2: Channel 4+5

ANALOG IN 3: Channel 6+7

TEMPERATURE 0: SENSOR Channel 8+9, REFERENCE Channel 10+11

TEMPERATURE 0: SENSOR Channel 12+13, REFERENCE Channel 14+15

Troubleshooting

General OS/system issues

If you are encountering general issues with your FR200 series system, such as the Real-Time-Clock (RTC) disconnecting, various ports not being detected, or features not working as expected, make sure you’re using the OnLogic provided config.txt and usercfg.txt files. These add additional functionality to the system, and allow the Raspberry Pi CM4 module to properly interface with the OnLogic designed FR200 series daughterboards. You can download the files from the Manual and Downloads section above.

You should make sure that any Factor (FR201 and FR202) units have the following lines in the config.txt file:

# Enable the audio output, I2C and SPI interfaces on the GPIO header. As these
# parameters related to the base device-tree they must appear *before* any
# other dtoverlay= specification
dtparam=audio=on
dtparam=i2c_arm=on
#dtparam=spi=on

For the FR202 specifically, you will also need to ensure the config.txt file includes:

dtoverlay=spi4-1cs
dtoverlay=spi3-1cs,cs0_pin=24
dtoverlay=i2c5,pins12_13=on,baudrate=40000

---

Missing/Disabled Ethernet port in Ubuntu

If one of the Ethernet ports is not detected or shows as Disabled in Ubuntu, you can follow these steps to add it into Netplan and enable it.

1. Run the following command:

lshw
Network: DISABLED

2. Look for the Logical name, which is required in the next step, and run the following commands

cd /etc
cd netplan
sudo nano 50-cloud-init.yaml

3. Add the logical name (found in Step 2) to the 50-cloud-init.yaml file. See an example below:

4. Close and save, then run the following commands

sudo netplan apply
reboot

---

TPM module not working/detected

If the TPM modules is not working properly, or failing to be detected, make sure that the usercfg.txt files includes the following lines (you may need to modify existing lines):

#to enable tpm SPI
dtoverlay=tpm-nuvoton

---

Booting via USB results in black screen

Booting Ubuntu via USB may result in a black screen if the eMMC has an OS image on it. Wiping the eMMC and/or M.2 drive is recommended if that is encountered.

---

Power LED does not turn on

Some operating system versions require different config.txt settings to make the power indicator light function. If your Factor unit is otherwise functional, but the power indicator light is not lighting up, this is likely an issue with the config.txt file. Look for the following lines in the file:

dtparam=pwr_led_trigger=backlight
drparam=pwr_led_activelow=on

Replace those lines with

dtparam=pwr_led_trigger=default-on
dtparam=pwr_led_activelow=off

---

Display Demo Program not working

If you’re seeing issues using the FR202 LCD display, or seeing errors when running the FR202-demo scripts, make the following changes to your config.txt file:

Delete/comment out:
dtparam=spi=on

Add:
dtoverlay=spi4-1cs
dtoverlay=spi3-1cs,cs0_pin=24
dtoverlay=i2c5,pins12_13=on,baudrate=40000

After making any changes, save and restart the operating system.

Experiencing Slow Wi-Fi Speeds

The Factor’s CM4 compute module has a built-in Wi-Fi antenna that it uses by default instead of the attached external antenna. The config file /boot/firmware/config.txt (or /boot/config.txt depending on your OS) may need to be updated for the CM4 to use the external antenna to connect to Wi-Fi instead of its internal one. To do this, open the specified config file and add the line ‘dtparam=ant2’ and then rebooting your system. This should provide a noticeable improvement in Wi-Fi speeds.

Wi-Fi or Modem Not Connecting to Internet

In a Factor with 4G LTE and Wi-Fi, there can be an issue where the devices “compete” for priority over each other, preventing them from connecting properly to the internet. To resolve this, you will need to set the priorities for the devices in the ‘/etc/dhcpcd.conf’ file for the Raspberry Pi OS and in the netplan configuration for the Ubuntu OS. You can do this by entering the following into the configuration file:

interface wlan0
metric 100
interface eth0
metric 200

The lower the metric, the higher priority. So in this example, the WIFI device (wlan0) will take priority over the ethernet. What that is doing is ensuring that the WIFI device’s default route is being used to route network traffic. The customer may need to set priorities for each network device, which for Factor is eth0, eth1, wlan0, and usb0, where usb0 is the AMIT card.