Merge branch 'main' of github.com:sipeed/sipeed_wiki

docs/hardware/en/kvm/NanoKVM/faq.md

@@ -2,6 +2,38 @@
 title: F&Q
 keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool
 ---
+## Abnormal repair
++ Unable to obtain IP address
+    1. Lite users need check if there is a card inserted. The Lite version is shipped without a card by default and requires users to bring their own TF card. Follow [here]（ https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/flashing.html ）Please retry after burning the card;
+    2. Check if the network switch supports 100M connection. Some new switches do not support 100M connection. Please replace the switch and try again
+    3. Try replacing the power supply, some power supplies may cause NanoKVM to not obtain IP or affect network speed
++ After logging into the browser interface, there is no screen
+    1. Ensure that HDMI has an output signal and unplug and plug the HDMI cable again
+    2. Enter the web terminal and execute `/etc/init.d/S95nanokvm restart` to restart the service.
+    3. If the above methods cannot restore normal operation, click on the "Check for Updates" button on the interface to update the application
+    4. The early internal testing version of Full NanoKVM used a regular ribbon cable to connect to the HDMI acquisition board, which may not detect HDMI signals due to poor contact. It can be disassembled as shown in the following figure and reconnected to the ribbon cable
+    ![](./../../../assets/NanoKVM/guide/Old_fix.png)
++ OLED displays information normally, but cannot open web pages
+    1. Reference [here](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/updating.html#%E8%8E%B7%E5%8F%96-IP) Connection Development Board
+    2. Enter the command `rm /etc/kvm/server.yaml`
+    3. Execute `reboot` to restart the system
++ Early beta version of Full NanoKVM ATX small board connected to the host RESET pin. When restarting NanoKVM, the host may be restarted. Please disconnect the RESET jumper
++ Early beta version of Full NanoKVM had a current backflow issue: when the host was turned off and there was no power output from the USB, the current would backflow into the host when connected to an auxiliary power supply
+    1. Firstly, it is recommended to set the USB to maintain power supply after the host is turned off
+    2. Full version users: Use an electric soldering iron to disconnect the 5V resistor or pin short-circuit at the position shown in the figure, and only use the auxiliary power supply port for power supply
+    ![](./../../../assets/NanoKVM/guide/fix2.png)
++ Attempt to power off and restart to solve unknown issues
++ If there are abnormal situations such as network disconnection during the update process, it may cause the update to fail. If the old application cannot be started, please refer to the following solutions:
+    1. Reference [here](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/updating.html#%E8%8E%B7%E5%8F%96-IP) Connection Development Board
+    2. Execute `rm -r /kvmapp && cp -r /root/old/ / && mv /old/kvmapp`
+    3. Execute `reboot` to restart the system
+    4. Re burn the system
+    5. Manual update: You can download and execute Python update scripts to manually complete the update process
+        1. Download [update-nanokvm.py.zip](https://github.com/user-attachments/files/16939944/update-nanokvm.py.zip) And decompress
+        2. Execution: `python update-nanokvm.py`
+        3. Wait for the update to complete
++ If the above methods cannot solve the exception, please raise your question in the forum, GitHub or QQ group, and we will patiently answer it
+
 ## Feedback
 * MaixHub Forum：https://maixhub.com/discussion/nanokvm
 * GitHub ：https://github.com/sipeed/NanoKVM

docs/hardware/en/kvm/NanoKVM/introduction.md

@@ -20,7 +20,7 @@ update:
 
 The Lichee NanoKVM is an IP-KVM product based on the LicheeRV Nano, inheriting its compact size and powerful features.
 
-NanoKVM includes an HDMI input interface that can be recognized as a monitor by a computer, capturing the computer's screen. It has a USB 2.0 interface to connect to the computer host, recognized as HID devices like keyboard, mouse, and touchpad, and uses extra storage space on the TF card, mounted as a USB flash drive. It comes with a 100 Mbps Ethernet port for video and control signal transmission. Additionally, the Full version features an ATX power control interface (USB-C form) for remote control and monitoring of the host's power status. Under the Full version's shell, there is an OLED display for showing the device's IP and KVM-related status.
+NanoKVM includes an HDMI input interface that can be recognized as a monitor by a computer, capturing the computer's screen. It has a USB 2.0 interface to connect to the computer host, recognized as HID devices like keyboard, mouse, and touchpad, and uses extra storage space on the Micro SD card, mounted as a USB flash drive. It comes with a 100 Mbps Ethernet port for video and control signal transmission. Additionally, the Full version features an ATX power control interface (USB-C form) for remote control and monitoring of the host's power status. Under the Full version's shell, there is an OLED display for showing the device's IP and KVM-related status.
 
 To meet different user needs, NanoKVM is available in two versions:
 - **NanoKVM Lite**: Basic version suitable for DIY enthusiasts and enterprises with bulk requirements.
@@ -53,11 +53,12 @@ To meet different user needs, NanoKVM is available in two versions:
 | Tailscale | ✓ | ✓ | ✓ |
 | WebSSH | ✓ | ✓ | ✓ |
 | Custom Scripts | ✓ | ✓ | - |
+| ETH | 100M/10M | 100M/10M | 1000M/100M/10M |
 | ATX Power Control | None, user-configurable | USB interface IO control board | RJ45 interface IO control board |
 | OLED Display | None, user-expandable | 128x64 0.96" white | 128x32 0.91" white |
 | Serial Terminal | 2 channels | 2 channels | - |
-| TF Card | None, user-provided | Included, ready to use | Included |
-| Expansion Accessories | None | WiFi or PoE | WiFi/LTE |
+| Micro SD Card | None, user-provided | Included, ready to use | Included |
+| Expansion Accessories | None | PoE | WiFi/LTE |
 | Power Consumption | 0.2A@5V | 0.2A@5V | Peak 2.6A@5V |
 | Power Input | Powered by PC USB | Powered by PC USB <br> Supports auxiliary power | Requires DC 5V 3A |
 | Cooling | Silent, fanless | Silent, fanless | Requires active fan cooling |
@@ -78,7 +79,7 @@ NanoKVM Lite consists of the LicheeRV Nano E and HDMItoCSI board, while NanoKVM
 ## Purchase Links
 
 [Official Taobao Store](https://item.taobao.com/item.htm?id=811206560480)
-[AliExpress Store]()
+[AliExpress Store](https://www.aliexpress.com/item/1005007369816019.html)
 [Pre-sale Page](https://sipeed.com/nanokvm)
 
 ## Product Feedback

docs/hardware/en/kvm/NanoKVM/quick_start.md

@@ -23,7 +23,7 @@ The Full version includes NanoKVM (with case, with card), KVM-B board, 2 USB A t
 
 ![](./../../../assets/NanoKVM/unbox/lite_ubox.png)
 
-The Lite version includes NanoKVM (without case and TF card) and a heatsink.
+The Lite version includes NanoKVM (without case and Micro SD card) and a heatsink.
 
 ## Interface Introduction
 
@@ -65,16 +65,20 @@ The wiring diagram for the NanoKVM-Full version is as follows. The Lite version
 
   ![](./../../../assets/NanoKVM/unbox/new-ATX-B.png)
 
+  > Note: The KVM-B board with version number 30132 cannot be directly connected to the pin header on the board with the built-in 9-pin bus header of the chassis, and must be connected with the included male to female cable according to the figure above.
+
   The wiring diagram for the internal test version of the KVM-B board and the host's 9-pin interface is shown below. The double-row headers are interconnected, allowing the connection of the case's power button and Power LED to the other row.
 
+  > Note: In the early stage, the NanoKVM reboot will briefly pull up the RESET control pin, causing the connected computer to restart, in order to avoid this problem, please do not connect the RESET jumper, which has been fixed in the later official version
+
   ![](./../../../assets/NanoKVM/unbox/old-ATX-B.png)
   ![](./../../../assets/NanoKVM/unbox/old-ATX-B-w.png)
 
 ## Updates
 
 ### Update Image
 
-> **The Lite version requires preparing a TF card and flashing the image before use!**
+> **The Lite version requires preparing a Micro SD card and flashing the image before use!**
 
 The Full version comes with a pre-flashed image and can skip this step.
 

docs/hardware/en/kvm/NanoKVM/user_guide.md

@@ -68,10 +68,12 @@ Next, start the installation process by clicking `Power On (Short Press)` and qu
 Note:
 
 + The virtual USB drive feature is enabled by default. If not needed, it can be disabled by clicking `Settings` -> `Virtual USB Drive`.
++ Please eject the original 21G virtual USB flash drive on the host before mounting the image to avoid data loss.
 + The virtual USB drive can also be used as a regular USB drive. If no image is selected in the web interface, the entire 21GB virtual USB drive will be mounted by default.
 + Users can also use the conventional card burning method to burn images, though it's not recommended.
 + The speed of copying images to NanoKVM is limited by USB2.0 transfer speed and SG2002 card writing speed, which may be slow. Users can remove the TF card, insert it into the computer, [unlock the hidden](https://jingyan.baidu.com/article/e4511cf34faece2b845eaf34.html) third partition of the TF card, and directly copy the images into it.
 + The virtual USB drive is also mounted to the `/data` directory of NanoKVM, allowing users to read and write to this partition directly from the NanoKVM terminal.
++ Canceling the virtual USB flash drive operation in the settings will force the USB flash drive to eject the USB flash drive, please eject the USB flash drive safely before setting it up to avoid data loss.
 
 ### Web Terminal
 
@@ -188,4 +190,6 @@ For further assistance and support, visit the NanoKVM [official website](https:/
 
 ---
 
+> Note: The TF card described in this article is a microSD card
+
 End of User Guide.

docs/hardware/en/lichee/K1/lpi3a/3_burn_image.md

@@ -29,6 +29,10 @@ https://www.openkylin.top/downloads/
 ![deepin](./assets/images/deepin.jpg)   
 https://ci.deepin.com/repo/deepin/deepin-ports/cdimage/20240815/riscv64/
 
+### irradium 
+![irradium](./assets/images/irradium.png)   
+https://dl.irradium.org/irradium/images/lichee_pi_3a/
+[mirror 1](https://mirror.serverion.com/irradium/images/lichee_pi_3a/), [mirror 2](https://ftp.cc.uoc.gr/mirrors/linux/irradium/images/lichee_pi_3a/), [mirror 3](https://mirror.accum.se/mirror/irradium.org/images/lichee_pi_3a/)
 
 ## Get burning tools
 LicheePi3A can be burned using fastboot or titan burning tools.

docs/hardware/en/tang/tang-mega-138k/mega-138k-pro.md

@@ -7,6 +7,11 @@ update:
     author: wonder
     content:
       - 新建文档
+  - date: 2024-09-26
+    version: v0.2
+    author: Serika
+    content:
+      - Update FAQs
 ---
 
 - Product Overview
@@ -253,6 +258,10 @@ Example code [github](https://github.com/sipeed/TangMega-138KPro-example)
         <td>Avoid Short Circuit</td>
         <td>Please avoid any liquid or metal touching the solder pads of the components on the PCBA during the power-on process, otherwise it may cause a short circuit and burn the PCBA.</td>
     </tr>
+    <tr>
+        <td>Protecting the die</td>
+        <td>Please avoid any impact on the exposed chip die during the process of removing and installing the heat sink. Do not press the heat sink hard after installing it. Otherwise, the chip die will be damaged.</td>
+    </tr>
 </table>
 
 
@@ -267,5 +276,19 @@ Tang Mega 138K can meet different needs of customers in various scenarios. For t
 1. Please check if the power switch of the board is turned on.
 2. Check your power supply method.
 
+### How to burn the bitstream to FLASH {#burn_flash}
+
+1. Setting the **Programmer** as shown in the figure below:
+
+<img src="./assets/flash_mode.png" alt="flash_mode" width=35%>
+
+### No Response or Undesirable Pin Phenomenon After Burning
+
+1. First, ensure that the IDE has selected the correct model **GW5AST-LV138FPG676AC1/10**; every parameter in the figure below **MUST** be consistent.
+
+<img src="./assets/partno_138K_Pro.png" alt="device_choose" width=35%>
+
+2. Then, check your code and the corresponding simulation waveforms to meet the requirements. The GAO tools in GOWIN IDE maybe helpful. For more information, please refer to the GOWIN document [SUG100](https://www.gowinsemi.com/upload/database_doc/1885/document/660bb2366d0b3.pdf)(require login).
+
 
 ### For more questions and solutions, go to [Related Questions](./../Tang-Nano-Doc/questions.md) to view

docs/hardware/en/tang/tang-mega-138k/mega-138k.md

@@ -2,16 +2,21 @@
 title: Tang Mega 138K Dock
 keywords: FPGA, Tang, Mega, 138K
 update:
-  - date: 06-26-2024
+  - date: 2024-06-26
     version: v0.1
     author: Serika
     content:
       - Create document
+  - date: 2024-09-26
+    version: v0.2
+    author: Serika
+    content:
+      - Corrected description of PCIe bus widths
 ---
 
 ## Overview
 
-  Tang Mega 138K uses a 22nm process **GW5AST-LV138PG484A** FPGA chip, which has 138,240 lookup table units and nearly 300 DSP units. It contains eight high-speed transceivers with a speed range of 270Mbps ~ 6.6Gbps, suitable for transmitting data through high-speed ports such as PCIe. In addition, the chip contains a hard-core PCIe, which consumes better resources when using PCIe and achieves better performance. It is suitable for high-speed communication, protocol conversion, high-performance computing, and other occasions.
+  Tang Mega 138K uses a 22nm process **GW5AST-LV138PG484A** FPGA chip, which has 138,240 lookup table units and nearly 300 DSP units. It contains eight high-speed transceivers with a speed range of 270Mbps ~ 8.0Gbps, suitable for transmitting data through high-speed ports such as PCIe. In addition, the chip contains a hard-core PCIe, which consumes better resources when using PCIe and achieves better performance. It is suitable for high-speed communication, protocol conversion, high-performance computing, and other occasions.
 
   Compared to the 138K Pro Dock, the 138K Dock has a smaller size and a lower price, and it replaces the SFP transceiver with USB3 SS(5Gbps). This not only effectively reduces the cost of high-speed communication but also brings better versatility.
 
@@ -22,8 +27,11 @@ update:
   - Large capacity LUT4
   - Large capacity memory
   - PCIe 2.0 x 4
-  - USB3.0 x 1
-  - RISCV hard core
+  - USB3.0 x 1(5Gbps)
+  - RISC-V hard core (AE350 @800MHz)
+  - HDMI TX/RX x 1
+  - Gigabit Ethernet x 1
+  - Onboard 3.7V li-on battery(1-Series) charge/discharge management
 
 ## Product Appearance
 
@@ -94,19 +102,19 @@ TBD
                     </tr>
                     <tr>
                         <td>Transceivers Rate</td>
-                        <td>270Mbps-6.6Gbps</td>
+                        <td>270Mbps-8.0Gbps</td>
                     </tr>
                     <tr>
                         <td>PCIe HardCore</td>
-                        <td>x1<br>Speed optional x1, x2, x4, x8 PCIe 2.0</td>
+                        <td>x1<br>Speed optional x1, x2, x4 PCIe 3.0</td>
                     </tr>
                     <tr>
                         <td>LVDS (Gbps)</td>
                         <td>1.25</td>
                     </tr>
                     <tr>
                         <td>DDR3 (Mbps)</td>
-                        <td>1333</td>
+                        <td>800</td>
                     </tr>
                         <td>Hard Core SoC</td>
                         <td>RiscV AE350_SOC</td>
@@ -181,10 +189,12 @@ TBD
 - [Dimension Diagram](https://dl.sipeed.com/shareURL/TANG/Mega_138K/04_Mechanical_drawing)
 - [3D Model](https://dl.sipeed.com/shareURL/TANG/Mega_138K/05_3D_file)
 - [Some Chip Manuals](https://dl.sipeed.com/shareURL/TANG/Mega_138K/07_Datasheet)
+- [All PIN Constraints](https://dl.sipeed.com/shareURL/TANG/Mega_138K_60K/08_Misc)
 
 ## Getting Started
 
 Note that 138K is currently not supported by the education version, and you need to download V1.9.9 or a newer version of the commercial IDE for use.  
+There are serious problems with the Programmer version V1.9.10.02, and this product cannot be programmed.
 Lic can be applied on the Gowin official website, or you can use the online Lic service provided by Sipeed. In the IDE, select Float Lic and fill in the following information:
 
 ~~~
@@ -287,7 +297,7 @@ Tang Mega 138K can meet different needs of customers in various scenarios. For t
 
 1. Setting the **Programmer** as shown in the figure below:
 
-<img src="./assets/flash_mode.png" alt="flash_mode" width=35%>
+<img src="./../assets/flash_mode_GAO.png" alt="flash_mode" width=35%>
 
 2. Check the position of the DIP switch; the correct position is shown in the figure below: