Skip to content

This is the first 64-bit system in the world to support all Raspberry Pi 64-bit hardware!!! (Include: 4B,3B+,3B,3A+)

Notifications You must be signed in to change notification settings

gaohongkui/Debian-Pi-Aarch64

 
 

Repository files navigation

openfans    amatfan.png

=★= Debian-Pi-Aarch64 =★=

The newest Raspberry Pi 64-bit OS 2.0 Release!!!

This is the first 64-bit system in the world to support all Raspberry Pi 64-bit hardware!!! (Include: 2Bv1.2, 3B, 3B+, 3A+, 4B)

catalina

There are always someone who do everything possible to find other's trouble, 
in order to avoid misleading,
We will explain all the help and reference that we have used and applied. 
If there are any omissions, please feel free to give us feedback in time.
Thanks again to all those who have helped us.

Official Documentation Version 2.0

中文版(Chinese)

English edition translation is continuously optimized and adjusted ...

Give me a star, just a click, I will be very happy and satisfied... :)

Gitee Repo: gitee.com/openfans-community/Debian-Pi-Aarch64

Github Repo: github.com/openfans-community-offical/Debian-Pi-Aarch64


The newest Raspberry Pi 64-bit OS, OPENFANS open source community & Raspberry Pi Fan base community Co-Produced.

This is an official version readme for the newest version 2.0 of 64-bit OS which is support for the full range of 64-bit CPU Raspberry Pi such as 3B, 3B+, 3A+, 4B.

The passed system version: 1.0 and 2.0 preview has been without any updates or supported.

The "Old Readme" was viewed here. ( - Just A Chinese Edition)

First, Please read this document carefully before your questions, maybe your answers have included in this document (We'll refuse to reply any answered questions).

Attention, please! Besides this document, any other documents in this Git repository are no longer supported (Except linked file form this document), just for a developer's archive.

Attention!

  • All commands executed of this article, unless specified, are executed under the root privileges by default!!

  • With any problems, be sure to upgrade your system, firmware and kernel to the latest version first. Click here to check the latest version and learned how to upgrade your system, kernel and firmware.

Notice:

The latest version of the system: 2020-06-22-v2020-2.0-U4-Release

If you had found a Chromium browser interface display error issue on version 202006 U3 please see here. This issue had fixed after version >=20200617U3

The latest version of kernel and firmware:
2020-06-22-v2020-2.0-U4-Release (recommended update)

The system version "2020-06-22-v2020-2.0-U4-Release" don't need upgrade the kernel and firmware to "2020-06-22-2.0-U4"

Note: Fimware >=U3, >=U4 do not support upgrade from version <=U2(include) !!

Donation

Thanks for your donation! We'll get the greatest power from your encourage!

jz


Contents

0. System Screenshots


1. Introduction

1-1. System Environment (Versions)

1-2. System Environment (Base Env)

1-3. Features Comparison From Different Versions

1-4. Some System Performance Testing Results


2. Main features Introduction

2-1. Web Visual Management Interface

2-2. QEMU-KVM Virtualization Support

2-3. Docker Container Support

2-4. AUFS File System Support

2-5. TCP Acceleration

2-6. Memory And Swap Optimization (Algorithm-level)

2-7. macOS-Mojave Theme Desktop

2-8. CecOS-CaaS Container Cloud (JUST A CHINESE EDITION SUPPORT)

2-9. Other Features


3. Instructions For Usage

3-1. System Initialization (First Boot)

3-2. Accounts And Passwords

3-3. Web Login Interface NOTE

3-4. Pre-Configured Items

3-5. Wireless Configuration

3-6. Wired Network Configuration

3-7. Boot Custom Startup Script

3-8. DO NOT Upgrade The Deepin Desktop ENV

3-9. TTY Display Chinese Font (Not Remote) Of Chinese Environment

3-10. Web Interface VNC Remote Desktop Of macOS Mojave Theme Desktop Support

3-11. Switch Sound Output Channels

3-12. 32-Bit Software Armhf Support

3-13. Enabled And Start Docker Service

3-14 Enabled And Start CecOS CaaS Container Cloud

3-15 Create And Joined Or Exit And Left A Docker Cluster

3-16. FAQ NOTE

- 3-16.1 Using Profiles To Connect To The Wireless Networks Of Graphical Desktop Environment

- 3-16.2 Version mismatch when installing packages using APT command

- 3-16.3 Chromium browser interface display error

- 3-16.4 Bluetooth Audio connection lost

3-17. Extra Application Instructions

- 3-17.1 WPS Office Arm 64-bit Desktop Installation Note

- 3-17.2 How to install the QQ Official Desktop App (Linux Edition)


4. Virtual Machine Instructions

4-1. Standard Virtual Machines PKG Instructions

4-2 BT-Panel Virtual Machine PKG Instructions

4-3 How To Expand The Size Of A Virtual Machine Disk


5. Update And Upgrade

5-1 Upgrade System

5-2 Update Kernel And Firmware

5-3 Update Instructions

5-4 Latest Current Version

5-5 Rpi4 USB Boot Support (Upgrade eeprom FW)


6. Download Links


7. Other Instructions

7-1 Donation

7-2 Contact Info.

7-3 Copyright


8. Join US!

9. Thanks


Official Documentation Version 2.0


0. System Screenshots

Screenshot of the macOS-Mojave theme desktop by XFCE.

macos

Screenshot of the BaseOS Plus++ version: Web Management login interface.

loginUI

Screenshot of the BaseOS Plus++ version: Web Management system info interface.

WebUI

Screenshot of the BaseOS Plus++ version: Web Management container interface.

Docker

Screenshot of the BaseOS Plus++ version: Web Management web console interface.

UI SHELL

Screenshot of the CecOS CaaS Container Cloud: Main page.

CaaS

Screenshot of the CecOS CaaS Container Cloud: Cluster Management.

CaaS Cluster

Screenshot of the macOS-Mojave theme desktop: Multimedia support.

macos

Screenshot of the Deepin desktop environment: Main Desktop.

Deepin桌面1

Screenshot of the Deepin desktop environment: Dashboard.

pi4桌面2

Screenshot of the Deepin desktop environment: System Settings & System info.

pi4桌面1

Screenshot of the macOS-Mojave Theme Desktop: Graphics Virtual Machine Manager (VMM).

pi4VMM


Screenshot of the macOS-Mojave Theme Desktop: Run Android App: DOTA.

pi4Android1

Screenshot of the macOS-Mojave Themed Desktop: Run Android App: WPS (A China office compatible software) and DOTA.

pi4Android2

Screenshot of the macOS-Mojave Themed Desktop: Run WPS-ARM64-Edition-App (A China office compatible software).

wps_arm64


Screenshot of the macOS-Mojave Themed Desktop: Run Windows 10 Arm Desktop Edition On Qemu.

qemu_win_arm_0

Install Arm windows on qemu.

qemu_win_arm_1

Arm desktop PIFAN desktop.

qemu_win_arm_2

Arm windows on qemu: Systeminfo.

qemu_win_arm_3

Arm windows on qemu: Run QQ X86 desktop edition App.

qemu_win_arm_4

Arm windows on qemu: Run WeiChat X86 desktop edition App.

qemu_win_arm_5

Arm windows on qemu: Run TIM X86 desktop edition App.


1. Introduction

Don't ask a question about using a 64-bit OS for the Raspberry Pi and what's the difference between 64-bit & 32-bit OS?

Cuz the Raspberry Pi with a 64-bit CPU, unfortunately the Raspberry Pi foundation had without any system or software supported the Raspberry Pi officially launched a 64bit Beta in May 2020, and the result is indeed Debian64+Pixel ... Otherwise please add your brain...

All the versions released in this article are official versions that had been used and validated in the real enterprise production environment. The system has been rigorously tested and used normally with fully compatible for the Raspberry Pi 3B/3B+/3A+/4B, such as local wired, wireless network card, Bluetooth, 3D acceleration, etc. The numbers of all system packages are almost comparable to the X86 version. The system was built from the official Debian 64-bit baseline (wasn't built from any other ported edition or third-part edition) to ensure the original flavor.

There isn't any other relationship with the official Raspberry Pi, so no proprietary commands as the Raspberry Pi official system used (such as raspi-config, rpi-update, etc.), you need to edit the configuration file ( /boot/config.txt ) by yourself.

Why choose Debian?

Cuz the Raspberry Pi has the best compatible from Debian OS (This is inseparable from Raspbian does, the Raspbian is also based on Debian OS with the full-testing, also inherited a great power and performance of Debian. For example: Ubuntu, the most famous and successful distribution OS which was also based built from Debian).

This system is completely different from any systems we released before (also including the previous 64-bit Debian we published), we have all built from zero-os baseline this time and built a new automatic compilation and packaging, the testing system in our lab. We also redefined the packaging process and adjust all the relevant configurations, make a lot of modifications, adjustments and optimizations for the system, fixed a lot of bugs of the kernel. A lot of new features have been added, especially with the support for the hardware KVM virtualization acceleration and optimization for Docker features tuning.

We have specifically redefined and optimized our own cross compiler chain-tool and compiler for rebuild the base kernel and modules of Raspberry Pi when we were publishing the version 2.0 what is more greatly optimized and improved compiler faster and efficiency (About cross compiler chain-tool and compiler, you can refer to Huawei's Ark compiler, they have the same effect, our compiler is optimized for basic compilation tools such as C, C++, G++, ASM, NM, ld, CMAKE, and Glib, etc., Specifically target the raspberry-based hardware, ARM aarch64 A53 and ARM-v8a A72 and also including instructions set of hardware, etc.)

On June 20, 2019, the Raspberry Pi foundation released the new fourth-generation single-board machine "Raspberry Pi 4B". We got the 4th-generation 4G version from the Raspberry Pi official Cambridge Global Store for the first time.

  • On July 6, 2019, half a month hard-working after Pi4 released, The OPENFANS and the Pi Fan base community released the new Debian-Pi-Aarch64 OS version 2.0 release together.

  • This is the first 64-bit system in the world to support all Raspberry Pi 64-bit hardware!!! (Include: 2Bv1.2, 3B, 3B+, 3A+, 4B)

All of the new version 2.0 has 3D acceleration supported (With FKMS), and finally introduced the OPENFANS Container Cloud Management Platform supported (Also called CecOS CaaS, based build from an open-source project which is called Portainer) which is be more perfect and powerful than system version 1.0!

The newest OS 2.0 is also adhering to the all excellent tradition from the Debian-Pi-Aarch64 OS which was built by OPENFANS and Pi Fan Base community.

This newest OS 2.0 is full support to all Raspberry Pi aarch64 single boards: 3B, 3B+, 3A+, 4B, and still inherit all the features of the stable version 1.0!


1-1. System Environment (Versions)

BaseOS (none desktop environment, basic version)

Standard underlying system basic image, none x-window environment.
**System image name format: OPENFANS-Debian-Buster-Aarch64-XXXXXX.img

BaseOS Plus++ (none desktop environment, plus++ version)

Out of the function of BaseOS, with a visual Web UI management interface added.
**System image name format: OPENFANS-Debian-Buster-Aarch64-XXXXXX-plus.img

macOS Mojave theme custom desktop (Desktop environment, Full-Featured)

Exclusive system image ingested from the XFCE depth-customized 
and full support all the features as our other versions!
**System image name format: OPENFANS-Debian-Buster-Desktop-Aarch64-XXXXXX.img

Deepin desktop environment

Based on our own underlying BaseOS system image, from the complete 
Deepin 15.5 Pro desktop environment is ported, which is the first 64-bit ARM64 image currently built 
based on the complete Debian Aarch64 architecture, adapted to the Raspberry Pi 3B, 3B+, 3A+ and 4B.
**System image name format: OPENFANS-Deepin-Professional-Desktop-Aarch64-XXXXXX.img

Kernel & Firmware Upgrade Package

General naming rules are in the form of (starting with the upkg ) :
upkg-xxxx (years)-xx (months) -xx (day) -vxxxx-x-x-zip/zip.xz

1-2. System Environment (Base Env)

All the version 2.0 system images are used "ext4" file system as default, the Tsinghua source-mirror was set as the default software repo, and version was based on the Debian Buster 10 Arm64.

Note that version 2.0 does not support upgrades from any other version for the time being and requires a fresh installation.

1-3. Features Comparison From Different Versions

Projects BaseOS BaseOS Plus++ Desktop Full-Featured Deepin Desktop
KVM Hardware Virtualization Support
Graphical Virtual Machine Manager X X X
Docker Container
CecOS CaaS Platform X
WebGUI Manager X X
Web SSH Client
Standard VM kit X
BT-Panel kit X

(1)Note:

★ : Stands for supported and default enabled. It can directly be used.

☆ : Stands for supported and default disabled. Need to be started manually.

(There will be an instructions for how to use this service in this document.)

X : Stands for not supported.

(2)Service control

Docker Container

Manual start: systemctl start docker.service
Manual stop: systemctl stop docker.service
Enable autostart: systemctl enable docker.service
Disable autostart: systemctl disable docker.service

CecOS CaaS Platform (service port: 8443)

Manual start: systemctl start cecos-caas.service
Manual stop: systemctl stop cecos-caas.service
Enable autostart: systemctl enable cecos-caas.service
Disable autostart: systemctl disable cecos-caas.service

WebGUI Manager (service port: 9090)

Manual start: systemctl start cockpit.socket
Manual stop: systemctl stop cockpit.socket
Enable autostart: systemctl enable cockpit.socket
Disable autostart: systemctl disable cockpit.socket

Web SSH Client (service port: 4200)

Manual start: systemctl start shellinabox.service
Manual stop: systemctl stop shellinabox.service
Enable autostart: systemctl enable shellinabox.service
Disable autostart: systemctl disable shellinabox.service

1-4. Some System Performance Testing Results

Version 1.0 vs. other comparable 64-bit OS (developed by others) testing result

An incomplete testing result, just theoretical data, for reference only:

UnixBench testing results using the Ext4 Standard File System and The Raspberry Pi 3B Plus (compared to comparable Debian Aarch64 systems):

  • Single Thread:

x1

  • Multi-threaded:

x4

  • Overall rating:

all

Overall performance comprehensively exceeds the comparison test system of 2 to 3 times, some indicators even reached more than 10 times, 1000% improvement.

  • Version 1.0 vs. Raspberry Pi Official 32-bit system testing result

Recently, the Raspberry Pi official has done a lot of optimization work, the current system compared to the previous 32-bit system has a larger improvement, but limited to the 32-bit local architecture restrictions, and 64-bit system performance gap is still large.

Attached: Pi Fan Debian Pi Aarch64 64-bit version 1.0 system vs. Raspbian 32-bit performance comparison testing result

Sysbench 0.4.12 Result:

Test projects ARM32/EXT4 ARM64/F2FS test unit:time / the smaller the better
System Information 2018-11-13-Raspbian Raspberry Pi Fan 64-bit U8 Edition Increase the multiple
The CPU single thread 119.2072 9.8725 12.07
The four-threaded 299.5217 24.6616 12.15
the eight-threaded 299.5824 24.6789 12.14
Memory Random 1.2625 0.8751 1.44
Memory Continuous 1.5803 1.1583 1.36
Continuous read-write of files 6.1621 2.2928 2.69
File Random Reading and Writing 484.812 6.3527 76.32

Maximum Performance Gap Multiple: 76.32

Multiples of the average performance gap: 14.95

  • Version 1.0 testing result comparison chart

sysbench

The latest 2.0 beta with The Raspberry Pi Official 32-bit System Testing Result

Test hardware: Raspberry Pi 4B

Sysbench 0.4.12 Result:

Test projects ARM32/EXT4 ARM64/EXT4 test unit:time / the smaller the better
The system 2019-06-20 raspbian-buster 2019-07-06 Pi Fan 2.0 Beta Edition Increase the multiple
Single-threaded 92.7292 6.7406 13.757
The four-threaded 231.6591 16.8172 13.775
the eight-threade 231.5002 16.8282 13.757
Memory Random 2.4225 0.6086 3.980
Memory Continuous 2.5631 0.9267 2.766
Continuous read-write of files 6.3636 1.8859 3.374
File Random Reading and Writing 627.719 10.6036 59.199
Mutually exclusive lock performance (4096) 0.0206 0.0081 2.543

Maximum Performance Gap Multiple: 59.199

Average Performance Gap Multiple: 14.144

  • Version 2.0 testing result comparison chart (statistical unit: time, the smaller the better)

sysbench


2. Main Features Introduction

2-1. Web Visual Management Interface

web manage

All-platform web visual management interface (Only supported for BaseOS and Desktop Full-Featured version).

With web management interface support on the new 64-bit OS version 2.0, the system-wide platform enables visual operational management interface, whether it's standard desktop graphics or desktop-free systems (enhanced version), the Debian-Pi-Aarch64 officially opens the visual era.

Web management interface support:

1. New Full-featured version of support;

2. Fully open the web management era, save the trouble of terminal tools, 
Anytime, Anywhere, direct browser management;

3. Enabled docker container service by default, out-of-the-box 
(version 2.0 please manage and use containers via CecOS CaaS Container Cloud);

4. Full-service monitoring of integrated Web interface;

5. Support the web interface to view system conditions, 
hardware information, situation and other information;

6. Support for web interface setting hostname;

7. Support for web interface setting up host domain;

8. Support web interface to set host time, NTP servers, update mode;

9. Support web interface shutdown and restart the system;

10. Support for web interface system log management;

11. Support web interface system storage and related peripheral management, 
online partitioning, mount equipment, and other functions;

13. Support for web interface system account management;

14. support for web interface system service management;

15. Support for web interface system update management;

16. Web interface integrates shell terminal, which can be operated directly on the web page;

17. Support for cross-node and unified management: manage multiple devices in one interface, 
dramatically improving management and productivity;

18. Web management communications are encrypted using SSL certificates to ensure the security 
of session data.

shellinabox

WEB SSH client support, using a separate web shell (shellinaBox) suite, provides separate web ssh login support.

2-2. QEMU-KVM Virtualization Support

This is a QEMU virtual machine with local Aarch64 architecture that supports KVM hardware acceleration.

We recompiled KVM binary to address many of the bugs for qemu-system-aarch64 in KVM hardware-accelerated environments:

The default version of the system virtual machine cannot run, the system cannot be installed, etc. After KVM hardware acceleration was turned on...

We added support for KVM virtual machines when compiling the kernel, directly supporting full virtualization of hardware-accelerated, and added support for local KVM virtual hardware kernel modules, the main kernel modules are as follows:

1. virtio //standard virtual disk

2. virtio-scsi //virtual scsi disk

3. virtio-blk //pass-through disk block device

4. Virtio-blk-scsi //pass-through disk block device scsi mode

5. virtio-net //virtio virtual network card

6. virtio-balloon //memory bubble

7. virtio-hw-random //virtual random number hardware

8. virtio-console //virtual terminal

9. virtio-input //virtual input device

10. Virtio-crypto-device //virtual encryption device

12. virtio-drm-gpu //virtual graphics

13. Virtio-9p //directory Sharing with v9p

14. vfio //Pass-through device support

15. vhost //host data interaction

16. vhost-net //host network data interaction

...

What is KSM?

The principle of KSM is that in multiple processes, Linux merges kernel-like memory pages into one memory page.

This feature, which is used by KVM to reduce memory usage of multiple similar virtual machines, improves memory efficiency. Cuz memory is shared, so multiple virtual machines use less memory, which is more effective when using the same image and operating system for virtual machines. To better optimize the memory efficiency of virtual machines, the kernels of all our systems support KSM by default.

The current 2.0 system is fully available for virtualization support by default, and the graphical desktop provides a visual "Virt-Manager" app for management.

2-3. Docker Container Support

The famous Docker will not be much introduced here, this time we recompile the kernel, added the full feature of Docker support, this is currently the most complete support for Docker features under the Raspberry Pi Aarch64 system architecture, Most other versions are still 32-bit systems with 32-bit dockers, and local 64-bit system cores lack much kernel support for Docker features.

Even the latest version of the famous 32-bit Raspberry Pi Docker system Hypriot doesn't fully support the Docker Swarm.

You'll get the following error message because the Hypriot does not support the bridge vlan/vxlan netfiler:

reexec to set bridge default vlan failed exit status 1

This will result in the complete use of the Docker Swarm cluster is not support (The Hypriot OS), the lack of relevant feature support for the network, there will be some functional missing problems.

You can find a lot of errors and warnings on the local 64-bit ARM system by using the systemctl status containerd and the systemctl status docker as well as by viewing the logs, and not counting them completely. The local system kernel includes at least lost the following features: (The Hypriot OS and most other system)

1. cgroup memory limit

2. cgroup swap limit

3. cgroup rt period

4. cgroup rt runtime

5. cgroup pid support

6. cgroup memory sysfs

7. cgroup rdma

8. cgroup perf

9. cgroup bridge vlan/vxlan

10. cgroup netfiler

11. cgroup net prio

12. cgroup cfs bandwidth limit

13. Bridge vlan ilter

14. ipvs

15. ipvs ipv6

16. memory sysfs

17. Kernel KSM

...

Docker Compose

Docker official doesn't provide arm/arm64 based docker-compose to run binary, so we recompiled and provided aarch64-bit binary that can be run and now the default is added to the system images, which you can use directly.

2-4. AUFS File System Support

Note: Support for AUFS will be discontinued after version 2.0 U3 (Include)!

What is the AUFS File System?

AUFS, the full name is an advanced multi-layered unification file system, the main function is to combine the contents of multiple folders to provide a unified view, mainly for the various Linux distributions livecd, and the docker inside used to organize the images.

AUFS was Docker's default storage driver, with a very stable, lots of real deployments, and strong community-supported, with several key advantages:

- Very short container start-up time
- Effective storage utilization
- Effective memory utilization

But since it is not included in the Linux kernel mainline, many Linux distributions do not support AUFS.

The latest Docker defaults to the faster and latest OverlayFS file system, we make maintains the default value for this official setting.

Do we need to use AUFS?

Cuz Docker's mirror files use a file system that is divided into multiple tiers, OverlayFS supports only 2 tiers, multiple replicas are replicated when using the same mirror layer, and takes up more space and I/O, while a AUFS also provides the ability to use multi-tiered storage and share data. Docker uses AUFS' Copy-on-Write copy technology to achieve image sharing and minimize disk space usage.

For devices with less storage space like Raspberry Pi, using the AUFS file system makes better use of our limited storage space resources and reduces I/O consumption.

To allow users to freely choose and use OverlayFS or AUFS according to their circumstances, we have added support for AUFS modules by default in the kernel.

Since AUFS is not supported by the mainline of Linux kernel, we have added AUFS kernel module code and recompiled to the kernel of mainline 4.19 through AUFS' PATH, and now the system boot will automatically load the AUFS module, which can be used directly without human intervention.

2-5. TCP Acceleration

The kernel has turned on the TCP BBR congestion control algorithm by default.

What is TCP BBR?

Let's explain simply what the TCP BBR solves:

- Make full use of bandwidth on network links with a certain drop rate, 
ideal for high-latency, high-bandwidth network links;

- Reduces buffer occupancy on network links, reducing latency, 
making it ideal for users who access the network at slow speed.

Simply put, the TCP BBR congestion control algorithm can improve TCP transmission speed and efficiency to a certain extent and optimize network transmission.

How to turn off:

Edit the "/mnt/etc/sysctl.conf" file, execute the command "sysctl -p" to view the results, and do not see the following comments, representing the operation succeeded.

Comment out the following 2 lines: (Just put the "#" at the beginning of each line)

net.core.default-qdisc-fq
net.ipv4.tcp.tcp-contents-control-bbr

2-6. Memory And Swap Optimization (Algorithm-level)

  • Support: Swap Partition

This new version of the system by default increased support for swap caches to alleviate the problem of low memory in the system, greatly improved support and efficiency of executable large-capacity memory requirements applications, users do not need to manually create the system Swap, our system will automatically complete and initialize Swap after installation. The location of the Swap file or partition can be adjusted by looking at the system mount profile /etc/fstab .

  • Support: zSWAP virtual memory compression

This new version of the system kernel by default has added the virtual memory compression function of the "zSWAP" to provide a compressed writeback cache for the pages to be swapped, the default limit of physical memory is the 25% of system's total memory upper limited.

Why zSWAP?

When the memory page is about to be swapped out, zSWAP does not move it to the switching device, but compresses it and then stores it in a pool of memory that is dynamically allocated within the system RAM, and the act of writing back to the actual swap device is delayed or even avoided altogether, thus significantly reducing the I/O used by the Linux system for switching. For Raspberry Pi such a device relying on the TF card, the original I/O is not very high, reducing the operation of I/O for exchange means improving system performance, I/O used in system applications and other more needed scheduling.

In scenarios where swap files/partitions are used, TF life can be increased by reducing I/O operation on Swap files/partitions.

zSWAP does not virtual a block device, but hook into the ordinary Swap code, before the actual write-to-disk/read operation, the first use of their management of memory for data swap/in, memory is not enough to use before the use of traditional Swap files/partitions. So zSWAP is suitable for systems that already have swap partitions themselves, as well as hardware devices like Raspberry Pi, which have little memory of itself.

Why not zRAM?

zSWAP uses both memory and swap partitions, and automatically adjusts the size of the memory, and the cached data is automatically stored into the Swap file/partition when the system memory is not enough, greatly improving the efficiency of the system Swap swap exchange. More full use of memory space resources and avoid the system memory shortage, and zRam completely use memory to operate and store data, completely occupied memory, generally used in large memory scenarios, which is not appropriate for a small memory Raspberry Pi.

zSWAP memory allocators and data compression algorithms used in this system :

Memory allocator zpool frame: smalloc, zbud, z3fold

The reality shows that although zsmalloc has a high compression rate, the algorithm is complex and requires additional threads to be responsible for memory finishing, which consumes more cpu time.

The zbud implementation is simple, memory page storage does not produce memory fragmentation, but the compression rate is low, up to only 2 times, does not meet the actual needs of small memory system.

As a result, Sony developed the z3fold memory allocator, which is exactly the same as zbud's implementation, except that each page can store 3 compressed pages, with a maximum compression rate of 3 x, and a nearly 4x of zsmalloc, a technique used in xperia xzp, Get a 4GB experience with your 4GB phone.

We selected the z3fold algorithm in the system, and we can see the configuration in the system /boot/cmdline.txt:

zswap.enabled=1 zswap.zpool=z3fold zswap.compressor=lz4 zswap.max_pool_percent=25

Compression algorithm

Linux has many compression algorithms: lz, lzo, xz, gzip, lzma...

We have adopted lz4 with very high compression speed and high compression rate, lz4 compared to other compression algorithms, compression rate is not the highest, but the speed is indeed the fastest, in the case of the z3fold algorithm has been used, combined with the Raspbery Pi's performance characteristics and actual testing, and also wanna get a good compression rate, Speed is the most important thing for the Raspberry Pi (given its CPU performance overhead and memory size).

2-7. macOS-Mojave Theme Desktop

desktop

The default desktop theme uses a desktop that mimics the macOS Mojave theme.

2-8. CecOS-CaaS Container Cloud (JUST A CHINESE EDITION SUPPORT)

caas-main

caas-cluster

Rebuild from An open-source project Portainer and develop for Chinese and others By OPENFANS.

2-9. Other Features

  • Support for 3D acceleration, all desktop environments are enabled by default.

  • There are too many new features of version 2.0, we won't elaborate anymore here.


3. Instructions For Usage

3-1. System Initialization (First Boot)

The system will automatically expand the root partition, and then automatically configure, until complete, the normal use, in the process the system will automatically restart 3 times.

3-2. Accounts And Passwords

System default account: pi, default password: raspberry

The default account pi account supports ssh login, for root account password please login first and then use the command "sudo passwd root" to set,

Or use the command "sudo -i" to switch to the root user mode.

3-3. Web Login Interface NOTE

1.Web Visual Management Login Interface
Login address https://yourRasp's IP address:9090
Description: Please login system used default account: pi

2.WEB SSH Client Portal Login Interface
Login address https://yourRasp's IP address:4200
Description: Used the account with the permission of console login, 
user pi was already with this permission.

3-4. Pre-Configured Items

The system provides a pre-configured network and auto-start task during boot, with the path and correspondence of the relevant profile as follows:

Pre-configured items Pre-profile paths Corresponding to the system file path to the link
Wireless Networks /boot/wpa_supplicant.conf /etc/wpa_supplicant/wpa_supplicant.conf
Wired Networks /boot/interfaces /etc/network/interfaces
DHCP Clients /boot/dhclient.conf /etc/dhcp/dhclient.conf
Custom Boot Scripts /boot/rc-local /etc/rc.local

3-5. Wireless Configuration

A desktop environment can be set up through a graphical interface after logging into the desktop environment, here provides how the configuration file is modified.

If the desktop environment wants to connect to wireless networks using a configuration-modifying approach, please NOTE here.

Modify the file "/boot/wpa_supplicant.conf"

## To use this file,you need to run the command: ##
## "systemctl disable network-manager" and reboot system.##
##
## (Do not uncomment this line!) ##

## 'country' is to set wifi area,'CN' is china ##
#country=CN
#ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
#update_config=1

## The following "WIFI 1", "WIFI 2" represents the settings of multiple wireless networks ##
## Unless you want to set up multiple wireless networks, ##
##you only need to set the settings of "WIFI 1". ##
## WIFI 1 (Do not uncomment this line!) ##

## In addition to canceling the content comments that need to take effect, ##
## the following only need to modify the contents of the quotes after "ssid" and "psk". ##
## ssid is your wireless Wifi name, psk is your wireless Wifi password ##
#network={
#    ssid="your-wifi1-ssid"
#    psk="wifi1-password"
#    priority=1
#    id_str="wifi-1"
#}

## WIFI 2 (Do not uncomment this line!) ##

#network={
#    ssid="your-wifi2-ssid"
#    psk="wifi2-password"
#    priority=2
#    id_str="wifi-2"
#}

wireless area code settings

Edit the file of the "/etc/default/crda", edit the contents behind "REGDOMAIN=", the default has been set to "CN" China, in general, no settings are required.

**with wireless common area code: **

AU Australia
CA Canada
CN China
GB UK
HK Hong Kong
JP Japan
KR Korea
DE Germany
US USA
TW Taiwan

3-6. Wired Network Configuration

Modifying the file of the file of the file: "/boot/interfaces"

interfaces (5) file used by by ifup (8) and ifdown (8)
Include files from /etc/network/interfaces.d:
source-source/etc/network/interfaces.d
Used dhcp ip address set eth0 inet to dhcp,
sor used static ip address set eth0 to static
Sand change other ip settings.
If you wanna let settings to take effect,
suncomment symbol in front.
#auto eth0
#allow-hotplug eth0
#iface eth0 inet dhcp
#iface eth0 inet static
#address 172.16.192.168
#netmask 255.255.255.0
#gateway 172.16.192.1
#dns-nameservers 8.8.8.8

3-7. Boot Custom Startup Script

The system supports a custom scripts as an auto-start task during boot, which can be pre-configured before the system starts.

Edit the script file "/boot/rc-local" and add the custom script content before line: "exit 0".

3-8. DO NOT Upgrade The Deepin Desktop ENV

The version which was after 2019-11-10 (Also included) had supported upgrade!

Cuz of compatibility issues with the Deepin system and upstream warehouses (deepin itself), it is strongly discouraged from using any of the following commands or any other operations that would cause the system to be upgraded unless you know what you need to do!!!

All Deepin version systems need attention, including all Deepin versions of 1.0 and 2.0!

apt upgrade
apt-get upgrade
apt dist-upgrade
apt-get dist-upgrade

PS:

Some software installation limited to Deepin itself compatibility issues, there may be bug caused the system can not start or any other unknown problems, because the software is too much we can not test one by one, welcome feedback, recommended install through source code.

The Deepin Software Store software is provided by Deepin, not us, at present, Depth Software Store does not provide software support for arm64 , if there is any needs, please go to the deepin official forum for assistance.

So we strongly recommend using our customized macOS-Mojave themed desktop version.

3-9. TTY Display Chinese Font (Not Remote) Of Chinese Environment

Notice: Remote login ignores this problem, there will be no garbled problem. When only using the local terminal through a local monitor or serial connection, because the Linux kernel local standard TTY does not support the display of Chinese font, the relevant of action when the display of garbled is required.

We need to install fbterm extension support, to do that, use following commands under network environment:

## Install fbterm
sudo apt update; sudo apt install fbterm -y

## Add a login user to the video group
sudo adduser root video ; sudo adduser pi video

sudo adduser you create your own other user name (if any) video

## And then execute the following command each time you need to display Chinese fonts
## (wait some time for the first time):

fbterm

3-10. Web Interface VNC Remote Desktop Of macOS Mojave Theme Desktop Support

web VNC

Note:

The macOS Mojave theme custom desktop (Desktop environment, Full-Featured) which the version is after 2019-11-17 (also include) had support web interface VNC remote desktop by default.

The default VNC access password is: raspberry
The default VNC web interface address is: http://your-rpi-ip-addr:5901
The default VNC client address is: your-rpi-ip-addr:5900

You can not used web interface and client to connect the same vnc server at the same time.

If you wanna used a client to connect the vnc server, we suggest you to use RealVNC client, you can click here to download RealVNC client.

Instructions for web interface VNC remote desktop usage

There are two ways to used the default VNC:

● Connected a real monitor

The VNC was default enabled, you needn't do nothing.

● Without any monitor connected

The VNC was default enabled, but if you haven't any monitor to connected, you should use a 
virutal monitor, run command: "virtual-monitor-enable" to enable virutal monitor mode, 
after this the system will reboot.

IMPORTANT

If you wanna enable the virtual monitor mode, you can not connect to a real monitor the 
same time, if you had enabled the virtual monitor mode, run command :

"virtual-monitor-disable" 

to back to the normal when you wanna connect to a real monitor back.

Note: The "Virtual Monitor Mode" is not enabled by default.

Commands for default VNC

virtual-monitor-enable

Enable the virtual monitor mode, without connect a real monitor.
After this, the system will reboot.

virtual-monitor-disable

Disable the virtual monitor mode, back to Normal and connect a real monitor.
After this, the system will reboot.
This is a system default mode.

enable-vnc

Enable the default VNC service.
After this, the system will reboot.
The system is enabled by default.

disable-vnc

Disable the default VNC service.
After this, the system will reboot.

vnc-passwd

Change the default VNC access password.

If you wanna install another VNC server packages, just like RealVNC, you can do this bellow:

(You need to disable our system default VNC service before installation)

But we still suggest you to use the default VNC of system by us.

Install RealVNC Remote Desktop Of macOS Mojave Theme Desktop Environment

vnc_pkg='VNC-Server-6.6.0-Linux-ARM.deb' ; \
sudo \
sed -i '/deb http:\/\/mirrors.tuna.tsinghua.edu.cn\/debian\/ sid main non-free contrib/d' \
/etc/apt/sources.list ; \
sudo apt clean all ; \
sudo echo 'deb http://mirrors.tuna.tsinghua.edu.cn/debian/ sid main non-free contrib' \
>>/etc/apt/sources.list ; \
sudo dpkg --add-architecture armhf ; sudo apt update ; \
cd ~ ; wget https://www.realvnc.com/download/file/vnc.files/$vnc_pkg ; \
sudo apt install ./$vnc_pkg ; \
rm -rf ./$vnc_pkg ; \
sudo dpkg --remove-architecture armhf ; sudo apt update ; \
sudo systemctl enable vncserver-x11-serviced.service ; \
sudo systemctl start vncserver-x11-serviced.service ; \
sudo \
sed -i '/deb http:\/\/mirrors.tuna.tsinghua.edu.cn\/debian\/ sid main non-free contrib/d' \
/etc/apt/sources.list ; \
sudo apt clean all ; sudo apt update

Attention please!!

sudo \
sed -i '/deb http:\/\/mirrors.tuna.tsinghua.edu.cn\/debian\/ sid main non-free contrib/d' \
/etc/apt/sources.list ; \

Don't miss this command in the process of installing RealVNC on it above!!!

Click here to download RealVNC client

Install and run the client, enter the IP address directly, do not need to fill in the port, username, and password is your system's login user and password.

PS:

Some advanced instructions for Realvnc:

Installed system unit for VNC Server in Service Mode Mode Daemon

Start or stop service with:

systemctl (start-stop) vncserver-x11-service.service

Mark or unmark the service to be started at boot time with:

systemctl (enable-disable) vncserver-x11-service.service

How to kill all Process:

killall vncserver-x11-core vncserver-x11 vncagent vncserverui

When you do not have a monitor you need do this way

VNC Server Virtual Mode

In this mode, the VNC connect address is:

your-Rpi-ip-address:1
## Mode A:

Installed system unit for VNC Server in Virtual Mode Daemon
(This feature needs a RealVNC license)

Start or stop service with:

    systemctl (start-stop) vncserver-virtuald.service

Mark or unmark the service to be started at boot time with:

    systemctl (enable-disable) vncserver-virtuald.service
## Mode B:

Another way run Virtual Mode Daemon:
(Custom way without license)
(From Pi forum https://www.raspberrypi.org/forums/viewtopic.php?t=249124)

Do as the follow steps:

1. Install a package: 

    apt install xserver-xorg-video-dummy -y

2. Run command:

    killall vncserver-x11-core vncserver-x11 vncagent vncserverui ;\
    systemctl stop vncserver-x11-serviced.service ;\
    systemctl disable vncserver-x11-serviced.service ;\
    systemctl stop vncserver-virtuald.service ;\
    systemctl disable vncserver-virtuald.service

3. Create a service script: 

/usr/lib/systemd/system/vncserver-pi.service

---------------------------------------------------
[Unit]
Description=VNC Server in Virtual Mode daemon
After=network.target

[Service]
User=pi
Type=forking
ExecStart=/usr/bin/vncserver :1
ExecStop=/usr/bin/vncserver -kill :1
Restart=on-failure
RestartSec=5
KillMode=process

[Install]
WantedBy=multi-user.target
---------------------------------------------------

4. To enable the system Xorg server for all users, run:

    vncinitconfig -enable-system-xorg

    All answers need to choose "Y"

    If you wanna disable, run:

    vncinitconfig -disable-system-xorg

5. Generate a "/etc/X11/vncserver-virtual.conf" conf file, run:

    vncinitconfig -virtual-xorg-conf

6. Then enable and start service:

    systemctl enable vncserver-pi.service
    systemctl start vncserver-pi.service


Known issue:
This mode isn't support restart vncserver-pi.service
You need to reboot system.

3-11. Switch Sound Output Channels

Vesrion 2.0: System Default Use the HDMI to output audio.

The commands for switching the sound output:

amixer cset numid=3 2

## Set the output here to 2, which is HDMI.
## Setting the output to 1 switch to the analog signal (that is, the headphone connector).
## The default setting is 0, which represents automatic selection.

After you have finished modifying your audio settings, you need to restart your Raspberry Pi in order for your changes to take effect.

If you're still not getting sound via HDMI:

In some rare cases, it is necessary to edit config.txt to force HDMI mode (as opposed to DVI mode, which does not send sound).

You can do this by editing /boot/config.txt and setting hdmi_drive=2 , then rebooting for the change to take effect.

3-12. 32-Bit Software Armhf Support

dpkg --add-architecture armhf
apt update

## The 32-bit "libc6:armhf" base library needs to be installed first
apt install libc6:armhf

apt install [Other package name]:[armhf]

## Install 32-bit software Please add suffix ":armhf" after the name of the package

3-13. Enabled And Start Docker Service

The BaseOS and Desktop Full-Features Versions are not enabled by default and require manual start-up.

## Turn on the Docker service automatically start
systemctl enable docker.service

## Start Docker service
systemctl start docker.service

######

## Stop Docker services
systemctl stop docker.service

## Disable Docker service from booting
systemctl disable docker.service

3-14 Enabled And Start CecOS CaaS Container Cloud

The BaseOS and Desktop Full-Features Versions are not enabled by default and require manual start-up.

Note: To enable the CecOS CaaS container cloud service, you must enable and start the docker service first!

## Turn on the CecOS CaaS Container Cloud service automatically start
systemctl enable cecos-caas.service

## Start CecOS CaaS Container Cloud service
systemctl start cecos-caas.service

######

## Stop CecOS CaaS Container Cloud service
systemctl stop cecos-caas.service

## Disable CecOS CaaS Container Cloud service from booting
systemctl disable cecos-caas.service

3-15 Create And Joined Or Exit And Left A Docker Cluster

## Initialize and join a Docker Swarm Cluster
docker swarm init

## View cluster node status
docker node ls

## exit Docker Swarm Cluster
docker swarm leave -force

3-16. FAQ NOTE

3-16.1 Using Profiles To Connect To The Wireless Networks Of Graphical Desktop Environment

The graphical desktop environment uses a profile to connect to a wireless network, and after modifying the ** /boot/wpa_supplicant.conf** file, to ensure good network compatibility, do the following:

with root user identity:

systemctl network Manager

Then execute:

sed -i  \
's/sudo systemctl restart NetworkManager/## sudo systemctl restart NetworkManager/g' \
/home/pi/.xsessionrc

Finally, after restart all done.

3-16.2 Version mismatch when installing packages using APT command

Problem Description:

When using the command apt to install the deb package online, you may encounter the problem that a matching version cannot be found, such as:

The following packages have unmet dependencies:
 package-name-1 : Depends: package-name-2 ( >= x.x.x-xxx-2 ) but x.x.x-xxx-1 is to be installed
              Recommends: package-name-3 but it is not going to be installed
E: Unable to correct problems, you have held broken packages.

Reason:

This is because some of the newer upstream packages installed on our system do not match the version of the packages in the default repository.

Solution:

To temporarily enable the upstream sid software repository, add the sid-used sudo command before your apt command:

Example: sid-used sudo apt install package-name

3-16.3 Chromium browser interface display error

Reason:

Maybe U will see this issue on version 20200615 U3, Cuz we changed mesalib, should used another way to set Chromium.

Solution:

Run command:

sudo sed -i  \
's/"hardware_acceleration_mode":{"enabled":true},/"hardware_acceleration_mode":{"enabled":false},/' \
/home/pi/.config/chromium/Local\ State

Then re-open your Chromium browser.

3-16.4 Bluetooth Audio connection lost

Reason:

Pi's Bluetooth has compatibility issues with certain hardware between alsa and pulseaudio.

Solution:

Disable Bluealsa Service, just use pulseaudio for bluetooth audio. Run the command below and reboot:

systemctl mask  bluealsa.service

Note: Here U must use "mask" for unactive bluealsa.service, mustn't use "disable" !!

3-17. Extra Application Instructions

3-17.1 WPS Office Arm 64-bit Desktop Installation Note

Get the install package from download repo's "APP" folder, after extracting the installation package, go to the installation package directory.

Then connect to the public network and execute the following command as the root user:

sudo ./install.sh

The program will be installed.

Note: Test only on the macOS Mojave theme custom desktop version!!

For testing and learning use only!!!

3-17.2 How to install the QQ Official Desktop App (Linux Edition)

Make sure your system can connect to internet, then run the commands below as root user:

qq_pkg='linuxqq_2.0.0-b1-1024_arm64.deb' ; \
cd ~ ; \
wget https://raw.githubusercontent.com/openfans-community-offical/Debian-Pi-Aarch64/master/add-app/$qq_pkg ; \
apt install ./$qq_pkg -y ; \
rm -rf ./$qq_pkg

After this, the App will be finished the installation.

linux_qq


4. Virtual Machine Instructions

Virtual machine resource packages are typically published as compression packages, and the following commands are performed to install the support for the unzip pack:

apt update ; apt install tar gzip zip unzip bzip2 xz-utils -y

4-1. Standard Virtual Machines PKG Instructions

Default user: root (remote permissions turned on), password: raspberry

After unzipping the virtual machine resource package, change location and into the virtual machine's resource package directory then unzip the virtual disk image:

xz -d -k disk.qcow2.xz

You will get a virtual disk image of disk.qcow2, and the system can be restored at any time with the commands above.

Run the virtual machine:

sudo ./vm-run

## This script command above will run the virtual machine in a background manner by default.

Run the virtual machine in the way the previous station:

Copy the file vm_run and name as vm_run2 , open the file vm_run2 and delete the following 2 lines:

... ## omitting content
nohup \
... ## omitting content
   &
... ## omitting content

Then, run "sudo ./vm_run2".

Remote login:

Port 22 of the virtual machine has been mapped by default to the local port 2222, SSH access to the local machine's port 2222 directly.

Example of the command:

ssh -p 2222 root@local-ip-address

4-2 BT-Panel Virtual Machine PKG Instructions

In order to take care of new users and respond to the voices of the people, we finally “integrated” the Pagoda for you, using the virtual machine, 32-bit super clean custom ARMHF virtual system optimized for the pagoda, even for virtual machines, The speed is also greatly stronger than the official backplane system (who has used and who will understand :) --).

To run the benchmark:

BT-Panel

By default, all software is installed. Version 5.9.X Relatively stable professional "learning version", you know, this is just only allowed to use for your testing!!

Why BT-Panel?

1. The use of beginners is convenient;
2. The voice of the masses is too high;
3. By the way...

Why not integrate directly in the 64-bit OS?

1. Not everyone needs a default integration, too bloated;

2. Pollute system;

3. BT-Panel is extremely poorly compatible with ARM64!

4. The BT-Panel is not just a simple installation. 
The software that needs to be used in the ARM system almost all needs to be recompiled. 
The compatibility is poor and it takes a long time. 
It can pretend that you doubt life and pretend that you wanna cry.

5. The problems of various strange pits encountered in our use;

6. It is not that the BT-Panel is not good overall. 
At least the compatibility on the ARM64 is a considerable problem. 
It feels like the official has not done the test. 
All the work just like do the testing for them by free.

Instructions:

As with the standard virtual machine, extract the compressed package, and then change location and into the virtual machine's directory to perform related operations.

installation:

sudo ./install

Start BT-Panel Virtual Machine:

./bt_run

Close the BT-Panel Virtual Machine:

To ensure the data synchronization security of the virtual machine, please follow the steps below:

Please ssh login to the virtual machine and execute the command "init 0" 
to shut down the virtual machine.

After shutting down, you need to execute the " ./bt_prog " command in the 
BT-Panel virtual machine directory 
to check if the virtual machine is closed.

If there is no output, it means the virtual machine has been shut down normally.

If the virtual machine cannot be shut down gracefully, 
execute the " ./bt_prog kill " command in the BT-Panel virtual machine directory.

Also remember to execute the " ./bt_prog " command again to check 
if the virtual machine is down.

Automatic startup:

## Enable boot auto start
./install int

## Cancel the boot automatically
./install uint

Default parameter value:

Project Content
Default Management Port 28888
Default Management Address http://IP-Address-of-your-Raspberry-Pi:28888/
Default Web Management User and Password openfans/openfans
BT-Panel Virtual Machine SSH Port 2222
BT-Panel virtual machine root default password raspberry

How to use ssh to connect to BT-Panel virtual machine?

Local connection: ssh -p 2222 root@localhost
External connection: ssh -p 2222 root@IP-address-of-your-Raspberry-Pi

NOTE:

Do not modify the default management port of the BT-Panel Panel unless you know how to modify the 
install the deployment script.

If you need to enable site support for custom ports, edit the ports file to add your custom port, 
but don't modify the other default ports in the ports file.

To save and save everyone's time, all the functions of the BT-Panel are turned on by default.

For better performance, we strongly recommend turning off or removing features you don't need.


4-3 How To Expand The Size Of A Virtual Machine Disk

First, make sure your virtual machine was shutdown or not running.

The virtual machine disk in this article uses bt.qcow2.disk as an example.

4-3.1. Disk expansion

View disk size

Excuting an order:

qemu-img info bt.qcow2.disk

Get the following information:

Image: bt.qcow2.disk
File format: qcow2
Virtual size: 10G (10737418240 bytes) # Total disk size
Disk size: 6.4 # used capacity
Cluster_size: 65536
Format specific information:
    Compat: 1.1
    Lazy refcounts: false
    Refcount bits: 16
    Corrupt: false

Disk expansion

In this case, our goal is to add 10G capacity to the virtual machine disk.

Execute the following command:

qemu-img resize bt.qcow2.disk +10G

Then look at the disk size again

Excuting an order:

qemu-img info bt.qcow2.disk

The results are as follows:

Image: bt.qcow2.disk
File format: qcow2
Virtual size: 20G (21474836480 bytes) # Capacity increase is successful, the total size is 20G
Disk size: 6.4G
Cluster_size: 65536
Format specific information:
    Compat: 1.1
    Lazy refcounts: false
    Refcount bits: 16
    Corrupt: false

4-3.2. Extended partition

Expanding increased capacity to system partition

First, start the virtual machine and login to the virtual machine.

ssh -p 2222 root@localhost

View disk size

Excuting an order:

fdisk -l /dev/sda

The results are as follows:

Disk /dev/sda: 20 GiB, 21474836480 bytes, 41943040 sectors # has been added to 20G
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: dos
Disk identifier: 0xcd0e4df1

Device Boot Start End Sectors Size Id Type
/dev/sda1 * 2048 20969471 20967424 10G 83 Linux # Partition capacity has not been expanded

View partition size

Excuting an order:

df -hT

The results are as follows:

Filesystem Type Size Used Avail Use% Mounted on
Udev devtmpfs 496M 0 496M 0% /dev
Tmpfs tmpfs 103M 1.5M 101M 2% /run
/dev/sda1 btrfs 10G 4.7G 4.7G 50% / # Partition capacity has not been expanded
Tmpfs tmpfs 513M 4.0K 513M 1% /dev/shm
Tmpfs tmpfs 5.0M 0 5.0M 0% /run/lock
Tmpfs tmpfs 513M 0 513M 0% /sys/fs/cgroup
Tmpfs tmpfs 103M 0 103M 0% /run/user/0

Installation parted Disk Management Tool

apt update ; apt install parted -y

Extended partition

Enter the following command: parted and follow these steps:

parted

At this point, you can see the disk information as follows

GNU Parted 3.2
Using /dev/sda # This is the disk we need to operate
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) print # Enter "print" to view the disk information of the current operation
Model: QEMU QEMU HARDDISK (scsi)
Disk /dev/sda: 21.5GB # Total size has been increased to 20G
Sector size (logical/physical): 512B/512B
Partition Table: msdos
Disk Flags:
Number Start End Size Type File system Flags
 1 1049kB 10.7GB 10.7GB primary btrfs boot 
# Here "1" is the disk partition number, and the partition capacity has not changed yet.

Next enter the following command resizepart :

(parted) resizepart 
# Enter the command "resizepart" for partition expansion
Partition number? 1 
# Enter the partition number to be expanded. Since our disk here has only one partition, enter "1".
Warning: Partition /dev/sda1 is being used. Are you sure you want to continue?
Yes/No? yes # Confirm to continue, type "yes"
End? [10.7GB]? 100% 
# Enter "100%" to extend all available capacity to the partition specified in the previous step.
(parted) print 
# Enter "print" to view the disk information of the current operation
Model: QEMU QEMU HARDDISK (scsi)
Disk /dev/sda: 21.5GB
Sector size (logical/physical): 512B/512B
Partition Table: msdos
Disk Flags:
Number Start End Size Type File system Flags
 1 1049kB 21.5GB 21.5GB primary btrfs boot 
# You can see that the increased disk capacity has been expanded successfully.

(parted) quit # Enter "quit" to quit
Information: You may need to update /etc/fstab.

Update Partition Table

Execute the following command

partprobe /dev/sda
partprobe /dev/sda1

Extended File System

Our virtual machine here uses the btrfs file system. The related btrfs file system expansion operation is as follows:

Excuting an order

btrfs filesystem resize max /

Will get the following tips

resize '/' of 'max'

Remount the partition

This article extends the root partition "/", so next we remount "/" root partition

Excuting an order:

mount -o remount,rw /

Synchronous Data

Excuting an order:

sync

Validation results

Check partition size

input the command

df -hT

The results are as follows:

Filesystem Type Size Used Avail Use% Mounted on
Udev devtmpfs 496M 0 496M 0% /dev
Tmpfs tmpfs 103M 1.5M 101M 2% /run
/dev/sda1 btrfs 20G 4.7G 15G 25% / # partition has been successfully expanded
Tmpfs tmpfs 513M 4.0K 513M 1% /dev/shm
Tmpfs tmpfs 5.0M 0 5.0M 0% /run/lock
Tmpfs tmpfs 513M 0 513M 0% /sys/fs/cgroup
Tmpfs tmpfs 103M 0 103M 0% /run/user/0

Restart the virtual machine, log in again, and execute the command df -hT to determine the result


5. Update And Upgrade

5-1 Upgrade System

For system updates, please use the tools or commands with the system, such as "apt update; apt upgrade"

Due to Deepin compatibility issues, do not perform any system upgrades on Deepin Desktop!!

5-2 Update Kernel And Firmware

Download the kernel and firmware update package, extract and go to the updated package directory, execute the following command:

cd ./upkg
sudo sh ./sys_upgrade

After the completion, restart it.

Note:

Version 2.0 does not currently support upgrading from any other version and requires a new installation.

5-3 Update Instructions

Click here to see the update instructions.

5-4 Latest Current Version

Click here to view the latest current version information.

5-5 Rpi4 USB Boot Support (Upgrade eeprom FW)

Click here to download file for eeprom FW upgrade, will be support Rpi4 usb boot.

After decompressing the files, please read the readme.txt file and follow the note steps to upgrade. (Note: You must upgrade the firmware on TF boot mode first)


6. Download Links

(Because of space constraints, OneDrive does not currently provide virtual machine image template to download)


7. Other Instructions

7-1 Donation

Thanks for your donation! We'll get the greatest power from your encourage!

You can choose to scan Alipay for direct sponsorship to support us, and we guarantee that all donations will be used for project development and equipment purchase.

jz

7-2 Contact Info.

Raspberry Pi Fan Base 64-bit OS special official community QQ group: 703626518(Full) , 976102807(new)

Raspberry Pi Fan Base official website: www.pifan.org

Technology support documents official website: blog.pifan.org

Raspberry Pi Fan Base official forum: bbs.pifan.org

OPENFANS official website: www.openfans.org

7-3 Copyright

1. The all above system is built by the OPENFANS open source community and is exclusively 
distributed and provided technical support by the Raspberry Pi Fan base community;

2. Any words or image reprint must indicate the source of the system (software); 
you can make any modifications to the software or system, but you must keep the source and readme;

Strictly used for any commercial purpose, if you need to use it commercially, 
please contact and obtain permission from OPENFANS open source community and 
Raspberry Pi Fan base community;

3. The above system and the ownership of the software belong to the corresponding software 
author and the license agreement to comply with the relevant software package;

4. Failure to comply with the appeal rules, the OPENFANS open source community and the 
Raspberry Pi Fan base community have the right to pursue their respective responsibilities 
and order to stop all infringements;

5. OPENFANS open source community and Raspberry Pi Fan base community have the final 
interpretation of the above content.

8. Join US!

The Raspberry Pi Fan base community is recruiting volunteers to join the community now. The basic requirements are as follows:

  • Hardware development and design staff
1. Recognize the Raspberry Pi Fan base community culture and have great enthusiasm 
for the Raspberry Pi;
2. Responsible and responsible for the task of completing community arrangements on 
time and in quality;
3. Have the design ability of 3D printing modeling or circuit DSP;
4. Have practical hardware design experience.
  • Software and system developer
1. Recognize the Raspberry Pi Fan base community culture and have great enthusiasm 
for the Raspberry Pi;
2. Responsible and responsible for the task of completing community arrangements on 
time and in quality;
3. Familiar with system build compilation or software development;
4. We like the development language, including but not limited to: JAVA, Python, 
Go, NodeJS, C, C++ ...;
5. Require software compilation and Deb packaging;
6. Have practical development experience.

Another way, organizations, institutions and business units are welcome to discuss cooperation!!!

Please contact us with any intent: admin@openfans.org

Please write down the details and intentions and at least leave your mobile phone number, thank you for your cooperation.


9. Thanks

OSCHINA : Support fot git repo

Raspbian: Official system (automatic expansion script part reference)

UMRnInside :Project UMRnInside/RPi-arm64(refer to the automatic expansion script section)

Andreiw: Project andreiw/RaspberryPiPkg(EFI firmware referenced in version 1.0)

Sakaki(1) : link (kernel boot problem reference)

Sakaki(2) : A H264-V4L2-M2M hardware acceleration command line video player.

Margetts99 : link (WPS integration recommendations and sharing issues report)

Windows Arm On Qemu: see link1 & link2

And all other friends who have privately sponsored and helped us!


Once again despise the attack and slander called the "Dog Egg Brother" !

About

This is the first 64-bit system in the world to support all Raspberry Pi 64-bit hardware!!! (Include: 4B,3B+,3B,3A+)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published