K1C USB Ethernet v1.0.2

K1C USB Ethernet v1.0.2 is a patch release for the documented 2023-generation Creality K1C target.

Changes:

• Fixes boot DHCP acquisition when usb0 is present and UP/LOWER_UP after reboot but has no IPv4 address.
• Waits for USB carrier before running bounded DHCP acquisition.
• Preserves USB Ethernet as primary with metric 50 and Wi-Fi fallback with metric 300 after a successful lease.
• Avoids destructive USB route cleanup after a failed boot DHCP attempt.

The installation procedure, supported hardware scope, and shipped driver module hashes are unchanged from v1.0.1.

K1C USB Ethernet v1.0.1

1.Release Notes: v1.0.1

v1.0.1 is a qualified patch release for the Creality K1C USB Ethernet
runtime. It provides ready-to-install prebuilt runtime archives and a separate
source archive for users who want to compile the three kernel modules
themselves.

Release assets:

• k1c-usb-ethernet-v1.0.1-runtime.tar.gz
• k1c-usb-ethernet-v1.0.1-runtime.zip
• k1c-usb-ethernet-v1.0.1-source.tar.gz
• SHA256SUMS

The runtime TAR and ZIP contain ready-to-install compiled modules. The source
TAR is for compilation and does not contain compiled .ko files.

2. Changes since v1.0.0

• Fixed installer path resolution so install.sh finds package/ beside
  itself even when invoked by absolute path, such as:

  sh /tmp/k1c-usb-ethernet-v1.0.1-runtime/install.sh --enable-boot

• Split release packaging into prebuilt runtime assets and a source-build
  archive.

• Documented the accepted source-build workflow and its external prerequisites.

• Preserved the qualified runtime module hashes.

3. Supported hardware

• Tested printer generation: 2023-generation Creality K1C
• Kernel: 4.4.94
• Module ABI/vermagic: 4.4.94 SMP preempt mod_unload MIPS32_R2 32BIT
• Tested USB adapter:
• UGREEN UR111 USB3.0 to Gigabit Ethernet
• UGREEN CR475 USB 3.0 to Ethernet Adapter, 5 in 1 Multiport Hub

The 2025 K1C revision has not been tested. Compatibility with the 2025 revision
is unknown and is not claimed.

4. Install the prebuilt driver

Use one runtime asset:

• k1c-usb-ethernet-v1.0.1-runtime.tar.gz
• k1c-usb-ethernet-v1.0.1-runtime.zip

Runtime users do not need an SDK, compiler, kernel source tree, or build
environment. Keep Wi-Fi enabled until USB Ethernet and fallback recovery are
verified.

Short TAR flow:

sha256sum -c SHA256SUMS
scp k1c-usb-ethernet-v1.0.1-runtime.tar.gz root@PRINTER_IP:/tmp/
ssh root@PRINTER_IP
cd /tmp
tar -xzf k1c-usb-ethernet-v1.0.1-runtime.tar.gz
sh /tmp/k1c-usb-ethernet-v1.0.1-runtime/install.sh --enable-boot

Installing with --enable-boot installs the boot hook but does not immediately
start Ethernet-primary mode. Start explicitly or reboot.

5. Compile from source

Use:

• k1c-usb-ethernet-v1.0.1-source.tar.gz

The source archive contains the released module sources, build records, and
helper scripts. It does not contain compiled .ko files, a vendor kernel tree,
SDK, toolchain, sysroot, firmware, or private build output.

Source compilation requires separately obtained external prerequisites:

• compatible prepared Creality/Ingenic X2000 Linux 4.4.94 kernel source;
• matching generated kernel configuration and headers;
• Ingenic-compatible MIPS toolchain.

For the accepted K1C configuration, CONFIG_MODVERSIONS is disabled. A
top-level kernel Module.symvers was not required in the accepted workflow;
Kbuild generated a module-local Module.symvers during modpost.
source/Module.symvers.known-good is a 53-symbol module-export reference, not
a full kernel symbol table.

Output hashes may differ because kernel modules can embed build paths. Runtime
ABI compatibility is checked through source identity, target configuration,
architecture, vermagic, dependencies, and verification output, not universal
byte-for-byte reproducibility.

6. Verify downloads

Download SHA256SUMS and the assets you plan to use, then run:

sha256sum -c SHA256SUMS

SHA256SUMS covers exactly:

• k1c-usb-ethernet-v1.0.1-runtime.tar.gz
• k1c-usb-ethernet-v1.0.1-runtime.zip
• k1c-usb-ethernet-v1.0.1-source.tar.gz

Only use assets that report OK.

7. Upgrade from v1.0.0

The v1.0.1 installer refuses an existing package-owned installation. Keep Wi-Fi
SSH available, then stop and uninstall v1.0.0:

/usr/data/k1c-usb-ethernet/vendor-native-known-good/stop-primary-ethernet.sh
/usr/data/k1c-usb-ethernet/vendor-native-known-good/uninstall-usb-ethernet.sh --yes

Install v1.0.1 after v1.0.0 is removed.

8. Start and status

Start immediately:

/usr/data/k1c-usb-ethernet/vendor-native-known-good/start-primary-ethernet.sh

Check status:

/usr/data/k1c-usb-ethernet/vendor-native-known-good/ethernet-failover-status.sh

Expected route behavior while USB is healthy:

• USB Ethernet default route metric 50
• Wi-Fi fallback default route metric 300
• gateway lookup from the USB address selects usb0

9. Uninstall and recovery

Disable boot integration:

/usr/data/k1c-usb-ethernet/vendor-native-known-good/disable-primary-ethernet-boot.sh

Uninstall:

/usr/data/k1c-usb-ethernet/vendor-native-known-good/uninstall-usb-ethernet.sh --yes

Keep Wi-Fi enabled during installation and testing so you can recover over Wi-Fi
SSH if USB Ethernet fails.

10. Known limitations

• Unofficial community release; not affiliated with or supported by Creality.
• Physical support claim is limited to the documented 2023-generation K1C.
• 2025 K1C compatibility is unknown and not claimed.
• The source-build workflow requires external vendor/toolchain inputs not
  redistributed here.
• Self-built modules must be validated before use on a printer.

11. Source and license compliance

The runtime archives include compiled Linux kernel modules. The source archive
includes corresponding module source files and build records.

COPYING contains the Linux kernel GPLv2 text. LICENSE.md explains the
mixed-license structure and does not claim that kernel-derived source or
modules are MIT-licensed.

12. Qualification summary

Runtime physical qualification passed across installation, reboot persistence,
Ethernet-cable loss and recovery, physical USB adapter removal and recreation,
uninstall, and final reinstall.

Source-build acceptance passed from a fresh source archive using a prepared K1C
kernel tree and Ingenic-compatible MIPS toolchain. All three built modules were
ELF32 LSB MIPS/MIPS32 rel2 and used vermagic
4.4.94 SMP preempt mod_unload MIPS32_R2 32BIT.

K1C USB Ethernet v1.0.0

Compatibility

• Tested printer generation: 2023-generation Creality K1C
• Kernel 4.4.94
• ABI/vermagic 4.4.94 SMP preempt mod_unload MIPS32_R2 32BIT
• ASIX 0b95:1790 adapter tested

Tested only on a 2023-generation Creality K1C running kernel 4.4.94 with the documented module ABI. The 2025 K1C revision has not been tested; compatibility is unknown and is not claimed.

Creality K1C Ethernet Driver Build Tools v0.1.1

v0.1.1 makes the project easier to build, install, and maintain.

Changes:

• rewrote the build, installation, configuration, and troubleshooting guides;
• added real filenames and copy-ready commands;
• improved help output for user-facing scripts;
• documented the known Ingenic X2000 Linux 4.4.94 source package;
• added the Ingenic Halley5/X2000 Baidu share and access code;
• added an MIT license for the project's original scripts and documentation;
• removed generated release archives and manifests from the Git branch;
• cleaned up empty and maintainer-only files;
• added documentation, license, and repository-cleanup regression tests.

Known external source package:
ingenic-linux-kernel4.4.94-x2000_v12-v8.0-20220125.tar.bz2

This release does not include prebuilt kernel modules, the Ingenic source
archive, a vendor SDK, firmware, or a cross-toolchain. External source,
toolchains, firmware, and locally compiled kernel modules remain subject to
their own licenses.

Creality K1C Ethernet Driver Build Tools v0.1.0

This release does not contain prebuilt kernel modules.

It provides build, verification, local packaging, deployment, installation,
configuration, Wi-Fi fallback, rollback, diagnostic, and uninstall tools for
users who have independently obtained a compatible kernel source tree and
cross-toolchain through authorized channels.

This is an unofficial community project and is not affiliated with,
endorsed by, or supported by Creality.

Included

• Scripts and documentation for local build orchestration.
• Build-environment validation.
• Kernel-tree compatibility inspection heuristics.
• Local module metadata verification.
• Local runtime package creation.
• Printer deployment and installation helpers.
• Wi-Fi fallback handling with both KEEP_WIFI_FALLBACK=1 and KEEP_WIFI_FALLBACK=0 supported.
• Boot-start enable/disable helpers, rollback, diagnostics, and uninstall support.

Not Included

• No vendor SDK is included.
• No vendor source is included.
• No firmware is included.
• No cross-toolchain is included.
• No prebuilt kernel modules are included.
• No unofficial SDK download link is provided.

Generic upstream Linux 4.4.94 is not guaranteed compatible. Users must provide a compatible source and build basis through authorized channels. Locally compiled modules are not distributed by this project. Anyone redistributing compiled modules is responsible for applicable source, notice, and licensing obligations.

Default installation leaves automatic boot startup disabled until connectivity testing passes.

Workflow

1. Obtain compatible source and toolchain through authorized channels.
2. Copy and edit build.env.example.
3. Validate the build environment.
4. Inspect kernel compatibility.
5. Prepare the kernel tree outside this repository.
6. Build the three modules locally.
7. Verify module metadata.
8. Create a local runtime package.
9. Deploy over the printer's Wi-Fi connection.
10. Test Ethernet and Wi-Fi fallback.
11. Enable automatic startup only after successful testing.

Documentation

Start with README.md, docs/SOURCE-ACQUISITION.md, docs/REQUIREMENTS.md, docs/BUILD.md, docs/VERIFY.md, docs/PACKAGE.md, docs/INSTALL.md, docs/CONFIGURATION.md, docs/UNINSTALL.md, docs/TROUBLESHOOTING.md, SECURITY.md, DISCLAIMER.md, and THIRD-PARTY-NOTICES.md.

SHA-256

e183bfc1e411411d2d7a16c6c309262be85727afb675b1caa350ac363e2e009a  dist/k1c-usb-ethernet-build-tools-v0.1.0.tar.gz
324426d0e236b14e0f93609819ccc9c5492471ebf55db1764c0a8877e9779330  dist/k1c-usb-ethernet-build-tools-v0.1.0.zip