【韌體】ASUS WL-HDD2.5 改刷 OpenWrt Kamikaze with X-Wrt Webif²

[FYI]

原先參考thx 版主發表的 "compile ASUS 3.5G WL-HDD's firmware 筆記(失敗) - PCZONE 討論區" 文章之後, 小弟於是偷懶把WL-HDD 改刷Koppel 版Oleg 韌體, 就這樣WL-HDD 變成一台支援GPRS/3G/HSDPA/UMTS USB Modem 的無線分享器, 雖然小弟並無3G 網卡, 但是這麼做只有一個字, 爽! 不過當小弟想要深入研究時, 這才發現Oleg 實在是綁手綁腳, 尤其是對於WL-HDD 而言, 所以經過一番嘗試, 小弟終於把Oleg 換成OpenWrt Kamikaze, 然而原先對於OpenWrt 的 "深度" 恐懼並未消除, 小弟向來認為OpenWrt 是給Linux 高手玩的, 必須記憶許多艱深的Linux 指令才能控制OpenWrt 這頭怪獸, 所以小弟一直停留於只研究DD-WRT 支援的分享器, 但問題是DD-WRT 並不支援WL-HDD, Oleg 又太忠於ASUS 原廠韌體, 所以只好硬著頭皮給它刷OpenWrt, 當然小弟事先做過功課, 所以知道有X-Wrt 的存在, 只不過在OpenWrt Kamikaze 功能穩定之前, 其實X-Wrt 也發展得很慢, 直到現在仍存在一些明顯的小瑕疵, 但功能和穩定性都已經達到一定的水準, 所以小弟鄭重推薦給想要學習改機, 順便學習Linux 的網友, 以下就是小弟改機的過程

X-Wrt 是一個專為OpenWrt 所設計的套件, 所以可以於安裝OpenWrt 之後再安裝X-Wrt, 不過 "聽說" OpenWrt's GUI 很陽春, 一堆功能都得靠手動完成, 所以小弟乾脆直接安裝包含X-Wrt 套件的OpenWrt Kamikaze 韌體, 這樣可以省下不少麻煩, X-Wrt 除了提供Webif² 套件之外, 還提供了預先打包好的版本, 區分成default, no_pppoe, openvpn 和extra, 小弟安裝的是openvpn 版, 網友也可以考慮extra 版, 其次得決定安裝Kamikaze 的哪個版本, 對於Broadcom CPU 來說有兩種選擇, brcm-2.4 和brcm47xx, 除了於前者採用Kernel 2.4, 後者採用Kernel 2.6 之外, 另一個很重要的差異就是Broadcom 無線驅動程式, 一般來說, 對於舊晶片Broadcom 只提供Kernel 2.4 無線驅動程式, 所以當小弟安裝brcm47xx 於WL-HDD 時, 也就發生找不到無線裝置的情形, 只好乖乖回頭安裝brcm-2.4

ASUS 分享器通常只需進入救援模式, 即可以tftp 上傳韌體, 但WL-300g, WL-500g & WL-HDD 例外, 最簡單的方式就是改用ASUS Firmware Restoration 公用程式, 請安裝ASUS WL-HDD Support CD 或上ASUS 網站下載, 執行Firmware Restoration 公用程式有一點必須特別注意, 小弟也因此差一點上來求助, 如果電腦主機有兩片以上網卡, 務必只啟用或連接接到ASUS 分享器的這一片網卡, 請將其他網路線拔除或停用網路卡, 否則Firmware Restoration 公用程式可能會找不到ASUS 分享器

升級之後, 請以PuTTY ssh 登入WL-HDD (192.168.1.1, 請避免和Modem's IP 衝突), 然後執行 "nvram set wan_proto=none; nvram commit", 雖然Kamikaze 已經不再利用NVRAM, 但是既然OpenWrt Wiki 有提到, 就請照辦, 接下來進行X-Wrt Webif² 設定, 需要修改的部份如下:

System -> System Settings -> 時區
Network -> Networks -> IP & DNS
Network -> DHCP
Network -> Wireless
Network -> Tweaks -> Maximum Connections

前面提到X-Wrt Webif² 還有一些小瑕疵, 接下來進行手動修正, 回到System -> File Editor, 開啟以下檔案:

File: /etc/config/network -> option 'dns' #是否正確?
File: /etc/config/wireless -> option 'country' 'US'
File: /etc/config/wireless -> option 'channel' '11' #必須介於1-11, 不得為0
File: /etc/config/wireless -> option 'txpower' '14' #發射功率介於1-24 之間, 單位是dBm

每個頁面改完以後, 都必續按下Save Changes, 可隨時點選Review Changes 檢查修改了哪些部份, 等全部修改完畢, 再統一按一次Apply Changes, 此時才會真正儲存於檔案系統中, 再點擊System -> Reboot, 讓修改生效, 若以X-Wrt Webif² 修改Wireless 設定, 則必須重複以上步驟

數位天堂 / [X-Wrt] 華碩WL-HDD 安裝X-Wrt (OpenWrt Kamikaze 8.09, r15789)
Kamikaze Installation - X-Wrt
User Manual - X-Wrt

OpenWrtDocs/Hardware/Asus/WL-HDD
OpenWrtDocs/Hardware/Asus/Flashing
OpenWrtDocs/KamikazeHowto
OpenWrtDocs/KamikazeConfiguration

[FYI]

接下來才是小弟最關心的主題, 換掉Oleg 的原因是在Oleg 韌體之下, 除非重新編譯韌體, 否則Reset 按鈕無法挪為他用, 換成OpenWrt Kamikaze 之後, 幾乎系統的每個部份都可以修改, 都可以儲存, 不用再刻意 "flashfs save && flashfs commit && flashfs enable", 以下腳本以Reset 按鈕當作無線開關, 乃參考 "OpenWrtDocs/Customizing/Software/WifiToggle" 改寫而成, 最大的差別在於不修改 "wireless.wl0.disabled", 當按下Reset 按鈕則可以開關無線訊號, 若無線開啟, 則PWR & WLAN LEDs 恆亮, 若無線關閉, 則WLAN LED 滅, PWR LED 閃爍, 若分享器有SES 或AOSS 按鈕, 那麼也可以把 "reset" 換成 "ses" 或 "aoss", 以下腳本僅適用於採用Broadcom CPU 且安裝OpenWrt Kamikaze 的分享器, Atheros 分享器則只能採用原來的指令 (uci & wifi), 且LED 控制似乎得透過GPIO

/sbin/woggle

#!/bin/sh
if [ "`wlc radio`" = 0 ]; then
	wlc radio 1 && \
	echo 1 > /proc/diag/led/power
else
	wlc radio 0 && \
	echo f > /proc/diag/led/power
fi

/etc/hotplug.d/button/01-radio-toggle

#!/bin/sh
if [ "$BUTTON" = reset ] && [ "$ACTION" = pressed ] && [ "$SEEN" -gt 2 ]; then
	/sbin/woggle &
fi

輸入完畢請執行:

chmod +x /sbin/woggle
chmod +x /etc/hotplug.d/button/01-radio-toggle

每一台分享器的LEDs 可能不同, 請執行 "ls /proc/diag/led" 以便找出哪些LEDs 可被控制, 數值可輸入 "0/1/f", 分別對應 "滅/亮/閃", 與按鈕相關的系統變數為:

$BUTTON = [reset|ses|aoss] 
$ACTION = [pressed|released]
$SEEN = [time since last event] 單位為秒, 小數以下不計

Enable Broadcom WiFi

uci set wireless.wl0.disabled=0 && wifi

Enable Atheros WiFi

uci set wireless.wifi0.disabled=0 && wifi

由於小弟尚未找到對應於 "wl assoclist" 的指令, 所以還無法做到無線閒置則自動關閉訊號

OpenWrt / [Howto] WiFi toggle
1.5 wifi-on/off-toggle with EZ-SETUP-button - wiki.georgweiss.de (/etc/hotplug.d/button/01-wifitoggle & /etc/config/wifitoggle)
原始wifitoggle 副本, 無LED 控制指令
OpenWrt / wl-hdd reset button
OpenWrt - Ticket #2855: atheros-toggle.patch
【腳本】WifiToggle for DD-WRT - 以Reset 按鈕當作無線開關, 無線閒置則自動關閉訊號 - PCZONE 討論區

[FYI]

其實前一篇只以 "wlc radio 1/0" (相當於 "wl radio on/off") 管理無線開關的做法可能並不完全, 只不過原先擔心的是如果修改了 "wireless.wl0.disabled", 然後其他程式又執行 "uci commit wireless", 那麼下次啟動可能就不會啟用無線 (WLAN LED 滅), 容易被誤以為無線有問題, 但這回小弟加了一項啟動指令, 以PWR LED 代表無線狀態, 閃爍代表無線關閉以及無線開關作用中, 那就前後一致了

/sbin/woggle

#!/bin/sh
if [ "`uci get wireless.@wifi-device[0].disabled`" = 1 ]; then
	uci set wireless.@wifi-device[0].disabled=0 && wifi && \
	echo 1 > /proc/diag/led/power
else
	uci set wireless.@wifi-device[0].disabled=1 && wifi && \
	echo f > /proc/diag/led/power
fi

/etc/hotplug.d/button/01-radio-toggle

#!/bin/sh
if [ "$BUTTON" = reset ] && [ "$ACTION" = pressed ] && [ "$SEEN" -gt 2 ]; then
	/sbin/woggle &
fi

/etc/init.d/custom-user-startup

#!/bin/sh /etc/rc.common
START=98
start() {
	if [ "`/sbin/uci get wireless.@wifi-device[0].disabled`" = 1 ]; then
		( /sbin/wifi down && echo f > /proc/diag/led/power ) &
	fi
}

輸入完畢請執行:

chmod +x /sbin/woggle
chmod +x /etc/hotplug.d/button/01-radio-toggle
chmod +x /etc/init.d/custom-user-startup

由於 /etc/rc.d/S95done 會設定PWR LED 正常狀態, 所以/etc/init.d/custom-user-startup "START" 數值必須大於95, 編輯完畢請執行:

/etc/init.d/custom-user-startup enable
/etc/init.d/custom-user-startup start

以上指令會產生 /etc/rc.d/S98custom-user-startup

本篇和前一篇主要不同之處就是盡量遵循Kamikaze 所使用的組態和指令, 以便相容於不同平台和不同設定, 但是小弟並不確定Atheros 平台的LED 控制方式是否透過GPIO, 請參考 /etc/diag.sh 或 /etc/init.d/done

Wifi Toggle Script - OpenWrt Wiki (新版WifiToggle)
Wireless configuration - OpenWrt Wiki

[FYI]

Package: nano
Version: 2.0.7-1
Depends: libncurses
Description: GNU nano (Nano's ANOther editor, or Not ANOther editor) is an enhanced clone of the Pico text editor..

雖然X-Wrt Webif² 在System 之下有個File Editor 介面, 但是File Editor 只能修改和刪除現有的檔案或目錄, 無法新增, 而小弟對於vi 又很不能適應, 尤其是剪貼時會自動縮排, 已經排好的程式碼卻又被攪亂, 這時候你就非常需要瑤瑤, 喔不, 是nano, 請點選System -> Packages, 先點一下Update package lists, 接著在Available packages 之下就可以找到nano, 請點選nano 左方的Install, 接著就會自動安裝, 你看, 多麼輕鬆愉快! 小弟接下來想玩的還有rp-pppoe-server, tc, qos-scripts, wl (只為了 "wl assoclist"), setserial, stty, ser2net...但是, 先別心急, 請隨時檢查Flash 還有多少可用空間, 請執行 "df"

root@OpenWrt:~#	df
Filesystem	1k-blocks	Used	Available	Use%	Mounted on
rootfs		2048		2048	0		100%	/
/dev/root	2048		2048	0		100%	/rom
tmpfs		7168		728	6440		10%	/tmp
/dev/mtdblock/4	1216		548	668		45%	/jffs
mini_fo:/jffs	2048		2048	0		100%	/

請檢查/jffs 還剩多少, 省點用, 別灌爆了還不知道, 此時就會深刻瞭解8MB Flash & USB Storage 的好處

OpenWrtDocs/Packages
OpenWrt / Serial port

[FYI]

其實早先搜尋OpenWrt 相關文章之時, 偶爾會看見網友推崇一個套件, Gargoyle, 其實和X-Wrt 一樣, Gargoyle 也是一個基於OpenWrt 的Front-end/webif, 同樣的道理, Gargoyle 也針對本身想完成的目標打包了一些套件, 而這些套件多半和QoS 有關, 例如:

[TABLE]Bandwidth (1):|QoS Pie Chart:|Qos (1):|Qos (2):
|||[/TABLE]

看了以上圖表, 是否讓網友想起Tomato Firmware? 沒錯! 這也是讓小弟產生興趣最主要的原因, 同時這也讓小弟想起另一個X-Wrt 打包好的extra 版, 其中包含以下套件: qos-scripts, ntpclient, bandwidthd, miniupnpd (UPnP), updatedd (DDNS)

[TABLE]Status / Bandwidth|Network / QoS
|[/TABLE]

從以上可以看出QoS 套件已經具備優先權和頻寬管理, 這不就是Tomato Firmware 所被稱羨的功能嗎? 然而這些在Kamekaze 之下已經一一被實現, 而且並不侷限於Broadcom-based 硬體, Atheros-based 硬體同樣也能享受到相同的功能

如果仔細看過OpenWrt 套件列表, 或許還會注意到以 "LuCI" 開頭的套件, LuCI 也是一個OpenWrt Front-end/webif, 同時, LuCI 開發者和Oleg Firmware 後續維護者可能是同一個高手

至此小弟深刻體驗到一件事情, 對於一般玩家來說, DD-WRT 的便利性以及多樣化, 讓隨便一位玩家都能輕易上手, 而且不必花費許多時間就可以完成所想要的功能, 因此非常適合於沒有時間, 卻又不能滿足於原廠韌體的玩家, 然而除了DD-WRT 所提供的功能以外, 玩家若想自行拓展功能, 則可能會受到某種程度的限制, 反觀OpenWrt 雖然沒有華麗且豐富的介面, 然而OpenWrt 卻是一個真正開放的平台, 可以讓玩家完全自主, 全盤操控所有的功能, 而且OpenWrt 愈來愈趨向於Linux 標準, 這代表著OpenWrt 不再只是一個特殊的嵌入式系統, 所以將會更容易學習, 在此基礎下, OpenWrt 也愈來愈趨於穩定, 操作介面也即將趕上DD-WRT, 但擴充性卻可能讓DD-WRT 望塵莫及, 所以小弟強烈建議玩家們要善選您的第一個分享器, 雖然目前Ralink-based 低階產品非常便宜, 種類繁多, 規格漂亮, 又可能有DD-WRT 的加持, 然而若有心學習Linux, 且對於頻寬管理有興趣的話, 那麼目前最佳選擇應該是Atheros-based 支援Draft N 的硬體, 其次才是Broadcom-based 的硬體, 而韌體則應該選擇基於Linux 2.6 的版本, 才有機會全盤掌控頻寬管理

TableOfHardware - OpenWrt
Kamikaze Presentation - X-Wrt
screenshots [Gargoyle Wiki]
Documentation Index [Gargoyle Wiki]

[FYI]

OpenWrt / New package: wifitoggle

請先檢查是否有定義/sys/class/leds/${led_sysfs}/brightness, 而且必須吻合 "option led_sysfs", 否則可能必須安裝kmod-leds-gpio, 原先安裝X-Wrt 打包好的8.09.2 vpn 版本時, GPIO 是有作用的, 但現在換成Gargoyle v1.2 版時, 卻找不到如何控制LED, 有待高人指點

root@OpenWrt:~# opkg files kmod-leds-gpio
Package kmod-leds-gpio (2.6.26.8-atheros-1) is installed on root and has the following files:
/lib/modules/2.6.26.8/leds-gpio.ko
/etc/modules.d/60-leds-gpio

root@OpenWrt:~# lsmod | grep gpio
leds_gpio               1504  0

System configuration - OpenWrt Wiki

[FYI]

Wireless Router with a 3G/UMTS/HSDPA dongle
Howto use 3G dongle Huawei E1750 in OpenWrt | An It-Slave in the digital saltmine
Howto use rndis device in Openwrt as a modem, i.e HTC Desire with Android | An It-Slave in the digital saltmine
eko.one.pl - OpenWrt as a 3G router
Use 3g/UMTS USB Dongle for WAN connection - OpenWrt Wiki
Wired WAN + 3G dongle - OpenWrt Wiki
OpenWrt / 3g connection doesn't start at boot
Rex's blah blah blah » Mobile AP based on OpenWrt