最近写了很多关于小程序的博客,突然想起在上一家公司的 openwrt 开发经历,什么 WiFi 探针啊,什么串口数据啊,还有4G模块上网啊,当时也想着把所有内容写成博客,还列了十篇博客的大纲,结果就写了一篇,现在快一年过去了,想想自己做过的东西总得留个痕迹吧,现在代码也丢了,只留下一些之前学习的收藏文章,反正也大致写写吧。

编写源码

开发环境是 Windows10下面的 Ubuntu子系统,具体可以看我之前博客。

第一步先创建目录,项目代码要放在 openwrt根目下的 package 目录中,这里源码写在了 hellworld 的 src 目录下,因为外层还有需要编写的文件。

mkdir -p ~/openwrt/package/hellworld/src
cd  ~/openwrt/package/helloworld/src

然后编写 helloworld.c 和源码下的 Makefile 文件

touch helloworld.c Makefile
nano helloworld.c
nano Makefile

helloworld.c 内容如下

#include <stdio.h>
int main()
{
    printf("hello world!\n");
    return 0;
}

Makefile 包含了两个编译过程,一个清除的命令

helloworld : helloworld.o
    $(CC) $(LDFLAGS) helloworld.o -o helloworld

helloworld.o : helloworld.c
    $(CC) $(CFLAGS) -c helloworld.c

clean :
    rm *.o helloworld

写完上面的代码后,可以简单测试一下,输入 make 编译,生成可执行文件,用 ./ 运行就可以了,使用 make clean 可以清除生成的可执行文件

make 
make clean

编写配置文件

这里先进入上一层目录,即 helloworld 目录,并创建一个新的 Makefile 文件

$cd ~/openwrt/package/helloworld
$touch Makefile

接下来编写这个 Makefile 文件,内容如下

include $(TOPDIR)/rules.mk

#定义相关信息
PKG_NAME:=helloworld
PKG_RELEASE:=1
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
    It's my first package demo.
endef

define Build/Prepare
    echo "Here is Package/Prepare"
    mkdir -p $(PKG_BUILD_DIR)
    $(CP) ./src/* $(PKG_BUILD_DIR)/
endef

define Package/helloworld/install
    echo "Here is Package/install"
    $(INSTALL_DIR) $(1)/bin
    $(INSTALL_BIN) $(PKG_BUILD_DIR)/helloworld $(1)/bin/
endef

$(eval $(call BuildPackage,helloworld))

这里别人写的很清楚,我就拿过来用了,也可以参考官方文档。

第1行 include $(TOPDIR)/rules.mk
一般在Makefile的开头,包含了包的基本信息,比如Makefile中的 $(BUILD_DIR), $(INCLUDE_DIR), $(CP), $(INSTALL_DIR), $(INSTALL_BIN)都是这里定义的.具体内容可以到源码主目录下,查看 rules.mk文件.

3~5行,软件包的信息均以“PKG_”开头,其意思和作用如下
PKG_NAME:软件包名称,将在menuconfig和ipkg可以看到。
PKG_VERSION:软件版本号。
PKG_RELEASE:Makefile的版本号
PKG_SOURCE:源代码的文件名。
PKG_SOURCE_URL:源代码的下载网站位置。
PKG_MD5SUM:源代码文件的效验码。用于核对软件包是否下载正确。
PKG_CAT:源代码文件的解压方法。包括zcat, bzcat, unzip等。
PKG_BUILD_DIR:软件包编译目录。它的父目录为$(BUILD_DIR)。

第7行 include $(INCLUDE_DIR)/package.mk
一般在软件包的基本信息完成后再引入,他定义了用户态软件包的规则。编译包分为用户态和内核模块,用户态软件包使用Package,内核模块使用KernelPackage. $(INCLUDE_DIR)/Kernel.mk文件对于软件包为内核时不可缺少, $(INCLUDE_DIR)/package.mk应用在用户态。接下来讲述用户态软件包。用户程序的编译包以 Package/开头,然后接着软件名,在Package定义中的软件名可以与软件包名不一样,而且可以多个定义。

9~13行
定义包的名称为 helloworld
SECTION : 包的类型为 utils
CATEGORY : 目录为Utilitis,即文件在 menuconfig中的位置;有时还会有 SUBMENU项,即子目录.
TITLE : 用于软件包的简短描述,将显示在 menuconfig中.
URL : 软件包的下载位置。
MAINTAINER : 维护者选项。
DEPENDS : 与其他软件的依赖。即如编译或安装需要其他软件时需要说明。如果存在多个依赖,则每个依赖需用空格分开。依赖前使用+号表示默认显示,即对象沒有选中时也会显示,使用@则默认为不显示,即当依赖对象选中后才显示。

15~17行
软件包的详细描述,将显示在 make menuconfig中

19~23行
编译准备方法,对于网上下载的软件包不需要再描述。对于非网上下载或自行开发的软件包必须说明编译准备方法。本文所用的准备方法就是首先创建软件包目录,然后将源码拷贝到刚刚创建的目录中。按OpenWrt的习惯,一般把自己设计的程序全部放在src目录下。

25~29行
软件包的安装方法,包括一系列拷贝编译好的文件到指定位置。调用时会带一个参数,就是嵌入系统的镜像文件系统目录,因此$(1)表示嵌入系统的镜像目录。
INSTALL_DIR:=install -d -m0755 : 创建所属用戶可读写、执行,其他用戶可读可执行的目录
INSTALL_BIN:=install -m0755 : 编译好的文件到镜像文件目录

31行 $(eval $(call BuildPackage,helloworld))
完成前面定义后,必须使用eval函数实现各种定义。其格式为:
对于一般软件包: $(eval openwrt python2编译_openwrt python2编译(PKG_NAME)))
或对于内核模块: $(eval openwrt python2编译_openwrt python2编译_02(PKG_NAME)))
如果一个软件包有多个程序,例如:一个应用程序有自己的内核模块,上面使用的 PKG_NAME需要灵活变通。 eval函数可能设计多个。也可以当成多个软件包处理。

编译软件

这里要回到 openwrt 的主目录编译软件

cd ~/openwrt

在 menu 中选中我们添加的软件

make menuconfig

还记得我们写的配置文件吗?我们定义了软件目录。

define Package/helloworld
    SECTION:=utils
    CATEGORY:=Utilities
    TITLE:=Helloworld -- prints a snarky message
endef

在 openwrt 菜单首页的 Utilities中找到 helloworld,使用空格键勾选上,保存退出。

接下来在 openwrt 的根目录下,单独编译我们的软件

make package/helloworld/compile V=s

应该可以在 openwrt\bin\ramips\ 下的某个目录找到,也可以用下面命令

find bin/ -name "helloworld*.ipk"

软件安装

具体如何使用 SFTP 传文件可以看我上一篇博客,下面讲讲安装软件,下面是一些命令

opkg install xxx.ipk

opkg update #更新可以获取的软件包列表
opkg upgrade #对已经安装的软件包升级
opkg list #获取软件列表
opkg install #安装指定的软件包
opkg remove #卸载已经安装的指定的软件包

运行软件

在 openwrt 板子上输入 helloworld并按下回车,应该就会输出我们代码里输出的内容

helloworld
hello world!