Support for managing OpenWrt in Amlogic, Rockchip and Allwinner boxes. include install and update the OpenWrt and kernel, Backup and Restore config, Snapshot management, etc.
View Chinese description | 查看中文说明
This plugin supports online management of Amlogic S9xxx series (X96, HK1, H96, etc.), Allwinner (V-Plus Cloud), and Rockchip (BeikeYun, Chainedbox-L1-Pro, FastRhino-R66S/R68S, Radxa-5B/E25) boxes. It also works in OpenWrt installed in the KVM virtual machine of the Armbian system. Current features include install OpenWrt to EMMC
, manually uploading/updating online
OpenWrt firmware or kernel versions, backup/restore OpenWrt configuration
, snapshot management
, and customizing firmware/kernel download site
, etc.
Using the OpenWrt system and Amlogic box plugin in the box requires the support of some required software packages. When custom compiling OpenWrt
, please add it according to the instructions. When using the one-click script for manual installation
in OpenWrt without compiling Amlogic's box, if there is a prompt for missing dependencies, please install the dependencies according to the log prompt (System
> Software Packages
> Refresh List
> Search for the corresponding package
> Install
), then retry
.
System Menu
→ TTYD Terminal
, run the one-click installation command to automatically download and install this plugin.curl -fsSL git.io/luci-app-amlogic | bash
# Add the plugin
rm -rf package/luci-app-amlogic
git clone https://github.com/ophub/luci-app-amlogic.git package/luci-app-amlogic
# You can compile this plugin separately
make package/luci-app-amlogic/compile V=99
# Or integrate this plugin during the full compilation of OpenWrt
make menuconfig
# choose LuCI ---> 3. Applications ---> <*> luci-app-amlogic ----> save
make V=99
OpenWrt firmware
and kernel
files in online download update
of the plugin can be customized as your own github.com repository. Configuration information is saved in the /etc/config/amlogic file. During the compilation of OpenWrt firmware, you can directly modify the related values in this file:# 1. Set the download repository of OpenWrt files
sed -i "s|amlogic_firmware_repo.*|amlogic_firmware_repo 'https://github.com/USERNAME/REPOSITORY'|g" package/luci-app-amlogic/root/etc/config/amlogic
# 2. Set the keyword of Tags in Releases
sed -i "s|ARMv8|RELEASES_TAGS_KEYWORD|g" package/luci-app-amlogic/root/etc/config/amlogic
# 3. Set the suffix of OpenWrt file in Releases
sed -i "s|.img.gz|.OPENWRT_SUFFIX|g" package/luci-app-amlogic/root/etc/config/amlogic
# 4. Set the download path of OpenWrt kernel
sed -i "s|amlogic_kernel_path.*|amlogic_kernel_path 'https://github.com/USERNAME/REPOSITORY'|g" package/luci-app-amlogic/root/etc/config/amlogic
System
→ Amlogic Box
settings.The plugin settings consist of 4 elements: OpenWrt firmware download address, kernel download address, version branch selection, and others.
OpenWrt firmware download repository: Fill in your repository on github where you compile OpenWrt (or other compiler's repository), such as: https://github.com/breakings/OpenWrt
. The OpenWrt Compiler author
button on the plugin's welcome homepage will link to the website filled in here (automatically updates the link according to the filled website), making it easy for everyone to find the firmware compiler for exchange and learning.
Tags keywords in Releases: It needs to distinguish other x86, R2S, etc. firmwares, and ensure that this keyword can find the corresponding OpenWrt firmware.
Suffix of OpenWrt file: Supported formats include .img.gz
/ .img.xz
/ .7z
. However, .img is not supported because it is too large and slow to download.
OpenWrt
firmware in Releases, please include SOC model
and kernel version
: openwrt_ {soc}
_ xxx_{kernel}
_ xxx.img.gz, for example: openwrt_ s905d
_ n1_R21.8.6_k5.15.25
-flippy-62+o.7z. Supported SOC
includes: s905x3
, s905x2
, s905x
, s905w
, s905d
, s922x
, s912
, l1pro
, beikeyun
, vplus
. Supported kernel versions
include 5.10.xxx
, 5.15.xxx
, etc.https://github.com/breakings/OpenWrt
or the shorthand breakings/OpenWrt
. The plugin will automatically download kernels corresponding to specific tags from Releases on Github.com. For instance, it will download the universal kernel from kernel_stable, the rk3588 specialized kernel from kernel_rk3588, and the rk35xx specialized kernel from kernel_rk35xx, among others.KERNELTAGS='xxx'
to the /etc/flippy-openwrt-release
file in the OpenWrt system to specify the fixed Tags for kernel downloads. If specified, the plugin will automatically download kernels from the designated kernel_xxx
in Releases. For example, when KERNELTAGS='flippy'
is specified, kernels will be automatically downloaded from kernel_flippy
. When making custom settings, ensure that this Tag exists in the kernel download repository.5.10
, 5.15
, etc. The OpenWrt
and Kernel
[Online Download Update]
will download and update according to the branch you selected.Keep configuration update: Modify as needed. If checked, the current configuration will be retained when updating the firmware.
Automatically write bootloader: Recommended to be checked, it has many features.
Set file system type: Set the file system type of the shared partition (/mnt/mmcblk*p4) when installing OpenWrt (default is ext4). This setting only applies to fresh installations of OpenWrt, and will not change the file type of the current shared partition when updating the kernel and firmware.
The default OpenWrt firmware (Plugin Full Version | Selected Plugins Mini Version | Flippy Shared Version) and Kernel download service are provided by breakings, who is an active and enthusiastic manager in the Flippy community, familiar with OpenWrt compilation, and proficient in the installation and use of various series of boxes supported by Flippy
. For issues encountered in the compilation and use of OpenWrt, you can consult in the community or give feedback on his Github.
The kernel will be deprecated after the update cycle, and you can choose to use the kernel of any other version
in the plugin settings
. Some kernels do not have a complete firmware, you can change the kernel branch in the plugin settings
and choose the version branch corresponding to the download address.
The plugin has 6 functions: Install OpenWrt, Manual Upload Update, Online Download Update, Firmware Configuration Backup, Plugin Settings, and CPU Settings.
Install OpenWrt: Select your device from the Select Device Model
list, and click Install
to write the firmware from TF/SD/USB into the built-in eMMC of the device.
Manual Upload Update: Click the Choose File
button, select the local OpenWrt Kernel (upload the full set of kernel files)
or OpenWrt Firmware (recommended to upload compressed firmware)
, and upload. Once the upload is complete, the corresponding Replace OpenWrt Kernel
or Update OpenWrt Firmware
button will appear at the bottom of the page, click to update (the system will automatically reboot after the update).
Online Download Update: Click the Update Box Plugin Only
button to update the Amlogic Box plugin to the latest version; click Update System Kernel Only
to download the corresponding kernel according to the kernel branch selected in Plugin Settings
; click Full System Update
to download the latest firmware based on the download site set in Plugin Settings
. Clicking the Rescue the original system kernel
button will copy the kernel currently in use on the device to the target disk. This facilitates rescue operations in case a kernel update fails and the OpenWrt system cannot start. For example, it allows for booting the OpenWrt system from a USB drive to rescue the system on the eMMC, supporting mutual rescue among eMMC/NVME/sdX
devices.
Backup Firmware Configuration: Click the Open List
button to edit the backup list; click the Download Backup
button to backup the OpenWrt configuration information from the current device to local; click the Upload Backup
button to upload the backup configuration files and restore the system configuration. Click Create Snapshot
, Restore Snapshot
and Delete Snapshot
buttons to manage the snapshot accordingly. Snapshots will record all configuration information in the /etc
directory of the current OpenWrt system, which is convenient for one-click restore to the current configuration status in the future. This function is similar to Download Backup
, but only saves in the current system and does not support download use.
Plugin Settings: Set the kernel download address and other information of the plugin, for details, see the relevant introduction in Plugin Settings Instructions
.
CPU Settings: Set the scheduling policy of the CPU (recommended to use the default settings), which can be set according to needs.
Note: Install OpenWrt
and CPU Settings
and other functions will automatically hide inapplicable functions depending on the device and environment.
For overpowered boxes, you can first install the Armbian system, then install the KVM virtual machine to achieve multi-system use. The compilation of the OpenWrt system can use the mk_qemu-aarch64_img.sh script developed by unifreq, and its installation and use instructions are detailed in the qemu-aarch64-readme.md document. The OpenWrt qemu firmware in Online Download Update
is supported by breakings.
The method of using the plugin in the KVM virtual machine is the same as the method of directly installing and using OpenWrt in the box.
Step 1: Compile the Rootfs file for OpenWrt: Use the OpenWrt source code and select Arm SystemReady (EFI) compliant
option in Target System
, select 64-bit (armv8) machines
option in Subtarget
, select Generic EFI Boot
option in Target Profile
, and add the required software packages to compile the rootfs.tar.gz
file for OpenWrt.
Step 2: Package the dedicated OpenWrt firmware for different devices: You can use the scripts from flippy or ophub to package the dedicated OpenWrt firmware for different devices. Please refer to the respective repositories for detailed usage instructions.
The luci-app-amlogic © OPHUB is licensed under GPL-2.0