Clean up and correct vim3 documentation

content/boards/meson-g12b-s922x-khadas-vim3.md → content/boards/meson-g12b-a311d-khadas-vim3.md

@@ -2,14 +2,13 @@
 title: Khadas VIM3 Pro
 ---
 
-This document provides information needed for adding Khadas' VIM3 Pro boards to the LAVA lab.
-
-https://www.khadas.com/vim3
+This document provides information needed for adding [Khadas' VIM3 Pro](https://www.khadas.com/vim3) boards to the LAVA lab.
 
 Note that this isn't about the VIM3 Basic board, which has less memory (2GB vs 4GB RAM and 16GB vs. 32GB eMMC).
 
 Specification:
-* Amlogic A311D 2.2GHz Quad core ARM Cortex-A73 and 1.8GHz dual core Cortex-A53 CPU
+* Amlogic A311D SoC
+* 2.2GHz Quad core ARM Cortex-A73 and 1.8GHz dual core Cortex-A53 CPU
 * 4GB of RAM
 * ARM Mali G52 MP4 GPU 800MHz
 * 1 USB 3.0 port (USB-A)
@@ -17,6 +16,7 @@ Specification:
 * 1 USB 2.0 port (USB-C) with power delivery (5-20V input)
 * 1 RJ-45 port
 * 40-Pin GPIO which includes pins for the SoC UART
+* 32GB eMMC
 
 This board is available from [Khadas' store](https://www.khadas.com/product-page/vim3).
 
@@ -24,13 +24,19 @@ This board is available from [Khadas' store](https://www.khadas.com/product-page
 
 The VIM3 can be powered via the USB-C port (5-20V input).
 
-It can also be powered via the VIN port on the back of the board, with a standard 4 circuit, Molex 78172-0004 connector (5-12V input). See vim3_interfaces_bottom.jpg in this repository.
+It can also be powered via the VIN port on the back of the board, with a
+standard 4 circuit, Molex 78172-0004 connector (5-12V input):
+
+![Vim3 bottom interface](/img/vim3_interfaces_bottom.jpg)
 
 ### Low-level boot control
 
-Baud rate: 115200 8n1
-Voltage: 3.3V TTL
-Pins: 18 is Linux_RX, 19 is Linux_TX: See SerialConnections_3Pin.jpg in this repository.
+
+- Baud rate: 115200 8n1
+- Voltage: 3.3V TTL
+- Pins: 17 is GND, 18 is Linux\_RX, 19 is Linux\_TX on the 40 pin extension header
+
+![Serial pinout](/img/vim3_SerialConnections_3Pin.jpg)
 
 #### Network connectivity
 
@@ -40,30 +46,22 @@ A random MAC address is generated if there's none defined in the environement. T
 
 ### Bootloader
 
-* Boot with the serial cable connected
-* On the terminal emulator interrupt the boot by pressing any key after U-Boot has started
-* Type `setenv bootdelay -1`
-* Type `saveenv`
+The Vim3 boards come with u-boot preflashed which includes networking support
+so can be used for lava out of the box.
 
 The bootloader resides in the 16MB SPI-Flash on board (not verified).
 
 These are the memory addresses to load the boot artifacts into:
-
+```
 {% set bootm_kernel_addr = '0x01080000' %}
 {% set bootm_dtb_addr = '0x01070000' %}
 {% set bootm_ramdisk_addr = '0x08000000' %}
+```
 
 ### Health checks
 
-To build a suitable kernel:
-
-* git clone https://github.com/bbrezillon/linux.git && cd linux && git checkout panfrost-vim3-working
-* make ARCH=arm64 CROSS_COMPILE=... vim3_deconfig
-* make ARCH=arm64 CROSS_COMPILE=... Image dtbs
-
-Copy Image and meson-g12b-s922x-khadas-vim3.dtb to your tftp dir.
-
-By the time Linux 5.9 is released, support for the on-board ethernet should be in mainline (should work out of the box with arm64_defconfig).
+The board is supported in the upstream Linux kernel starting from at least
+linux 5.8. Board dtb is: `amlogic/meson-g12b-a311d-khadas-vim3.dtb`
 
 ### Lab notes and trouble shooting