[Lua] comment

註解

• 任何地方「--」開始，直到行末

區塊註解

• 以「--[[」開始，直到下個「]]」
• 以「--[=[」開始，直到下個「]=]」，依此類推，兩邊等號數目要相等

小技巧：使用成對的「--[[」跟「--]]」，要取消註解，只要前面多加「-」變成「---[[」

--[[
--註解
--]]

取消

---[[
--取消區塊註解
--]]

參考：

1. Programming in Lua (second edition) by Roberto Ierusalimschy, Lua.org, March 2006

[Lua] Hello World

安裝：sudo apt-get lua5.2
(註：目前 Ubuntu 1304 是用 liblua5.1)

檔案：hello.lua

print("Hello World")

執行：lua hello.lua

Hello World

參考：

1. Programming in Lua (second edition) by Roberto Ierusalimschy, Lua.org, March 2006 

相關文章

• lua教學 - 不錯的 lua Hello World 文章，應該是《Programming in Lua》某個章節的翻譯，使用 lua 互動模式使用 print 印出字串、數字，數字運算，字串運算，數字變數，io.write()，io.read()。

[OpenWrt] sysupgrade

/sbin/sysupgrade 是一個 shell 指令檔，在 OpenWrt 自動化韌體更新作業，包括保留設定檔、覆寫 firmware 分割^[註]、重開機等等。

基本上，sysupgrade 需要 RAM 暫時儲存韌體及保留的設定檔。會保留的檔案或目錄紀錄在 /etc/sysupgrade.conf 跟 /lib/upgrade/keep.d/*。sysupgrade 加 -n 參數則不保留。

sysupgrade 會載入 /lib/upgrade 下的命令檔，不同 platform 需要提供自己的 platform_check_image() 來檢查更新檔是否正常，一般是 /lib/upgrade/platform.sh。此外亦可提供自己的 platform_do_upgrade() 及 platform_copy_config()。

註：raw flash 使用 mtd write，x86 跟 x86_64 用 dd，x86 的 olpc 用 > /dev/hda

參考：

1. https://openwrt.org/docs/guide-user/installation/generic.sysupgrade
2. /sbin/sysupgrade

[OpenWrt] preinit

一般 Linux 執行的第一個指令會是 /sbin/init、/etc/init、/bin/init、/bin/sh 其中之一 ，而 OpenWrt 將第一個執行的指令改為 /etc/preinit。

/etc/preinit 會呼叫 /lib/preinit/ 下的 script 來準備下列五組程式組，記在環境變數裡，並執行前面兩組：

1. preinit_essential：會先執行，大致上是在掛載 /proc, /sys, /tmp, /dev 等，跟相關 daemon，以及初始化 console。
2. preinit_main：大致包括載入 reset 按鍵驅動，設定網路界面，檢查是否執行 failsafe 程式組，初始化 hotplug，檢查是否執行 initramfs 程式組，執行 preinit_mount_root 程式組，回復系統設定，最後執行 /sbin/init。
3. failsafe：提供 telnet 登入
4. initramfs：似乎是空的
5. preinit_mount_root：掛載根目錄

[設備] TP-LINK TL-WR703N

號稱市面上最小的含有 USB Host 的 Wi-Fi AP，也相當省電，低於 1W^{[參考來源]}。

主要處理器是 Atheros AR9331，內含：

• AR7240 CPU @400MHz
• Wi-Fi 802.11b/g/n
• Fast Ethernet (有 5 port，但 WR703N 只用一個)
• USB 2.0

外加 4MB Flash 及 32MB RAM

AR9331 也用在 TL-MR3020 (多開關及一些燈號)、TL-WR741ND (使用 5 port Ethernet)

由於 OpenWrt 有支援，常拿來改成其它應用。

拆解：[參考]。應該拿小一字起子，往有卡榫的地方插下去。我插在卡榫旁邊不太好拆，需要一些暴力，造成一些損傷。

接 UART 出來

• 拆開後，正面下方的 TP_IN 及 TP_OUT 分別是 UART 的 Rx 及 Tx，如果接 FT232R 或其它轉 USB 的晶片或連接線，只需要再找一個 GND 接點。有人把 Ethernet 或 USB 的鐵殼當 GND，其實不是。除了背面的 TPGND 外，可以找的很多地方去接 GND。
• baud rate 是 115200。

備份 u-boot 及 art：

• u-boot 是 bootloader，損壞的話，將無法開機，也無法做任何更新動作，只能解焊 SPI Flash 透過燒錄器寫入好的 u-boot，才能讓 TL-WR703N 重新運作。有了 u-boot 之後，就可以更新其它任何部份。
• art 是放無線校準後的資料，損壞的話，可以開機，但會影響到無線功能無法使用。這裡提到，如果沒經過校準，Wi-Fi 訊號可能會較差；也就是複製別台同樣型號及處理器的 art，未必適用。
• 參考這裡，在 UART console 下用 Linux 的 cp 指令讀出 u-boot 及 art 分割，透過網頁存到 PC。應該也可以使用指令「dd if=/dev/mtd0 of=/tmp/boot.backup」跟「dd if=/dev/$(grep '"art"' /proc/mtd |cut -c 1-4) of=/tmp/art.backup」讀出。

加大 SPI Flash (例如改用 8MB SPI Flash)

• firmware 修改：
1. OpenWrt 的 tools/firmware-utils/src/mktplinkfw.c
•  TL-WR703Nv1 的 fw_max_len 改成 0x7c0000
2.  target/linux/ar71xx/files/arch/mips/ar71xx/mach-tl-wr703n.c
• rootfs 的 .size 改成 0x6d0000
• art 的 .offset 改成 0x7f0000
• firmware 的 .size 改成 0x7d0000
3. 編譯，結果在 bin/ar71xx/openwrt-ar71xx-tl-wr703n-v1-squashfs-*.bin
• 最終 8MB SPI Flash 的內容應該是：
• u-boot 複製自原本的 flash，放到 8MB flash
• art 複製自原本的 flash，放到到最後分割，也就是位址 0x7f0000 開始的地方
• firmware 需要改成支援 8MB Flash 後重新編譯產生，放到位址 0x20000 開始的地方
• 解焊舊 SPI Flash，焊上新 8MB SPI Flash。
• 參考
• https://forum.openwrt.org/viewtopic.php?pid=146315#p146315 (Flash/RAM Modification，使用 MR3420，很詳細)
• https://forum.openwrt.org/viewtopic.php?pid=179169#p179169 (新舊 Flash 並接，不用另外燒錄器寫新的 Flash)
• 使用 EZP2010 燒錄器

參考資料：

• http://wiki.openwrt.org/toh/tp-link/tl-wr703n (相當詳盡，包括 AR9331 pinout 等)
• http://www.osslab.com.tw/Hardware/Open_Embedded_System/MIPS/Atheros/WR-703N (有許多應用連結)
• 音效卡(可做air player)
• Wemcam (可做 ip cam)
• Printer
• Arduino Wi-Fi shield
• Wi-Fi robot：arduino 驅動+web cam +web gui，ser2net，mjpg-streamer，UVC摄像头驱动
• 小车网页控制：透過 luci web
• AR933x (WR703N) USB Device Driver (作為 USB gadget，需修改硬體、patch OpenWrt)

[OpenWrt] min. flash and RAM

OpenWrt 至少要有 4MB flash 及 16MB RAM。有些 2MB Flash 或 8MB RAM 的無線路由器 -- TL-WR702N 等，就無法執行 OpenWrt，但基於 Broadcom 處理器的在 DD-WRT 還勉強可以。

OpenWrt LED

無線路由器有許多 LED 顯示狀態。在 OpenWrt 下，如何控制 LED 呢？

除了電源狀態 (PWR) 是有電就亮，及一些 Ethernet 狀態 (WAN 和 LAN 1 2 3 4) 是 Ethernet Controller 直接控制外，其它 LED 是接到 SoC 的 GPIO，Linux Kernel 有個 platform 子系統，並有一些針對 GPIO 的現成驅動程式，例如驅動程式 leds-gpio 用來控制 LED。只要把 GPIO 的位置，所使用的驅動程式及功能在編譯前設定好，編譯後的 Linux Kernel 就能支援這些 GPIO。

• 準備資料結構 struct gpio_led，內含每個 LED 名稱、GPIO 接腳、是否 low 動作等。例如：
  static struct gpio_led tl_wr1043nd_leds_gpio[] __initdata = {
    {
        .name        = "tl-wr1043nd:green:wlan",
        .gpio        = TL_WR1043ND_GPIO_LED_WLAN,
        .active_low    = 1,
    }
};
不清楚 LED 名稱為何要取 tl-wr1043nd:green:wlan 這麼一長串
• 透過 platform_device_alloc() 取得使用 "leds-gpio" 的資料結構 struct platform_device。(相反是 platform_device_put())
• 建構資料結構 struct gpio_led_platform_data，包括 LED 數目，及 leds 欄位指到 struct gpio_led
• 透過 platform_device_add_data() 加進 struct gpio_led_platform_data
• 透過 platform_device_add() 登記到 Linux Kernel

上述例子是在 Linux 的 arch/mips/ar71xx/mach-tl-wr1043nd.c 執行 arch/mips/ar71xx/dev-leds-gpio.c 裡的 ar71xx_add_device_leds_gpio() 完成的。

編譯後的 Linux 就會有 /sys/class/leds/tl_wr1043nd:green:wlan/  目錄。使用方式，例如
點亮 LED：

echo 1 > /sys/class/leds/tl_wr1043nd:green:wlan/brightness

熄滅 LED

echo 0 > /sys/class/leds/tl_wr1043nd:green:wlan/brightness

應該還有其它用法，待了解。