Rebuild Armbian and Kernel
ActionsTags
(1)View Chinese description |查看中文说明
Armbian is a lightweight Linux system specially built for ARM chips based on Debian/Ubuntu. The Armbian system is lean, clean, and 100% compatible with and inherits the features and rich software ecosystem of the Debian/Ubuntu system. It can run securely and stably in TF/SD/USB and the device's eMMC. This project preserves the integrity of the official Armbian system and further expands its usage on devices such as TV boxes that are not officially supported. It adds some convenient operation commands. Now, you can replace the Android TV system on your TV box with the Armbian system, turning it into a powerful server.
This project relies on manycontributors to build the Armbian system forAmlogic,Rockchip, andAllwinner boxes, supports writing to eMMC for use, supports updating the kernel and other features. Detailed usage can be found in theArmbian User Documentation. The latest Armbian system can be downloaded fromReleases. Welcome toFork and personalize. If it's useful to you, you can clickStar in the upper right corner of the repository to show support.
Tip
At present, thes905 box can only be used inTF/SD/USB. Other models of boxes support writing toEMMC for use. For more information, please refer to theSupported Device List Description. You can refer to the method in Section 12.15 of the instruction document toadd new supported devices. Please read theArmbian User Documentation before use. It provides solutions to common issues.
Choose the Armbian system that corresponds to your box model, and refer to the corresponding instructions for different devices.
For
Rockchipplatform, please refer to theChapter 8 in the instruction document.For
AmlogicandAllwinnerplatforms, use tools such asRufus orbalenaEtcher to write the system to a USB stick, then insert the USB stick with the written system into the box. Log in to the Armbian system (default user: root, default password: 1234) → Enter the command:
armbian-install
| Optional | Default | Options | Description |
|---|---|---|---|
| -m | no | yes/no | Use mainline u-boot |
| -a | yes | yes/no | Useampart partition adjustment tool |
| -l | no | yes/no | Show a list of all devices |
Example:armbian-install -m yes -a no
Log in to the Armbian system → Enter the command:
# Run as root user (sudo -i)# If no parameter is specified, it will be updated to the latest version.armbian-update
| Optional | Default | Options | Description |
|---|---|---|---|
| -r | ophub/kernel | <owner>/<repo> | Set the repository to download the kernel from github.com |
| -u | Automation | stable/flippy/dev/beta/rk3588/rk35xx/h6 | Set thetags suffix of the kernel in use |
| -k | Latest version | Kernel version | Set thekernel version |
| -b | yes | yes/no | Automatically back up the current system's kernel when updating the kernel |
| -m | no | yes/no | Use mainline u-boot |
| -s | None | None/DiskName | [SOS] Restore the system kernel in eMMC/NVMe/sdX and other disks |
| -h | None | None | View help |
Example:armbian-update -k 5.15.50 -u dev
When specifying the kernel version number through the-k parameter, you can accurately specify a specific version number, for example:armbian-update -k 5.15.50, or you can specify the kernel series vaguely, for example:armbian-update -k 5.15. When vaguely specified, the latest version of the specified series will be automatically used.
When updating the kernel, the currently used kernel will be automatically backed up and stored in the/ddbr/backup directory. The backup keeps the three most recent versions of the kernel. If the newly installed kernel is unstable, you can easily restore the backup kernel at any time. If the kernel update fails and the system cannot boot, you can restore the system kernel usingarmbian-update -s. For more details, see theHelp Document.
Log in to the Armbian system → Enter the command:
armbian-apt
Choosing the appropriate software source for your country or region can improve software download speeds. For more details, see theHelp Document.
Log in to the Armbian system → Enter the command:
armbian-software
The commandarmbian-software -u can update the local software center list. Based on the demand feedback from users inIssue, we gradually integrate commonly usedsoftware to achieve one-click installation/update/uninstallation and other shortcut operations. This includesdocker images,desktop software,application services, etc. For more details, see theinstructions.
Log in to the Armbian system → Enter the command:
armbian-config
If you feel that the current box's memory is insufficient when using applications that consume a lot of memory, such asdocker, you can create aswap virtual memory partition, virtually using a certain capacity of disk space as memory. The unit of the input parameter of the following command isGB, the default is1.
Log in to the Armbian system → Enter the command:
armbian-swap 1
Log in to the Armbian system → Enter the command:
armbian-openvfd
Debug according to theLED Screen Display Control Instructions.
Supports backing up/restoring theEMMC partition of the box inTF/SD/USB. Before installing the Armbian system in a brand new box, it is recommended that you back up the Android TV system that comes with the current box so that it can be used in the future to restore the TV system and other situations.
Please boot the Armbian system fromTF/SD/USB → Enter the command:
armbian-ddbr
Enterb according to the prompt to back up the system, and enterr to restore the system.
Important
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 inTools.
For the usage of compiling the kernel in Armbian, please refer to theCompile Kernel instruction document. Log in to the Armbian system → Enter the command:
armbian-kernel -uarmbian-kernel -k 6.6.12
To update all service scripts in the local system to the latest version, you can log in to the Armbian system → Enter the command:
armbian-sync
In the use of Armbian, some common problems that may be encountered can be found indocuments
Clone the repository to local
git clone --depth 1 https://github.com/ophub/amlogic-s9xxx-armbian.gitInstall the necessary software packages (scripts have only been tested under x86_64 Ubuntu-20.04/22.04)
sudo apt-get update -ysudo apt-get full-upgrade -y# For Ubuntu-22.04sudo apt-get install -y$(cat compile-kernel/tools/script/ubuntu2204-build-armbian-depends)
Enter the
~/amlogic-s9xxx-armbianroot directory, create abuild/output/imagesfolder in the root directory, and upload the Armbian image file (such asArmbian_21.11.0-trunk_Odroidn2_current_5.15.50.img) to~/amlogic-s9xxx-armbian/build/output/imagesdirectory. Please keep the release version number (such as21.11.0) and the kernel version number (such as5.15.50) in the original Armbian image file name. It will be used as the name of the Armbian system after restructuring.Enter the
~/amlogic-s9xxx-armbianroot directory, and then run thesudo ./rebuild -b s905x3 -k 6.6.12command to generate the Armbian image file for the specified board. The generated file is saved in thebuild/output/imagesdirectory.
| Parameter | Meaning | Description |
|---|---|---|
| -b | Board | Specifies the device code(s) to build. For example,-b s905x3 builds the device with code s905x3. Multiple device codes can be connected using underscores, such as-b s905x3_s905d. Special values:all builds all devices;top50 builds the top 50 devices in the device list;rest50 builds from the 51st device to the end. The full list of device codes can be found in theBOARD entries ofmodel_database.conf. Default:all |
| -r | KernelRepo | Specify the<owner>/<repo> of the github.com kernel repository. Default value:ophub/kernel |
| -u | kernelUsage | Set thetags suffix of the kernel used, such asstable,flippy,dev,beta. Default value:stable |
| -k | Kernel | Specifykernel name, such as-k 6.6.12. Connect multiple kernels with_, such as-k 6.6.12_5.15.50. The kernel version freely specified by the-k parameter is only valid for kernels usingstable/flippy/dev/beta. Other kernel series such asrk3588 /rk35xx /h6 can only use specific kernels. |
| -a | AutoKernel | Set whether to automatically adopt the latest version of the same series of kernels. When it istrue, it will automatically look for whether there is a newer version of the same series in the kernel library in the kernel specified in-k, such as 6.6.12. If there is a latest version after 6.6.12, it will be automatically changed to the latest version. When set tofalse, it will compile the specified version of the kernel. Default value:true |
| -t | RootfsType | Set the file system type of the system's ROOTFS partition, the options areext4 orbtrfs type. For example:-t btrfs. Default value:ext4 |
| -s | Size | Set the size of the system's image partitions. When setting only the ROOTFS partition size, you can specify a single value, for example:-s 2560. When setting both BOOTFS and ROOTFS partition sizes, use / to connect the two values, for example:-s 512/2560. The default value is512/2560 |
| -n | BuilderName | Set the Armbian system builder signature. Do not include spaces when setting the signature. Default value:None |
sudo ./rebuild: Use the default configuration to package all models of TV boxes.sudo ./rebuild -b s905x3 -k 6.6.12: Recommended. Use the default configuration to package related kernels.sudo ./rebuild -b s905x3 -k 6.1.y: Package the relevant kernels using the default configuration; the kernel utilizes the latest version of the 6.1.y series.sudo ./rebuild -b s905x3_s905d -k 6.6.12_5.15.50: Use the default configuration, package multiple kernels at the same time. Use_to connect multiple kernel parameters.sudo ./rebuild -b s905x3 -k 6.6.12 -s 2560: Use the default configuration, specify a kernel, a model for packaging, the system size is set to 2560MiB.sudo ./rebuild -b s905x3_s905dUse the default configuration, package all kernels for multiple models of TV boxes, use_to connect multiple models.sudo ./rebuild -k 6.6.12_5.15.50: Use the default configuration, specify multiple kernels, and package all models of TV boxes, the kernel package uses_for connection.sudo ./rebuild -k 6.6.12_5.15.50 -a true: Use the default configuration, specify multiple kernels, and package all models of TV boxes, the kernel package uses_for connection. Automatically upgrade to the latest kernel of the same series.sudo ./rebuild -t btrfs -s 2560 -k 6.6.12: Use the default configuration, set the file system to btrfs format, the partition size is 2560MiB, and specify the kernel as 6.6.12, package for all models of TV boxes.
The configuration of the Workflows file can be found in the.github/workflows/ files.
Fresh Build: On theActions page, select
Build Armbian server imageto start the build using thebuild-armbian-server-image.yml workflow. You can choose from the Ubuntu series such asjammy, or the Debian series such asbullseye, etc. Click theRun workflowbutton to begin the build.Rebuild: If there are already compiled
Armbian_.*-trunk_.*.img.gzfiles inReleases, and you just want to make another box of different boards, you can skip compiling the Armbian source files and directly usebuild-armbian-using-releases-files.yml for secondary build.Use other Armbian systems, such as theodroidn2 system provided by the Armbian official system download websitearmbian.tnahosting.net, and only introduce the script of this repository in the process control filebuild-armbian-using-official-image.yml to restructure Armbian. The code is as follows:
-name:Build Armbianuses:ophub/amlogic-s9xxx-armbian@mainwith:build_target:armbianarmbian_path:build/output/images/*.imgarmbian_board:s905d_s905x3_s922x_s905xarmbian_kernel:6.1.y_5.15.y
The related parameters correspond to thelocal packaging command, please refer to the above description.
| Parameter | Default | Description |
|---|---|---|
| armbian_path | None | Set the path of the original Armbian file, support the file path in the current workflow such asbuild/output/images/*.img, and also support the network download address such as:https://dl.armbian.com/*/Armbian_*.img.xz |
| armbian_board | all | Set theboard of the package box, refer to-b |
| kernel_repo | ophub/kernel | Specify<owner>/<repo> of the github.com kernel repository, refer to-r |
| kernel_usage | stable | Set thetags suffix of the used kernel. Refer to-u |
| armbian_kernel | 6.1.y_5.15.y | Set theversion of the kernel, refer to-k |
| auto_kernel | true | Set whether to automatically adopt the latest version of the same series kernel, refer to-a |
| armbian_fstype | ext4 | Set the file system type of the system's ROOTFS partition, refer to-t |
| armbian_size | 512/2560 | Set the size of the system BOOTFS and ROOTFS partitions, function reference-s |
| builder_name | None | Set the Armbian system builder signature, refer to-n |
To upload toReleases, you need to setWorkflow read/write permissions for repository. For details, see theusage instructions.
| Parameter | Default | Description |
|---|---|---|
| ${{ env.PACKAGED_OUTPUTPATH }} | out | Armbian system files output path |
| ${{ env.PACKAGED_OUTPUTDATE }} | 04.13.1058 | Packaging date (month.day.hourminute) |
| ${{ env.PACKAGED_STATUS }} | success | Packaging status: success / failure |
The method for creating theDocker image of the Armbian system can refer to thearmbian_docker build script.
| System Name | Default Username | Default Password | SSH Port | IP Address |
|---|---|---|---|---|
| Armbian.OS | root | 1234 | 22 | Obtain IP from router |
| Armbian.Docker | root | 1234 | 22 | Use host machine’s IP |
For the method of compiling the kernel, refer tocompile-kernel
-name:Compile the kerneluses:ophub/amlogic-s9xxx-armbian@mainwith:build_target:kernelkernel_version:6.1.y_5.15.ykernel_auto:truekernel_sign:-yourname
First of all, thanks to150balbes for the outstanding contributions and the solid foundation laid for using Armbian in Amlogic TV boxes. TheArmbian system compiled here directly uses the latest source code from the official in real-time. The development ideas of the program come from tutorials from authors such asebkso. Thank you all for your dedication and sharing, allowing us to use the Armbian system in more boxes.
Theu-boot,kernel and other resources used in this system are mainly copied from theunifreq/openwrt_packit project, and some files are provided by users inPull andIssues of projects such asamlogic-s9xxx-openwrt,amlogic-s9xxx-armbian,luci-app-amlogic,u-boot andkernel. To thank these pioneers and sharers, from now on (this source code repository was created on2021-09-19), I have recorded it uniformly inCONTRIBUTORS.md. Thanks again to everyone for giving the box a new life and meaning.
- Theamlogic-s9xxx-openwrt project provides the
OpenWrtsystem used in the box, which is also applicable to devices that support Armbian. - unifreq has made
OpenWrtsystem for more boxes such as Amlogic, Rockchip, and Allwinner, which is a benchmark in the box circle and recommended to use. - Scirese tested the production, installation, and use of
Arch Linux ARM/Manjarosystem in Android TV boxes, for details refer to the relevant instructions in his repository. - 7Ji has published some articles on reverse engineering and development on the Amlogic platform in his blog, such as installing the ArchLinux ARM system in the way of ArchLinux, an introduction to the boot mechanism of the Amlogic platform, etc. In hisampart project, a partition tool is provided that can read and edit the Amlogic eMMC partition table and DTB internal partition, and can utilize 100% of eMMC space. Theamlogic-s9xxx-archlinuxarm project provides the production and use method of
Arch Linux ARMsystem. In theYAopenvfD project, another openvfd daemon is provided. - 13584452567 is the pioneer for the
Rockchipseries of devices in this repository, having expanded support for numerousRockchipdevices likeEAIDK-610,King3399,TN3399,Kylin3399,ZCube1-Max,tvi3315a,xiaobao and more, thanks to his sharing. Additionally, he remains the maintainer of specializedkernels forAllwinnerdevices likeTQC-A01. Having provided a wealth of tech support and solutions withinDiscussions andIssues sections, he's made significant contributions to the development of the box circle. - cooip-jm shares many Armbian, lxc, docker, AdGuard, etc. usage methods in hiswiki, recommended learning.
The amlogic-s9xxx-armbian © OPHUB is licensed underGPL-2.0
Rebuild Armbian and Kernel is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.
Tags
(1)Rebuild Armbian and Kernel is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.