Merge pull request #851 from MK16kawai/main

docs(NanoKVM Pro): add comprehensive LED strip installation guide

docs/hardware/en/kvm/NanoKVM_Pro/ws2812.md

@@ -1,3 +1,112 @@
-# Screen Color Expansion LED Strip
+---
+title: Screen Expansion LED Strip
+keywords: NanoKVM, LED Strip
+update:
+  - date: 2025-9-05
+    version: v0.1
+    author: iawak9lkm
+    content:
+      - Release docs
+---
 
-Coming Soon
+## Package Accessories Overview
+
+If you purchased the LED strip package, you will receive the following items:
+
+![ledstrip\_ov](../../../assets/NanoKVM/pro/ledstrip/ledstrip_ov.jpg)
+
+1. 1-to-2 data cable
+2. LED strip adapter kit (includes 6 adapters and 3 right-angle cables)
+3. One roll of LED strip
+
+---
+
+## Installation Steps
+
+### Confirm Installation Orientation
+
+![ledstrip_screen](../../../assets/NanoKVM/pro/ledstrip/ledstrip_screen.jpg)
+
+> Segment ④ is optional. You can choose between three-sided or four-sided mode based on your needs.
+>
+> The sampling order of the strip is: **Bottom-left → Top-left → Top-right → Bottom-right → Bottom-left**.
+> Ensure consistency during installation. The green end is the strip’s Type-C connector, and the other end connects to NanoKVM-Pro via the adapter cable.
+
+### Cut the LED Strip
+
+![ledstrip_cut_st0](../../../assets/NanoKVM/pro/ledstrip/ledstrip_cut_st0.jpg)
+
+Cut the LED strip according to the screen’s width and height.
+
+> The number of LEDs on opposite sides must remain consistent.
+
+Example: Screen height 18 LEDs, width 30 LEDs.
+
+* Segment ①: 18 LEDs
+* Segment ②: 30 LEDs
+* Segment ③: 18 LEDs
+* Segment ④: 30 LEDs
+
+When cutting, make sure to cut along the red line (the midpoint between contacts):
+
+![ledstrip_cut_st1](../../../assets/NanoKVM/pro/ledstrip/ledstrip_cut_st1.jpg)
+
+### Open the Adapter Connector
+
+In the image below, the right side shows the **side view** of the adapter connector. Pry open the connector at the red-marked area, resulting in the state shown on the left:
+
+![ledstrip_con_st2](../../../assets/NanoKVM/pro/ledstrip/ledstrip_con_st2.jpg)
+
+### Insert the Cables
+
+Insert the LED strip and right-angle cable into opposite sides of the adapter connector, ensuring that the metal contacts align with the bridging metal inside the connector. Close the connector to secure.
+
+![ledstrip_con_st3](../../../assets/NanoKVM/pro/ledstrip/ledstrip_con_st3.jpg)
+
+Connect the other end of the right-angle cable. **Ensure that the arrow direction on the LED strip (signal flow direction) remains consistent**.
+Repeat this process until all strips are connected.
+
+![ledstrip_con_st4](../../../assets/NanoKVM/pro/ledstrip/ledstrip_con_st4.jpg)
+
+### Attach the LED Strip
+
+Peel off the protective film of the double-sided adhesive on the back of the strip, then firmly attach it to the back of the screen.
+
+### Connect to NanoKVM-Pro
+
+The connection layout is as follows:
+
+* ① Connect to NanoKVM-Pro PWR port
+* ② Connect to LED strip
+* ③ Connect to power adapter
+
+> ⚠️ Note: Please ensure the power supply specification is **5V ≥ 3A**.
+
+![ledstrip_pwr](../../../assets/NanoKVM/pro/ledstrip/ledstrip_pwr.jpg)
+
+---
+
+## Enable the LED Strip
+
+* Enable via Web
+
+  1. Log in to NanoKVM via a browser
+  2. Navigate to **Settings → Device → LED Strip Settings**
+
+  ![ledstrip_web1_en](../../../assets/NanoKVM/pro/ledstrip/led_strip_web1_en.jpg)
+
+  3. Enter the number of LEDs and enable the feature
+
+  ![ledstrip_web2_en](../../../assets/NanoKVM/pro/ledstrip/led_strip_web2_en.jpg)
+
+* Enable via Desk UI
+
+  1. Go to the `Settings` page
+  2. Select `Ambilight` to enter the sub-settings page
+  3. Configure the number of LEDs and enable the feature
+
+---
+
+## Demonstration
+
+![ledstrip_show](../../../assets/NanoKVM/pro/ledstrip/ledstrip_show.png)

docs/hardware/zh/kvm/NanoKVM_Pro/ws2812.md

@@ -1,3 +1,110 @@
-# 屏幕色彩扩展灯带
+---
+title: 屏扩灯带
+keywords: NanoKVM, LED Strip
+update:
+  - date: 2025-9-05
+    version: v0.1
+    author: iawak9lkm
+    content:
+      - Release docs
+---
 
-敬请期待
+## 套餐配件概览
+
+如果您购买了灯带套餐，您将获得以下配件：
+
+![ledstrip_ov](../../../assets/NanoKVM/pro/ledstrip/ledstrip_ov.jpg)
+
+1. 一分二数据线
+2. 灯带转接套件（含 6 个转接件和 3 根直角转接线）
+3. 一卷 LED 灯带
+
+---
+
+## 安装步骤
+
+### 确认安装方向
+
+![ledstrip_screen](../../../assets/NanoKVM/pro/ledstrip/ledstrip_screen.jpg)
+
+> 第④段为可选，支持三边模式和四边模式，根据您的需求来选择即可
+>
+> 灯带采样顺序为：**屏幕左下角 → 左上角 → 右上角 → 右下角 → 左下角** 。
+> 安装时请保持一致。绿色端为灯带的 Type-C 接口，另一端通过转接线连接至 NanoKVM-Pro。
+
+### 裁剪灯带
+
+![ledstrip_cut_st0](../../../assets/NanoKVM/pro/ledstrip/ledstrip_cut_st0.jpg)
+
+根据屏幕长宽裁剪灯带。
+
+> 对边的灯珠数量需要保持一致。
+
+示例：屏幕高度 18 颗灯珠，宽度 30 颗灯珠。
+
+* 第①段：18 颗
+* 第②段：30 颗
+* 第③段：18 颗
+* 第④段：30 颗
+
+裁剪时请沿红线位置（触点中间）对半剪开：
+
+![ledstrip_cut_st1](../../../assets/NanoKVM/pro/ledstrip/ledstrip_cut_st1.jpg)
+
+### 打开转接件
+
+在下图右侧为转接件**侧视图**，红框处掰开转接件，效果如左图：
+
+![ledstrip_con_st2](../../../assets/NanoKVM/pro/ledstrip/ledstrip_con_st2.jpg)
+
+### 插入线材
+
+将灯带和直角转接线分别插入转接件两侧，确保金属触点与转接件内的桥接金属对应。闭合转接件后固定。
+
+![ledstrip_con_st3](../../../assets/NanoKVM/pro/ledstrip/ledstrip_con_st3.jpg)
+
+接入另一端直角转接线，**注意灯带箭头方向（信号传输方向）保持一致**。
+重复此步骤，直至所有灯带完成连接。
+
+![ledstrip_con_st4](../../../assets/NanoKVM/pro/ledstrip/ledstrip_con_st4.jpg)
+
+### 粘贴灯带
+
+撕开灯带背部的双面胶保护膜，将其牢固粘贴在屏幕背面。
+
+### 连接到 NanoKVM-Pro
+
+连接示意如下：
+
+* ① 接 NanoKVM-Pro PWR 接口
+* ② 接灯带
+* ③ 接电源适配器
+
+> ⚠️ 注意：请确保输入电源规格 **5V ≥ 3A**。
+
+![ledstrip_pwr](../../../assets/NanoKVM/pro/ledstrip/ledstrip_pwr.jpg)
+
+---
+
+## 启用灯带
+
+* 通过 Web 开启
+  1. 通过浏览器登录 NanoKVM
+  2. 依次进入 **设置 → 设备 → LED 灯带设置**
+
+    ![ledstrip_web1_en](../../../assets/NanoKVM/pro/ledstrip/led_strip_web1_en.jpg)
+
+  3. 填写灯带数量并开启
+
+    ![ledstrip_web2_en](../../../assets/NanoKVM/pro/ledstrip/led_strip_web2_en.jpg)
+
+* 通过 Desk UI 开启
+  1. 进入 `Settings` 页面
+  2. 选择 `Ambilight` 进入二级设置页面
+  3. 配置灯带数量并开启
+
+---
+
+## 效果展示
+
+![ledstrip_show](../../../assets/NanoKVM/pro/ledstrip/ledstrip_show.png)