This document provides instructions for building OpenWrt firmware including setting up the build environment, downloading feeds, configuring packages, building the firmware image, and flashing or upgrading the firmware on devices. Key steps include making a defconfig, adding custom feeds, resolving package conflicts, and using tools like sysupgrade to update devices.

1. OpenWrt Guide
sean

2. Doc version
● V1 2018-04-28
– Source,build,download
– Feeds,init rc,uci,ubus

3. Being-towards-death

4. Build script
● ./m.sh
– cd qsdk
– make defconfig # openwrt standard
– make V=s -j8
– cd -
– ./pack.sh
● cp -rvf qsdk/bin/ipq806x/openwrt* common/build/ipq #use new build squashfs-root.img
● cd common/build/
● python update_common_info.py #build mtd single bin
● cp -vf bin/nornand-ipq40xx-single.img /media/sean/project/IPQ4019/img/spf5.img # release fw
● cd -
● Mount smb of 176 to local path
– sudo mount -t cifs //192.168.180.176/project/ /media/sean/project/ -o guest

5. Build env
● Ubuntu 14.04
– Glibc 2.17
● sudo apt-get install gcc g++ binutils patch bzip2 flex make gettext
pkg-config unzip zlib1g-dev libc6-dev subversion libncurses5-dev
gawk
sharutils curl libxml-parser-perl ocaml-nox ocaml-nox ocaml
ocaml-findlib
libpcre3-dev binutils-gold python-yaml
● sudo apt-get install u-boot-tools
● sudo apt-get install device-tree-compiler
● sudo apt-get install mtd-utils

6. Juci build env
● feeds/juci/openwrt-bootstrap.sh

7. Download fw
● Self upgrade (recommend)
– Copy fw bin to device
● Use scp # see ssh to openwrt
– Use sysupgrade
● Tftp download
– Need to connect serial port
– See uboot and tftpboot
● Flash program
– Need program device

8. Telnet to openwrt

If not set root passwd

telnet 192.168.1.1
●
passwd #set root password, needed by
scp&ssh

9. ssh to openwrt

ssh root@192.168.1.1

scp /pathto/spf502.img root@192.168.1.1:/tmp/


10. sysupgrade

sysupgrade -c -v /tmp/xxx-single.img

Not need serial port

openwrt 升级功能介绍
 https://blog.csdn.net/u013485792/article/details/50505
706

WARN: can't upgrade from nor to nornand

11. uboot

reset # soft reboot

set # set var, used by $var

12. tftpboot

set ipaddr 192.168.1.11

set serverip 192.168.1.xx

ping ${serverip}

tftpboot 0x84000000 xxxx-ipq40xx-single.img

imgaddr=0x84000000 && source $imgaddr:script

13. Check firmware version

cat /proc/version | less
 Build user and hostname
 Build time
 Kernel version
 ...

14. ROM

df -h

/tmp 115

/rom 15

/ | /overlay 38

15. RAM

free -m
 Total 236 used 134 free 102

16. Feeds folder
Qsdk/feeds
├── luci -> ../qca/feeds/luci
├── luci.index -> luci.tmp/.packageinfo
├── luci.targetindex -> luci.tmp/.targetinfo
├── packages -> ../qca/feeds/packages
├── packages.index -> packages.tmp/.packageinfo
├── packages.targetindex -> packages.tmp/.targetinfo

17. Add feeds

src-git juci https://github.com/mkschreder/juci-
openwrt-feed.git

src-git vuci https://github.com/zhaojh329/vuci.git

./scripts/feeds update vuci juci

./scripts/feeds install -a -p vuci

18. Feeds command

./scripts/feeds list -s

./scripts/feeds install -a -f -p juci

19. Makefile
● https://openwrt.org/docs/guide-developer/packag
es
● define Package/lighttpd/Default
● define Package/lighttpd
– $(call Package/lighttpd/Default)
● define Package/lighttpd/config
● define Package/lighttpd/install
● define Build/Configure
● define Build/Prepare
● define Build/Compile

20. feeds/juci/libblobpack/Makefile
+PKG_VERSION=2.16.09-$(PKG_SOURCE_VERSION)
+PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.gz
+PKG_SOURCE_SUBDIR:=$(PKG_NAME)-$(PKG_VERSION)
make[3]: Entering directory `/work/workspace/SPF5.02/qca-networking-2017-spf-5-0-
2_qca_oem.git/qsdk/feeds/juci/libblobpack'
Makefile:43: *** Download/default is missing the FILE field.. Stop.

21. Configuration .config
cp qca/configs/qsdk/ipq806x_standard.config
.config

make defconfig

Modify manual

make defconfig # again before real make

**Use version control .config

make menuconfig # for modify

22. luci and juci conflict
● cp v9.luci.config .config
● cp v9.juci.config .config
●
make menuconfig
– Select luci and unselect all juci
– Select juci and unselect all luci

23. Usb net

CONFIG_PACKAGE_kmod-usb-net=y

CONFIG_PACKAGE_kmod-usb-net-cdc-ether=y

CONFIG_PACKAGE_kmod-usb-net-rndis=y

24. make

make V=s -j8

make -j8

make download V=s # download to dl folder

make V=s -j1 # for check build error

make package/juci/compile V=s -j1

25. Make clean
●
Don't call make clean
●
/build_dir/target-arm_cortex-a7_uClibc-
1.0.14_eabi/xxx-project
– rm -rf ipkg-i* #ipkg-install, ipkg-ipq806x
●
rm -rf ./build_dir/target-arm_cortex-a7_uClibc-
1.0.14_eabi/root-ipq806x/
●

26. Init Scripts

https://openwrt.org/docs/techref/initscripts

/etc/init.d/

/etc/rc.d/

27. Power 4G modem
● Qsdk/package/base-files/files/etc/rc.local
● Power up:gpio 39
● Power on:gpio 21

28. UCI is a data backend

https://openwrt.org/zh-cn/doc/techref/uci

https://openwrt.org/docs/guide-user/base-
system/uci
 Configuration Files Lists

UCI 配置文件位于目录 /etc/config/ 内

use init.d call to take effect

/etc/config/samba overwrite
/etc/samba/smb.conf when running
/etc/init.d/samba start

29. Not UCI

https://openwrt.org/docs/guide-user/base-
system/notuci.config

System configuration not handled by UCI

30. UBUS is a functional backend

ubus call network reload

31. SVC
● .repo/manifest.xml
● feeds.conf

32. .repo/manifest.xml
● name="quic/qsdk/oss/system/openwrt"
path="qsdk"
●

33. feeds.conf
● src-link juci ../vendor/feeds/juci

34. ●Vendor-feeds-juci
● Fixed bug for build libblobpack
● Change src git
– juci
– orange-rpcd
–

35. configs
● qca/configs/qsdk/
– mr1200.config

36. issue
● perf build error
– ##CONFIG_PACKAGE_perf=y
● Diff ath9k_platform.h
– cmp $
(PKG_BUILD_DIR)/include/linux/ath9k_platform.h $
(LINUX_DIR)/include/linux/ath9k_platform.h

37. blogs
● https://www.cnblogs.com/rohens-hbg/category/
728530.html
● https://blog.csdn.net/xushx_bigbear/article/det
ails/47746241
● https://blog.csdn.net/walker0411
● https://blog.csdn.net/u012819339/article/categ
ory/5803489
●

38. packages
● Source download from URL
● Source present in src
– Build/Prepare
● $(CP) ./src/* $(PKG_BUILD_DIR)/
●

39. Add a new module
● https://openwrt.org/docs/guide-
developer/helloworld/start
● Release path
– vendor/feeds/qos
● Link in feeds
–