openWRT自学---如何开发新的用户态模块-helloworld
以http://www.gargoyle-router.com/wiki/doku.php?id=openwrt_coding为参考文档
1.要获得openWRT的sdk环境。只要在Backfire的make menuconfig中选择:Build the OpenWRT SDK,然后make即可。会得到一个sdk的压缩包:OpenWrt-SDK-brcm47xx-for-Linux-x86_64-gcc-4.3.3+cs_uClibc-0.9.30.1.tar.bz2 (位置在bin/brcm47xx目录中)。这个SDK就是我们后面开发自己的模块的开发环境了(因为它模拟了我们开发的模块所要工作的目标平台的编译环境)
2.将OpenWrt-SDK-brcm47xx-for-Linux-x86_64-gcc-4.3.3+cs_uClibc-0.9.30.1.tar.bz2拷贝到其他地方并解压缩,然后将得到的目录名改短为:OpenWrt-SDK-brcm47xx;进入此目录后会发现其组成和之前使用的openWRT的开发包大致是一样的。
进入其中的OpenWrt-SDK-brcm47xx/package目录,并开始我们自己的模块,即helloworld的开发。
这里有一篇文档,可以指导如何使用此SDK环境:http://wiki.openwrt.org/doc/howto/obtain.firmware.sdk
3.创建一个子目录:helloworld(代表我们自己的模块),进入helloworld子目录。在此目录中创建一个用于让OpenWRT识别的Makefile。其内容如下:
#
# Copyright (C) 2007-2010 OpenWrt.org
#
# This is free software, licensed under the GNU General Public License v2.
# See /LICENSE for more information.
#
include $(TOPDIR)/rules.mk
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
define Package/helloworld
SECTION:=utils
CATEGORY:=Utilities
TITLE:=Helloworld -- prints a snarky message
endef
define Package/helloworld/description
helloworld,first self-made.
endef
define Build/Prepare
mkdir -p $(PKG_BUILD_DIR)
$(CP) ./src/* $(PKG_BUILD_DIR)/
endef
define Package/helloworld/install
$(INSTALL_DIR) $(1)/bin ---- 这个决定了最后通过opkg命令,将此ipk安装到设备中的哪个目录?
$(INSTALL_BIN) $(PKG_BUILD_DIR)/helloworld $(1)/bin/
endef
$(eval $(call BuildPackage,helloworld))
然后,再在此目录下创建一个新的子目录:src,并在其中创建实际的源代码文件(helloworld.c)和针对此源代码文件的Makefile---这个Makefile是用来编译helloworld模块自己的。源代码文件:helloworld.c的内容是:
#include <stdio.h>
#include <unistd.h>
int main(void)
{
printf("hello world, my first self package \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
特别注意:
1.这里创建的两个Makefile,在ubuntu上,都不要使用Gedit来写,而要使用VIM来写,并特别保证命令之前使用TAB键盘进行空格操作。方能让Makfile识别出来 --- 我在这上面耗费了1天时间啊
2.不能使用make menuconfig来进行配置,否则会导致.config文件中只有一个关于helloworld模块的编译选项,其他与编译环境有关的配置项都消失了。这样会导致无法编译出结果;因此,在编写完上述Makefile和源代码后,只要在主目录上敲入make就可以了 -- 但是这里遗留一个问题:如果存在多个package,然而只要指定编译其中某一个,该怎么办呢?
**********************************************************
4.上述就是文件编写的过程了。如下是编译和使用
在OpenWrt-SDK-brcm47xx目录中,敲入make即可。然后就可以在bin/brcm47xx/packages目录下看到我们的编译成果了:helloworld_1_brcm47xx.ipk
5.接下来是将此文件拷贝到设备中。
首先,在设备中开启ssh服务;
然后,敲入命令:scp helloworld_1_brcm47xx.ipk root@192.168.1.1: 此命令敲入后会提示输入密码,则就把设备上的ssh的登陆密码输入即可。然后此ipk文件就拷贝到设备上的root目录中了 ---- 但是,这样还不是最终结果,我们还需要将此文件装载到设备上
最后,我们通过ssh连接到设备中,并敲入命令:opkg install helloworld_1_brcm47xx.ipk --- 这样,就真正把此ipk装载到设备中了 :装载到bin目录中
我们验证一下:在设备的任意目录中,敲入helloworld,就可以看到输出了:Hello world, my first self package
6.补充说明
如果我们更新了helloworld的源码包,并再次编译出新的ipk。则要更新之,需要做如下工作:
首先:将设备中的root目录下的当前的ipk删除之;并且将之前安装到设备的相同文件删除之(这个方法是opkg remove helloworld)
然后:将新的ipk通过scp命令拷贝到设备中, 并再通过opkg命令安装之