update v4 guide, Serial Console Access via the 5V Port

docs/en/BliKVM-v4-guide.md

@@ -68,7 +68,7 @@ v4 supports a maximum video input of 4K30Hz, and the default transmission resolu
 | M2.5x5 Screws               | 8   |
 | Silicone Bumper Pellets              | 1   |
 
-## Serial Console Access via the 5V Port
+## **Serial Console Access via the 5V Port**
 
 The 5V port can be used both for power supply and serial console access at the same time. There is an onboard CH341-based USB to UART converter present inside BliKVM v4 which is connected to UART0 of the [mCore-H616 SoC](https://linux-sunxi.org/H616), so you can connect a USB port of a PC to the 5V port without an external UART and a USB-C to dupont adapter.
 

docs/zh/BliKVM-v4-guide.md

@@ -68,5 +68,35 @@ v4最高支持4K30Hz的视频输入，传输分辨率默认为1920x1080。
 | M2.5x5螺丝               | 8   |
 | 硅胶防撞粒              | 1   |
 
+## **通过5V端口访问串行控制台**
+
+5V端口可以同时用于供电和串行控制台访问。BliKVM v4内部有一个基于CH341的USB到UART转换器，它连接到[mCore-H616 SoC](https://linux-sunxi.org/H616)的UART0，所以你可以将PC的USB端口连接到5V端口，无需外部UART和USB-C到杜邦适配器。
+
+!!! warning "PC USB端口电流输出"
+    尝试使用5V端口时要小心，因为单独的PC USB端口可能无法提供3A（5V），这是板卡工作的要求。可以同时使用12V 2A DC端口供电和5V端口进行串行通信，无需[USB分线器板](https://wiki.blicube.com/blikvm/en/usb-splitter-guide/)。或者使用分线器板分离出VCC引脚，并使用单独的5V 3A电源为5V端口的VCC引脚供电。同样，当BliKVM通电时从12V 2A DC端口断开电缆时，要确保先从5V端口断开电缆（因为在12V 2A电源断开后，除非使用了分线器，否则5V端口将成为BliKVM v4的电源）。
+
+当你将USB电缆连接到BliKVM v4的5V端口时，你应该在主机内核日志中看到类似这样的内容（如果你使用的是基于Linux的操作系统）:
+    ```
+    usb 1-1.2: new full-speed USB device number 12 using xhci_hcd
+    usb 1-1.2: New USB device found, idVendor=1a86, idProduct=7523, bcdDevice=81.34
+    usb 1-1.2: New USB device strings: Mfr=0, Product=2, SerialNumber=0
+    usb 1-1.2: Product: USB Serial
+    ch341 1-1.2:1.0: ch341-uart converter detected
+    usb 1-1.2: ch341-uart converter now attached to ttyUSB0
+    ```
+
+然后，可以使用[GNU screen](https://www.gnu.org/software/screen/)或[TIO](https://github.com/tio/tio)访问此端口:
+    ```
+    tio /dev/ttyUSB0
+    mangopimcore login: blikvm
+    # ...
+    ```
+
+如果你需要检查通过UART0接收了多少数据，可以通过查看通过proc公开的计数器来实现（当从外部主机发送数据时，如果内置的USB到UART转换器工作正常，rx计数器应该会增加）：
+    ```
+    root@mangopimcore:~# grep '0: uart' /proc/tty/driver/serial
+    0: uart:16550A mmio:0x05000000 irq:284 tx:20306 rx:40 pe:1 RTS|DTR
+    ```
+
 ## **购买链接**
 [v4淘宝地址](https://item.taobao.com/item.htm?spm=a1z10.3-c-s.w4002-24390589055.12.25da4adfmEV9JL&id=730202747005)

generated/en/BliKVM-v4-guide/index.html

@@ -220,6 +220,11 @@
   </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="#serial-console-access-via-the-5v-port">
+    Serial Console Access via the 5V Port
+  </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="#dev">
     Dev
   </a>
@@ -505,6 +510,11 @@
   </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="#serial-console-access-via-the-5v-port">
+    Serial Console Access via the 5V Port
+  </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="#dev">
     Dev
   </a>
@@ -615,6 +625,29 @@ <h2 id="product-list">Product List</h2>
 </tr>
 </tbody>
 </table>
+<h2 id="serial-console-access-via-the-5v-port"><strong>Serial Console Access via the 5V Port</strong></h2>
+<p>The 5V port can be used both for power supply and serial console access at the same time. There is an onboard CH341-based USB to UART converter present inside BliKVM v4 which is connected to UART0 of the <a href="https://linux-sunxi.org/H616">mCore-H616 SoC</a>, so you can connect a USB port of a PC to the 5V port without an external UART and a USB-C to dupont adapter.</p>
+<div class="admonition warning">
+<p class="admonition-title">PC USB port current output</p>
+<p>Be careful when trying to use the 5V port because a PC USB port alone may not be able to provide 3A (5V) which is a documented requirement for the board to work. Either use a 12V 2A DC port at the same time as using the 5V port for serial communication without a <a href="https://wiki.blicube.com/blikvm/en/usb-splitter-guide/">USB Splitter</a> board, or use the splitter board to split out the VCC pin and use a separate 5V 3A power supply to provide power to the 5V port's VCC pin. Likewise, when disconnecting a cable from the 12V 2A DC port while BliKVM is powered on, make sure to disconnect the cable from the 5V port first (because that will become the power source for BliKVM v4 after the 12V 2A source is disconnected unless a splitter is used).</p>
+</div>
+<p>You should see something like this in your host kernel log (if you are using a Linux-based OS) when attaching a USB cable to the 5V port of BliKVM v4:
+    <div class="highlight"><pre><span></span><code><a href="#__codelineno-1-1" id="__codelineno-1-1" name="__codelineno-1-1"></a>usb 1-1.2: new full-speed USB device number 12 using xhci_hcd
+<a href="#__codelineno-1-2" id="__codelineno-1-2" name="__codelineno-1-2"></a>usb 1-1.2: New USB device found, idVendor=1a86, idProduct=7523, bcdDevice=81.34
+<a href="#__codelineno-1-3" id="__codelineno-1-3" name="__codelineno-1-3"></a>usb 1-1.2: New USB device strings: Mfr=0, Product=2, SerialNumber=0
+<a href="#__codelineno-1-4" id="__codelineno-1-4" name="__codelineno-1-4"></a>usb 1-1.2: Product: USB Serial
+<a href="#__codelineno-1-5" id="__codelineno-1-5" name="__codelineno-1-5"></a>ch341 1-1.2:1.0: ch341-uart converter detected
+<a href="#__codelineno-1-6" id="__codelineno-1-6" name="__codelineno-1-6"></a>usb 1-1.2: ch341-uart converter now attached to ttyUSB0
+</code></pre></div></p>
+<p>Accessing this port can then be done using <a href="https://www.gnu.org/software/screen/">GNU screen</a> or <a href="https://github.com/tio/tio">TIO</a>:
+    <div class="highlight"><pre><span></span><code><a href="#__codelineno-2-1" id="__codelineno-2-1" name="__codelineno-2-1"></a>tio /dev/ttyUSB0
+<a href="#__codelineno-2-2" id="__codelineno-2-2" name="__codelineno-2-2"></a>mangopimcore login: blikvm
+<a href="#__codelineno-2-3" id="__codelineno-2-3" name="__codelineno-2-3"></a># ...
+</code></pre></div></p>
+<p>If you need to check how much data is received over UART0 you can do this by looking at the counters exposed via proc as follows (the rx counter should increase when the data is sent from an external host if the built-in USB to UART converter is working properly):
+    <div class="highlight"><pre><span></span><code><a href="#__codelineno-3-1" id="__codelineno-3-1" name="__codelineno-3-1"></a>root@mangopimcore:~# grep '0: uart' /proc/tty/driver/serial
+<a href="#__codelineno-3-2" id="__codelineno-3-2" name="__codelineno-3-2"></a>0: uart:16550A mmio:0x05000000 irq:284 tx:20306 rx:40 pe:1 RTS|DTR
+</code></pre></div></p>
 <h2 id="dev">Dev</h2>
 <p>If you want to develop or port software on v4 hardware yourself, you can refer to this <a href="../Dev-BliKVM-v4-Allwinner/">hardware resource description</a>.</p>
 <h2 id="buy-link"><strong>Buy link</strong></h2>

generated/zh/BliKVM-v4-guide/index.html

@@ -220,6 +220,11 @@
   </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="#5v">
+    通过5V端口访问串行控制台
+  </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="#_6">
     购买链接
   </a>
@@ -495,6 +500,11 @@
   </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="#5v">
+    通过5V端口访问串行控制台
+  </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="#_6">
     购买链接
   </a>
@@ -607,6 +617,29 @@ <h2 id="_5"><strong>发货清单</strong></h2>
 </tr>
 </tbody>
 </table>
+<h2 id="5v"><strong>通过5V端口访问串行控制台</strong></h2>
+<p>5V端口可以同时用于供电和串行控制台访问。BliKVM v4内部有一个基于CH341的USB到UART转换器，它连接到<a href="https://linux-sunxi.org/H616">mCore-H616 SoC</a>的UART0，所以你可以将PC的USB端口连接到5V端口，无需外部UART和USB-C到杜邦适配器。</p>
+<div class="admonition warning">
+<p class="admonition-title">PC USB端口电流输出</p>
+<p>尝试使用5V端口时要小心，因为单独的PC USB端口可能无法提供3A（5V），这是板卡工作的要求。可以同时使用12V 2A DC端口供电和5V端口进行串行通信，无需<a href="https://wiki.blicube.com/blikvm/en/usb-splitter-guide/">USB分线器板</a>。或者使用分线器板分离出VCC引脚，并使用单独的5V 3A电源为5V端口的VCC引脚供电。同样，当BliKVM通电时从12V 2A DC端口断开电缆时，要确保先从5V端口断开电缆（因为在12V 2A电源断开后，除非使用了分线器，否则5V端口将成为BliKVM v4的电源）。</p>
+</div>
+<p>当你将USB电缆连接到BliKVM v4的5V端口时，你应该在主机内核日志中看到类似这样的内容（如果你使用的是基于Linux的操作系统）:
+    <div class="highlight"><pre><span></span><code><a href="#__codelineno-1-1" id="__codelineno-1-1" name="__codelineno-1-1"></a>usb 1-1.2: new full-speed USB device number 12 using xhci_hcd
+<a href="#__codelineno-1-2" id="__codelineno-1-2" name="__codelineno-1-2"></a>usb 1-1.2: New USB device found, idVendor=1a86, idProduct=7523, bcdDevice=81.34
+<a href="#__codelineno-1-3" id="__codelineno-1-3" name="__codelineno-1-3"></a>usb 1-1.2: New USB device strings: Mfr=0, Product=2, SerialNumber=0
+<a href="#__codelineno-1-4" id="__codelineno-1-4" name="__codelineno-1-4"></a>usb 1-1.2: Product: USB Serial
+<a href="#__codelineno-1-5" id="__codelineno-1-5" name="__codelineno-1-5"></a>ch341 1-1.2:1.0: ch341-uart converter detected
+<a href="#__codelineno-1-6" id="__codelineno-1-6" name="__codelineno-1-6"></a>usb 1-1.2: ch341-uart converter now attached to ttyUSB0
+</code></pre></div></p>
+<p>然后，可以使用<a href="https://www.gnu.org/software/screen/">GNU screen</a>或<a href="https://github.com/tio/tio">TIO</a>访问此端口:
+    <div class="highlight"><pre><span></span><code><a href="#__codelineno-2-1" id="__codelineno-2-1" name="__codelineno-2-1"></a>tio /dev/ttyUSB0
+<a href="#__codelineno-2-2" id="__codelineno-2-2" name="__codelineno-2-2"></a>mangopimcore login: blikvm
+<a href="#__codelineno-2-3" id="__codelineno-2-3" name="__codelineno-2-3"></a># ...
+</code></pre></div></p>
+<p>如果你需要检查通过UART0接收了多少数据，可以通过查看通过proc公开的计数器来实现（当从外部主机发送数据时，如果内置的USB到UART转换器工作正常，rx计数器应该会增加）：
+    <div class="highlight"><pre><span></span><code><a href="#__codelineno-3-1" id="__codelineno-3-1" name="__codelineno-3-1"></a>root@mangopimcore:~# grep '0: uart' /proc/tty/driver/serial
+<a href="#__codelineno-3-2" id="__codelineno-3-2" name="__codelineno-3-2"></a>0: uart:16550A mmio:0x05000000 irq:284 tx:20306 rx:40 pe:1 RTS|DTR
+</code></pre></div></p>
 <h2 id="_6"><strong>购买链接</strong></h2>
 <p><a href="https://item.taobao.com/item.htm?spm=a1z10.3-c-s.w4002-24390589055.12.25da4adfmEV9JL&amp;id=730202747005">v4淘宝地址</a></p>
 <hr/>