这是 Flippy 的 Openwrt 打包源码，主要用于制作基于arm64 soc的一系列电视盒及开发板可用的openwrt固件，例如：Phicomm N1(amlogic s905d)、贝壳云(rockchip rk3328)、我家云(rockchip rk3328)、微加云(allwinner H6)、Amlogic S905x3、Amlogic s912、Amlogic S922x、FastRhino R66S/R68S(RK3568)、Radxa E25(RK3568)、Hlink H28K(RK3528)、Hlink H66K/H68K/H69K(RK3568)、Hlink H88K(RK3588)，Radxa rock5b(RK3588)、ZCube1-Max(RK3399)、JRadxa CM3-RPI-CM4-IO(RK3566)、JP-TVbox(RK3566)等，除了原生固件以外，也支持 ARM64 Docker openwrt、ARM64 QEMU KVM openwrt等多种形式的固件，基本可满足所有arm64机型的需求了。

一、制作材料：

1. Flippy预编译好的 Arm64 内核 (在 https://t.me/openwrt_flippy 及 https://pan.baidu.com/s/1tY_-l-Se2qGJ0eKl7FZBuQ 提取码：846l)
2. 自己编译的 openwrt rootfs tar.gz 包： openwrt-armvirt-64-default-rootfs.tar.gz , openwrt的源码仓库首选 (https://github.com/coolsnowwolf/lede) ，当然也可以采用其它第三方源，例如 (https://github.com/Lienol/openwrt) , 也可以采用 openwrt 官方源： (https://github.com/openwrt/openwrt)。

二、环境准备

1. 需要一台 linux 主机， 可以是 x86或arm64架构，可以是物理机或虚拟机（但不支持win10自带的linux环境），需要具备root权限， 并且具备以下基本命令（只列出命令名，不列出命令所在的包名，因不同linux发行版的软件包名、软件包安装命令各有不同，请自己查询)： losetup、lsblk(版本>=2.33)、blkid、uuidgen、fdisk、parted、mkfs.vfat、mkfs.ext4、mkfs.btrfs (列表不一定完整，打包过程中若发生错误，请自行检查输出结果并添加缺失的命令）

2. 需要把 Flippy预编译好的 Arm64 内核上传至 /opt/kernel目录（目录需要自己创建）

3. cd /opt
   git clone https://github.com/unifreq/openwrt_packit

4. 把编译好的 openwrt-armvirt-64-default-rootfs.tar.gz 上传至 /opt/openwrt_packit目录中

5. cd /opt/openwrt_packit

   ./mk_xxx.sh # xxx指代你想要生成的固件类别，例如： ./mk_s905d_n1.sh 表示生成 Phicomm N1所用的固件

   生成好的固件是 .img 格式， 存放在 /opt/openwrt_packit/output 目录中，下载刷机即可

   提示:工作临时目录是 /opt/openwrt_packit/tmp, 为了提升IO性能，减少硬盘损耗，可以采用tmpfs文件系统挂载到该目录，最多会占用 1GB 内存， 挂载方法如下:

   # 开机自动挂载
   echo "none /opt/openwrt_packit/tmp  tmpfs   defaults   0  0" >> /etc/fstab
   mount /opt/openwrt_packit/tmp
   

   或者

   # 手动挂载
   mount -t tmpfs  none /opt/openwrt_packit/tmp
   

   相关的在线升级脚本在 files/目录下

   相关的 openwrt 示例配置文件在 files/openwrt_config_demo/目录下

6. openwrt rootfs 编译注意事项：

   Target System  ->  QEMU ARM Virtual Machine 
   Subtarget ->  QEMU ARMv8 Virtual Machine (cortex-a53)
   Target Profile  ->  Default
   Target Images  ->   tar.gz
   *** 必选软件包(基础依赖包，仅保证打出的包可以写入EMMC,可以在EMMC上在线升级，不包含具体的应用)： 
   Languages -> Perl               
                ->  perl-http-date
                ->  perlbase-file
                ->  perlbase-getopt
                ->  perlbase-time
                ->  perlbase-unicode                              
                ->  perlbase-utf8        
   Utilities -> Disc -> blkid、fdisk、lsblk、parted            
             -> Filesystem -> attr、btrfs-progs(Build with zstd support)、chattr、dosfstools、
                              e2fsprogs、f2fs-tools、f2fsck、lsattr、mkf2fs、xfs-fsck、xfs-mkfs
             -> Compression -> bsdtar 或 p7zip(非官方源)、pigz
             -> Shells  ->  bash         
             -> gawk、getopt、losetup、tar、uuidgen
             -> acpid (可选， 用于 kvm 虚拟机固件)
   
    * (可选)Wifi基础包：
    *     打出的包可支持博通SDIO无线模块,Firmware不用选，
    *     因为打包源码中已经包含了来自Armbian的firmware，
    *     会自动覆盖openwrt rootfs中已有的firmware
    Kernel modules  ->   Wireless Drivers -> kmod-brcmfmac(SDIO) 
                                          -> kmod-brcmutil
                                          -> kmod-cfg80211
                                          -> kmod-mac80211
    Network  ->  WirelessAPD -> hostapd-common
                             -> wpa-cli
                             -> wpad-basic
             ->  iw
             
    * 光影猫(Photonicat) 依赖包：
        *  (必选, required，如果不选的话开机一分钟内会自动关机，与硬件内置的看门狗有关)
        Utilities -> pcat-manager
   
        * 可选，optional, 如果不选的话，官方个性化主页无效
        Languages -> Python -> Python3-flask
                               Python3-flask-httpauth
                               Python3-flask-login
                               Python3-flask-seasurf
                               Python3-flask-session
                               Python3-flask-socketio
                               Python3-passlib
                               Python3-pyserial
                               Python3-sqlite3
                               Python3-xml
                               Python3-requests
   
    * DM路由监视器依赖包： https://hiwbb.com/2021/10/openwrt-netdata-show-temperature/
        *  (必选, required)
        Applications -> luci-app-netdata
   
        * 二选一：建议首先python方式
        Languages -> Python -> Python3-logging
                               Python3-ctypes
                               Python3-yaml
        Utilities -> lm-sensors
   
        * 或者(OR)   
        Utilities -> coreutils -> coreutils-timeout
   

   除上述必选项以外的软件包可以按需自主选择。

7. OpenWrt 在 KVM 虚拟机中的使用说明：

对于性能过剩的盒子，可以先安装 Armbian 系统，再安装 KVM 虚拟机实现多系统使用。其中 OpenWrt 系统的编译可以使用本仓库的 mk_qemu-aarch64_img.sh 脚本进行制作，其安装与使用说明详见 qemu-aarch64-readme.md 文档，更多系统如 Debian、Ubuntu、OpenSUSE、ArchLinux、Centos、Gentoo、KyLin、UOS 等可在相关网站查阅安装与使用说明。

三、其它相关信息请参见我在恩山论坛的贴子：

https://www.right.com.cn/forum/thread-981406-1-1.html

https://www.right.com.cn/forum/thread-4055451-1-1.html

https://www.right.com.cn/forum/thread-4076037-1-1.html

四、TG群友打包的固件地址

暴躁老哥： https://github.com/breakings/OpenWrt

有一妙计： https://github.com/HoldOnBro/Actions-OpenWrt/

诸葛先生： https://github.com/hibuddies/openwrt/

那坨： https://github.com/Netflixxp/N1HK1dabao

五、Github Actions 打包使用方法 actions 源码来自 https://github.com/ophub (smith1998)，主脚本为 openwrt_flippy.sh

在 .github/workflows/*.yml 云编译脚本中引入此 Actions 即可使用。详细使用说明：README.ACTION.md

- name: Package Armvirt as OpenWrt
  uses: unifreq/openwrt_packit@master
  env:
    OPENWRT_ARMVIRT: openwrt/bin/targets/*/*/*.tar.gz
    PACKAGE_SOC: s905d_s905x3_beikeyun
    KERNEL_VERSION_NAME: 5.13.2_5.4.132

六、采用 luci-app-amlogic 在线升级

luci-app-amlogic 源码来自 https://github.com/ophub/luci-app-amlogic (smith1998)， 可以集成到openwrt固件中，并与本打包源码紧密结合，可实现在线升级内核和在线升级完整固件。