openwrt開發

以前寫過一篇日誌，是關於如何搭建本身的OpenWRT開發環境。通過最近一段時間的開發學習和實踐，對OpenWRT環境的開發有了必定的瞭解。在這裏將個人開發心得作個整理。

 

一、搭建開發環境

首先，咱們須要一個爲路由器定製的開發環境，具體能夠參考個人另外一篇日誌：《搭建本身的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目錄下的全部文件給清除掉!!

 

二、 更改原有packages

 

在編譯根目錄下會有一個dl的目錄，這個目錄實際上是「download」的簡寫，在編譯前期，須要從網絡下載的數據包都會放在這個目錄下，這些軟件包的一個特色就是，會自動安裝在所編譯的固件中，也就是咱們make menuconfig的時候，爲固件配置的一些軟件包。若是咱們須要更改這些源碼包，只須要將更改好的源碼包打包成相同的名字放在這個目錄下，而後開始編譯便可。編譯時，會將軟件包解壓到build_dir目錄下。

固然，你也能夠本身在dl裏面建立本身的軟件包，而後更改相關的配置文件，讓openwrt能夠識別這個文件包。

 

因爲個人項目更改的內容是底層的，須要跟固件一塊兒安裝。因此，我使用的方法就是直接更改dl目錄下軟件包，而後從新進行固件編譯。感受相似於Linux的內核編譯。反覆編過十屢次，沒有任何問題。

 

三、 新建本身的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】

 

但願對你們能有幫助 :)

 

-----------------------------------------------------------