Difference between revisions of "Orange Pi Lite 2"
(→Get the source code of Linux SDK from Baidu Cloud Disk) |
(→Development board instructions) |
||
Line 123: | Line 123: | ||
The above software can be obtained through Github, Mega network disk and Baidu cloud disk. | The above software can be obtained through Github, Mega network disk and Baidu cloud disk. | ||
− | <p | + | <p> |
− | '''http://www.orangepi. | + | '''http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Lite2.html''' <br> |
− | '''http://www.orangepi. | + | '''http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Lite2.html''' |
</p> | </p> | ||
Revision as of 15:01, 29 June 2022
Contents
- 1 Basic Features of Orange Pi Lite 2
- 2 Development board instructions
- 3 Android compilation environment
- 4 Linux compilation environment setup
- 5 Android firmware burning
- 6 Linux firmware burning
- 7 Instructions for use of Linux system
- 8 Introduction to serial debugging tools
- 9 History
- 10 Download the Orange Pi Lite 2 User Manual
Basic Features of Orange Pi Lite 2
What is Orange Pi Lite 2
Orange Pi is an open source single board computer, a new generation of arm64 development board, which can run Android 7.0, Ubuntu and Debian operating systems. Orange Pi single board computer uses Allwinner H6 system-on-chip and has 1GB LPDDR3 memory.
Use of Orange Pi Lite 2
We can use it to build:
- A computer
- A web server
- Game console
- HD video player
- Speaker
- Android
- ......
There are many more features because Orange Pi Lite 2 is open source.
Who is the Orange Pi Lite 2 for?
Orange Pi Lite 2 is not just a consumer product, it is also designed for anyone who wants to use technology to create and innovate. It is a very simple, interesting and practical tool that you can use to build the world around you.
Hardware Features of Orange Pi Lite 2
GPIO specifications
The following figure is the GPIO pin function diagram of Orange Pi Lite 2:
Orange Pi Lite 2 pin correspondence table | ||
CON12-P01 | VCC-3.3V | VCC-IO |
CON12-P02 | VCC-5V | DCIN |
CON12-P03 | TWI1-SDA | PH06 |
CON12-P04 | VCC-5V | DCIN |
CON12-P05 | TWI1-SCK | PH05 |
CON12-P06 | GND | GND |
CON12-P07 | PWM1 | PH04 |
CON12-P08 | PD21 | PD21 |
CON12-P09 | GND | GND |
CON12-P10 | PD22 | PD22 |
CON12-P11 | UART3-RX | PD24 |
CON12-P12 | PC09 | PC09 |
CON12-P13 | UART3-TX | PD23 |
CON12-P14 | GND | GND |
CON12-P15 | UART3_CTS | PD26 |
CON12-P16 | PC08 | PC08 |
CON12-P17 | VCC-3.3V | VCC-IO |
CON12-P18 | PC07 | PC07 |
CON12-P19 | SPI0_MOSI | PC02 |
CON12-P20 | GND | GND |
CON12-P21 | SPI0_MISO | PC03 |
CON12-P22 | UART3_RTS | PD25 |
CON12-P23 | SPI0_CLK | PC00 |
CON12-P24 | SPI0_CS0 | PC05 |
CON12-P25 | GND | GND |
CON12-P26 | PH03 | PH03 |
Development board instructions
Prepare hardware and software tools
Hardware requirements:
- Orange Pi Lite 2 development board
- TF card, minimum 8GB capacity, class 10, recommended brand TF card, such as SanDisk 16G TF card
- For a compiling host, the configuration should preferably meet the following conditions:
64bit CPU;
8 GB memory and above
100GB of free disk space;
The operating system is best:
Ubuntu14.04 (for compiling Android)
Ubuntu18.04 (for compiling Linux source code)
Software Requirements:
- Orange Pi Lite 2 SDK
- Orange Pi Lite 2 firmware
- Android and Linux flashing tools
The above software can be obtained through Github, Mega network disk and Baidu cloud disk.
http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Lite2.html
http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Lite2.html
Development board power supply
There are two ways to power the development board:
- DC (5V 2A) power supply:
Power on after inserting the DC adapter
- Micro USB (5V 2A) OTG power supply:
Plug in the Micro USB adapter to power on.
Android compilation environment
The following operations are performed on a PC with Ubuntu 14.04 installed. Other versions of Ubuntu systems or Linux distributions may have some differences.
Get SDK source code zip
After downloading the Android source package, first you need to combine multiple compressed files into one and then decompress them.
$ mkdir OrangePi_Lite2
$ cat H6-2018-1-2.tar.gza* > OrangePi_Lite2.tar
$ tar xf OrangePi_Lite2.tar -C OrangePi_Lite2
Build a compilation environment
- Install JDK
Android 7.0 development can only use the version of openjdk8, higher or lower than this version and Oracle's JDK will cause the compilation to fail. Openjdk-8 installation command is as follows:
$ sudo add-apt-repository ppa:openjdk-r/ppa
$ sudo apt-get update
$ sudo apt-get install openjdk-8-jdk
- Configure JAVA environment variables
For example, the installation path is / usr / lib / jvm / java-8-openjdk-amd64. You can run the following command in the terminal to configure the environment variables:
$ export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
$ export PATH=$JAVA_HOME/bin:$PATH
$ export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar
- Install platform support software
For Ubuntu 14.04:
$ sudo apt-get update
$ sudo apt-get install git gnupg flex bison gperf build-essential \ zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \ lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev ccache \ libgl1-mesa-dev libxml2-utils xsltproc unzip
$ sudo apt-get install u-boot-tools
Compile SDK source code
After the SDK is decompressed, there will be two subdirectories andorid and lichee under the decompressed directory. The main contents of the lichee directory are as follows:
lichee/brandy/u-boot-2014.07 #uboot Code directory
lichee/bootloader/uboot_2014_sunxi_spl #boot0 Code directory
lichee/linux-3.10 #Kernel code
lichee/tools #Solution hardware
configuration, packaging tools, etc.
(1)Kernel compilation process
Enter the following command in the lichee directory:
$ cd OrangePi_3/lichee
$ ./build.sh config
Welcome to mkscript setup progress
All available chips:
- sun50iw1p1
- sun50iw2p1
- sun50iw6p1
- sun8iw11p1
- sun8iw12p1
- sun8iw6p1
- sun8iw7p1
- sun8iw8p1
- sun9iw1p1
Choice: 2
All available platforms:
- android
- dragonboard
- linux
- eyeseelinux
Choice: 0
All available business:
- 5.1
- 4.4
- 7.x
Choice: 2
The output after compilation is as follows:
regenerate rootfs cpio
15757 blocks
17099 blocks
build_ramfs
Copy boot.img to output directory ...
Copy modules to target ...
sun50iw6p1 compile Kernel successful
INFO: build kernel OK.
INFO: build rootfs ...
INFO: skip make rootfs for android
INFO: build rootfs OK.
build sun50iw6p1 android 7.x lichee OK
The kernel code is in the lichee / linux-3.10 directory. Executing the above commands will automatically copy the configuration file from lichee / linux-3.10 / arch / arm64 / configs / sun50iw6p1smp_android_7.x_defconfig to lichee / linux-3.10 / .config as the default configuration before compiling , You can run ./build.sh directly in the lichee directory for the next compilation, and will continue to use the previous .config configuration.
(2)uboot / boot0 compilation process (optional)
Under normal circumstances, you do not need to recompile uboot, but if you have customized modifications to uboot, you can compile. The compilation method is as follows:
cd lichee/brandy/u-boot-2014.07
make distclean && make sun50iw6p1_config && make -j5 # compile uboot
cd lichee/brandy/u-boot-2014.07
make distclean && make sun50iw6p1_config && make spl # compile boot0
If uboot / boot0 is not compiled, the default is to use the pre-compiled results of lichee
/ tools / pack / chips / sun50iw6p1 / bin. After recompiling with the above command, the above files will be replaced automatically.
(3)Android code compilation process
$ cd android
$ source ./build/envsetup.sh
$ lunch petrel_fvd_p1-eng
$ extract-bsp
$ make -j8 && pack
The pack command is to generate the firmware. If the compilation and packaging process passes successfully, the following message will be prompted:
Dragon execute image.cfg SUCCESS !
image is at----------
OrangePi_Lite2/lichee/tools/pack/sun50iw6p1_android_petrel-p1_uart0.img
pack finish
According to the prompt, you can see the generated Android firmware sun50iw6p1_android_petrel-p1_uart0.img in the OrangePi_Lite2 / lichee / tools / pack / directory. Below, please refer to the "Android Firmware Burning" section to complete the Android firmware burning.
Linux compilation environment setup
Get the Linux SDK source code from Github
(1)Orange Pi Linux Source Downloader
Orange Pi lite2's Linux source code has been uploaded to GitHub. The currently supported kernel version is Linux 4.9 and the mainline kernel (some drivers are still under development). We can use the Orange Pi Linux source downloader to download and obtain the downloader source code. Here's how:
$ sudo apt-get install git
$ git clone https://github.com/orangepi-xunlong/OrangePi_Build.git
$ cd OrangePi_Build
$ ls
Build_OrangePi.sh lib README.md
(2)Run the downloader
$ ./Build_OrangePi.sh
Enter the root password and press enter
Select 0 Build system with uboot / kernel / rootfs / image to enter the interface of development board model selection.
Select orange pi lite2, enter the kernel version selection interface after entering
At present, the orangepi lite2 development board supports the kernel code of Linux 4.9 and mainline. Select one of them and press Enter to start downloading the corresponding SDK source code.
The downloaded source code will be stored in the same directory of OrangePi_Build
$ ls ../OrangePi_Build -l OrangePi_Build
OrangePiH6_Linux4.9 (Where the kernel version is Linux4.9)
OrangePiH6_mainline (The current kernel version is Linux5.3.5)
Get the source code of Linux SDK from Baidu Cloud Disk
If GitHub fails to download the code, you can download the source code compression package of Linux SDK directly from Baidu Cloud Disk.
Download link is:
http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/details/Orange-Pi-Lite-2.html
Build a compilation environment
The Orange Pi H6 Linux SDK has only been tested on PCs with Ubuntu 18.04. Please prepare the host environment of ubuntu 18.04 before use.
The Linux source directory structure for Orange Pi H6 is shown below:
$ cd OrangePiH6_Linux4.9
$ tree -L 1
.
├── build.sh -> scripts/build.s Compile startup script
├── external Store additional configuration files
├── kernel Linux kernel source
├── output Store output files, only generated after compiling source code
├── scripts Script files used during compilation
├── toolchain Cross-compilation toolchain used by the kernel and u-boot
└── uboot Store boot0 and u-boot source code
6 directories, 1 file
Compile Linux and U-boot source code
(1) Execute compile startup script
$ cd OrangePiH6_Linux4.9
$ sudo ./build.sh
Select OrangePi lite2 and press Enter
The functions of each option are as follows:
- 0 Build Release Image —— Compile ubuntu or debian distribution images
- 1 Build Rootfs —— Compile rootfs for ubuntu or debian
- 2 Build Uboot —— Compile boot0 and u-boot source code
- 3 Build Linux —— Compile Linux kernel source code
- 4 Build Module only —— Compile Linux kernel modules
- 5 Update kernel Image —— Update kernel in SD card Linux system
- 6 Update Module —— Update the kernel module in SD card Linux system
- 7 Update Uboot —— Update boot0 and u-boot and dtb configuration of SD card Linux system
The final file generated by the compilation will be saved in the output directory
$ cd output
$ tree -L 2
.
├── images //Generated image file
│ └──
OrangePi_lite2_ubuntu_xenial_server_linux4.9.118_v2.0.2.img
├── kernel //Compile the generated kernel│
── uImage_lite2
├── rootfs //Compile the generated rootfs
├── uboot //Compile the generated uboot image
│ ├── boot0_sdcard_sun50iw6p1.bin
│ ├── H6.dtb
│ └── u-boot-sun50iw6p1.bin
└── xenial_arm64_server_rootfs.tar.gz
Linux SDK usage example
The following will fully demonstrate the use of the Linux SDK by adding a rtl8812AU USB WIFI kernel module to the kernel source.
(1)Get the source code of rtl8812AU from github
$ cd OrangePiH6_Linux4.9/kernel/drivers/net/wireless
$ git clone https://github.com/diederikdehaas/rtl8812AU.git
Cloning into 'rtl8812AU'...
remote: Counting objects: 2347, done.
Receiving objects: 100% (2347/2347), 7.87 MiB | 22.00 KiB/s, done.
Resolving deltas: 100% (1292/1292), done.
Checking connectivity... done.
(2)Add rtl8812AU configuration
$ cd OrangePiH6_Linux4.9/kernel/drivers/net/wireless
$ git diff .
diff --git a/drivers/net/wireless/Kconfig b/drivers/net/wireless/Kconfig
index 373666b..b7ebd5c 100755
--- a/drivers/net/wireless/Kconfig
+++ b/drivers/net/wireless/Kconfig
@@ -294,4 +294,5 @@ source "drivers/net/wireless/rtl8192eu/Kconfig"
+source "drivers/net/wireless/rtl8812AU/Kconfig" endif # WLAN
diff --git a/drivers/net/wireless/Makefile
b/drivers/net/wireless/Makefile
index fd8a466..3aef800 100755
--- a/drivers/net/wireless/Makefile
+++ b/drivers/net/wireless/Makefile
@@ -66,3 +66,4 @@ obj-$(CONFIG_XR_WLAN) += xradio/
+obj-$(CONFIG_RTL8812AU) += rtl8812AU/
(3)Select Realtek 8812A USB WiFi in the kernel configuration and compile it into a kernel module
(4)Recompile the kernel according to the method in `` Compiling Linux and U-boot Source
Partially compiled log looks like this:
Start Compile.....
Start Compile Module
CC [M] drivers/net/wireless/rtl8812AU/core/rtw_cmd.o
CC [M] drivers/net/wireless/rtl8812AU/core/rtw_security.o
CC [M] drivers/net/wireless/rtl8812AU/core/rtw_debug.o
CC [M] drivers/net/wireless/rtl8812AU/core/rtw_io.o
CC [M] drivers/net/wireless/rtl8812AU/core/rtw_ioctl_query.o
CC [M] drivers/net/wireless/rtl8812AU/core/rtw_ioctl_set.o
After compiling, you can find the compiled kernel module in output / lib / modules / 4.9.118 + / kernel / drivers / net / wireless / rtl8812AU
$ cd output/lib/modules/4.9.118+/kernel/drivers/net/wireless/rtl8812AU
$ ls
8812au.ko
(5)Update the kernel module
First, insert the SD card that has been burned with Linux firmware into a PC used
to compile Linux source code (physical or virtual machine with Ubuntu 18.04 installed). After the system recognizes and successfully mounts the inserted SD card, we can / media / $ LOGNAME see the name of the corresponding partition.
$ cd /media/$LOGNAME
$ ls
BOOT Store the kernel
rootfs Root file system
Then choose 6 Update Module to update the kernel module according to the instructions in the section `` Compiling Linux and U-boot Source
Next, you can start the system through the SD card and use the new 8812au.ko kernel module to drive the USB WIFI network card.
Android firmware burning
Android firmware cannot be written to the TF card via the dd command in Linux or the Win32 Diskimager tool in Windows. Need to use the tool PhoenixCard to write, PhoenixCard current latest version is PhoenixCard V4.1.2, can be downloaded from the official tool on the official website download page.
Android firmware burning steps
(1)Format TF card
Check whether the inserted TF card is consistent with the selected drive letter, click the "Restore Card" button to start formatting the TF
(2)Then select firmware, select boot card.
Please note the red mark in the picture below:
(3)Click "Burn Card" to start writing to the TF card and wait for the burning to complete.
After the Android firmware is successfully programmed, click the "Close" button, and then you can insert the TF card into the development board to start the system
Linux firmware burning
We can burn the Linux firmware of Orange Pi Lite 2 into the TF card through Etcher. Since Orange Pi Lite 2 has no on-board eMMC, we can only start the system through TF. Etcher supports the following operating systems:
- Linux (most distributions, such as Ubuntu)
- MacOS 10.9 and later
- Windows 7 and later
The Etcher software installation package can be downloaded from its official website https://etcher.io/, or it can be downloaded from the official tools on the official download page of Orange Pi Lite 2.
How to install Etcher
- The installation method of Etcher in Windows is the same as that of ordinary software
- Etcher is installed on Ubuntu and Debian systems as follows
1.Add Etcher Debian repository:
$ echo "deb https://dl.bintray.com/resin-io/debian stable etcher" | sudo tee /etc/apt/sources.list.d/etcher.list
2.Download the key
$ sudo apt-key adv --keyserver hkp://pgp.mit.edu:80 --recv-keys 379CE192D401AB61
3.Update and install
$ sudo apt-get update && sudo apt-get install etcher-electron
4.Uninstallation method
$ sudo apt-get remove etcher-electron
$ sudo rm /etc/apt/sources.list.d/etcher.list && sudo apt-get update
How to flash Linux firmware through Etcher
(1)First open Etcher, its interface is shown below
(2)Then use "Select image" to select the Linux firmware to be burned
(3)Then insert the TF card, Etcher will automatically identify the corresponding drive
(4)Finally, click “Flash!” To start burning. After burning, you can insert the development board to start the system.
Instructions for use of Linux system
Linux boot light description
After booting, the on board LED light will first light up red, then the red light will turn off, and the yellow light will stay on.
Login account and password
Username root, password: orangepi
Username orangepi, password: orangepi
extend rootfs partition
After the system operating card is prepared, the rootfs partition of the file system should be expanded immediately. This will greatly improve the performance of the system and avoid various complicated problems caused by insufficient space.
We can use the system's built-in script resize_rootfs.sh to expand the capacity after entering the system:
The amount of free space in the system before expansion
root@OrangePi:~# df -h
Filesystem | Size | Used | Avail | Use% | Mounted on |
/dev/mmcblk0p2 | 1.1G | 520M | 488M | 52% | / |
devtmpfs | 481M | 0 | 481M | 0% | /dev |
tmpfs | 489M | 0 | 489M | 0% | /dev/shm |
tmpfs | 489M | 6.6M | 489M | 2% | /run |
tmpfs | 5.0M | 4.0K | 5.0M | 1% | /run/lock |
tmpfs | 489M | 0 | 489M | 0% | /sys/fs/cgroup |
/dev/mmcblk1p1 | 50M | 29M | 22M | 58% | /boot |
Run the built-in expansion script
root@OrangePi:~# resize_rootfs.sh
The amount of space available in the system after the expansion
root@OrangePi:~# df -h
Filesystem | Size | Used | Avail | Use% | Mounted on |
/dev/mmcblk0p2 | 7.2G | 539M | 6.4G | 8% | / |
devtmpfs | 481M | 0 | 481M | 0% | /dev |
tmpfs | 489M | 0 | 489M | 0% | /dev/shm |
tmpfs | 489M | 13M | 477M | 3% | /run |
tmpfs | 5.0M | 4.0K | 5.0M | 1% | /run/lock |
tmpfs | 489M | 0 | 489M | 0% | /sys/fs/cgroup |
/dev/mmcblk1p1 | 50M | 29M | 22M | 58% | /boot |
Recording playback test method
Note: The Audio Codec audio driver for the mainline kernel is not yet available
(1)Test recording function
root@orangepilite2:~# arecord -d 10 -f cd -D hw:1,0 -t wav Test.wav Recording
WAVE 'Test.wav' : Signed 16 bit Little Endian, Rate 44100 Hz,
Stereo
root@orangepilite2:~#
(2)Test the HDMI playback function, just use the aplay command to play
root@orangepilite2:~# aplay Test.wav
WIFI configuration method
Add the following configuration to / etc / network / interface and restart
auto wlan0
iface wlan0 inet dhcp
wpa-ssid orangepi //Fill in the WIFI account here(orangepi)
wpa-psk orangepi //Fill in the WIFI password here(orangepi)
Introduction to serial debugging tools
First you need to prepare a USB to TTL serial cable similar to the picture below:
Connect the serial cable as shown in the figure below. From the silk screen on the back of the board, you can see that the corresponding functions of the different colors are as follows
- Black—GND
- Green-RX
- White-TX
Use on Windows platform
In the process of using OrangePi for project development, in order to obtain more debugging information, OrangePi supports serial port information debugging by default. For developers, they only need to prepare the materials mentioned above to get serial debugging information. The serial debugging tools used by different host computers are similar. Basically, you can refer to the methods below to deploy. There are many tools for serial debugging on the Windows platform. The commonly used tool is putty. This section uses putty as an example to explain deployment.
(1)Install USB driver
Download the latest driver PL2303_Prolific_DriverInstaller_v130.zip, download and unzip.
Select application installation as administrator
Wait for the installation to complete
(2)Download and install Putty
Putty can be downloaded from the following address, please choose the version suitable for your development environment.
https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
Double-click the downloaded putty.exe directly to open putty. The software interface is shown in the figure below.
(3)Acquisition of equipment information
In Windows 7, we can check whether the serial port connection is normal and the device number of the serial port through the device manager. If the device is not recognized properly, please check if the driver is successfully installed. If there is a problem with the driver installation, you can try to scan and install the driver using 360 Driver Master.
(4)Putty configuration
Set the serial port to the corresponding port number (COM4), disable flow control, and set the speed to 115200
(5)Start debugging serial output
OrangePi is powered on and putty will automatically print serial port log information
Use on Linux platform
There is not much difference between using putty on the Linux platform and the Windows platform. The following mainly describes the operation steps where there are differences. All operations are based on Ubuntu 14.04 system.
(1)Install and launch Putty
$ sudo apt-get install putty
$ sudo putty
(2)Configure Putty
The serial number can be viewed through ls / dev / ttyUSB *
Baud rate needs to be set to 115200
And turn off flow control
History
Ver | Data | Author | Brief | Publish | Memo |
1.0 | 2018-05-07 | Leeboby | Create Files | ||
1.0 | 2019-7-10 | Leeboby | Update audio instructions | ||
1.0 | 2019-12-16 | Leeboby | |||
Download the Orange Pi Lite 2 User Manual
For more information on using the Orange Pi Lite 2, please see the Orange Pi Lite 2 User Manual. (Click to download)