Skip to content

Commit

Permalink
Update docs
Browse files Browse the repository at this point in the history
Add GPU tests to test_report.md
Add some demos to application.md
Update desktop.md, images.md and burn_image.md
  • Loading branch information
wu-yue-yu committed Jul 28, 2023
1 parent 45c1dac commit 057695f
Show file tree
Hide file tree
Showing 23 changed files with 696 additions and 62 deletions.
62 changes: 62 additions & 0 deletions docs/hardware/en/lichee/th1520/lpi4a/10_test_report.md
Original file line number Diff line number Diff line change
Expand Up @@ -141,6 +141,68 @@ Fishbowl test in Chromium with results as shown:

![web_browser_fishbowl](./../../../../zh/lichee/th1520/lpi4a/assets/test_report/web_browser_fishbowl.png)

## GPU

The test results using `glmark2` are as follows:
```shell
root@lpi4a:~# glmark2-es2
==================================================== =====
glmark2 2021.12
==================================================== =====
OpenGL Information
GL_VENDOR: Imagination Technologies
GL_RENDERER: PowerVR B-Series BXM-4-64
GL_VERSION: OpenGL ES 3.2 build 1.16@6099580
Surface Config: buf=32 r=8 g=8 b=8 a=8 depth=24 stencil=8
Surface Size: 800x600 windowed
==================================================== =====
[build] use-vbo=false: FPS: 460 FrameTime: 2.174 ms
[build] use-vbo=true: FPS: 434 FrameTime: 2.304 ms
[texture] texture-filter=nearest: FPS: 489 FrameTime: 2.045 ms
[texture] texture-filter=linear: FPS: 493 FrameTime: 2.028 ms
[texture] texture-filter=mipmap: FPS: 776 FrameTime: 1.289 ms
[shading] shading=gouraud: FPS: 1055 FrameTime: 0.948 ms
[shading] shading=blinn-phong-inf: FPS: 1049 FrameTime: 0.953 ms
[shading] shading=phong: FPS: 832 FrameTime: 1.202 ms
[shading] shading=cel: FPS: 781 FrameTime: 1.280 ms
[bump] bump-render=high-poly: FPS: 481 FrameTime: 2.079 ms
[bump] bump-render=normals: FPS: 1056 FrameTime: 0.947 ms
[bump] bump-render=height: FPS: 730 FrameTime: 1.370 ms
[effect2d] kernel=0,1,0;1,-4,1;0,1,0;:1 FPS: 456 FrameTime: 2.193 ms
[effect2d] kernel=1,1,1,1,1;1,1,1,1,1;1,1,1,1,1;:2 FPS: 184 FrameTime: 5.435 ms
[pulsar] light=false:quads=5:texture=false: FPS: 585 FrameTime: 1.709 ms
[desktop] blur-radius=5:effect=blur:passes=1:separable=true:windows=4: FPS: 177 FrameTime: 5.650 ms
[desktop] effect=shadow:windows=4: FPS: 405 FrameTime: 2.469 ms
[buffer] columns=200:interleave=false:update-dispersion=0.9:update-fraction=0.5:update-method=map: FPS: 135 FrameTime: 7.407 ms
[buffer] columns=200:interleave=false:update-dispersion=0.9:update-fraction=0.5:update-method=subdata: FPS: 160 FrameTime: 6.250 ms
[buffer] columns=200:interleave=true:update-dispersion=0.9:update-fraction=0.5:update-method=map: FPS: 197 FrameTime: 5.076 ms
[ideas] speed=duration: FPS: 442 FrameTime: 2.262 ms
[jellyfish] <default>: FPS: 433 FrameTime: 2.309 ms
[terrain] <default>: FPS: 31 FrameTime: 32.258 ms
[shadow] <default>: FPS: 275 FrameTime: 3.636 ms
[refract] <default>: FPS: 45 FrameTime: 22.222 ms
[conditionals] fragment-steps=0:vertex-steps=0: FPS: 775 FrameTime: 1.290 ms
[conditionals] fragment-steps=5:vertex-steps=0: FPS: 484 FrameTime: 2.066 ms
[conditionals] fragment-steps=0:vertex-steps=5: FPS: 819 FrameTime: 1.221 ms
[function] fragment-complexity=low:fragment-steps=5: FPS: 1048 FrameTime: 0.954 ms
[function] fragment-complexity=medium:fragment-steps=5: FPS: 694 FrameTime: 1.441 ms
[loop] fragment-loop=false:fragment-steps=5:vertex-steps=5: FPS: 1093 FrameTime: 0.915 ms
[loop] fragment-steps=5:fragment-uniform=false:vertex-steps=5: FPS: 678 FrameTime: 1.475 ms
[loop] fragment-steps=5:fragment-uniform=true:vertex-steps=5: FPS: 438 FrameTime: 2.283 ms
=========================================================
glmark2 Score: 551
=========================================================
```

![gpu_test_glmark2](./../../../../zh/lichee/th1520/lpi4a/assets/test_report/gpu_test_glmark2.png)

Running `glxgears` results in the following:
```shell
es2gears_x11
```

![gpu_test_gears](./../../../../zh/lichee/th1520/lpi4a/assets/test_report/gpu_test_gears.png)

## Other

Contributions are welcome~ You can get ¥5~150 ($1~20) coupon if your contribution is accepted!
13 changes: 7 additions & 6 deletions docs/hardware/en/lichee/th1520/lpi4a/3_images.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,8 +56,8 @@ ISCAS mirror: [click me](https://mirror.iscas.ac.cn/revyos/extra/images/lpi4a/)
- Known issues:
- There is a problem with the sound quality of HDMI audio playing under chromium
- Instructions for use:
- This compressed package only supports HDMI display, please pay attention to the boot suffix and device correspondence when burning
- 8gddr/16gddr corresponds to 8g/16g memory respectively
- This zip file only supports HDMI display, when burning, please note that the suffix in the file name corresponds to the relevant parameters of the device.
- boot, 8gddr/16gddr in the u-boot file name corresponds to 8g/16g memory respectively.

2. LPI4A_20230721_mipi.zip

Expand All @@ -82,9 +82,9 @@ ISCAS mirror: [click me](https://mirror.iscas.ac.cn/revyos/extra/images/lpi4a/)
- Switch to root user, execute `echo brightness value (integer value from 0-7) > /sys/class/backlight/pwm-backlight@0/brightness`
- There is a problem with the sound quality of HDMI audio playing under chromium
- Instructions for use:
- The compressed package is an image that supports MIPI screen, please pay attention to the boot suffix and device correspondence when burning
- 8gddr/16gddr correspond to 8g/16g memory respectively
- mipi_720p/mipi_1080p correspond to 800x1280 MIPI screen (with touch)/1200x1920 mipi screen respectively
- This zip file is the image of the MIPI screen, please note that the suffix in the file name corresponds to the relevant parameters of the device when burning.
- 8gddr/16gddr in the boot and u-boot file names correspond to 8g/16g memory respectively.
- mipi_720p/mipi_1080p in the boot file name corresponds to 800x1280 MIPI screen (with touch)/1200x1920 mipi screen respectively.

<!-- 1. LPi4A_Test_0425
1. Release date: April 25, 2023
Expand Down Expand Up @@ -141,7 +141,8 @@ Readme and image download address: [Link](https://github.com/aiminickwong/lichee
![openKylin](./../../../../zh/lichee/th1520/lpi4a/assets/images/openkylin.png)
![oepnkylin_neofetch](./../../../../zh/lichee/th1520/lpi4a/assets/images/oepnkylin_neofetch.png)

Readme and image download link: [Click me](https://github.com/aiminickwong/licheepi4a-images)
Readme link: [Click me](https://github.com/aiminickwong/licheepi4a-images)
[openKylin V1.0 Download address](https://www.openkylin.top/downloads/index-cn.html)

### armbian

Expand Down
21 changes: 10 additions & 11 deletions docs/hardware/en/lichee/th1520/lpi4a/4_burn_image.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ update:
### Download an image

Refer to the previous chapter "Images" to find the desired image.
The image burning method below uses the Debian image `LPi4A_Test_0425.7z` as an example .
The following burning method takes Debian single-screen image `LPI4A_20230721.zip`, 16+128 core board as an example.

### Get the burning tool
The burning tool can be obtained from the Mega cloud disk and is found in the `burn_tool.zip` file.
Expand Down Expand Up @@ -74,32 +74,31 @@ After putting the board into burning mode, you can use fastboot from `burn_tool.
Let´s take linux as an example:
Note that you need to mark the fastboot binary as executable first via `chmod +x fastboot`

`u-boot-with-spl-ddr8g.bin` and `u-boot-with-spl-ddr16g.bin` are u-boot firmware, please refer to the image description for specific differences.
```bash
sudo ./fastboot flash ram ./images/u-boot-with-spl.bin
sudo ./fastboot flash ram ./images/u-boot-with-spl-ddr16g.bin
sudo ./fastboot reboot
sleep 10
sudo ./fastboot flash uboot ./images/u-boot-with-spl.bin
sudo ./fastboot flash boot ./images/boot.ext4
sudo ./fastboot flash root ./images/rootfs.ext4
sudo ./fastboot flash uboot ./images/u-boot-with-spl-ddr16g.bin
sudo ./fastboot flash boot ./images/boot_16gddr.ext4
sudo ./fastboot flash root ./images/rootfs-thead-image-linux_sing.ext4.ext4
```

The first three lines will check and create the partitions on the flash. If you skip this step,
burning the rootfs will be very slow later on.

`boot.ext4` contains the following content:

`boot_8gddr.ext4`, `boot_8gddr_mipi_720p.ext4`, `boot_8gddr_mipi_1080p.ext4`, `boot_16gddr.ext4`, `boot_16gddr_mipi_720p.ext4` and `boot_16gddr_mipi_1080p.ext4` for boot For specific differences, please refer to the image description. They mainly include the following:
```bash
fw_dynamic.bin #opensbi
Image #kernel image
kernel-release #commit id of kernel
light_aon_fpga.bin #fw for E902 aon
light_c906_audio.bin #fw for C906 audio
light-lpi4a.dtb #1.85GHz dtb
light-lpi4a_2Ghz.dtb #2GHz overclock dtb
light-lpi4a-ddr2G.dtb #history dtb
light-lpi4a.dtb # ddr8G dtb
light-lpi4a-ddr16g.dtb # ddr16G dtb
```

`rootfs.ext4` is the root filesystem, the default is a debian system.
`rootfs-thead-image-linux_sing.ext4` and `rootfs-thead-image-linux_mipi.ext4` are the root file system, and the default is Debian system. For the specific differences between the two, please refer to the image description.

Log output you typically see while burning an image:

Expand Down
15 changes: 14 additions & 1 deletion docs/hardware/en/lichee/th1520/lpi4a/5_desktop.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ By default, the sources are listed in the `/etc/apt/sources.list` file, but you

Use `sudo apt update` to update the software list, which is usually needed after changing sources.

Before using this command, check the time with the ``date`'' command. If the time is incorrect, you can manually update it to make sure that the packages in the source are up to date:
Before using this command, check the time with the `date` command. If the time is not correct or the time is not updated automatically after connecting to the network, you can update it manually to make sure that the packages in the repository are the latest versions:
```shell
sudo date -s "20230717 12:00:00"
```
Expand Down Expand Up @@ -449,5 +449,18 @@ The effect displayed is as follows:

![vnc_viewer_use](./../../../../zh/lichee/th1520/lpi4a/assets/desktop/vnc_viewer_use.png)

## btop

Btop is an aesthetically pleasing resource that displays processor, memory, disk, network, and process usage and statistics.

It can be installed using the following command:
```shell
sudo apt install btop
```

Then run the `btop` command on the command line to use it, the effect is as follows:

![btop_use](./../../../../zh/lichee/th1520/lpi4a/assets/application/btop_use.png)

## More
Contributions are welcome~ You can get ¥5~150 ($1~20) coupon after your submission is accepted!
16 changes: 13 additions & 3 deletions docs/hardware/en/lichee/th1520/lpi4a/6_peripheral.md
Original file line number Diff line number Diff line change
Expand Up @@ -496,7 +496,7 @@ Check the corresponding ID of the touch screen device
```shell
xinput
```
! [list_touchsreen](. /assets/peripheral/list_touchsreen.png)
![list_touchsreen](./../../../../zh/lichee/th1520/lpi4a/assets/peripheral/list_touchsreen.png)
Here you can see that it is a touch screen device Goodix 7, then enter the following command to map the touch device to the correct screen:
```shell
xinput map-output-of 7 DSI-1
Expand All @@ -514,9 +514,19 @@ echo off > /sys/class/drm/card0-DSI-1/status

## GPU

`sudo watch cat /sys/kernel/debug/pvr/status`
Use the following command to view the status of the GPU in real time:
```shell
sudo watch cat /sys/kernel/debug/pvr/status
```

Under the xfce desktop, the status of the GPU is as follows:

![gpu_status_desktop](./../../../../zh/lichee/th1520/lpi4a/assets/peripheral/gpu_status_desktop.png)

When playing video with Chromium browser, the state of GPU is as follows:

![gpu_status_play_video](./../../../../zh/lichee/th1520/lpi4a/assets/peripheral/gpu_status_play_video.png)

TODO
## NPU

TODO
Expand Down
10 changes: 0 additions & 10 deletions docs/hardware/en/lichee/th1520/lpi4a/7_develop_andriod.md

This file was deleted.

Loading

0 comments on commit 057695f

Please sign in to comment.