【整理】如何在OpenWRT環境下做開發
之前寫過一篇日誌，是關於如何搭建自己的OpenWRT開發環境。經過最近一段時間的開發學習和實踐，對OpenWRT環境的開發有了一定的瞭解。在這裏將我的開發心得做個整理。
1、搭建開發環境
首先，我們需要一個爲路由器定製的開發環境，具體可以參考我的另一篇日誌：《搭建自己的OpenWrt開發環境》。這裏只做一個簡單的補充，在執行make menuconfig後，會出現下圖：
其中，圖中紅框部分是我定製路由器的系統版本，大家可以根據不同的路由器進行不同的選擇；綠框部分表示我們需要編譯一個SDK開發環境（默認情況下，此項未勾選）。
編譯過程中需要通過官網下載很多相關的軟件包，所以必須保證能夠順利連上外網。由於下載速度的限制，編譯過程大概需要數小時。編譯結束後，所有的產品都會放在編譯根目錄下的bin/yourtarget/. 例如:我所編譯的產物都放在./bin/brcm47xx/下，其中文件主要有幾類：
（1）.bin/.trx 文件: 這些都是在我們所選的target-system的類別之下，針對不同路由器型號、版本編譯的路由器固件。這些不同路由器的型號和版本是openwrt預先設置好的，我們不需要更改。至於.bin和.trx的區別，一種說法是，第一次刷路由器的時候，需要用.bin文件，如果需要再升級，則不能再使用.bin文件，而需要用.trx文件。原因是，.bin是將路由器的相關配置信息和.trx封裝在一起而生成的封包，也就是說是包含路由器版本信息的.trx。在第一次刷固件的時候，我們需要提供這樣的信息，而在後續升級時，則不再需要，用.trx文件即可。
（2）packages文件夾: 裏面包含了我們在配置文件裏設定的所有編譯好的軟件包。默認情況下，會有默認選擇的軟件包。
（3）OpenWrt-SDK.**.tar.bz2: 這個也就是我們定製編譯好的OpenWRT SDK環境。我們將用這個來進行OpenWrt軟件包的開發。例如，我所編譯好的SDK環境包爲：/bin/brcm47xx/OpenWrt-SDK-brcm47xx-for-Linux-x86_64-gcc-4.3.3+cs_uClibc-0.9.30.1.tar.bz2
可以從名稱上看出，target system是brcm47xx，host system是Linux-x86_64，使用的編譯工具以及庫是4.3.3+cs_uClibc-0.9.30.1。
（4）md5sums 文件: 這個文件記錄了所有我們編譯好的文件的MD5值，來保證文件的完整性。因爲文件的不完整，很容易將路由器變成“磚頭”。
需要主要的是，編譯完成後，一定要將編譯好的bin目錄進行備份（如果裏面東西對你很重要的話），因爲在下次編譯之前，執行make clean 會將bin目錄下的所有文件給清除掉!!
2、 更改原有packages
在編譯根目錄下會有一個dl的目錄，這個目錄其實是“download”的簡寫，在編譯前期，需要從網絡下載的數據包都會放在這個目錄下，這些軟件包的一個特點就是，會自動安裝在所編譯的固件中，也就是我們make menuconfig的時候，爲固件配置的一些軟件包。如果我們需要更改這些源碼包，只需要將更改好的源碼包打包成相同的名字放在這個目錄下，然後開始編譯即可。編譯時，會將軟件包解壓到build_dir目錄下。
當然，你也可以自己在dl裏面創建自己的軟件包，然後更改相關的配置文件，讓openwrt可以識別這個文件包。
由於我的項目更改的內容是底層的，需要跟固件一起安裝。所以，我使用的方法就是直接更改dl目錄下軟件包，然後重新進行固件編譯。感覺類似於Linux的內核編譯。反覆編過十多次，沒有任何問題。
3、 新建自己的packages
對於自己新建的package，而這個package又不需要隨固件一起安裝，換句話說，就是可以當做一個可選軟件包的話。我們可以利用我們的SDK環境來單獨編譯，編譯後會生成一個ipk的文件包。然後利用 opkg install xxx.ipk 來安裝這個軟件。
下面具體說下，如何編譯一個helloword的軟件包。
（1）首先，編寫helloworld程序
編寫helloworld.c
/****************
* Helloworld.c
* The most simplistic C program ever written.
* An epileptic monkey on crack could write this code.
*****************/
#include <stdio.h>
#include <unistd.h>
int main(void)
{
printf("Hell! O' world, why won't my code compile?\n\n");
return 0;
}
編寫Makefile文件
# build helloworld executable when user executes "make"
helloworld: helloworld.o
$(CC) $(LDFLAGS) helloworld.o -o helloworld
helloworld.o: helloworld.c
$(CC) $(CFLAGS) -c helloworld.c
# remove object files and executable when user executes "make clean"
clean:
rm *.o helloworld
在這兩個文件的目錄下，執行make 應該可以生成helloworld的可執行文件。執行helloworld後，能夠打印出“Hell! O' world, why won't my code compile?”。 這一步，主要保證我們的源程序是可以正常編譯的。下面我們將其移植到OpenWRT上。
（2）將OpenWrt-SDK-brcm47xx-for-Linux-x86_64-gcc-4.3.3+cs_uClibc-0.9.30.1.tar.bz2解壓
tar –xvf OpenWrt-SDK-brcm47xx-for-Linux-x86_64-gcc-4.3.3+cs_uClibc-0.9.30.1.tar.bz2
（3）進入SDK
cd OpenWrt-SDK-brcm47xx-for-Linux-x86_64-gcc-4.3.3+cs_uClibc-0.9.30.1
可以看到裏面的目錄結構跟我們之前source的目錄結構基本相同，所需要編譯的軟件包，需要放置在package目錄下
（4）在package目錄下創建helloworld目錄
cd package
mkdir helloworld
cd helloworld
（5）創建src目錄，拷貝 helloworld文件
mkdir src
cp /home/wrt/test/helloworld.c src
cp /home/wrt/test/Makefile src
（6）在helloworld目錄下創建Makefile文件
這個Makefile文件是給OpenWRT讀的，而之前寫的那個Makefile文件是針對helloworld給編譯其讀的。兩個Makefile不在同一層目錄下。
touch Makefile
vim Makefile
Makefile文件模板內容如下：
##############################################
# OpenWrt Makefile for helloworld program
#
#
# Most of the variables used here are defined in
# the include directives below. We just need to
# specify a basic description of the package,
# where to build our program, where to find
# the source files, and where to install the
# compiled program on the router.
#
# Be very careful of spacing in this file.
# Indents should be tabs, not spaces, and
# there should be no trailing whitespace in
# lines that are not commented.
#
##############################################
include $(TOPDIR)/rules.mk
# Name and release number of this package
PKG_NAME:=helloworld
PKG_RELEASE:=1
# This specifies the directory where we're going to build the program.
# The root build directory, $(BUILD_DIR), is by default the build_mipsel
# directory in your OpenWrt SDK directory
PKG_BUILD_DIR := $(BUILD_DIR)/$(PKG_NAME)
include $(INCLUDE_DIR)/package.mk
# Specify package information for this program.
# The variables defined here should be self explanatory.
# If you are running Kamikaze, delete the DESCRIPTION
# variable below and uncomment the Kamikaze define
# directive for the description below
define Package/helloworld
SECTION:=utils
CATEGORY:=Utilities
TITLE:=Helloworld -- prints a snarky message
endef
# Uncomment portion below for Kamikaze and delete DESCRIPTION variable above
define Package/helloworld/description
If you can't figure out what this program does, you're probably
brain-dead and need immediate medical attention.
endef
# Specify what needs to be done to prepare for building the package.
# In our case, we need to copy the source files to the build directory.
# This is NOT the default. The default uses the PKG_SOURCE_URL and the
# PKG_SOURCE which is not defined here to download the source from the web.
# In order to just build a simple program that we have just written, it is
# much easier to do it this way.
define Build/Prepare
mkdir -p $(PKG_BUILD_DIR)
$(CP) ./src/* $(PKG_BUILD_DIR)/
endef
# We do not need to define Build/Configure or Build/Compile directives
# The defaults are appropriate for compiling a simple program such as this one
# Specify where and how to install the program. Since we only have one file,
# the helloworld executable, install it by copying it to the /bin directory on
# the router. The $(1) variable represents the root directory on the router running
# OpenWrt. The $(INSTALL_DIR) variable contains a command to prepare the install
# directory if it does not already exist. Likewise $(INSTALL_BIN) contains the
# command to copy the binary file from its current location (in our case the build
# directory) to the install directory.
define Package/helloworld/install
$(INSTALL_DIR) $(1)/bin
$(INSTALL_BIN) $(PKG_BUILD_DIR)/helloworld $(1)/bin/
endef
# This line executes the necessary commands to compile our program.
# The above define directives specify all the information needed, but this
# line calls BuildPackage which in turn actually uses this information to
# build a package.
$(eval $(call BuildPackage,helloworld))
（7）返回到SDK的根目錄
執行make進行編譯
編譯過程會在build_dir目錄下完成
編譯結果會放在 bin/[yourtarget]/package目錄下helloworld_1_bcm47xx.ipk
（8）上傳helloworld_1_bcm47xx.ipk
使用sftp軟件上傳helloworld_1_bcm47xx.ipk至路由器
執行 opkg install helloworld_1_bcm47xx.ipk
輸入hello然後按Tab鍵，發現openwrt中已經有helloworld可執行命令。
執行 helloworld 查看程序的效果。
Hell! O' world, why won't my code compile?
【End】
希望對大家能有幫助 :)
-----------------------------------------------------------
