Repository navigation
Releases
Releases · elsangithub/mt7663-router-webui
Release v1.0.6
Changes in v1.0.6:
Added
- Universal Dual-Band Companion for MediaTek MT7668 & MT7663:
- Expanded package compatibility to support both MediaTek MT7663 (
mt7663-driver) and MT7668 (mt7668-driver) SDIO chipsets seamlessly under a single turnkey package. - Relaxed Debian package dependencies to
Depends: mt7663-dkms | mt7668-dkmsto allow installation on boards powered by either driver. - Added dedicated modprobe configuration
wlan_mt7668.confsettingoptions wlan_mt7668 ap_mode=1without colliding withmt7668-dkmspackage files. - Dynamic hardware-aware driver loading in
mt7663-hotspot: automatically detects active kernel module or inspects physical SDIO card ID (/sys/bus/sdio/devices/*/device), completely ignoring absent hardware with zero CPU/log overhead. - Dynamic chipset detection with SDIO bus fallback in backend WSGI API (
/api/status). - Adaptive Web UI branding: dynamic browser tab title, navigation bar brand, and live chipset status row (
st-hotspot-chip) on the dashboard hotspot card. - Universal login portal branding ("MediaTek Router Login" / "Login Router MediaTek").
- Single Source of Truth (
sync-version.sh) release automation script ensuring atomic version synchronization across Debian package control, build scripts, and documentation per Rule 2.
- Expanded package compatibility to support both MediaTek MT7663 (
Release v1.0.5
Changes in v1.0.5:
Fixed
- Eliminated Kernel
rtnl_lockDeadlock (hostapd-mt7663.conf,mt7663-hotspot.service&mt7663-hotspot):- Removed
country_code=IDandieee80211d=1fromhostapd-mt7663.conf. MediaTek MT7663 driver cannot handle userspace Netlink regulatory domain requests on modern Linux (6.18+), which previously lockedrtnl_lockindefinitely in uninterruptible sleep (D-state) and froze network/console/SSH sequences. - Removed redundant
iw reg set IDcommands frommt7663-hotspot.serviceand/usr/sbin/mt7663-hotspot. - Regulatory domain is now cleanly handled by hardware NVRAM/EEPROM without userspace netlink interference.
- Removed
- Eliminated Package Collision with
mt7663-dkms:- Removed duplicate
/etc/NetworkManager/conf.d/99-mt7663-unmanaged-ap0.conffrom this package, resolvingdpkg: error: trying to overwrite ... which is also in package mt7663-dkms.
- Removed duplicate
- Non-Blocking Post-Installation (
debian/postinst):- Conditioned
systemctl restart mt7663-hotspot.serviceduring package installation to only execute ifap0is already present. - On fresh installs prior to reboot, hotspot service is enabled for next boot while only
mt7663-webui.serviceis started immediately, completely eliminating the 50-second freeze at 93% progress.
- Conditioned
- Dedicated DBDC AP Isolation (
mt7663-hotspot):- Removed destructive
wlan0fallback and config file mutation (sed -i ... interface=wlan0) in/usr/sbin/mt7663-hotspot. - SoftAP strictly binds to
ap0, preventing race conditions, IP flushing, and disconnections on active client interfacewlan0.
- Removed destructive
- CPU Governor Sweet Spot Baseline (
mt7663-hotspot):- Explicitly enforced
ondemandgovernor and 1.0 GHz minimum frequency (scaling_min_freq = 1000000) across all CPU cores prior to tuning sampling rate.
- Explicitly enforced
- Pre-daemon Clean Startup & Enhanced Diagnostics:
- Moved stale process termination (
hostapd,dnsmasq) and socket deletion to the start ofstart_hotspot(). - Added
export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:$PATH"and automatedrfkill unblock all. - Replaced rigid 1-second check with a 6-second hostapd PID polling loop and stderr log diagnostics.
- Moved stale process termination (
- Systemd Unit Decoupling (
mt7663-hotspot.service):- Removed obsolete device dependency
sys-subsystem-net-devices-ap0.devicefromAfter=to allow reliable standalone boot without LAN. - Added module pre-load
ExecStartPre=-/sbin/modprobe wlan_mt7663_sdio ap_mode=1.
- Removed obsolete device dependency
Release v1.0.4
Changes in v1.0.4:
Fixed
- Python 3.13 / Debian 13 (Trixie) Compatibility:
- Upgraded embedded WSGI micro-framework
bottle.pyfrom v0.12.25 to v0.13.2. - Resolves fatal
ModuleNotFoundError: No module named 'cgi'caused by the PEP 594 removal of the deprecatedcgimodule in Python 3.13. - Improved
server.pyimport error handling to output the explicit Python exception details.
- Upgraded embedded WSGI micro-framework
- Hotspot Daemon Hardening & SDIO Boot Enumeration:
- Added
-u rootparameter todnsmasqinvocation in/usr/sbin/mt7663-hotspotto prevent privilege drop and permission denied failures across varied base distributions. - Added driver auto-load (
modprobe wlan_mt7663_sdio) and a 15-second interface detection loop instart_hotspot()to eliminate boot race conditions while SDIO hardware initializes.
- Added
Release v1.0.3
Changes in v1.0.3:
Added
- One-Click STB System Reboot (
/api/system/reboot):- Added a dedicated reboot trigger button in the STB Status card with an interactive confirmation prompt.
- Built an animated 45-second countdown progress bar overlay with automated reconnect and page reload once the STB finishes rebooting.
- Configurable DHCP Lease Duration:
- Added a customizable DHCP Lease Time selector in the 5 GHz Hotspot settings (1h, 2h, 6h, 12h, 24h, 48h, 7d), replacing hardcoded configuration values.
- Sequential IP Allocation Option (
--dhcp-sequential-ip):- Added configurable IP distribution method in Web UI: choose between Sequential (allocating IPs in order immediately following the gateway) or Random / Hash-based (MAC hash-based).
- Real-Time Lease Time Remaining Column:
- Added a dedicated Lease Time (
Sisa Sewa) column in the connected clients table displaying dynamic remaining lease countdown for each leased IP.
- Added a dedicated Lease Time (
- Table Layout & Header Streamlining:
- Condensed
Device Name / Hostnametable header to simplyHostnamefor cleaner spacing and perfect responsiveness across mobile and desktop viewports.
- Condensed
- Multi-Core Network Packet Steering (RPS & XPS):
- Added automatic Receive Packet Steering (RPS) and Transmit Packet Steering (XPS) on interfaces
ap0(Wi-Fi) andeth0(Ethernet WAN) targeting Cores 1, 2, and 3 (rps_cpus = e,xps_cpus = e), withrps_flow_cnt = 4096andnet.core.rps_sock_flow_entries = 32768. - Load-balances incoming and outgoing packet routing symmetrically across all CPU cores, eliminating single-core bottlenecks on CPU 0.
- Added automatic Receive Packet Steering (RPS) and Transmit Packet Steering (XPS) on interfaces
- Turbo DNS Cache (10,000 Entries) & Parallel Upstream Resolver:
- Activated local high-speed DNS proxy in
dnsmasqwith 10,000 RAM cache entries, sub-millisecond local response times, and--all-serversparallel querying across Cloudflare (1.1.1.1) and Google (8.8.8.8). - Isolated listener socket (
-i ap0 --bind-interfaces --listen-address="${AP_GATEWAY}") ensuring zero port 53 conflicts with host OS resolvers (e.g.,systemd-resolvedon127.0.0.53).
- Activated local high-speed DNS proxy in
- Google TCP BBR Congestion Control & FQ Queuing:
- Enabled kernel
bbrTCP congestion control andfqpacing queue discipline via/etc/sysctl.d/99-mt7663.conf, minimizing packet latency and bufferbloat under full bandwidth saturation.
- Enabled kernel
- Conntrack Fast-Reap & Active Connections Telemetry:
- Accelerated kernel TCP dead connection cleanup (
time_wait = 30s,close_wait = 15s,fin_wait = 30s) to prevent NAT connection table exhaustion. - Added live Active Connections (
Koneksi Aktif) telemetry row in Card 4 (STB Status) displaying real-time connection count, maximum capacity (65,535), and utilization percentage.
- Accelerated kernel TCP dead connection cleanup (
- CPU Governor Sweet Spot Tuning (Cooler Baseline & Low Jitter):
- Tuned
ondemandgovernor parameters (sampling_rate=20000/ 20ms,up_threshold=60,sampling_down_factor=2,io_is_busy=0). - Allows CPU to rest stably at 1000 MHz (1.0 GHz) during idle to lower operating temperatures, while instantly bursting to 2.0 GHz within 0.02s during gaming or heavy network bursts.
- Tuned
- Real-Time CPU Clock Frequency Telemetry:
- Replaced raw RAM megabytes in Card 4 with active live CPU clock frequency (
X.XX GHz), providing immediate visibility into dynamic CPU governor scaling between 1.0 GHz idle and 1.9–2.0 GHz burst.
- Replaced raw RAM megabytes in Card 4 with active live CPU clock frequency (
- Automated Ophub Governor Persistence (
postinst/postrm):- Integrated automated injection of
ondemandsweet-spot parameters (sampling_rate=20ms,up_threshold=60%) directly into/etc/custom_service/start_service.shduring.debpackage installation (postinst), with clean teardown on package removal (postrm). Guarantees cool ~50°C baseline temperatures across reboots on any Ophub Armbian build.
- Integrated automated injection of
Changed
- Symmetrical Dashboard Card Balancing:
- Relocated the Active NAT Sessions / Connections telemetry row from Card 4 (Hotspot) to Card 3 (Internet WAN), balancing both Card 3 and Card 4 symmetrically with exactly 6 informative rows each.
Fixed
- Station Disconnect & OFFLINE Status Accuracy:
- Fixed logic flaw where an empty active station set (
active_wifi_stas) evaluated toTrue(not active_wifi_stas), causing disconnected DHCP lease entries to falsely display withCONNECTEDgreen status. - Wired real-time association check directly to kernel mac80211 station dump (
iw dev ap0 station dump); stations absent from the dump are strictly assignedOFFLINEstatus with muted badge styling.
- Fixed logic flaw where an empty active station set (
- Active Clients Counter Accuracy:
- Fixed
client_countin both Dashboard card and table header (Perangkat Terhubung ( ... )) to sum only stations actively associated withstatus == "CONNECTED". Disconnected devices or stale lease entries no longer increment the active client counter.
- Fixed
- Device Deletion & DHCP Release Reliability:
- Updated
/api/devices/delete(🗑️ button) to remove MAC mappings frommt7663-devices.json, purge matching lease entries from/var/lib/misc/dnsmasq.leases, and flush kernel ARP cache (ip neigh flush dev ap0), removing the device instantly and permanently. - Revamped
/api/dhcp/release(♻️ Release DHCP) to truncate lease files, flush ARP, terminate runningdnsmasq, and cleanly spawn a fresh instance so in-memory DHCP cache is completely wiped.
- Updated
- Frontend Action Handlers & Settings Round-Trip:
- Implemented missing client-side JavaScript functions
flushDhcpLeases()anddeleteDevice()inindex.htmlto ensure action buttons execute smoothly without DOM errors. - Included
dhcp_leaseduration anddhcp_allocdistribution method in settings save payload, ensuring full configuration round-trip synchronization between frontend and backend.
- Implemented missing client-side JavaScript functions
- Authoritative DHCP Service Flag (
--dhcp-authoritative):- Added
--dhcp-authoritativetodnsmasqinvocation in/usr/sbin/mt7663-hotspotto immediately reject foreign DHCP lease requests from mobile devices reconnecting after network restarts, forcing instant clean IP re-allocation.
- Added
- Authentication Handshake Fix in Management Endpoints:
- Replaced undefined
check_auth()calls in/api/devices/rename,/api/devices/delete, and/api/dhcp/releasewith properis_authenticated()session checks, resolving HTTP 500 Internal Server Errors when modifying devices or releasing DHCP.
- Replaced undefined
Release v1.0.2
Changes in v1.0.2:
Added
- Low-Latency Online Gaming Optimizations:
- DTIM Period Tuning (
dtim_period=1): Shortened beacon wake-up intervals from 200 ms to 100 ms inhostapd-mt7663.conf, eliminating micro-sleep buffering delays on mobile gaming clients. - U-APSD Advertisement Disabled (
uapsd_advertisement_enabled=0): Prevented WMM sleep buffer queuing jitter on modern smartphone wireless chipsets. - Bufferbloat Mitigation (
fq_codel): Automatically applied Fair Queueing Controlled Delay (target 5ms interval 100ms noecn) queue discipline on interfaceap0during hotspot startup, prioritizing small UDP gaming packets over large TCP bulk transfers. - CPU Governor Responsiveness Tuning: Tuned kernel
ondemandgovernor parameters (up_threshold=25,sampling_down_factor=10,io_is_busy=1) when hotspot activates to maintain steady processing frequencies and eliminate clock switching micro-jitter.
- DTIM Period Tuning (
- Client & Hostname Management:
- Delete Device Action (🗑️): Added an explicit delete button next to hostname editing in the connected devices table, enabling instant removal of duplicate/stale entries caused by mobile MAC Randomization.
- API Endpoint (
/api/devices/delete): Backend endpoint to cleanly remove cached MAC mappings from/var/lib/misc/mt7663-devices.json. - Flush DHCP Leases Button (
♻️ Release DHCP): Added a quick action button and backend endpoint (/api/dhcp/release) to flush inactive DHCP leases fromdnsmasq.leases, freeing orphaned IP addresses immediately.
- Admin Password Safety & Confirmation:
- Added a mandatory Confirm New Password field with real-time match validation (
checkPassMatch) and backend validation to prevent accidental lockouts caused by typos. - Added automated session invalidation and re-login flow upon successful password modification.
- Added a mandatory Confirm New Password field with real-time match validation (
Changed
- Client Status Accuracy:
- Replaced stale DHCP lease status assumptions with real-time station dump verification (
iw dev ap0 station dump). Devices that disconnected or roamed to another Wi-Fi network are now marked asOFFLINE(with muted styling) instead of remaining misleadinglyACTIVE.
- Replaced stale DHCP lease status assumptions with real-time station dump verification (
- Table Column Headers:
- Simplified traffic table headers by removing redundant directional indicators:
Upload (UP)->Upload(Unggah),Download (DOWN)->Download(Unduh).
- Simplified traffic table headers by removing redundant directional indicators:
- Form Text & Localization:
- Removed confusing
Default: adminplaceholder in current password input; replaced with localized contextual prompts (Enter current password/Ketik kata sandi saat ini). - Standardized all admin form placeholders to fully respect active language selection.
- Removed confusing
Release v1.0.1
Changes in v1.0.1:
Added
- Full Bilingual Localization (ID / EN):
- Translated all dropdown
<option>selectors dynamically:- Security Modes: WPA2-Personal (AES/CCMP) [Recommended], WPA2/WPA3 Mixed, WPA3-Personal Only, and Open.
- Wireless Bands: 2.4 GHz (Recommended for Repeater) and 5 GHz (High Speed LAN).
- 5 GHz & 2.4 GHz Channels: Channel 1–11, UNII-1 (Channels 36–48), and UNII-3 (Channels 149–161).
- Channel Widths: 20 MHz, 40 MHz (HT40), and 80 MHz (VHT80).
- DNS Presets: Cloudflare (Fastest & Privacy, Security Malware, Family), Google Public DNS, AdGuard (Anti-Ads, Family SafeSearch), Quad9 Phishing Protection, OpenDNS, and Custom manual configuration.
- Translated all contextual guidance hints, the Repeater Mode Performance Warning box, and DoH / Private DNS tips.
- Translated Wi-Fi connection modal dialogue, password placeholders, and "Forget Network" button.
- Translated all dropdown
Changed
- Dynamic Band Switching (
onBandChange): Updated channel and bandwidth options rendering to respect active language while preserving currently selected form values. - Safe Hardware Installation (
postinst): Removed aggressive livemodprobe -r wlan_mt7663_sdioduring package installation. On Amlogic SDIO controllers (meson-gx-mmc), on-the-fly driver unloading without physical power-cycling can freeze the MMC bus; the package now applies options gracefully and guides the user to reboot only when needed.