Dmitry IlyinandGitHub
a225f75f6d
Follow-up to OpenIPC/firmware#2410, which left MT7601U as the only in-tree USB Wi-Fi stack on hi3518ev300. RTL8188EU lands here as a camera profile, splitting the two adapters across the two repositories. hi3518ev300_lite_generic-rtl8188eu builds the driver INTO the kernel rather than shipping it as a module: a profile whose only Wi-Fi is that driver has no reason to carry it as loadable code, and the rootfs is the partition under pressure. The out-of-tree rtl8188eus-openipc cannot make that move -- it is an external kernel-module package, never linked into vmlinux -- so this uses the in-tree staging driver at CONFIG_R8188EU=y through a variant kernel config, the same shape as gk7205v200.generic-otg.config. Built in, the driver also has no modprobe problem: as a module it was unreachable, because /etc/wireless/usb's rtl8188eu-generic profile modprobes '8188eu' while the in-tree module is 'r8188eu'. Linked into the kernel it binds off its own USB device table at boot. CONFIG_R8188EU selects WIRELESS_EXT, so the wext ABI firmware#2410 dropped comes back on this variant only. It requests rtlwifi/rtl8188eufw.bin, so linux-firmware-openipc comes with it. Registered in .github/firmware-drift.json against the firmware blob it derives from. MEASURED in CI, against the module-based version of the same profile: uImage [1873KB/2048KB] -> [1991KB/2048KB] 56KB free rootfs.squashfs [5084KB/5120KB] -> [4728KB/5120KB] 392KB free Also drops excludes entries firmware now handles upstream: r8188eu.ko from xiaomi-mjsxj02hl, and r8188eu.ko + scsi_mod.ko + sd_mod.ko from yuancam-dgk423403. Both cameras build green; both run out-of-tree Realtek drivers over nl80211 and are otherwise unaffected. Not tested on a camera. This changes which 8188EU driver is used -- mainline staging rather than the Realtek vendor fork -- so it wants confirmation that a dongle is detected at boot without a modprobe, associates, and streams.
OpenIPC Builder
(based on Buildroot)
Specialized features
- Tweaker for automatically configuring devices according to profile (gpio, wifi, etc).
- Specialized storage location for customized firmware for well-known devices.
- QR code recognition to automatically connect to WiFi on your home network.
List of known and supported devices
Aoni EP01J05 T31L ? RTL8188FU_USB NOR_16M new
Azarton C1 T20X JXF23 RTL8189FS_SDIO NOR_16M done
Azarton C1 T31X GC2053 RTL8189FS_SDIO NOR_16M done
Babysense See HD IP206 SSC333 GC2053 RTL8188FU_USB NOR_16M done
Botslab C213 T23N SC3332 ATBM6012B_USB NOR_8M **INIT** - frozen
CCDCAM IM50Q01 SSC377QE IMX335 - NOR_16M done
ChinaTelecom DS-YTJ5301 SSC30KD GC2053 RTL8188FU_USB NOR_16M video-ok, wifi-no, motors-no
ChinaTelecom Y4H-50 T31L ? ? NOR_16M new
CMCC HDC-51 A5-V12 T21N SC2235 RTL8189FTV_SDIO NOR_16M done
CMCC HDC-51 A6-V10 T31L JXF37 RTL8188FU_USB NOR_16M done
CMCC HDC-51 A6-V11 T31L SC2332 RTL8188FU_USB NOR_16M done
Cootli CAMV0103 GK7202V300 SC223A SSV6355_USB NOR_8M in progress
CP Plus CP-UNC-TA21L2C GK7205V200 SC223A - NOR_16M video-ok, ir-cut-no, audio-no
Emax Wyvern Link SSC338Q IMX415 NOR_16M done
Foscam X5 SSC337DE GC4653 RTL8188FU_USB NOR_16M done
G.Craftsman GCA50 T31ZX GC4653 - NOR_16M done
EC37-T11 T20L SC2232 RTL8188FU_USB MOR_16M in progress
H3C TC2101 SSC337 JXQ03 RTL8188FU_USB NOR_16M done
HB-WIFI-Z6 v1.2 T10 JXH62 RTL8188EU_USB NOR_8M in progress
iFlytek XFP301-M T31ZX JXQ03 RTL8188FU_USB NOR_16 research
Imilab EC3 CMSXJ25A SSC325 GC2053 MT7603UN_? NOR_16M in progress
Dahua IPC-HFW1230SP-V2 SSC335DE GC2053 NOR_16M done
Imou IPC-C22E-S2-v2 SSC335DE GC2053 RTL8188FU_USB NOR_16M done
Imou IPC-C22EP-S2 SSC325DE SC2239 RTL8188FU_USB NAND testing stage 1
Imou IPC-C22EP-S2 ? SSC325DE SC2335 RTL8188FU_USB NAND wait sensor driver
Imou IPC-С22СP SSC325 SC2239 RTL8188FU_USB NOR_8M in progress
Jooan A6M-U T23N SC1346 ATBM6012B_USB NOR_8M **INIT** - in progress
Jooan A6M-U vB T23N SC1A4T ATBM6012B_USB NOR_8M **INIT** - in progress
Jooan Q3R-U T23N SC1346 ATBM6012B_USB NOR_8M **INIT** - in progress
JVS INGT10 GQS60EP T10A OV9750 - NOR_8M done
Lenovo Snowman 1080P HI3518EV200 SC2035 RTL8188EUS_USB NOR_16M in progress, LightSensor-no
LSC 3215672 T23N SC2331 ATBM6012B_USB NOR_8M **INIT** - progress
Meari Speed 6S SSC333 JXF37 RTL8188FU_USB NOR_16M video-yes, wifi-yes, motors-no
OpenIPC AIO Mario SSC338Q IMX335 RTL8812AU_USB NOR_16M done
OpenIPC AIO Thinker SSC338Q IMX335 NOR_16M done
OpenIPC AIO UltraSight SSC338Q IMX415 RTL8812AU_USB NOR_16M done
OpenIPC URLLC SSC338Q NOR_16M done
Qtech QVC-IPC-136W HI3518EV200 OV9732 RTL8188EU_USB NOR_16M done
Rostelecom IPC8232SWC-WE HI3516EV300 SP2305 RTL8188FU_USB NAND done
RunCam WiFiLink SSC338Q IMX415 NOR_16M done
RVi-1NCMW2028 (2.8) HI3516EV300 SC2330 RTL8188FU_USB NAND testing
Smartwares CIP-37210 HI3518EV200 OV9732 RTL8188FU_USB NOR_16M done
Smartwares CIP-37210AT T21N JXF37 RTL8188FU_USB NOR_16M done
Switcam HS303 v1 HI3518EV200 JXF22 RTL8188FU_USB NOR_16M done
Switcam HS303 v2 HI3518EV200 OV9732 RTL8188EU_USB NOR_16M done
Tiandy TC-C321N GK7205V200 OS02G10 - NOR_8M done
Tiandy TC-C321N v2 SSC337 SC2336P - NOR_8M done
Tiandy TC-C32QN GK7205V210 OS02G10 - NOR_8M done
TP-Link Kasa KC110 HI3518EV200 OV2735 RTL8188FU_USB NOR_16M ptz-yes, video-WIP (pending majestic MIPI fix)
TP-Link Tapo C110 v1 SSC335 SC3335 ATBM6032i_USB NOR_8M done
TP-Link Tapo C110 v1 SSC337 SC3335 SSW101B_USB NOR_8M done
TP-Link Tapo C110 v2 SSC333 SC3338 SSW101B_USB NOR_8M done
TP-Link Tapo C110 v26 SSC333 ? ? NOR_? done
TP-Link Tapo C310 v1 SSC325 SC3335 RTL8192EU_USB NOR_8M in progress
TP-Link Tapo C310 v2.20 SSC335 SC3338 RTL8192EU_USB NOR_8M testing
TP-Link Tapo TC60 V5 T23N WQ9001_? NOR_8M **INIT** - frozen
TP-Link Tapo TC70 V3 T31L SC2336 RTL8188FU_USB NOR_8M done
Trassir TR-D4121IR1 v2 HI3516CV200 AR0237 - NOR_16M done
Trassir TR-W2C1 v1 SSC325 GC2053 MT7601U_USB NOR_16M done
Trassir TR-W2C1 v2 SSC335 GC2053 MT7601U_USB NOR_16M done
Tuya GV7630-T31-PTZ T31L SC2336 ATBM6012B_USB NOR_8M in progress
Umea QC012 GK7102C_A MIS2003 RDA5995_USB MOR_8M wip
Uniview C1L-2WN-G SSC335DE OS02G10 RTL8188FU_USB NOR_16M done
Vixand IPC-1 GK7205V200 none EC200N_USB NOR_8M frozen
Vixand IPH-5-4G GK7205V200 SC2239 EC200N_USB NOR_8M frozen
Vixand IVG-G3S GK7205V210 IMX307 - NOR_16M in progress
Vixand IVG-G4F-A GK7205V210 SC223A - NOR_16M in progress
Vixand IVG-G4F-A-W GK7205V210 SC223A ATBM6032i_USB NOR_16M w/ext wifi board
Vixand IVG-G4H GK7205V210 MIS2008 - NOR_16M done
Vixand IVG-G6S GK7205V300 IMX335 - NOR_16M done
Vixand IVG-G6S-W GK7205V300 IMX335 ATBM6032i_USB NOR_16M w/ext wifi board
VStarcam C43S(B) SSC333 JXF37 MT7601U_USB NOR_16M in progress
VStarcam CS55 T31N GC2053 RTL8188FU_USB NOR_16M in progress
VStarcam C8622 T23N SC2336P AIC8800DL_? NOR_8M **INIT** - in progress
XiongMai 85H50AI HI3516EV300 IMX335 - NOR_8M testing, motorized zoom+focus (pelco-xm)
VStarcam C8892WIP HI3518EV200 AR0237 MT7601U_USB NOR_16M done
VStarcam C8896WIP GK7102C_A GC2033 RTL8189ES_SDIO NOR_8M wip
Wansview Q5 1080p T21Z OV2735B RTL8188FU_USB NOR_16M in progress
Wansview Q5 2K T31L SC2336 ATBM6031_SDIO NOR_8M done
Wyze V3 (WYZEC3B) T31X GC2053 RTL8189FS_SDIO NOR_16M done
X-06S v2.2 T21 JXH62 RTL8188FU_USB NOR_8M in progress
Xiaomi MJSXJ02HL HI3518EV300 JXF22 RTL8189FS_SDIO NOR_16M preparation
Xiaomi MJSXJ03HL T31N JXQ03 RTL8189FS_SDIO NOR_16M done
Xiaomi MJSXJ03HL T31N JXQ03P RTL8189FS_SDIO NOR_16M done
Xiaomi MJSXJ05HL T31L GC2053 ATBM6031_SDIO NOR_16M preparation
YuanCam DGK-423403 HI3518EV300 JXH62 RTL8188FU_USB NOR_8M research
ZTE K540 T31X SC4336 ATBM6012B_USB NOR_16M done
ZTE K543 SSC337DE SC401AI MT7601U_USB NOR_16M done
ZTE K545 T31X SC4336 ATBM6012B_USB NOR_16M done
4G Camera XG521 V1.2 GK7202V300 GC1054 EC800E-CN_USB NOR_8M done
XM IPG-G3-WR GK7202V300 JXH63 ATBM60321S_USB NOR_8M done
Compatibility and clones
Many devices sold in online stores are clones of original devices or, more often, devices adapted for the local national market.
Model names Our firmware
Dahua IPC-HFW1230SP-V3 => Dahua IPC-HFW1230SP-V2
Dahua IPC-C22C-LC => Imou IPC-С22CP
Imou IPC-С22EP-A => Imou IPC-С22CP
Imou IPC-F22AP => Imou IPC-С22CP
Switcam HS303 v3 => Qtech QVC-IPC-136W
Tiandy TC-C320N => Tiandy TC-C321N
Tiandy TC-C320N v2 => Tiandy TC-C321N v2
TP-Link Tapo C110 v2.20 => TP-Link Tapo C110 v2
TP-Link Tapo C200 v3.00 => TP-Link Tapo TC70 V3
Rostelecom IPC8232SWC-WE-B => Uniview C1L-2WN-G
Rostelecom IPC C22E-S2 v2 => Imou IPC-C22E-S2-v2
Uniview C1L-2WN-G-RU => Uniview C1L-2WN-G
Device setup
WiFi Settings
Run these commands and enjoy:
fw_setenv wlanssid 'OpenIPC'
fw_setenv wlanpass 'mypassword'
reboot
Requirements for registration of new devices
When adding new devices, please follow a few simple rules. The list of files to be added should be minimal, try not to store binary files, remember that all common files and configurations should be stored in the firmware repository. However, some list of files must be required.
processor_flavor_vendor-model-version/br-ext-chip-sigmastar/configs/processor_flavor_vendor-model-version_defconfig
processor_flavor_vendor-model-version/general/overlay/usr/share/openipc/customizer.sh
processor_flavor_vendor-model-version/general/scripts/excludes/processor_flavor.list
The file names contain variables with option names - flavor, model, processor, vendor, version
- flavor - firmware direction in the openipc system, by default try to use "lite" as much as possible
- model - official model name from the main device manufacturer
- processor - official name of the processor in the OpenIPC structure
- vendor - the name of the official equipment manufacturer; if there are several of them, a description is created
- version - usually this is an addition to the model, version or revision of hardware differences
Preparing and using the project
sudo apt-get update -y
sudo apt-get install -y automake autotools-dev bc build-essential curl fzf git libtool rsync \
unzip mc tree python-is-python3
git clone https://github.com/openipc/builder.git
cd builder
./builder.sh
Create firmware with built-in credentials
- Usage:
repack.sh [uboot] [firmware] [ssid] [pass]
sh repack.sh ssc337de ssc337de_ultimate_foscam-x5-nor router password
Existing problems
- On some devices NOR flash 8M is small, and the WiFi driver is very large and the QR scanner currently does not fit into the firmware
Additional information
Technical support and donations
Please support our project with donations or orders for development or maintenance. Thank you!
