View Chinese description | 查看中文说明
The method of using GitHub Actions to compile OpenWrt in the cloud, and many contents in this guide, come from many technological innovators and resource sharers such as P3TERX, Flippy, etc. Thanks to everyone's contributions, using OpenWrt in the box has become so simple.
Github Actions is a service launched by Microsoft. It provides a very well-configured virtual server environment for building, testing, packaging, and deploying projects. It can be used for free with no time limit for public repositories, and each compilation time can last up to 6 hours, which is enough for compiling OpenWrt (we generally can complete a compilation in about 3 hours). Sharing is just for the exchange of experiences, please understand the shortcomings, please do not initiate various bad attacks on the internet, and do not maliciously use GitHub Actions.
- OpenWrt Production and Usage Guide
- Table of Contents
- 1. Register Your Own Github Account
- 2. Set Privacy Variable GITHUB_TOKEN
- 3. Fork the repository and set Workflow permissions
- 4. Personalized OpenWrt Firmware Customization File Description
- 5. Firmware Compilation
- 6. Saving Firmware
- 7. Downloading Firmware
- 8. Install OpenWrt
- 9. Update OpenWrt system or kernel
- 10. Advanced Tutorial on Personalized Firmware Customization
- 10.1 Getting to Know the Complete .config File
- 10.2 Understanding Workflow Files
- 10.3 Customizing Banner Information
- 10.4 Customize feeds configuration file
- 10.5 Customize default software configuration information
- 10.6 Opkg package management
- 10.7 Manage packages using the Web interface
- 10.8 How to restore the original Android TV system
- 10.10 Setting up the Box to Boot from USB/TF/SD
- 10.11 Required OpenWrt Options
Register your own account to continue with firmware personalization operations. Click the Sign up button in the upper right corner of the github.com website and register your own account according to the prompts.
According to the GitHub Docs, GitHub automatically creates a unique GITHUB_TOKEN secret at the start of every workflow job for use within the workflow. The {{ secrets.GITHUB_TOKEN }} can be used for authentication within the workflow job.
Now you can Fork the repository. Open the repository https://github.com/ophub/amlogic-s9xxx-openwrt, click the Fork button in the upper right, and copy a copy of the repository code to your own account. Wait a few seconds, after the Fork is completed, visit amlogic-s9xxx-openwrt in your own repository under your own account. In the upper right corner Settings > Actions > General > Workflow permissions in the left navigation bar, select Read and write permissions and save. The illustration is as follows:
After the first 3 steps of preparation, start personalizing the firmware customization now. The 3 files under the config/lede-master directory are for customizing the OpenWrt firmware. In this chapter, we only make the simplest explanation, let you experience the joy of personalized customization as soon as you start, and I put more complex customization operations in the 10th section, which requires you to have a little foundation.
This file is the core file for customizing the OpenWrt software package, which contains all configuration information. Each line of code in the file represents a personalized configuration option. Although there are many projects, management is very simple. Let's start operating.
In # National language packs, luci-i18n-base: Taking France as an example, to enable French support, change
# CONFIG_PACKAGE_luci-i18n-base-fr is not setto
CONFIG_PACKAGE_luci-i18n-base-fr=yAll personalizations in the .config file can be operated in this way. For projects you don't need, fill in # at the beginning of the line and change =y at the end of the line to is not set. For the projects you need, remove the # at the beginning of the line and change is not set at the end of the line to =y.
In #LuCI-app:, the approach to enable and delete default software packages is the same as above. This time we delete the plugin luci-app-zerotier from the default software package list, just change
CONFIG_PACKAGE_luci-app-zerotier=yto
# CONFIG_PACKAGE_luci-app-zerotier is not setBy now, you should have a clear understanding of how to personalize configurations. Each line in the .config file represents a configuration item and can be enabled or deleted in this manner. The complete content of this file spans several thousand lines, what I have provided is a simplified version. How to obtain the full configuration file for more complex customization will be introduced in section 10.
The scripts diy-part1.sh and diy-part2.sh are executed before and after the update and installation of feeds respectively. When we introduce OpenWrt's source code library for personalized firmware compilation, sometimes we want to rewrite some parts of the source code, or add some third-party software packages, delete or replace some software packages in the source code library. For example, we may want to modify the default IP, hostname, theme, add/delete software packages, etc. These modification instructions can be written into these two scripts. Let's take a few examples using OpenWrt source code library provided by coolsnowwolf.
Our operations below are all based on this source code library: https://github.com/coolsnowwolf/lede
Step one, add the following code in diy-part2.sh:
git clone https://github.com/jerrykuku/luci-app-ttnode.git package/lean/luci-app-ttnodeStep two, add the activation code for this third-party software package to the .config file:
CONFIG_PACKAGE_luci-app-ttnode=yThis completes the integration of the third-party software package, expanding the software packages that the current source code library does not have.
Example 2, Replace an Existing Same-Named Software Package in the Current Source Code Library with a Third-Party Software Package
Step one, add the following code to diy-part2.sh: The first line of code removes the original software from the source code library, and the second line introduces a third-party software package with the same name.
rm -rf package/lean/luci-theme-argon
git clone https://github.com/jerrykuku/luci-theme-argon.git package/lean/luci-theme-argonStep two, add the third-party software package to the .config file:
CONFIG_PACKAGE_luci-theme-argon=yThis achieves the replacement of an existing same-named software package in the current source code library with a third-party software package.
We add support for aarch64 to luci-app-cpufreq so that it can be used in our firmware (some modifications should be handled with caution, you must know what you are doing).
Source file address: luci-app-cpufreq/Makefile. Modify the code to add support for aarch64:
sed -i 's/LUCI_DEPENDS.*/LUCI_DEPENDS:=\@\(arm\|\|aarch64\)/g' package/lean/luci-app-cpufreq/MakefileThis achieves the modification of the source code. Through the diy-part1.sh and diy-part2.sh scripts, we have added some operation commands to make the compiled firmware better fit our personalized needs.
The OpenWrt official website provides a ready-made openwrt-imagebuilder-*-armvirt-64.Linux-x86_64.tar.xz file (download address: https://downloads.openwrt.org/releases). The official Image Builder can be used to add packages and plugins to this file, and an openwrt-rootfs.tar.gz file can usually be made in just a few minutes. The manufacturing method can be found in the official documentation: Use Image Builder
This repository provides a one-click manufacturing service. You just need to pass the branch parameters into the imagebuilder script to complete the production.
-
Localized production command: In the
~/amlogic-s9xxx-openwrtroot directory, run the commandsudo ./config/imagebuilder/imagebuilder.sh openwrt:21.02.3to generate. The parameter21.02.3is the current availablereleasesversion number for download. The generated file is located in theopenwrt/bin/targets/armvirt/64directory. -
Produce in
Actionson github.com: Build OpenWrt with Image Builder
The configuration information of the default system is recorded in the /etc/model_database.conf file, where the BOARD name is required to be unique.
Among them, the parts of the box system that are packaged by default when the value of BUILD is yes can be used directly. Those that are not packaged by default when the value is no need to download the packaged system of the same FAMILY (recommended to download the system of kernel 5.15/5.4), and after writing to the USB, the boot partition in the USB can be opened on the computer, and the FDT dtb name in the /boot/uEnv.txt file can be modified to adapt to other boxes in the list.
When compiling locally, specify through the -b parameter, and when compiling in Actions on github.com, specify through the openwrt_board parameter. Using -b all means to package all devices whose BUILD is yes. When packaging with a specified BOARD parameter, it can be packaged regardless of whether BUILD is yes or no, for example: -b r68s_s905x3-tx3_s905l3a-cm311
In the navigation bar of your own repository, click the Actions button, and then click Build OpenWrt > Run workflow > Run workflow in order, start the compilation, wait for about 3 hours, and the entire process is completed after all processes are ended. The illustration is as follows:
In the .github/workflows/build-openwrt.yml file, use Cron to set up scheduled compilation. The 5 different positions represent minute (0 - 59) / hour (0 - 23) / date (1 - 31) / month (1 - 12) / day of the week (0 - 6) (Sunday - Saturday) respectively. By modifying the values at different positions to set the time. The system defaults to UTC standard time, please convert according to the different time zones of your country.
schedule:
- cron: '0 17 * * *'The default compile space for Github Actions is 84G, with about 50G available after considering the system and necessary software packages. When compiling all firmware, you may encounter an issue with insufficient space, which can be addressed by using logical volumes to expand the compile space to approximately 110G. Refer to the method in the .github/workflows/build-openwrt.yml file, and use the commands below to create a logical volume. Then, use the path of the logical volume during the compilation process.
- name: Create simulated physical disk
run: |
mnt_size=$(expr $(df -h /mnt | tail -1 | awk '{print $4}' | sed 's/[[:alpha:]]//g' | sed 's/\..*//') - 1)
root_size=$(expr $(df -h / | tail -1 | awk '{print $4}' | sed 's/[[:alpha:]]//g' | sed 's/\..*//') - 4)
sudo truncate -s "${mnt_size}"G /mnt/mnt.img
sudo truncate -s "${root_size}"G /root.img
sudo losetup /dev/loop6 /mnt/mnt.img
sudo losetup /dev/loop7 /root.img
sudo pvcreate /dev/loop6
sudo pvcreate /dev/loop7
sudo vgcreate github /dev/loop6 /dev/loop7
sudo lvcreate -n runner -l 100%FREE github
sudo mkfs.xfs /dev/github/runner
sudo mkdir -p /builder
sudo mount /dev/github/runner /builder
sudo chown -R runner.runner /builder
df -ThThe settings for firmware saving are also controlled in the .github/workflows/build-openwrt.yml file. We automatically upload the compiled firmware to the Actions and Releases provided by the official github through scripts, or to a third party (such as WeTransfer).
Currently, the longest storage period in Actions on github is 90 days, Releases is permanent, and third parties such as WeTransfer are 7 days. First of all, we thank these service providers for their free support, but please also save everyone's use. We advocate reasonable use of free services.
- name: Upload artifact to Actions
uses: kittaakos/upload-artifact-as-is@master
if: ${{ steps.build.outputs.status }} == 'success' && env.UPLOAD_FIRMWARE == 'true' && !cancelled()
with:
path: ${{ env.FILEPATH }}/- name: Upload OpenWrt Firmware to Release
uses: ncipollo/release-action@main
if: ${{ env.PACKAGED_STATUS }} == 'success' && !cancelled()
with:
tag: openwrt_amlogic_s9xxx_lede_${{ env.PACKAGED_OUTPUTDATE }}
artifacts: ${{ env.PACKAGED_OUTPUTPATH }}/*
allowUpdates: true
token: ${{ secrets.GITHUB_TOKEN }}
body: |
This is OpenWrt firmware for Amlogic s9xxx tv box
* Firmware information
Default IP: 192.168.1.1
Default username: root
Default password: password
Default WIFI name: OpenWrt
Default WIFI password: none
Install to EMMC: Login to OpenWrt → System → Amlogic Service → Install OpenWrt- name: Upload OpenWrt Firmware to WeTransfer
if: ${{ steps.build.outputs.status }} == 'success' && env.UPLOAD_WETRANSFER == 'true' && !cancelled()
run: |
curl -fsSL git.io/file-transfer | sh
./transfer wet -s -p 16 --no-progress ${{ env.FILEPATH }}/{openwrt_s9xxx_*,openwrt_n1_*} 2>&1 | tee wetransfer.log
echo "WET_URL=$(cat wetransfer.log | grep https | cut -f3 -d" ")" >> $GITHUB_ENVDownload the OpenWrt firmware that we have already compiled and uploaded to the relevant storage locations.
Click the Actions button in the repository navigation bar. In the All workflows list, click on the completed firmware list. In the firmware list, choose the firmware that corresponds to your box model. The illustration is as follows:
Enter from the Release section in the lower right corner of the repository homepage, select the firmware that corresponds to your box model. The illustration is as follows:
In the .github/workflows/build-openwrt.yml file, we have the option to upload to a third party turned off by default. If you need it, change false to true, and it will upload to the third party the next time the compilation is complete. The URL of the third party can be seen in the log of the firmware compilation process, and it can also be output to the compilation information.
UPLOAD_COWTRANSFER: false
UPLOAD_WETRANSFER: falseThe support for uploading to third parties comes from https://github.com/Mikubill/transfer. If you need, you can add more third-party support according to his instructions (control your creativity, don't waste too many free resources). The illustration is as follows:
- Get the source code of the plugin
luci-app-amlogic:
rm -rf package/luci-app-amlogic
git clone https://github.com/ophub/luci-app-amlogic.git package/luci-app-amlogic- After executing
menuconfig, you can select the pluginLuCI ---> 3. Applications ---> <*> luci-app-amlogic
For more instructions on the plugin, see: https://github.com/ophub/luci-app-amlogic
-
For the
Rockchipplatform, please refer to the introduction in the Chapter 8 of the instruction manual, which is the same as the Armbian installation method. -
For the
AmlogicandAllwinnerplatforms, use tools like Rufus or balenaEtcher to write the firmware into the USB, then insert the USB with the firmware into the box. Access the default IP of OpenWrt from the browser: 192.168.1.1 →Log in to OpenWrt using the default account→System Menu→Amlogic Treasure Box→Install OpenWrt.
Access the OpenWrt system from the browser, in the System menu, choose Amlogic Treasure Box, choose Upgrade OpenWrt Firmware or Change OpenWrt Kernel feature to upgrade. (You can upgrade from a higher version like 5.15.50 to a lower version like 5.10.125, or you can upgrade from a lower version like 5.10.125 to a higher version like 5.15.50. The level of the kernel version number does not affect the upgrade, you can freely upgrade/downgrade).
[SOS]: In cases where a kernel update is incomplete due to special reasons, causing the system to fail to boot from eMMC/NVMe/sdX, you can boot an OpenWrt system with any kernel version from USB or other disks. To perform kernel rescue, go to System Menu > Amlogic Service > Online Download Update > Rescue Kernel to restore the normal use of the original system. You can also use the command openwer-kernel -s in the TTYD terminal for kernel rescue. When no disk parameter is specified, it defaults to restoring the kernel from a USB device to eMMC/NVMe/sdX. If the device has multiple disks, you can specify the exact disk name that needs to be restored. An example is as follows:
# To recover the kernel in eMMC
openwer-kernel -s mmcblk1
# To recover the kernel in NVMe
openwer-kernel -s nvme0n1
# To recover the kernel in a removable storage device
openwer-kernel -s sda
# Disk names can be abbreviated as mmcblk0/mmcblk1/nvme0n1/nvme1n1/sda/sdb/sdc, etc., or use the full name, such as /dev/sda
openwer-kernel -s /dev/sda
# When the device has only one built-in storage among eMMC/NVMe/sdX, the disk name parameter can be omitted
openwer-kernel -sIf you have followed the tutorial to this step, I believe you already know how to play happily. But if you continue to delve into it, you will start an extraordinary journey of exploration. You will encounter many problems, which requires you to be prepared to explore constantly, be good at using search engines to solve problems, and spend some time learning in some OpenWrt communities.
Use OpenWrt's official source code repository, or other branch source code repositories, to conduct a local compilation once, such as choosing the source code repository at https://github.com/coolsnowwolf/lede. Following its compilation instructions, install the Ubuntu system locally, deploy the environment, and complete a local compilation. In the local compilation configuration interface, you can also see a lot of rich descriptions, which will strengthen your understanding of the OpenWrt compilation process.
After you complete the personalized configuration of OpenWrt locally, save and exit the configuration interface. You can find the .config file in the root directory of the local OpenWrt source code repository (enter the ls -a command in the root directory of the code repository to view all hidden files). You can upload this file directly to your repository on github.com and replace the file at config/lede-master/config.
GitHub's official detailed instructions on how to use GitHub Actions are available. You can start getting to know it here: GitHub Actions Quick Start
Let's take a simple look at the current compilation process control file being used in the repository as an example: build-openwrt.yml
#On line 63: This is where the OpenWrt compile source code address is specified
REPO_URL: https://github.com/coolsnowwolf/lede
#On line 64: This is where the branch name is specified
REPO_BRANCH: masterYou can modify it to the address of other source code repositories, such as using the official source code repository and its openwrt-21.02 branch:
REPO_URL: https://github.com/openwrt/openwrt
REPO_BRANCH: openwrt-21.02Around line 139, look for the compile step titled Build OpenWrt firmware, and its code block should look like this:
- name: Build OpenWrt firmware
if: ${{ steps.compile.outputs.status }} == 'success' && !cancelled()
uses: ophub/amlogic-s9xxx-openwrt@main
with:
openwrt_path: openwrt/bin/targets/*/*/*rootfs.tar.gz
openwrt_board: ${{ inputs.openwrt_board }}
openwrt_kernel: ${{ inputs.openwrt_kernel }}
auto_kernel: ${{ inputs.auto_kernel }}
openwrt_size: ${{ inputs.openwrt_size }}Refer to the parameter instructions related to the packaging command. The above setting options can be set by writing in fixed values, or they can be selected through the Actions panel:
The default /etc/banner information is as follows, you can use a banner generator to customize your own personalized banner information (the style below is slant), just overwrite the file with the same name.
____ _ __ __ ____
/ __ \____ ___ ____| | / /____/ /_ / __ )____ _ __
/ / / / __ \/ _ \/ __ \ | /| / / ___/ __/_____/ __ / __ \| |/_/
/ /_/ / /_/ / __/ / / / |/ |/ / / / /_/_____/ /_/ / /_/ /> <
\____/ .___/\___/_/ /_/|__/|__/_/ \__/ /_____/\____/_/|_|
/_/ H E L L O - W O R L D W I R E L E S S - F R E E D O M
───────────────────────────────────────────────────────────────────────When you look at the feeds.conf.default file in the source code repository, have you noticed that it introduces many package source code repositories? Yes, we can find the source code repository provided by the official openwrt on GitHub, and many people share the branches and packages of openwrt. If you are familiar with them, you can add from here. For example, the feeds.conf.default in the coolsnowwolf source code repository.
When we are using openwrt, we have configured many pieces of software. Most of the configuration information of these software is saved in the /etc/config/ and other related directories of your openwrt. Copy these configuration information storage files to the files folder in the root directory of the repository on GitHub. Please keep the directory structure and file names the same. During the openwrt compilation, these configuration information storage files will be compiled into your firmware. The specific method is in the .github/workflows/build-openwrt.yml file. Let's take a look at this piece of code together:
- name: Load custom configuration
run: |
[[ -d "files" ]] && mv -f files openwrt/files
[[ -e "${CONFIG_FILE}" ]] && cp -f ${CONFIG_FILE} openwrt/.config
chmod +x ${DIY_P2_SH}
cd openwrt
${GITHUB_WORKSPACE}/${DIY_P2_SH}Please do not copy those configuration information files that involve privacy. If your repository is public, the files you put in the files directory are also public. Do not expose secrets. Some password information can be encrypted using private key settings and other methods that you just learned in the GitHub Actions Quick Start Guide. You must understand what you are doing.
Like most Linux distributions (or mobile device operating systems, such as Android or iOS), the functionality of the system can be upgraded by downloading and installing packages from package repositories (local or Internet). The opkg utility is a lightweight package manager used for this job. It is designed to add software to the firmware of embedded devices. Opkg is a complete package manager for the root file system, including kernel modules and drivers. The opkg package manager tries to solve the dependencies of packages in the repository. If it fails, it will report an error and abort the installation of the package. Third-party packages may lack dependencies, which can be obtained from the source of the package. To ignore dependency errors, pass the --force-depends argument.
-
If you are using a snapshot/trunk/latest version, installing a package may fail if the kernel version used by the package in the repository is newer than the kernel version you own. In this case, you will receive an error message like
Cannot satisfy the following dependencies.... For this usage of OpenWrt firmware, it is strongly recommended that you directly integrate the packages you need during the OpenWrt firmware compilation. -
Non-official openwrt.org plugins, such as
luci-app-uugamebooster,luci-app-xlnetacc, etc., need to be directly integrated during firmware compilation. These packages cannot be installed directly from the mirror server using opkg, but you can manually upload these packages to openwrt and use opkg to install them. -
On the trunk/snapshot, the kernel and kmod packages are marked as reserved, and the
opkg upgradecommand will not attempt to update them.
Common commands:
opkg update #Update the list of available packages
opkg upgrade <pkgs> #Upgrade packages
opkg install <pkgs> #Install packages
opkg install --force-reinstall <pkgs> #Force reinstallation of packages
opkg configure <pkgs> #Configure unpacked packages
opkg remove <pkgs | regexp> #Remove packages
opkg list #List available packages
opkg list-installed #List installed packages
opkg list-upgradable #List installed and upgradable packages
opkg list | grep <pkgs> #Search for packages matching keywordsFor more help, please check opkg
After installing the OpenWrt firmware on the device, other packages can be installed through WebUI.
- Login to OpenWrt →
System→Software packages - Click the
Refresh listbutton to update - Fill in the
Filterfield, and then click theFind Packagebutton to search for specific packages - Switch to the
Available packagestab to display the packages that can be installed - Switch to the
Installed packagestab to display and delete installed packages
If you want to use LuCI to configure services, please search and install luci-app-* packages.
For more help, please check packages
The Android TV system on the device is usually backed up and restored using openwrt-ddbr.
In addition, the Android system can also be flashed into eMMC using the method of flashing via a cable. The download image of the Android system can be found in Tools.
Before installing the OpenWrt system on a brand-new box, it is suggested that you backup the original Android TV system that the box comes with, for recovery purposes when needed. Boot the OpenWrt system from TF/SD/USB, type in the openwrt-ddbr command, and then input b following the prompts to back up the system. The backup file is stored in the path /ddbr/BACKUP-arm-64-emmc.img.gz, please download and save it. When you need to restore the Android TV system, upload the previously backed-up file to the same path on the TF/SD/USB device, input the openwrt-ddbr command, and then input r according to the prompts to restore the system.
-
Generally, if you can boot from USB by plugging in the power again, all you need to do is reinstall, try a few more times.
-
If the box does not boot from the USB and the screen is black after being connected to a monitor, it's necessary to short-circuit the box for initialization. First, restore the box to the original Android system, then reflash the OpenWrt system. Firstly, download the amlogic_usb_burning_tool system recovery tool and install it. Prepare a USB A-A data cable and a paper clip.
-
For example, for the x96max+ model, confirm the location of the short-circuit point on the box's motherboard, download the Android TV firmware package for the box. The Android TV system firmware and corresponding short-circuit point diagrams for other common devices can also be downloaded and viewed here.
Operation method:
1. Open the flashing software USB Burning Tool:
[ File → Import firmware package ]: X96Max_Plus2_20191213-1457_ATV9_davietPDA_v1.5.img
[ Select ]: Erase flash
[ Select ]: Erase bootloader
Click the [ Start ] button
2. Use the [ paperclip ] to [ short-circuit the two points on the box's motherboard ],
and simultaneously connect the [ box ] and [ computer ] with the [ USB A-A data cable ].
3. When you see the [ progress bar start moving ], remove the paperclip, no longer short-circuit.
4. When you see [ progress bar at 100% ], the flashing is complete, and the box has been restored to the Android TV system.
Click the [ Stop ] button, unplug the [ USB A-A data cable ] between the [ box ] and [ computer ].
5. If any step above fails, try again until successful.
If the progress bar does not move, you can try plugging in the power. Under normal circumstances, the power provided by the USB A-A alone is sufficient for flashing.Once the factory reset is complete, the box has been restored to the Android TV system, the operation of installing the OpenWrt system is the same as the first time you installed the system. Just do it again.
- A very small number of devices may not be able to boot after choosing to write the mainline
u-boot. The prompt seen on the monitor ends with a=>symbol. At this point, you need to solder a 5-10 K pull-up or pull-down resistor on the TTL to solve the problem of the box being easily interfered by surrounding electromagnetic signals and failing to boot. After soldering the resistor, it can boot from the EMMC.
If you chose to install the mainline u-boot and cannot boot, please connect your box to the screen and check if the prompt is as follows:
Net: eth0: ethernet0ff3f0000
Hit any key to stop autoboot: 0
=>If your phenomenon is as shown above, then you need to solder a resistor on the TTL: X96 Max Plus's V4.0 motherboard diagram
####################################################### ########################################################
# # # #
# Pull-Up Resistor: Solder between TTL RX and GND # # Pull-Down Resistor: Solder between TTL 3.3V and RX #
# # # #
# 3.3V RX TX GND # OR # 3.3V RX TX GND #
# ┖————█████████————┚ # # ┖————█████████————┚ #
# (5~10kΩ) # # (5~10kΩ) #
# # # #
####################################################### ########################################################Based on the situation of your own device, there are two methods to use: initial installation and reinstallation of the OpenWrt system.
- Insert the USB/TF/SD with the flashed firmware into the box.
- Enable developer mode: Settings → About Device → Version number (e.g., X96max plus...), quickly click the left mouse button 5 times on the version number, until the system shows a prompt saying
Developer mode is enabled. - Enable USB debugging mode: System → Advanced options → Developer options (set
Enable USB debuggingto enabled). EnableADBdebugging. - Install the ADB tool: Download adb and unzip it, copy the three files
adb.exe,AdbWinApi.dll,AdbWinUsbApi.dllto both thesystem32andsyswow64folders in thec://windows/directory, then open thecmdcommand panel, use theadb --versioncommand, if it shows something, it means you can use it now. - Enter
cmdcommand mode. Type theadb connect 192.168.1.137command (modify the IP according to your box, you can check it in the router device that the box is connected to), if the connection is successful, it will displayconnected to 192.168.1.137:5555. - Type the
adb shell reboot updatecommand, the box will restart and boot from the USB/TF/SD you inserted, access the firmware IP address from the browser, or SSH access to enter the firmware. - Login to the OpenWrt system: Directly connect your box to your computer → Turn off the WIFI option of the computer, only use the wired network card → Set the network of the wired network card to the same segment as OpenWrt, if the default IP of OpenWrt is:
192.168.1.1, you can set the computer's IP to192.168.1.2, the subnet mask is set to255.255.255.0, besides these 2 options, no other options need to be set. Then you can enter OpenWrt from the browser. The default IP:192.168.1.1, default account:root, default password:password.
- In normal situations, you can directly insert the USB flash drive with OpenWrt installed and boot from it. USB booting takes priority over eMMC.
- In some cases, the device may not boot from the USB flash drive. In such cases, you can rename the
boot.scrfile in the/bootdirectory of the OpenWrt system on the eMMC. For example, you can rename it toboot.scr.bak. After that, you can insert the USB flash drive and boot from it. This way, you will be able to boot from the USB flash drive.
This list is organized based on the development guide from unifreq. To ensure that installation/update scripts can run normally in OpenWrt, when using make menuconfig for configuration, the following required options need to be added:
Target System -> Arm SystemReady (EFI) compliant
Subtarget -> 64-bit (armv8) machines
Target Profile -> Generic EFI Boot
Target Images -> tar.gz
OR
Target System -> QEMU ARM Virtual Machine
Subtarget -> QEMU ARMv8 Virtual Machine (cortex-a53)
Target Profile -> Default
Target Images -> tar.gz
Kernel modules -> Wireless Drivers -> kmod-brcmfmac(SDIO)
-> kmod-brcmutil
-> kmod-cfg80211
-> kmod-mac80211
Languages -> Perl
-> perl-http-date
-> perlbase-file
-> perlbase-getopt
-> perlbase-time
-> perlbase-unicode
-> perlbase-utf8
-> Python
-> Python3-ctypes
-> Python3-logging
-> Python3-yaml
Network -> File Transfer -> curl、wget-ssl
-> Version Control Systems -> git
-> WirelessAPD -> hostapd-common
-> wpa-cli
-> wpad-basic
-> iw
Utilities -> Compression -> bsdtar、pigz
-> Disc -> blkid、fdisk、lsblk、parted
-> Editors -> nano、vim
-> Filesystem -> attr、btrfs-progs(Build with zstd support)、chattr、dosfstools、
e2fsprogs、f2fs-tools、f2fsck、lsattr、mkf2fs、xfs-fsck、xfs-mkfs
-> Shells -> bash
-> Time Zone info -> zoneinfo-america、zoneinfo-asia、zoneinfo-core、zoneinfo-europe (other)
-> acpid、coremark、coreutils(-> coreutils-base64、coreutils-dd、coreutils-df、coreutils-nohup、
coreutils-tail、coreutils-timeout、coreutils-touch、coreutils-tr、coreutils-truncate)、
gawk、getopt、jq、lm-sensors、losetup、pv、tar、uuidgen