Build guide · C5_USBNIC

Wired Ethernet for the Flashforge Creator 5 Pro

The Creator 5 Pro is Wi-Fi only. A USB gigabit adapter and a driver built for the printer's kernel give it a wired connection, and Wi-Fi stays on as a fallback.

Project: github.com/DIEHARDave/C5_USBNIC

Why bother?

Printers often sit in a garage or workshop where Wi-Fi is weakest. Large print files, camera streams and Spoolman lookups all go faster and more reliably over a cable. The printer has a USB port, but its kernel doesn't include a driver for USB network adapters. C5_USBNIC adds one.

What you need

A Creator 5 Pro whose kernel reports uname -r = 5.10.186+.
Zmod installed. Its boot hook starts the driver.
SSH access as root. The printer's Dropbear doesn't accept ed25519 keys, so use ssh-keygen -t ecdsa or RSA.
A USB gigabit adapter with a Realtek RTL8153 chip (USB ID 0bda:8153).

Check the chip, not the brand. The driver is Realtek's mainline r8152, so any RTL8153 adapter works. Adapters with ASIX or other chips won't. On a Linux PC, lsusb should show 0bda:8153.

Install

From Linux or WSL, clone the repository and run:

printer/install.sh root@PRINTER_IP

The script checks the printer's kernel version, then copies the prebuilt modules, startup scripts and the RTL8153B firmware patch to /usr/data/r8152/. It also adds one line to Zmod's boot hook. Reboot, or start it right away with the command the script prints. To remove it, run printer/uninstall.sh root@PRINTER_IP.

How it behaves

Ethernet gets its address by DHCP. Give the adapter a DHCP reservation in your router for a fixed address.
While the cable is connected, Ethernet is preferred. Unplug it, or turn Wi-Fi off, and traffic falls back to the other link.
Each address only answers on its own interface, so the Wi-Fi address is unreachable while Wi-Fi is off.
DNS servers from both links are kept.

Is it safe?

Flashforge doesn't publish its kernel source, so the modules are built from vanilla Linux 5.10.186 with patches that reproduce the vendor kernel's struct layouts. A module built against the wrong layouts loads fine and then corrupts memory. That's why the build was checked function by function against the printer's own kernel. The verification notes are in the README.

If a Flashforge firmware update changes the kernel version, the modules must be rebuilt and re-verified. The installer refuses to install on a kernel it doesn't recognize.

Results

On my Creator 5 Pro running Zmod 1.7.4 with HelixScreen: gigabit link, DHCP at boot, 50 MB transferred each way with no errors, and Wi-Fi failover working in both directions.