gk7202v300: add ultimate variant + ship rtl8188fufw blob from the FU package#2157
Merged
Conversation
The Realtek 8188FTV firmware blob was sitting inside the rtl8188eus-openipc package and was only installed when BR2_PACKAGE_RTL8188EUS_OPENIPC=y — which no production defconfig sets. As a result, every board that enabled BR2_PACKAGE_RTL8188FU_OPENIPC=y (e.g. hi3518ev200_ultimate) built the kernel module but never shipped /lib/firmware/rtlwifi/rtl8188fufw.bin, so the 8188fu driver could not bring up the dongle. Move the blob into the FU package and install it from a POST_INSTALL hook there, mirroring the install idiom that previously lived in the EUS .mk. Drop the matching hook + license note from rtl8188eus-openipc. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The OpenIPC Installation Guide already advertises a gk7202v300-nor-ultimate firmware but no such image has ever been built — only the lite defconfig existed. Add the ultimate defconfig, modelled on gk7205v200_ultimate (same SoC family) with the gk7202v300 kernel config and SOC_MODEL, and wire it into the CI matrix. Enable BR2_PACKAGE_RTL8188FU_OPENIPC=y plus the linux-firmware RTL_8188EU set so the 16 MB image natively drives an RTL8188FTV USB dongle (0bda:f179, /etc/wireless/usb rtl8188fu-generic), which is what the reporter of #2153 has wired to the BM002-IPC-GK7202-PCB-V10 board. Local build verified: uImage 1890/2048 KB, rootfs.squashfs 7064/8192 KB, 8188fu.ko and /lib/firmware/rtlwifi/rtl8188fufw.bin both present in the squashfs. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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
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.
Summary
Closes #2153 (no
gk7202v300ultimate build + RTL8188FTV not working) and fixes #1906 (HI3518EV200 ultimate same RTL8188FU firmware-blob symptom) as a side effect.rtl8188fu-openipc: thertl8188fufw.binfirmware blob was sitting insidertl8188eus-openipc/and was only installed whenBR2_PACKAGE_RTL8188EUS_OPENIPC=y, which no production defconfig sets. Boards that enabledBR2_PACKAGE_RTL8188FU_OPENIPC=y(e.g.hi3518ev200_ultimate) therefore compiled8188fu.kobut never shipped/lib/firmware/rtlwifi/rtl8188fufw.bin, so the driver couldn't bind. Moved the blob into the FU package and install it from aPOST_INSTALLhook there.gk7202v300_ultimate_defconfig(new): cloned fromgk7205v200_ultimate_defconfig(same SoC family) with thegk7202v300.generic.configkernel config andSOC_MODEL=gk7202v300. AddsBR2_PACKAGE_RTL8188FU_OPENIPC=yandBR2_PACKAGE_LINUX_FIRMWARE_OPENIPC_RTL_8188EU=yso the 16 MB ultimate image natively drives the reporter's RTL8188FTV (USB0bda:f179) via the existing/etc/wireless/usb rtl8188fu-genericshim.gk7202v300_ultimateto the ultimate matrix in.github/workflows/build.yml.Local-build verification (
make BOARD=gk7202v300_ultimate)unsquashfs -l rootfs.squashfs.gk7202v300 | grep -E '8188fu|rtl8188fufw|wpa_supplicant':Both the driver and the firmware blob land in the squashfs at the expected paths. Image fits comfortably within the NOR-16 MB caps.
Out of scope
gk7202v300_litewas deliberately not modified — adding the FU driver+blob to the 8 MB rootfs (already close to the 5120 KB cap) needs a separate size-budget audit. The reporter's hardware ships with 16 MB NOR, so the ultimate path covers their case.fw_setenv wlandev rtl8188fu-generic→ reboot →wlan0associates) should be done by the issue reporter or a lab board after merge.hi3518ev200_ultimatewas not run locally (Buildroot mirror was flaky enough that one full build took multiple retries with hand-seededdl/tarballs); the CI matrix will exercise it on this PR.Test plan
gk7202v300_ultimatecleanlyhi3518ev200_ultimatecontinues to pass (no regression from the blob relocation)wlan0comes up withwlandev=rtl8188fu-generic🤖 Generated with Claude Code