openwrt開發

weixin_34377065發表於2015-03-24

之前寫過一篇日誌,是關於如何搭建自己的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】

 

希望對大家能有幫助 :)

 

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

相關文章