Armbian for Amlogic S9xxx STB

View Chinese description | 查看中文说明

Compile the Armbian for Amlogic S9xxx STB. including install to EMMC and update related functions. Support Amlogic S9xxx STB are s922x, s905x3, s905x2, s912, s905d, s905x, s905w, etc. such as Belink GT-King, Belink GT-King Pro, UGOOS AM6 Plus, X96-Max+, HK1-Box, H96-Max-X3, Phicomm-N1, Octopus-Planet, Fiberhome HG680P, ZTE B860H, etc.

The latest version of the Armbian firmware can be downloaded in Releases. Welcome to Fork and personalize it. If it is useful to you, you can click on the Star in the upper right corner of the warehouse to show your support.

Armbian Firmware instructions

Model	STB	Optional kernel	Armbian Firmware
s922x	Belink, Belink-Pro, Ugoos-AM6-Plus, ODROID-N2	All	armbian_aml_s922x_buster_*.img
s905x3	X96-Max+, HK1-Box, H96-Max-X3, Ugoos-X3, X96-Air, A95XF3-Air	All	armbian_aml_s905x3_buster_*.img
s905x2	X96Max-4G, X96Max-2G	All	armbian_aml_s905x2_buster_*.img
s912	H96-Pro-Plus, T95Z-Plus, Octopus-Planet	All	armbian_aml_s912_buster_*.img
s905d	Phicomm-N1	All	armbian_aml_s905d_buster_*.img
s905x	HG680P, B860H	5.4.*	armbian_aml_s905x_buster_*.img
s905w	X96-Mini, TX3-Mini	5.4.*	armbian_aml_s905w_buster_*.img

Install to EMMC and update instructions

Choose the corresponding firmware according to your STB. Then write the IMG file to the USB hard disk through software such as Rufus or balenaEtcher. Insert the USB hard disk into the STB. Common for all Amlogic S9xxx STB.

• Install Armbian to EMMC

Login in to armbian (default user: root, default password: 1234) → input command:

armbian-install

• Update Armbian Kernel

Query the available kernel_version. Login in to armbian → input command:

# Run as root user (sudo -i), input command: armbian-update <kernel_version>
armbian-update 5.4.160

The kernel update script will be continuously updated during development. You can use this command to update the local script synchronously: wget -q -O /usr/sbin/armbian-update git.io/armbian-update . Or directly use the latest script on the server side to update the kernel: bash <(curl -fsSL git.io/armbian-update) 5.4.160

When the kernel is updated, By default, download from stable kernel version branch, if you download other version branch, please specify according to the branch folder name in the second parameter, such as armbian-update 5.7.19 beta . The mainline u-boot is automatically installed by default, which can better support the use of kernel series 5.10 and above. If you choose not to install, please specify in the third input parameter, such as armbian-update 5.4.160 stable no

The headers files in the kernel is installed in the /use/local/include directory. When compiling the application, add -I /usr/local/include to the CFLAG parameter of GCC to find the headers files.

• Install Docker Service

Login in to armbian → input command:

armbian-docker

• Modify Armbian Config

Login in to armbian → input command:

armbian-config

• Create swap for Armbian

If you feel that the memory of the current box is not enough when you are using applications with a large memory footprint such as docker, you can create a swap virtual memory partition, Change the disk space a certain capacity is virtualized into memory for use. The unit of the input parameter of the following command is GB, and the default is 1.

Login in to armbian → input command:

armbian-swap 1

• Use Armbian in TF/USB

To activate the remaining space of TF/USB, please login in to armbian → input command:

armbian-tf

Or manually allocate the remaining space

View Operation screenshot

# 1. Confirm the name of the TF/USB according to the size of the space. The TF is [ `mmcblk` ], USB is [ `sd` ]
Command: Enter [ fdisk -l | grep "sd" ]

# 2. Get the starting value of the remaining space, Copy and save, used below  (E.g: 5382144)
Command: Enter [ fdisk -l | grep "sd" | sed -n '$p' | awk '{print $3}' | xargs -i expr {} + 1 ]

# 3. Start allocating unused space (E.g: sda, mmcblk0 or mmcblk1)
Command: Enter [ fdisk /dev/sda ] Start allocating the remaining space
Command: Select [ n ] to create a partition
Command: Select [ p ] to specify the partition type as primary partition
Command: Set the partition number to [ 3 ]
Command: The start value of the partition, enter the value obtained in the second step, E.g: [ 5382144 ]
Command: End value, press [ Enter ] to use the default value
Command: If there is a hint: Do you want to remove the signature? [Y]es/[N]o: Enter [ Y ]
Command: Enter [ t ] to specify the partition type
Command: Enter Partition number [ 3 ]
Command: Enter Hex code (type L to list all codes): [ 83 ]
Command: Enter [ w ] to save
Command: Enter [ reboot ] to restart

# 4. After restarting, format the new partition
Command: Enter [ mkfs.ext4 -F -L SHARED /dev/sda3 ] to format the new partition

# 5. Set the mount directory for the new partition
Command: Enter [ mkdir -p /mnt/share ] to Create mount directory
Command: Enter [ mount -t ext4 /dev/sda3 /mnt/share ] to Mount the newly created partition to the directory

# 6. Add automatic mount at boot
Command: Enter [ vi /etc/fstab ]
# Press [ i ] to enter the input mode, copy the following values to the end of the file
/dev/sda3 /mnt/share ext4 defaults 0 0
# Press [ esc ] to exit, Input [ :wq! ] and [ Enter ] to Save, Finish.

Detailed build compile command

• sudo ./rebuild -d -b s905x3 -k 5.4.160: recommend. Use the default configuration, specify a kernel and a firmware for compilation.
• sudo ./rebuild -d -b s905x3_s905d -k 5.10.80_5.4.160: Use the default configuration, specify multiple cores, and multiple firmware for compilation. use _ to connect.
• sudo ./rebuild -d: Use the default configuration to pack all boxes.
• sudo ./rebuild -d -b s905x3 -k 5.4.160 -s 1024: Use the default configuration, specify a kernel, a firmware, and set the partition size for compilation.
• sudo ./rebuild -d -b s905x3 -v beta -k 5.7.19: Use the default configuration, specify the model, specify the version branch, and specify the kernel for packaging.
• sudo ./rebuild -d -b s905x3_s905d: Use the default configuration, specify multiple firmware, use _ to connect. compile all kernels.
• sudo ./rebuild -d -k 5.10.80_5.4.160: Use the default configuration. Specify multiple cores, use _ to connect.
• sudo ./rebuild -d -k 5.10.80_5.4.160 -a true: Use the default configuration. Specify multiple cores, use _ to connect. Auto update to the latest kernel of the same series.
• sudo ./rebuild -d -s 1024 -k 5.4.160: Use the default configuration and set the partition size to 1024m, and only compile the armbian firmware with the kernel version 5.4.160.

Parameter	Meaning	Description
-d	Defaults	Compile all cores and all firmware types.
-b	Build	Specify the Build firmware type. Write the build firmware name individually, such as -b s905x3 . Multiple firmware use _ connect such as -b s905x3_s905d . You can use these codes: s905x3, s905x2, s905x, s905w, s905d, s922x, s922x-n2, s912, s912-t95z . Note: s922x-n2 is s922x-odroid-n2, s912-t95z is s912-t95z-plus.
-v	Version	Specify the name of the kernel version branch, Such as -v stable. The specified name must be the same as the branch directory name. The stable branch version is used by default.
-k	Kernel	Specify the kernel name. Write the kernel name individually such as -k 5.4.160 . Multiple kernel use _ connection such as -k 5.10.80_5.4.160
-a	AutoKernel	Set whether to automatically adopt the latest version of the kernel of the same series. When it is true, it will automatically find in the kernel library whether there is an updated version of the kernel specified in -k such as 5.4.160 version. If there is the latest version of 5.4 same series, it will automatically Replace with the latest version. When set to false, the specified version of the kernel will be compiled. Default value: true
-s	Size	Specify the size of the root partition in MB. The default is 1024, and the specified size must be greater than 256. Such as -s 1024

💡Tips: The s905x and s905w boxs currently only support 5.4.* kernels, Cannot use kernel version 5.10 and above. Please add kernel substitution variables when compiling these two models of devices. Other devices can be freely selected.

• Use GitHub Action to build instructions

1. Workflows configuration in .yml files. Set the armbian SOC you want to build in Rebuild Armbian for amlogic s9xxx.

2. New compilation: Select Build the armbian firmware on the Action page. Click the Run workflow button.

3. Compile again: If there is an Armbian_.*-trunk_.*.img.gz file in Releases, you do not need to compile it completely, you can directly use this file to build armbian of different soc. Select Use Releases file to build armbian on the Action page. Click the Run workflow button.

• Local build instructions

1. Install the necessary packages (E.g Ubuntu 20.04 LTS user)

sudo apt-get update -y
sudo apt-get full-upgrade -y
sudo apt-get install -y $(curl -fsSL git.io/ubuntu-2004-server)

2. Clone the repository to the local. git clone --depth 1 https://github.com/ophub/amlogic-s9xxx-armbian.git
3. Create the build/output/images folder, and upload the Armbian image of the lepotato board ( Eg: Armbian_21.11.0-trunk_Lepotato_buster_current_5.10.80.img ) to this ~/amlogic-s9xxx-armbian/build/output/images directory.
4. Enter the ~/amlogic-s9xxx-armbian root directory. And run Eg: sudo ./rebuild s905x3 to build armbian for amlogic s9xxx. The generated Armbian image is in the build/output/images directory under the root directory.

Compile a custom kernel

For the compilation method of the custom kernel, see compile-kernel

Armbian contributor list

The armbian directly calls the official source code for compilation, When making dedicated Armbian systems for different boxes, the kernel, scripts, u-boot and other resources made by flippy for Amlogic s9xxx openwrt are used. The development idea of the program comes from the tutorials of authors such as ebkso. Thank you for your dedication and sharing, so that we can use the Armbian system in the Amlogic s9xxx box.

Because of these innovations and contributors, we can have the company of the box in the long river of years. We have grown up many years later, but this beautiful memory will always stay deep in the memory for a long time. From now on, record the achievements of these pioneers and leave them to the new friends who have joined the box circle.

License

LICENSE © OPHUB