说明
这是一个使用openwrt开发MT7688的例子(仅供测试)。
硬件为HLK-7688A模块,采用MT7688AN作为主芯片，具有32M Flash与128M DDR2 RAM。
源代码下载
由于本源代码包含第三方源代码,故直接下载可能有部分源代码缺失，需要通过以下方法解决:
-
在进行git clone 使用--recurse-submodules参数。
-
若已通过git clone下载,则在源代码目录中执行以下命令下载子模块:
git submodule update --init --recursive
key-build
采用openwrt的工具usign生成,生成后可在应用中使用公钥校验文件。
在openwrt中使用以下命令生成密钥对：
usign -G -c "注释信息" -p key-build.pub -s key-build
软件包
软件包实现目录为 packages/ 。除开第三方软件包，其余的软件包均将源代码放在本地目录，一般放在该软件包Makefile所在目录。对于C/C++程序，一般采用CMake作为构建工具，可生成适应各种IDE的工程。
FirstBootInit
软件包实现目录为 packages/FirstBootInit/。第一次启动执行的初始化脚本。可用于初始化某些设置（如WIFI）。
netlib
软件包实现目录为 packages/netlib/ 。网络库，包装一些常用的网络操作。作为库软件包模板。包含部分测试程序（编译完成后在 packages/netlib/src/build/,后缀为.exe），测试程序不会安装至openwrt。
appubus
软件包实现目录为 packages/appubus。使用C++封装常用的ubus客户端功能。
MQTTDaemon
软件包实现目录为 packages/MQTT/MQTTDaemon/ 。MQTT守护进程，可连接MQTT Broker。
luci-MQTTDaemon
软件包实现目录为 packages/MQTT/luci-MQTTDaemon/ 。MQTT守护进程的luci界面。
OneNETDaemon
软件包实现目录为 packages/MQTT/OneNETDaemon 。OneNET网关设备守护进程，可连接OneNET平台。
luci-OneNETDaemon
软件包实现目录为 packages/MQTT/luci-OneNETDaemon 。OneNET网关设备守护进程的luci界面。
编译
openwrt编译过程中,需要下载大量的数据，尤其是要确保github.com等外网的联通，若因下载失败而编译失败，请手动下载相应的软件包放入openwrt/dl目录,再重新编译。若网络不好需要编译很多次极为正常。
若在中国境内，建议做以下设置：
#启用go模块代理
export GO111MODULE=on
export GOPROXY=https://goproxy.cn
编译环境
编译环境的设置见https://openwrt.org/docs/guide-developer/start 。通常在编译过程中缺什么就安装什么即可。
除了自行安装工具，在Linux下还可直接使用docker(需要自行安装docker)命令直接进入编译环境：
#若一开始使用docker那么需要一直使用docker。否则openwrt做的某些软链接会失效。
#此openwrt-be镜像推荐用于脚本测试，除非手动安装环境不成功，不推荐直接用于整个openwrt的编译，推荐使用ubuntu镜像。
sudo docker run -it --rm -u `id -u`:`id -g` -v `pwd`:/work -w /work heyahong/openwrt-be:22.03 /bin/bash
#更多关于此docker镜像的说明见https://hub.docker.com/r/heyahong/openwrt-be
#此ubuntu镜像安装了编译所需工具，可直接作为编译环境。
sudo docker run -it --rm -u `id -u`:`id -g` -v `pwd`:/work -w /work heyahong/buildenv-ubuntu22.04:base
#更多关于此docker镜像的说明见https://hub.docker.com/r/heyahong/buildenv-ubuntu22.04
常用操作
所有操作都需要在执行bootstrap.sh后进行。成功执行bootstrap.sh后可进行以下操作：
-
编译
#直接编译 make #直接编译(显示详细信息) make V=sc -
配置kconfig
make menuconfig -
清理
#清理生成的文件 make clean #清理所有（建议备份好openwrt/dl再清理） make distclean
烧录
编译完成后（未报错直接退出），所有生成的文件在openwrt/bin目录下,其中用的最多的是用于sysupgrade的bin文件。可采用以下方式安装：
- 通过openwrt的固件升级安装。注意：不要保留配置。
- 通过bootloader（如breed，模组厂家的uboot）安装固件。注意：布局需要选公版布局，非公版布局将导致mac地址不正确。
调试
串口
串口0为调试串口，主要用于调试信息输出，参数为57600 8N1。
串口主要有以下用途：
- uboot阶段输出启动信息。在此阶段也可进行一些其它操作，如升级固件（openwrt固件损坏救砖方式之一）等。
- linux启动过程中输出内核启动信息。
- linux启动完成后可通过串口进入控制台(按ENTER)，可打开SHELL。
- 用户程序启动后输出信息(如直接向/dev/ttyS0写入信息,
echo 信息 > /dev/ttyS0)。
调试信息
openwrt作为一个完整的linux系统，可使用多种方式进行调试。
在本工程中通常采用syslog输出调试信息,可通过以下方式查看输出的syslog:
- 登陆luci界面后，在 状态 -> 系统日志 的WEB界面查看
- 登陆控制台后（通过串口登陆或者ssh登陆），使用 logread 命令读取系统日志。
- 如果在luci界面中设定了其它方式（如输出到文件或者外部服务器），可使用其它方式查看系统日志。
在用户程序中，可通过以下方式输出syslog：
- 在sh脚本中，可使用 logger 命令向系统日志写入信息。
- 在C/C++程序中，可使用 syslog 函数输出系统日志（需要先使用 openlog 打开系统日志）
软件包中用户二进制文件的测试
有时候需要对某个编译后得到的用户二进制程序进行测试，除了使用硬件测试（使用各种工具上传到开发板中），还可以使用qemu测试（使用QEMU用户程序模拟器）。
在ubuntu中，可使用以下命令安装QEMU（其他平台请自行查找资料安装）：
sudo apt-get install qemu-user
运行二进制文件
注意：所有的运行操作必须在编译完成后，若未编译完成，可能不可运行。
./qemu_run.sh 待运行的程序及参数
