diff --git a/.gitignore b/.gitignore
index 725f1869..d04ac415 100644
--- a/.gitignore
+++ b/.gitignore
@@ -40,3 +40,4 @@ CLAUDE.md
# Secrets (compile-time configuration)
secrets.toml
.env
+/docs/
diff --git a/Cargo.toml b/Cargo.toml
index c246fdd3..899b0b3e 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "one-kvm"
-version = "0.1.4"
+version = "0.1.5"
edition = "2021"
authors = ["SilentWind"]
description = "A open and lightweight IP-KVM solution written in Rust"
diff --git a/README.md b/README.md
index e20c6845..7798cb72 100644
--- a/README.md
+++ b/README.md
@@ -7,13 +7,6 @@
[](https://github.com/mofeng-git/One-KVM/stargazers)
[](https://github.com/mofeng-git/One-KVM/network/members)
[](https://github.com/mofeng-git/One-KVM/issues)
-
-
- ๐ ๆๆฏๆๆกฃ โข
- โก ๅฟซ้ๅผๅง โข
- ๐ ๅ่ฝไป็ป โข
- ๐ ่ฟ็งป่ฏดๆ
-
---
@@ -26,7 +19,7 @@
- **ๅผๆพ**๏ผไธ็ปๅฎ็นๅฎ็กฌไปถ้
็ฝฎ๏ผๅฐฝ้้้
ๅธธ่ง Linux ่ฎพๅค
- **่ฝป้**๏ผๅไบ่ฟๅถๅๅ๏ผ้จ็ฝฒ่ฟ็จๆด็ฎๅ
-- **ๆ็จ**๏ผ็ฝ้กต็้ขๅฎๆ่ฎพๅคไธๅๆฐ้
็ฝฎ๏ผๅฐฝ้ๅๅฐๆๅจๆน้
็ฝฎๆไปถ
+- **ๆ็จ**๏ผ็ฝ้กต็้ขๅฎๆ่ฎพๅคไธๅๆฐ้
็ฝฎ๏ผๆ ้ๆๅจๆน้
็ฝฎๆไปถ
> **ๆณจๆ๏ผ** One-KVM Rust ็ฎๅไปๅคไบๅผๅๆฉๆ้ถๆฎต๏ผๅ่ฝไธ็ป่ไผๅฟซ้่ฟญไปฃ๏ผๆฌข่ฟไฝ้ชไธๅ้ฆใ
@@ -35,7 +28,7 @@
ๅผๅ้ๅฟๆญฃๅจไป **One-KVM Python** ้ๆญฅ่ฝฌๅ **One-KVM Rust**ใ
- ๅฆๆไฝ ๅจไฝฟ็จ **One-KVM Python๏ผๅบไบ PiKVM๏ผ**๏ผ่ฏทๆฅ็ [One-KVM Python ๆๆกฃ](https://docs.one-kvm.cn/python/)
-- One-KVM Rust ็ธ่พไบ One-KVM Python๏ผ**ๅฐๆช้้
CSI HDMI ้้ๅก**ใ**ไธๆฏๆ VNC ่ฎฟ้ฎ**๏ผไปๅคไบๅผๅๆฉๆ้ถๆฎต
+- One-KVM Rust ็ธ่พไบ One-KVM Python๏ผ**ๅฐๆชๅฎๅ
จ้้
CSI HDMI ้้ๅก**ใ**ไธๆฏๆ VNC ่ฎฟ้ฎ**๏ผไปๅคไบๅผๅๆฉๆ้ถๆฎต
## ๐ ๅ่ฝไป็ป
@@ -55,13 +48,13 @@
- **VAAPI**๏ผIntel/AMD GPU
- **RKMPP**๏ผRockchip SoC
-- **V4L2 M2M**๏ผ้็จ็กฌไปถ็ผ็ ๅจ๏ผๅฐๆชๅฎ็ฐ๏ผ
+- **V4L2 M2M**๏ผ้็จ็กฌไปถ็ผ็ ๅจ
- **่ฝฏไปถ็ผ็ **๏ผCPU ็ผ็
### ๆฉๅฑ่ฝๅ
- Web UI ้
็ฝฎ๏ผๅค่ฏญ่จๆฏๆ๏ผไธญๆ/่ฑๆ๏ผ
-- ๅ
็ฝฎ Web ็ป็ซฏ๏ผttyd๏ผๅ
็ฝ็ฉฟ้ๆฏๆ๏ผgostc๏ผใP2P ็ป็ฝๆฏๆ๏ผEasyTier๏ผใRustDesk ๅ่ฎฎ้ๆ๏ผ็จไบ่ทจๅนณๅฐ่ฟ็จ่ฎฟ้ฎ่ฝๅๆฉๅฑ๏ผ
+- ๅ
็ฝฎ Web ็ป็ซฏ๏ผttyd๏ผใๅ
็ฝ็ฉฟ้ๆฏๆ๏ผgostc๏ผใP2P ็ป็ฝๆฏๆ๏ผEasyTier๏ผใRustDesk ๅ่ฎฎ้ๆ๏ผ็จไบ่ทจๅนณๅฐ่ฟ็จ่ฎฟ้ฎ่ฝๅๆฉๅฑ๏ผๅ RTSP ่ง้ขๆต๏ผ็จไบ่ง้ขๆจๆต๏ผ
## โก ๅฎ่ฃ
ไฝฟ็จ
@@ -195,6 +188,10 @@
- ็ฑๅ็ต็จๆท_JT6c
+- MaxZ
+
+- ็ฑๅ็ต็จๆท_d3d9c
+
- ......
diff --git a/docs/README.md b/docs/README.md
deleted file mode 100644
index 24545f82..00000000
--- a/docs/README.md
+++ /dev/null
@@ -1,130 +0,0 @@
-# One-KVM ๆๆฏๆๆกฃ
-
-ๆฌ็ฎๅฝๅ
ๅซ One-KVM ้กน็ฎ็ๅฎๆดๆๆฏๆๆกฃใ
-
-## ๆๆกฃ็ปๆ
-
-```
-docs/
-โโโ README.md # ๆฌๆไปถ - ๆๆกฃ็ดขๅผ
-โโโ system-architecture.md # ็ณป็ปๆถๆๆๆกฃ
-โโโ tech-stack.md # ๆๆฏๆ ๆๆกฃ
-โโโ modules/ # ๆจกๅๆๆกฃ
- โโโ video.md # ่ง้ขๆจกๅ
- โโโ hid.md # HID ๆจกๅ
- โโโ otg.md # OTG ๆจกๅ
- โโโ msd.md # MSD ๆจกๅ
- โโโ atx.md # ATX ๆจกๅ
- โโโ audio.md # ้ณ้ขๆจกๅ
- โโโ webrtc.md # WebRTC ๆจกๅ
- โโโ rustdesk.md # RustDesk ๆจกๅ
- โโโ auth.md # ่ฎค่ฏๆจกๅ
- โโโ config.md # ้
็ฝฎๆจกๅ
- โโโ events.md # ไบไปถๆจกๅ
- โโโ web.md # Web ๆจกๅ
-```
-
-## ๅฟซ้ๅฏผ่ช
-
-### ๆ ธๅฟๆๆกฃ
-
-| ๆๆกฃ | ๆ่ฟฐ |
-|------|------|
-| [็ณป็ปๆถๆ](./system-architecture.md) | ๆดไฝๆถๆ่ฎพ่ฎกใๆฐๆฎๆตใๆจกๅไพ่ต |
-| [ๆๆฏๆ ](./tech-stack.md) | ไฝฟ็จ็ๆๆฏใๅบๅๅผๅ่ง่ |
-
-### ๅ่ฝๆจกๅ
-
-| ๆจกๅ | ๆ่ฟฐ | ๅ
ณ้ฎๆไปถ |
-|------|------|---------|
-| [Video](./modules/video.md) | ่ง้ข้้ๅ็ผ็ | `src/video/` |
-| [HID](./modules/hid.md) | ้ฎ็้ผ ๆ ๆงๅถ | `src/hid/` |
-| [OTG](./modules/otg.md) | USB Gadget ็ฎก็ | `src/otg/` |
-| [MSD](./modules/msd.md) | ่ๆๅญๅจ่ฎพๅค | `src/msd/` |
-| [ATX](./modules/atx.md) | ็ตๆบๆงๅถ | `src/atx/` |
-| [Audio](./modules/audio.md) | ้ณ้ข้้็ผ็ | `src/audio/` |
-| [WebRTC](./modules/webrtc.md) | WebRTC ๆตๅชไฝ | `src/webrtc/` |
-| [RustDesk](./modules/rustdesk.md) | RustDesk ๅ่ฎฎ้ๆ | `src/rustdesk/` |
-
-### ๅบ็ก่ฎพๆฝ
-
-| ๆจกๅ | ๆ่ฟฐ | ๅ
ณ้ฎๆไปถ |
-|------|------|---------|
-| [Auth](./modules/auth.md) | ่ฎค่ฏๅไผ่ฏ | `src/auth/` |
-| [Config](./modules/config.md) | ้
็ฝฎ็ฎก็ | `src/config/` |
-| [Events](./modules/events.md) | ไบไปถ็ณป็ป | `src/events/` |
-| [Web](./modules/web.md) | HTTP API | `src/web/` |
-
-## ๆถๆๆฆ่ง
-
-```
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ One-KVM System โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
-โ โ
-โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
-โ โ Web Frontend (Vue3) โ โ
-โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
-โ โ โ
-โ โผ โ
-โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
-โ โ Axum Web Server โ โ
-โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
-โ โ โ
-โ โผ โ
-โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
-โ โ AppState โ โ
-โ โ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โ โ
-โ โ โ Video โ โ HID โ โ MSD โ โ ATX โ โ โ
-โ โ โ Module โ โ Module โ โ Module โ โ Module โ โ โ
-โ โ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โ โ
-โ โ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โ โ
-โ โ โ Audio โ โ WebRTC โ โRustDeskโ โ Events โ โ โ
-โ โ โ Module โ โ Module โ โ Module โ โ Bus โ โ โ
-โ โ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โ โ
-โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
-โ โ โ
-โ โผ โ
-โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
-โ โ Hardware Layer โ โ
-โ โ V4L2 โ USB OTG โ GPIO โ ALSA โ Network โ โ
-โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
-โ โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-```
-
-## ๅ
ณ้ฎ็นๆง
-
-- **ๅไธไบ่ฟๅถ**: Web UI + ๅ็ซฏไธไฝๅ้จ็ฝฒ
-- **ๅๆตๆจกๅผ**: WebRTC (H264/H265/VP8/VP9) + MJPEG
-- **USB OTG**: ่ๆ้ฎ้ผ ใ่ๆๅญๅจ
-- **็กฌไปถๅ ้**: VAAPI/RKMPP/V4L2 M2M
-- **RustDesk**: ่ทจๅนณๅฐ่ฟ็จ่ฎฟ้ฎ
-- **ๆ ้
็ฝฎๆไปถ**: SQLite ้
็ฝฎๅญๅจ
-
-## ็ฎๆ ๅนณๅฐ
-
-| ๅนณๅฐ | ๆถๆ | ็จ้ |
-|------|------|------|
-| aarch64-unknown-linux-gnu | ARM64 | ไธป่ฆ็ฎๆ |
-| armv7-unknown-linux-gnueabihf | ARMv7 | ๅค้ |
-| x86_64-unknown-linux-gnu | x86-64 | ๅผๅ/ๆต่ฏ |
-
-## ๅฟซ้ๅผๅง
-
-```bash
-# ๆๅปบๅ็ซฏ
-cd web && npm install && npm run build && cd ..
-
-# ๆๅปบๅ็ซฏ
-cargo build --release
-
-# ่ฟ่ก
-./target/release/one-kvm --enable-https
-```
-
-## ็ธๅ
ณ้พๆฅ
-
-- [้กน็ฎไปๅบ](https://github.com/mofeng-git/One-KVM)
-- [ๅผๅ่ฎกๅ](./DEVELOPMENT_PLAN.md)
-- [้กน็ฎ็ฎๆ ](./PROJECT_GOALS.md)
diff --git a/docs/modules/atx.md b/docs/modules/atx.md
deleted file mode 100644
index 316d4a34..00000000
--- a/docs/modules/atx.md
+++ /dev/null
@@ -1,484 +0,0 @@
-# ATX ๆจกๅๆๆกฃ
-
-## 1. ๆจกๅๆฆ่ฟฐ
-
-ATX ๆจกๅๆไพ็ตๆบๆงๅถๅ่ฝ๏ผ้่ฟ GPIO ๆ USB ็ปง็ตๅจๆงๅถ็ฎๆ ่ฎก็ฎๆบ็็ตๆบๅ้็ฝฎๆ้ฎใ
-
-### 1.1 ไธป่ฆๅ่ฝ
-
-- ็ตๆบๆ้ฎๆงๅถ
-- ้็ฝฎๆ้ฎๆงๅถ
-- ็ตๆบ LED ็ถๆ็่ง
-- Wake-on-LAN ๆฏๆ
-- ๅคๅ็ซฏๆฏๆ (GPIO/USB ็ปง็ตๅจ)
-
-### 1.2 ๆไปถ็ปๆ
-
-```
-src/atx/
-โโโ mod.rs # ๆจกๅๅฏผๅบ
-โโโ controller.rs # AtxController (11KB)
-โโโ executor.rs # ๅจไฝๆง่กๅจ (10KB)
-โโโ types.rs # ็ฑปๅๅฎไน (7KB)
-โโโ led.rs # LED ็่ง (5KB)
-โโโ wol.rs # Wake-on-LAN (5KB)
-```
-
----
-
-## 2. ๆถๆ่ฎพ่ฎก
-
-```
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ ATX Architecture โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
- Web API
- โ
- โผ
- โโโโโโโโโโโโโโโโโโโ
- โ AtxController โ
- โ (controller.rs) โ
- โโโโโโโโโโฌโโโโโโโโโ
- โ
- โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโ
- โ โ โ
- โผ โผ โผ
-โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ
-โ Power โ โ Reset โ โ LED โ
-โExecutorโ โExecutorโ โMonitor โ
-โโโโโฌโโโโโ โโโโโฌโโโโโ โโโโโฌโโโโโ
- โ โ โ
- โผ โผ โผ
-โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ
-โ GPIO โ โ GPIO โ โ GPIO โ
-โ or USB โ โ or USB โ โ Input โ
-โ Relay โ โ Relay โ โ โ
-โโโโโฌโโโโโ โโโโโฌโโโโโ โโโโโฌโโโโโ
- โ โ โ
- โโโโโโโโโโโโโผโโโโโโโโโโโโโโ
- โ
- โผ
- โโโโโโโโโโโโโโโโโ
- โ Target PC โ
- โ (ATX Header) โ
- โโโโโโโโโโโโโโโโโ
-```
-
----
-
-## 3. ๆ ธๅฟ็ปไปถ
-
-### 3.1 AtxController (controller.rs)
-
-```rust
-pub struct AtxController {
- /// ็ตๆบๆ้ฎ้
็ฝฎ
- power: Arc,
-
- /// ้็ฝฎๆ้ฎ้
็ฝฎ
- reset: Arc,
-
- /// LED ็่งๅจ
- led_monitor: Arc>>,
-
- /// WoL ๆงๅถๅจ
- wol: Arc>>,
-
- /// ๅฝๅ็ถๆ
- state: Arc>,
-
- /// ไบไปถๆป็บฟ
- events: Arc,
-}
-
-impl AtxController {
- /// ๅๅปบๆงๅถๅจ
- pub fn new(config: &AtxConfig, events: Arc) -> Result;
-
- /// ็ญๆ็ตๆบๆ้ฎ (ๅผๆบ/ๆญฃๅธธๅ
ณๆบ)
- pub async fn power_short_press(&self) -> Result<()>;
-
- /// ้ฟๆ็ตๆบๆ้ฎ (ๅผบๅถๅ
ณๆบ)
- pub async fn power_long_press(&self) -> Result<()>;
-
- /// ๆ้็ฝฎๆ้ฎ
- pub async fn reset_press(&self) -> Result<()>;
-
- /// ่ทๅ็ตๆบ็ถๆ
- pub fn power_state(&self) -> PowerState;
-
- /// ๅ้ WoL ้ญๆฏๅ
- pub async fn wake_on_lan(&self, mac: &str) -> Result<()>;
-
- /// ่ทๅ็ถๆ
- pub fn state(&self) -> AtxState;
-
- /// ้ๆฐๅ ่ฝฝ้
็ฝฎ
- pub async fn reload(&self, config: &AtxConfig) -> Result<()>;
-}
-
-pub struct AtxState {
- /// ๆฏๅฆๅฏ็จ
- pub available: bool,
-
- /// ็ตๆบๆฏๅฆๅผๅฏ
- pub power_on: bool,
-
- /// ๆๅๆไฝๆถ้ด
- pub last_action: Option>,
-
- /// ้่ฏฏไฟกๆฏ
- pub error: Option,
-}
-
-pub enum PowerState {
- On,
- Off,
- Unknown,
-}
-```
-
-### 3.2 AtxButton (executor.rs)
-
-```rust
-pub struct AtxButton {
- /// ๆ้ฎๅ็งฐ
- name: String,
-
- /// ้ฉฑๅจ็ฑปๅ
- driver: AtxDriverType,
-
- /// GPIO ๅฅๆ
- gpio: Option,
-
- /// USB ็ปง็ตๅจๅฅๆ
- relay: Option,
-
- /// ้
็ฝฎ
- config: AtxKeyConfig,
-}
-
-impl AtxButton {
- /// ๅๅปบๆ้ฎ
- pub fn new(name: &str, config: &AtxKeyConfig) -> Result;
-
- /// ็ญๆ (100ms)
- pub async fn short_press(&self) -> Result<()>;
-
- /// ้ฟๆ (3000ms)
- pub async fn long_press(&self) -> Result<()>;
-
- /// ่ชๅฎไนๆๅๆถ้ด
- pub async fn press(&self, duration: Duration) -> Result<()>;
-
- /// ่ฎพ็ฝฎ่พๅบ็ถๆ
- fn set_output(&self, high: bool) -> Result<()>;
-}
-
-pub enum AtxDriverType {
- /// GPIO ็ด่ฟ
- Gpio,
-
- /// USB ็ปง็ตๅจ
- UsbRelay,
-
- /// ็ฆ็จ
- None,
-}
-```
-
-### 3.3 LedMonitor (led.rs)
-
-```rust
-pub struct LedMonitor {
- /// GPIO ๅผ่
- pin: u32,
-
- /// GPIO ๅฅๆ
- line: LineHandle,
-
- /// ๅฝๅ็ถๆ
- state: Arc,
-
- /// ็่งไปปๅก
- monitor_task: Option>,
-}
-
-impl LedMonitor {
- /// ๅๅปบ็่งๅจ
- pub fn new(config: &AtxLedConfig) -> Result;
-
- /// ๅฏๅจ็่ง
- pub fn start(&mut self, events: Arc) -> Result<()>;
-
- /// ๅๆญข็่ง
- pub fn stop(&mut self);
-
- /// ่ทๅๅฝๅ็ถๆ
- pub fn state(&self) -> bool;
-}
-```
-
-### 3.4 WolController (wol.rs)
-
-```rust
-pub struct WolController {
- /// ็ฝ็ปๆฅๅฃ
- interface: String,
-
- /// ๅนฟๆญๅฐๅ
- broadcast_addr: SocketAddr,
-}
-
-impl WolController {
- /// ๅๅปบๆงๅถๅจ
- pub fn new(interface: Option<&str>) -> Result;
-
- /// ๅ้ WoL ้ญๆฏๅ
- pub async fn wake(&self, mac: &str) -> Result<()>;
-
- /// ๆๅปบ้ญๆฏๅ
- fn build_magic_packet(mac: &[u8; 6]) -> [u8; 102];
-
- /// ่งฃๆ MAC ๅฐๅ
- fn parse_mac(mac: &str) -> Result<[u8; 6]>;
-}
-```
-
----
-
-## 4. ้
็ฝฎ
-
-```rust
-#[derive(Serialize, Deserialize)]
-#[typeshare]
-pub struct AtxConfig {
- /// ๆฏๅฆๅฏ็จ
- pub enabled: bool,
-
- /// ็ตๆบๆ้ฎ้
็ฝฎ
- pub power: AtxKeyConfig,
-
- /// ้็ฝฎๆ้ฎ้
็ฝฎ
- pub reset: AtxKeyConfig,
-
- /// LED ็่ง้
็ฝฎ
- pub led: AtxLedConfig,
-
- /// WoL ้
็ฝฎ
- pub wol: WolConfig,
-}
-
-#[derive(Serialize, Deserialize)]
-#[typeshare]
-pub struct AtxKeyConfig {
- /// ้ฉฑๅจ็ฑปๅ
- pub driver: AtxDriverType,
-
- /// GPIO ่ฏ็ (ๅฆ /dev/gpiochip0)
- pub gpio_chip: Option,
-
- /// GPIO ๅผ่ๅท
- pub gpio_pin: Option,
-
- /// USB ็ปง็ตๅจ่ฎพๅค
- pub relay_device: Option,
-
- /// ็ปง็ตๅจ้้
- pub relay_channel: Option,
-
- /// ๆฟๆดป็ตๅนณ
- pub active_level: ActiveLevel,
-}
-
-#[derive(Serialize, Deserialize)]
-#[typeshare]
-pub struct AtxLedConfig {
- /// ๆฏๅฆๅฏ็จ
- pub enabled: bool,
-
- /// GPIO ่ฏ็
- pub gpio_chip: Option,
-
- /// GPIO ๅผ่ๅท
- pub gpio_pin: Option,
-
- /// ๆฟๆดป็ตๅนณ
- pub active_level: ActiveLevel,
-}
-
-pub enum ActiveLevel {
- High,
- Low,
-}
-
-impl Default for AtxConfig {
- fn default() -> Self {
- Self {
- enabled: false,
- power: AtxKeyConfig::default(),
- reset: AtxKeyConfig::default(),
- led: AtxLedConfig::default(),
- wol: WolConfig::default(),
- }
- }
-}
-```
-
----
-
-## 5. API ็ซฏ็น
-
-| ็ซฏ็น | ๆนๆณ | ๆ่ฟฐ |
-|------|------|------|
-| `/api/atx/status` | GET | ่ทๅ ATX ็ถๆ |
-| `/api/atx/power/short` | POST | ็ญๆ็ตๆบ |
-| `/api/atx/power/long` | POST | ้ฟๆ็ตๆบ |
-| `/api/atx/reset` | POST | ๆ้็ฝฎ |
-| `/api/atx/wol` | POST | ๅ้ WoL |
-
-### ๅๅบๆ ผๅผ
-
-```json
-// GET /api/atx/status
-{
- "available": true,
- "power_on": true,
- "last_action": "2024-01-15T10:30:00Z",
- "error": null
-}
-
-// POST /api/atx/wol
-// Request: { "mac": "00:11:22:33:44:55" }
-{
- "success": true
-}
-```
-
----
-
-## 6. ็กฌไปถ่ฟๆฅ
-
-### 6.1 GPIO ็ด่ฟ
-
-```
-One-KVM Device Target PC
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ
-โ GPIO Pin โโโโโโโโโโโโโโโโโ Power SW โ
-โ (Output) โ โ โ
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ
-
-ๆฅ็บฟ่ฏดๆ:
-- GPIO ๅผ่่ฟๆฅๅฐ ATX ็ตๆบๆ้ฎ
-- ไฝฟ็จๅ
่ฆๆ็ปง็ตๅจ้็ฆป (ๆจ่)
-- ๆณจๆ็ตๅนณๅน้
-```
-
-### 6.2 USB ็ปง็ตๅจ
-
-```
-One-KVM Device USB Relay Target PC
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ
-โ USB โโโโโโโโโโโโโโโโโ Relay โโโโโโโโโโโโ Power SW โ
-โ โ โ โ โ โ
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ
-
-ไผ็น:
-- ๅฎๅ
จ้็ฆป
-- ๆ ้ๆ
ๅฟ็ตๅนณ้ฎ้ข
-- ๆดๅฎๅ
จ
-```
-
----
-
-## 7. ไบไปถ
-
-```rust
-pub enum SystemEvent {
- AtxStateChanged {
- power_on: bool,
- last_action: Option,
- error: Option,
- },
-
- AtxActionPerformed {
- action: String, // "power_short" | "power_long" | "reset" | "wol"
- success: bool,
- },
-}
-```
-
----
-
-## 8. ้่ฏฏๅค็
-
-```rust
-#[derive(Debug, thiserror::Error)]
-pub enum AtxError {
- #[error("ATX not available")]
- NotAvailable,
-
- #[error("GPIO error: {0}")]
- GpioError(String),
-
- #[error("Relay error: {0}")]
- RelayError(String),
-
- #[error("WoL error: {0}")]
- WolError(String),
-
- #[error("Invalid MAC address: {0}")]
- InvalidMac(String),
-
- #[error("Operation in progress")]
- Busy,
-}
-```
-
----
-
-## 9. ไฝฟ็จ็คบไพ
-
-```rust
-let atx = AtxController::new(&config, events)?;
-
-// ๅผๆบ
-atx.power_short_press().await?;
-
-// ๆฃๆฅ็ถๆ
-tokio::time::sleep(Duration::from_secs(5)).await;
-if atx.power_state() == PowerState::On {
- println!("PC is now on");
-}
-
-// ๅผบๅถๅ
ณๆบ
-atx.power_long_press().await?;
-
-// ้็ฝฎ
-atx.reset_press().await?;
-
-// Wake-on-LAN
-atx.wake_on_lan("00:11:22:33:44:55").await?;
-```
-
----
-
-## 10. ๅธธ่ง้ฎ้ข
-
-### Q: GPIO ๆ ๆณๆงๅถ?
-
-1. ๆฃๆฅๅผ่้
็ฝฎ
-2. ๆฃๆฅๆ้ (`/dev/gpiochip*`)
-3. ๆฃๆฅๆฅ็บฟ
-
-### Q: LED ็ถๆไธๆญฃ็กฎ?
-
-1. ๆฃๆฅ active_level ้
็ฝฎ
-2. ๆฃๆฅ GPIO ่พๅ
ฅๆจกๅผ
-
-### Q: WoL ไธๅทฅไฝ?
-
-1. ๆฃๆฅ็ฎๆ PC BIOS ่ฎพ็ฝฎ
-2. ๆฃๆฅ็ฝๅกๆฏๆ
-3. ๆฃๆฅ็ฝ็ปๅนฟๆญ
diff --git a/docs/modules/audio.md b/docs/modules/audio.md
deleted file mode 100644
index 670f4469..00000000
--- a/docs/modules/audio.md
+++ /dev/null
@@ -1,463 +0,0 @@
-# Audio ๆจกๅๆๆกฃ
-
-## 1. ๆจกๅๆฆ่ฟฐ
-
-Audio ๆจกๅ่ด่ดฃ้ณ้ข้้ๅ็ผ็ ๏ผๆฏๆ ALSA ้้ๅ Opus ็ผ็ ใ
-
-### 1.1 ไธป่ฆๅ่ฝ
-
-- ALSA ้ณ้ข้้
-- Opus ็ผ็
-- ๅค่ดจ้้
็ฝฎ
-- WebSocket/WebRTC ไผ ่พ
-
-### 1.2 ๆไปถ็ปๆ
-
-```
-src/audio/
-โโโ mod.rs # ๆจกๅๅฏผๅบ
-โโโ controller.rs # AudioController (15KB)
-โโโ capture.rs # ALSA ้้ (12KB)
-โโโ encoder.rs # Opus ็ผ็ (8KB)
-โโโ shared_pipeline.rs # ๅ
ฑไบซ็ฎก้ (15KB)
-โโโ monitor.rs # ๅฅๅบท็่ง (11KB)
-โโโ device.rs # ่ฎพๅคๆไธพ (8KB)
-```
-
----
-
-## 2. ๆถๆ่ฎพ่ฎก
-
-```
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ Audio Architecture โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-ALSA Device (hw:0,0)
- โ
- โ PCM 48kHz/16bit/Stereo
- โผ
-โโโโโโโโโโโโโโโโโโโ
-โ AudioCapturer โ
-โ (capture.rs) โ
-โโโโโโโโโโฌโโโโโโโโโ
- โ
- โผ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ SharedAudioPipeline โ
-โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
-โ โ Opus Encoder โ โ
-โ โ 48kHz โ 24-96 kbps โ โ
-โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
-โโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโ
- โ
- โโโโโโโโโโโดโโโโโโโโโโ
- โ โ
- โผ โผ
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ
-โ WebSocket โ โ WebRTC โ
-โ Stream โ โ Audio Track โ
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ
-```
-
----
-
-## 3. ๆ ธๅฟ็ปไปถ
-
-### 3.1 AudioController (controller.rs)
-
-```rust
-pub struct AudioController {
- /// ้้ๅจ
- capturer: Arc>>,
-
- /// ๅ
ฑไบซ็ฎก้
- pipeline: Arc,
-
- /// ้
็ฝฎ
- config: Arc>,
-
- /// ็ถๆ
- state: Arc>,
-
- /// ไบไปถๆป็บฟ
- events: Arc,
-}
-
-impl AudioController {
- /// ๅๅปบๆงๅถๅจ
- pub fn new(config: &AudioConfig, events: Arc) -> Result;
-
- /// ๅฏๅจ้ณ้ข
- pub async fn start(&self) -> Result<()>;
-
- /// ๅๆญข้ณ้ข
- pub async fn stop(&self) -> Result<()>;
-
- /// ่ฎข้
้ณ้ขๅธง
- pub fn subscribe(&self) -> broadcast::Receiver;
-
- /// ่ทๅ็ถๆ
- pub fn status(&self) -> AudioStatus;
-
- /// ่ฎพ็ฝฎ่ดจ้
- pub fn set_quality(&self, quality: AudioQuality) -> Result<()>;
-
- /// ๅๅบ่ฎพๅค
- pub fn list_devices(&self) -> Vec;
-
- /// ้ๆฐๅ ่ฝฝ้
็ฝฎ
- pub async fn reload(&self, config: &AudioConfig) -> Result<()>;
-}
-
-pub struct AudioStatus {
- pub enabled: bool,
- pub streaming: bool,
- pub device: Option,
- pub sample_rate: u32,
- pub channels: u16,
- pub bitrate: u32,
- pub error: Option,
-}
-```
-
-### 3.2 AudioCapturer (capture.rs)
-
-```rust
-pub struct AudioCapturer {
- /// PCM ๅฅๆ
- pcm: PCM,
-
- /// ่ฎพๅคๅ
- device: String,
-
- /// ้ๆ ท็
- sample_rate: u32,
-
- /// ้้ๆฐ
- channels: u16,
-
- /// ๅธงๅคงๅฐ
- frame_size: usize,
-
- /// ่ฟ่ก็ถๆ
- running: AtomicBool,
-}
-
-impl AudioCapturer {
- /// ๆๅผ่ฎพๅค
- pub fn open(device: &str, config: &CaptureConfig) -> Result;
-
- /// ่ฏปๅ้ณ้ขๅธง
- pub fn read_frame(&self) -> Result>;
-
- /// ๅฏๅจ้้
- pub fn start(&self) -> Result<()>;
-
- /// ๅๆญข้้
- pub fn stop(&self);
-
- /// ๆฏๅฆ่ฟ่กไธญ
- pub fn is_running(&self) -> bool;
-}
-
-pub struct CaptureConfig {
- pub sample_rate: u32, // 48000
- pub channels: u16, // 2
- pub frame_size: usize, // 960 (20ms)
- pub buffer_size: usize, // 4800
-}
-```
-
-### 3.3 OpusEncoder (encoder.rs)
-
-```rust
-pub struct OpusEncoder {
- /// Opus ็ผ็ ๅจ
- encoder: audiopus::Encoder,
-
- /// ้ๆ ท็
- sample_rate: u32,
-
- /// ้้ๆฐ
- channels: u16,
-
- /// ๅธงๅคงๅฐ
- frame_size: usize,
-
- /// ็ ็
- bitrate: u32,
-}
-
-impl OpusEncoder {
- /// ๅๅปบ็ผ็ ๅจ
- pub fn new(quality: AudioQuality) -> Result;
-
- /// ็ผ็ PCM ๆฐๆฎ
- pub fn encode(&mut self, pcm: &[i16]) -> Result>;
-
- /// ่ฎพ็ฝฎ็ ็
- pub fn set_bitrate(&mut self, bitrate: u32) -> Result<()>;
-
- /// ่ทๅ็ ็
- pub fn bitrate(&self) -> u32;
-
- /// ้็ฝฎ็ผ็ ๅจ
- pub fn reset(&mut self) -> Result<()>;
-}
-```
-
-### 3.4 SharedAudioPipeline (shared_pipeline.rs)
-
-```rust
-pub struct SharedAudioPipeline {
- /// ้้ๅจ
- capturer: Arc>>,
-
- /// ็ผ็ ๅจ
- encoder: Arc>,
-
- /// ๅนฟๆญ้้
- tx: broadcast::Sender,
-
- /// ้้ไปปๅก
- capture_task: Arc>>>,
-
- /// ้
็ฝฎ
- config: Arc>,
-}
-
-impl SharedAudioPipeline {
- /// ๅๅปบ็ฎก้
- pub fn new(config: &AudioConfig) -> Result;
-
- /// ๅฏๅจ็ฎก้
- pub async fn start(&self) -> Result<()>;
-
- /// ๅๆญข็ฎก้
- pub async fn stop(&self) -> Result<()>;
-
- /// ่ฎข้
้ณ้ขๅธง
- pub fn subscribe(&self) -> broadcast::Receiver;
-
- /// ่ทๅ็ป่ฎก
- pub fn stats(&self) -> PipelineStats;
-}
-
-pub struct AudioFrame {
- /// Opus ๆฐๆฎ
- pub data: Bytes,
-
- /// ๆถ้ดๆณ
- pub timestamp: u64,
-
- /// ๅธงๅบๅท
- pub sequence: u64,
-}
-```
-
----
-
-## 4. ้ณ้ข่ดจ้
-
-```rust
-pub enum AudioQuality {
- /// 24 kbps - ๆไฝๅธฆๅฎฝ
- VeryLow,
-
- /// 48 kbps - ไฝๅธฆๅฎฝ
- Low,
-
- /// 64 kbps - ไธญ็ญ
- Medium,
-
- /// 96 kbps - ้ซ่ดจ้
- High,
-}
-
-impl AudioQuality {
- pub fn bitrate(&self) -> u32 {
- match self {
- Self::VeryLow => 24000,
- Self::Low => 48000,
- Self::Medium => 64000,
- Self::High => 96000,
- }
- }
-}
-```
-
----
-
-## 5. ้
็ฝฎ
-
-```rust
-#[derive(Serialize, Deserialize)]
-#[typeshare]
-pub struct AudioConfig {
- /// ๆฏๅฆๅฏ็จ
- pub enabled: bool,
-
- /// ่ฎพๅคๅ
- pub device: Option,
-
- /// ้ณ้ข่ดจ้
- pub quality: AudioQuality,
-
- /// ่ชๅจๅฏๅจ
- pub auto_start: bool,
-}
-
-impl Default for AudioConfig {
- fn default() -> Self {
- Self {
- enabled: true,
- device: None, // ไฝฟ็จ้ป่ฎค่ฎพๅค
- quality: AudioQuality::Medium,
- auto_start: false,
- }
- }
-}
-```
-
----
-
-## 6. API ็ซฏ็น
-
-| ็ซฏ็น | ๆนๆณ | ๆ่ฟฐ |
-|------|------|------|
-| `/api/audio/status` | GET | ่ทๅ้ณ้ข็ถๆ |
-| `/api/audio/start` | POST | ๅฏๅจ้ณ้ข |
-| `/api/audio/stop` | POST | ๅๆญข้ณ้ข |
-| `/api/audio/devices` | GET | ๅๅบ่ฎพๅค |
-| `/api/audio/quality` | GET | ่ทๅ่ดจ้ |
-| `/api/audio/quality` | POST | ่ฎพ็ฝฎ่ดจ้ |
-| `/api/ws/audio` | WS | ้ณ้ขๆต |
-
-### ๅๅบๆ ผๅผ
-
-```json
-// GET /api/audio/status
-{
- "enabled": true,
- "streaming": true,
- "device": "hw:0,0",
- "sample_rate": 48000,
- "channels": 2,
- "bitrate": 64000,
- "error": null
-}
-
-// GET /api/audio/devices
-{
- "devices": [
- {
- "name": "hw:0,0",
- "description": "USB Audio Device",
- "is_default": true
- }
- ]
-}
-```
-
----
-
-## 7. WebSocket ้ณ้ขๆต
-
-```javascript
-// ่ฟๆฅ WebSocket
-const ws = new WebSocket('/api/ws/audio');
-ws.binaryType = 'arraybuffer';
-
-// ๅๅงๅ Opus ่งฃ็ ๅจ
-const decoder = new OpusDecoder();
-
-// ๆฅๆถ้ณ้ขๅธง
-ws.onmessage = (event) => {
- const frame = new Uint8Array(event.data);
- const pcm = decoder.decode(frame);
- audioContext.play(pcm);
-};
-```
-
----
-
-## 8. ไบไปถ
-
-```rust
-pub enum SystemEvent {
- AudioStateChanged {
- enabled: bool,
- streaming: bool,
- device: Option,
- error: Option,
- },
-}
-```
-
----
-
-## 9. ้่ฏฏๅค็
-
-```rust
-#[derive(Debug, thiserror::Error)]
-pub enum AudioError {
- #[error("Device not found: {0}")]
- DeviceNotFound(String),
-
- #[error("Device busy: {0}")]
- DeviceBusy(String),
-
- #[error("ALSA error: {0}")]
- AlsaError(String),
-
- #[error("Encoder error: {0}")]
- EncoderError(String),
-
- #[error("Not streaming")]
- NotStreaming,
-}
-```
-
----
-
-## 10. ไฝฟ็จ็คบไพ
-
-```rust
-let controller = AudioController::new(&config, events)?;
-
-// ๅฏๅจ้ณ้ข
-controller.start().await?;
-
-// ่ฎข้
้ณ้ขๅธง
-let mut rx = controller.subscribe();
-while let Ok(frame) = rx.recv().await {
- // ๅค็ Opus ๆฐๆฎ
- send_to_client(frame.data);
-}
-
-// ๅๆญข
-controller.stop().await?;
-```
-
----
-
-## 11. ๅธธ่ง้ฎ้ข
-
-### Q: ๆพไธๅฐ้ณ้ข่ฎพๅค?
-
-1. ๆฃๆฅ ALSA ้
็ฝฎ
-2. ่ฟ่ก `arecord -l`
-3. ๆฃๆฅๆ้
-
-### Q: ้ณ้ขๅปถ่ฟ้ซ?
-
-1. ๅๅฐๅธงๅคงๅฐ
-2. ้ไฝ่ดจ้
-3. ๆฃๆฅ็ฝ็ป
-
-### Q: ้ณ้ขๆญๆญ็ปญ็ปญ?
-
-1. ๅขๅคง็ผๅฒๅบ
-2. ๆฃๆฅ CPU ่ด่ฝฝ
-3. ไฝฟ็จๆดไฝ่ดจ้
diff --git a/docs/modules/auth.md b/docs/modules/auth.md
deleted file mode 100644
index a1e4a4b6..00000000
--- a/docs/modules/auth.md
+++ /dev/null
@@ -1,340 +0,0 @@
-# Auth ๆจกๅๆๆกฃ
-
-## 1. ๆจกๅๆฆ่ฟฐ
-
-Auth ๆจกๅๆไพ็จๆท่ฎค่ฏๅไผ่ฏ็ฎก็ๅ่ฝใ
-
-### 1.1 ไธป่ฆๅ่ฝ
-
-- ็จๆท็ฎก็
-- ๅฏ็ ๅๅธ (Argon2)
-- ไผ่ฏ็ฎก็
-- ่ฎค่ฏไธญ้ดไปถ
-- ๆ้ๆงๅถ
-
-### 1.2 ๆไปถ็ปๆ
-
-```
-src/auth/
-โโโ mod.rs # ๆจกๅๅฏผๅบ
-โโโ user.rs # ็จๆท็ฎก็ (5KB)
-โโโ session.rs # ไผ่ฏ็ฎก็ (4KB)
-โโโ password.rs # ๅฏ็ ๅๅธ (1KB)
-โโโ middleware.rs # ไธญ้ดไปถ (4KB)
-```
-
----
-
-## 2. ๆ ธๅฟ็ปไปถ
-
-### 2.1 UserStore (user.rs)
-
-```rust
-pub struct UserStore {
- db: Pool,
-}
-
-impl UserStore {
- /// ๅๅปบๅญๅจ
- pub async fn new(db: Pool) -> Result;
-
- /// ๅๅปบ็จๆท
- pub async fn create_user(&self, user: &CreateUser) -> Result;
-
- /// ่ทๅ็จๆท
- pub async fn get_user(&self, id: &str) -> Result>;
-
- /// ๆ็จๆทๅ่ทๅ
- pub async fn get_by_username(&self, username: &str) -> Result>;
-
- /// ๆดๆฐ็จๆท
- pub async fn update_user(&self, id: &str, update: &UpdateUser) -> Result<()>;
-
- /// ๅ ้ค็จๆท
- pub async fn delete_user(&self, id: &str) -> Result<()>;
-
- /// ๅๅบ็จๆท
- pub async fn list_users(&self) -> Result>;
-
- /// ้ช่ฏๅฏ็
- pub async fn verify_password(&self, username: &str, password: &str) -> Result>;
-
- /// ๆดๆฐๅฏ็
- pub async fn update_password(&self, id: &str, new_password: &str) -> Result<()>;
-
- /// ๆฃๆฅๆฏๅฆ้่ฆๅๅงๅ
- pub async fn needs_setup(&self) -> Result;
-}
-
-pub struct User {
- pub id: String,
- pub username: String,
- pub role: UserRole,
- pub created_at: DateTime,
-}
-
-pub enum UserRole {
- Admin,
- User,
-}
-
-pub struct CreateUser {
- pub username: String,
- pub password: String,
- pub role: UserRole,
-}
-```
-
-### 2.2 SessionStore (session.rs)
-
-```rust
-pub struct SessionStore {
- /// ไผ่ฏๆ ๅฐ
- sessions: RwLock>,
-
- /// ไผ่ฏ่ถ
ๆถ
- timeout: Duration,
-}
-
-impl SessionStore {
- /// ๅๅปบๅญๅจ
- pub fn new(timeout: Duration) -> Self;
-
- /// ๅๅปบไผ่ฏ
- pub fn create_session(&self, user: &User) -> String;
-
- /// ่ทๅไผ่ฏ
- pub fn get_session(&self, token: &str) -> Option;
-
- /// ๅ ้คไผ่ฏ
- pub fn delete_session(&self, token: &str);
-
- /// ๆธ
็่ฟๆไผ่ฏ
- pub fn cleanup_expired(&self);
-
- /// ๅทๆฐไผ่ฏ
- pub fn refresh_session(&self, token: &str) -> bool;
-}
-
-pub struct Session {
- pub token: String,
- pub user_id: String,
- pub username: String,
- pub role: UserRole,
- pub created_at: Instant,
- pub last_active: Instant,
-}
-```
-
-### 2.3 ๅฏ็ ๅๅธ (password.rs)
-
-```rust
-/// ๅๅธๅฏ็
-pub fn hash_password(password: &str) -> Result {
- let salt = SaltString::generate(&mut OsRng);
- let argon2 = Argon2::default();
- let hash = argon2
- .hash_password(password.as_bytes(), &salt)?
- .to_string();
- Ok(hash)
-}
-
-/// ้ช่ฏๅฏ็
-pub fn verify_password(password: &str, hash: &str) -> Result {
- let parsed_hash = PasswordHash::new(hash)?;
- Ok(Argon2::default()
- .verify_password(password.as_bytes(), &parsed_hash)
- .is_ok())
-}
-```
-
-### 2.4 ่ฎค่ฏไธญ้ดไปถ (middleware.rs)
-
-```rust
-pub async fn auth_middleware(
- State(state): State>,
- cookies: Cookies,
- request: Request,
- next: Next,
-) -> Response {
- // ่ทๅ session token
- let token = cookies
- .get("session_id")
- .map(|c| c.value().to_string());
-
- // ้ช่ฏไผ่ฏ
- let session = token
- .and_then(|t| state.sessions.get_session(&t));
-
- if let Some(session) = session {
- // ๅฐ็จๆทไฟกๆฏๆณจๅ
ฅ่ฏทๆฑ
- let mut request = request;
- request.extensions_mut().insert(session);
- next.run(request).await
- } else {
- StatusCode::UNAUTHORIZED.into_response()
- }
-}
-
-pub async fn admin_middleware(
- session: Extension,
- request: Request,
- next: Next,
-) -> Response {
- if session.role == UserRole::Admin {
- next.run(request).await
- } else {
- StatusCode::FORBIDDEN.into_response()
- }
-}
-```
-
----
-
-## 3. API ็ซฏ็น
-
-| ็ซฏ็น | ๆนๆณ | ๆ้ | ๆ่ฟฐ |
-|------|------|------|------|
-| `/api/auth/login` | POST | Public | ็ปๅฝ |
-| `/api/auth/logout` | POST | User | ็ปๅบ |
-| `/api/auth/check` | GET | User | ๆฃๆฅ่ฎค่ฏ |
-| `/api/auth/password` | POST | User | ไฟฎๆนๅฏ็ |
-| `/api/users` | GET | Admin | ๅๅบ็จๆท |
-| `/api/users` | POST | Admin | ๅๅปบ็จๆท |
-| `/api/users/:id` | DELETE | Admin | ๅ ้ค็จๆท |
-| `/api/setup/init` | POST | Public | ๅๅงๅ่ฎพ็ฝฎ |
-
-### ่ฏทๆฑ/ๅๅบๆ ผๅผ
-
-```json
-// POST /api/auth/login
-// Request:
-{
- "username": "admin",
- "password": "password123"
-}
-
-// Response:
-{
- "user": {
- "id": "uuid",
- "username": "admin",
- "role": "admin"
- }
-}
-
-// GET /api/auth/check
-{
- "authenticated": true,
- "user": {
- "id": "uuid",
- "username": "admin",
- "role": "admin"
- }
-}
-```
-
----
-
-## 4. ้
็ฝฎ
-
-```rust
-#[derive(Serialize, Deserialize)]
-#[typeshare]
-pub struct AuthConfig {
- /// ไผ่ฏ่ถ
ๆถ (็ง)
- pub session_timeout_secs: u64,
-
- /// ๆฏๅฆๅฏ็จ่ฎค่ฏ
- pub enabled: bool,
-}
-
-impl Default for AuthConfig {
- fn default() -> Self {
- Self {
- session_timeout_secs: 86400, // 24 ๅฐๆถ
- enabled: true,
- }
- }
-}
-```
-
----
-
-## 5. ๅฎๅ
จ็นๆง
-
-### 5.1 ๅฏ็ ๅญๅจ
-
-- Argon2id ๅๅธ
-- ้ๆบ็ๅผ
-- ไธๅฏ้
-
-### 5.2 ไผ่ฏๅฎๅ
จ
-
-- ้ๆบ token (UUID v4)
-- HTTPOnly Cookie
-- ไผ่ฏ่ถ
ๆถ
-- ่ชๅจๆธ
็
-
-### 5.3 ๆ้ๆงๅถ
-
-- ไธค็บงๆ้: Admin / User
-- ไธญ้ดไปถๆฃๆฅ
-- ๆๆๆไฝ้ Admin
-
----
-
-## 6. ไฝฟ็จ็คบไพ
-
-```rust
-// ๅๅปบ็จๆท
-let user = users.create_user(&CreateUser {
- username: "admin".to_string(),
- password: "password123".to_string(),
- role: UserRole::Admin,
-}).await?;
-
-// ้ช่ฏๅฏ็
-if let Some(user) = users.verify_password("admin", "password123").await? {
- // ๅๅปบไผ่ฏ
- let token = sessions.create_session(&user);
-
- // ่ฎพ็ฝฎ Cookie
- cookies.add(Cookie::build("session_id", token)
- .http_only(true)
- .path("/")
- .finish());
-}
-
-// ่ทๅไผ่ฏ
-if let Some(session) = sessions.get_session(&token) {
- println!("User: {}", session.username);
-}
-```
-
----
-
-## 7. ้่ฏฏๅค็
-
-```rust
-#[derive(Debug, thiserror::Error)]
-pub enum AuthError {
- #[error("Invalid credentials")]
- InvalidCredentials,
-
- #[error("User not found")]
- UserNotFound,
-
- #[error("User already exists")]
- UserExists,
-
- #[error("Session expired")]
- SessionExpired,
-
- #[error("Permission denied")]
- PermissionDenied,
-
- #[error("Setup required")]
- SetupRequired,
-}
-```
diff --git a/docs/modules/config.md b/docs/modules/config.md
deleted file mode 100644
index 9e1cf34d..00000000
--- a/docs/modules/config.md
+++ /dev/null
@@ -1,755 +0,0 @@
-# Config ๆจกๅๆๆกฃ
-
-## 1. ๆจกๅๆฆ่ฟฐ
-
-Config ๆจกๅๆไพ้
็ฝฎ็ฎก็ๅ่ฝ๏ผๆๆ้
็ฝฎๅญๅจๅจ SQLite ๆฐๆฎๅบไธญ๏ผไฝฟ็จ ArcSwap ๅฎ็ฐๆ ้่ฏปๅ๏ผๆไพ้ซๆง่ฝ้
็ฝฎ่ฎฟ้ฎใ
-
-### 1.1 ไธป่ฆๅ่ฝ
-
-- SQLite ้
็ฝฎๅญๅจ๏ผๆไน
ๅ๏ผ
-- ๆ ้้
็ฝฎ่ฏปๅ๏ผArcSwap๏ผ
-- ็ฑปๅๅฎๅ
จ็้
็ฝฎ็ปๆ
-- ้
็ฝฎๅๆด้็ฅ๏ผbroadcast channel๏ผ
-- TypeScript ็ฑปๅ็ๆ๏ผtypeshare๏ผ
-- RESTful API๏ผๆๅ่ฝๅๅ็ฆป๏ผ
-
-### 1.2 ๆไปถ็ปๆ
-
-```
-src/config/
-โโโ mod.rs # ๆจกๅๅฏผๅบ
-โโโ schema.rs # ้
็ฝฎ็ปๆๅฎไน๏ผๅ
ๅซๆๆๅญ้
็ฝฎ๏ผ
-โโโ store.rs # SQLite ๅญๅจไธๆ ้็ผๅญ
-```
-
----
-
-## 2. ๆ ธๅฟ็ปไปถ
-
-### 2.1 ConfigStore (store.rs)
-
-้
็ฝฎๅญๅจไฝฟ็จ **ArcSwap** ๅฎ็ฐๆ ้่ฏปๅ๏ผๆไพๆฅ่ฟ้ถๆๆฌ็้
็ฝฎ่ฎฟ้ฎๆง่ฝ๏ผ
-
-```rust
-pub struct ConfigStore {
- pool: Pool,
- /// ๆ ้็ผๅญ๏ผไฝฟ็จ ArcSwap ๅฎ็ฐ้ถๆๆฌ่ฏปๅ
- cache: Arc>,
- /// ้
็ฝฎๅๆด้็ฅ้้
- change_tx: broadcast::Sender,
-}
-
-impl ConfigStore {
- /// ๅๅปบๅญๅจ
- pub async fn new(db_path: &Path) -> Result;
-
- /// ่ทๅๅฝๅ้
็ฝฎ๏ผๆ ้๏ผ้ถๆท่ด๏ผ
- ///
- /// ่ฟๅ Arc๏ผ้ซๆๅ
ฑไบซๆ ้ๅ
้
- /// ่ฟๆฏไธไธชๆ ้ๆไฝ๏ผๅผ้ๆๅฐ
- pub fn get(&self) -> Arc;
-
- /// ่ฎพ็ฝฎๅฎๆด้
็ฝฎ
- pub async fn set(&self, config: AppConfig) -> Result<()>;
-
- /// ไฝฟ็จ้ญๅ
ๆดๆฐ้
็ฝฎ
- ///
- /// ่ฏป-ไฟฎๆน-ๅๆจกๅผใๅนถๅๆดๆฐๆถ๏ผๆๅ็ๅๅ
ฅ่ท่ใ
- /// ๅฏนไบไธ้ข็น็็จๆท่งฆๅ้
็ฝฎๆดๆนๆฅ่ฏดๆฏๅฏๆฅๅ็ใ
- pub async fn update(&self, f: F) -> Result<()>
- where
- F: FnOnce(&mut AppConfig);
-
- /// ่ฎข้
้
็ฝฎๅๆดไบไปถ
- pub fn subscribe(&self) -> broadcast::Receiver;
-
- /// ๆฃๆฅ็ณป็ปๆฏๅฆๅทฒๅๅงๅ๏ผๆ ้๏ผ
- pub fn is_initialized(&self) -> bool;
-
- /// ่ทๅๆฐๆฎๅบ่ฟๆฅๆฑ ๏ผ็จไบไผ่ฏ็ฎก็๏ผ
- pub fn pool(&self) -> &Pool;
-}
-```
-
-**ๆง่ฝ็น็น**๏ผ
-- `get()` ๆฏๆ ้่ฏปๅๆไฝ๏ผ่ฟๅ `Arc`๏ผๆ ้ๅ
้
-- ้
็ฝฎ่ฏปๅ้ข็่ฟ้ซไบๅๅ
ฅ๏ผArcSwap ไผๅไบ่ฏปๅ่ทฏๅพ
-- ๅๅ
ฅๆไฝๅ
ๆไน
ๅๅฐๆฐๆฎๅบ๏ผๅๅๅญๆงๆดๆฐๅ
ๅญ็ผๅญ
-- ไฝฟ็จ broadcast channel ้็ฅ้
็ฝฎๅๆด๏ผๆฏๆๅค่ฎข้
่
-
-**ๆฐๆฎๅบ่ฟๆฅๆฑ ้
็ฝฎ**๏ผ
-```rust
-SqlitePoolOptions::new()
- .max_connections(2) // SQLite ๅๅๆจกๅผ๏ผ2 ไธช่ฟๆฅ่ถณๅค
- .acquire_timeout(Duration::from_secs(5))
- .idle_timeout(Duration::from_secs(300))
-```
-
-### 2.2 AppConfig (schema.rs)
-
-ไธปๅบ็จ้
็ฝฎ็ปๆ๏ผๅ
ๅซๆๆๅญ็ณป็ป็้
็ฝฎ๏ผ
-
-```rust
-#[derive(Debug, Clone, Serialize, Deserialize)]
-#[serde(default)]
-#[typeshare]
-pub struct AppConfig {
- /// ๅๅง่ฎพ็ฝฎๆฏๅฆๅฎๆ
- pub initialized: bool,
-
- /// ่ฎค่ฏ้
็ฝฎ
- pub auth: AuthConfig,
-
- /// ่ง้ข้้้
็ฝฎ
- pub video: VideoConfig,
-
- /// HID๏ผ้ฎ็/้ผ ๆ ๏ผ้
็ฝฎ
- pub hid: HidConfig,
-
- /// MSD๏ผๅคงๅฎน้ๅญๅจ๏ผ้
็ฝฎ
- pub msd: MsdConfig,
-
- /// ATX ็ตๆบๆงๅถ้
็ฝฎ
- pub atx: AtxConfig,
-
- /// ้ณ้ข้
็ฝฎ
- pub audio: AudioConfig,
-
- /// ๆตๅชไฝ้
็ฝฎ
- pub stream: StreamConfig,
-
- /// Web ๆๅกๅจ้
็ฝฎ
- pub web: WebConfig,
-
- /// ๆฉๅฑ้
็ฝฎ๏ผttyd, gostc, easytier๏ผ
- pub extensions: ExtensionsConfig,
-
- /// RustDesk ่ฟ็จ่ฎฟ้ฎ้
็ฝฎ
- pub rustdesk: RustDeskConfig,
-}
-```
-
-### 2.3 ไธป่ฆๅญ้
็ฝฎ็ปๆ
-
-#### AuthConfig - ่ฎค่ฏ้
็ฝฎ
-
-```rust
-#[derive(Debug, Clone, Serialize, Deserialize)]
-#[serde(default)]
-#[typeshare]
-pub struct AuthConfig {
- /// ไผ่ฏ่ถ
ๆถๆถ้ด๏ผ็ง๏ผ
- pub session_timeout_secs: u32, // ้ป่ฎค 86400๏ผ24ๅฐๆถ๏ผ
- /// ๅฏ็จๅๅ ็ด ่ฎค่ฏ
- pub totp_enabled: bool,
- /// TOTP ๅฏ้ฅ๏ผๅ ๅฏๅญๅจ๏ผ
- pub totp_secret: Option,
-}
-```
-
-#### VideoConfig - ่ง้ข้้้
็ฝฎ
-
-```rust
-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
-#[serde(default)]
-#[typeshare]
-pub struct VideoConfig {
- /// ่ง้ข่ฎพๅค่ทฏๅพ๏ผๅฆ /dev/video0๏ผ
- pub device: Option,
- /// ๅ็ด ๆ ผๅผ๏ผๅฆ "MJPEG", "YUYV", "NV12"๏ผ
- pub format: Option,
- /// ๅ่พจ็ๅฎฝๅบฆ
- pub width: u32, // ้ป่ฎค 1920
- /// ๅ่พจ็้ซๅบฆ
- pub height: u32, // ้ป่ฎค 1080
- /// ๅธง็
- pub fps: u32, // ้ป่ฎค 30
- /// JPEG ่ดจ้๏ผ1-100๏ผ
- pub quality: u32, // ้ป่ฎค 80
-}
-```
-
-#### HidConfig - HID ้
็ฝฎ
-
-```rust
-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
-#[serde(default)]
-#[typeshare]
-pub struct HidConfig {
- /// HID ๅ็ซฏ็ฑปๅ
- pub backend: HidBackend, // Otg | Ch9329 | None
- /// OTG ้ฎ็่ฎพๅค่ทฏๅพ
- pub otg_keyboard: String, // ้ป่ฎค "/dev/hidg0"
- /// OTG ้ผ ๆ ่ฎพๅค่ทฏๅพ
- pub otg_mouse: String, // ้ป่ฎค "/dev/hidg1"
- /// OTG UDC๏ผUSB ่ฎพๅคๆงๅถๅจ๏ผๅ็งฐ
- pub otg_udc: Option,
- /// OTG USB ่ฎพๅคๆ่ฟฐ็ฌฆ้
็ฝฎ
- pub otg_descriptor: OtgDescriptorConfig,
- /// CH9329 ไธฒๅฃ่ทฏๅพ
- pub ch9329_port: String, // ้ป่ฎค "/dev/ttyUSB0"
- /// CH9329 ๆณข็น็
- pub ch9329_baudrate: u32, // ้ป่ฎค 9600
- /// ้ผ ๆ ๆจกๅผ๏ผ็ปๅฏนๅฎไฝๆ็ธๅฏนๅฎไฝ
- pub mouse_absolute: bool, // ้ป่ฎค true
-}
-
-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
-#[typeshare]
-pub struct OtgDescriptorConfig {
- pub vendor_id: u16, // ้ป่ฎค 0x1d6b๏ผLinux Foundation๏ผ
- pub product_id: u16, // ้ป่ฎค 0x0104
- pub manufacturer: String, // ้ป่ฎค "One-KVM"
- pub product: String, // ้ป่ฎค "One-KVM USB Device"
- pub serial_number: Option,
-}
-```
-
-#### StreamConfig - ๆตๅชไฝ้
็ฝฎ
-
-```rust
-#[derive(Debug, Clone, Serialize, Deserialize)]
-#[serde(default)]
-#[typeshare]
-pub struct StreamConfig {
- /// ๆตๆจกๅผ๏ผWebRTC | Mjpeg๏ผ
- pub mode: StreamMode,
- /// ็ผ็ ๅจ็ฑปๅ
- pub encoder: EncoderType, // Auto | Software | Vaapi | Nvenc | Qsv | Amf | Rkmpp | V4l2m2m
- /// ็ ็้ข่ฎพ๏ผSpeed | Balanced | Quality๏ผ
- pub bitrate_preset: BitratePreset,
- /// ่ชๅฎไน STUN ๆๅกๅจ
- pub stun_server: Option, // ้ป่ฎค "stun:stun.l.google.com:19302"
- /// ่ชๅฎไน TURN ๆๅกๅจ
- pub turn_server: Option,
- /// TURN ็จๆทๅ
- pub turn_username: Option,
- /// TURN ๅฏ็ ๏ผๅ ๅฏๅญๅจ๏ผไธ้่ฟ API ๆด้ฒ๏ผ
- pub turn_password: Option,
- /// ๆ ๅฎขๆท็ซฏๆถ่ชๅจๆๅ
- #[typeshare(skip)]
- pub auto_pause_enabled: bool,
- /// ่ชๅจๆๅๅปถ่ฟ๏ผ็ง๏ผ
- #[typeshare(skip)]
- pub auto_pause_delay_secs: u64,
- /// ๅฎขๆท็ซฏ่ถ
ๆถๆธ
็๏ผ็ง๏ผ
- #[typeshare(skip)]
- pub client_timeout_secs: u64,
-}
-```
-
-#### MsdConfig - ๅคงๅฎน้ๅญๅจ้
็ฝฎ
-
-```rust
-#[derive(Debug, Clone, Serialize, Deserialize)]
-#[serde(default)]
-#[typeshare]
-pub struct MsdConfig {
- /// ๅฏ็จ MSD ๅ่ฝ
- pub enabled: bool, // ้ป่ฎค true
- /// ISO/IMG ้ๅๅญๅจ่ทฏๅพ
- pub images_path: String, // ้ป่ฎค "./data/msd/images"
- /// Ventoy ๅฏๅจ้ฉฑๅจๅจๆไปถ่ทฏๅพ
- pub drive_path: String, // ้ป่ฎค "./data/msd/ventoy.img"
- /// ่ๆ้ฉฑๅจๅจๅคงๅฐ๏ผMB๏ผๆๅฐ 1024๏ผ
- pub virtual_drive_size_mb: u32, // ้ป่ฎค 16384๏ผ16GB๏ผ
-}
-```
-
-#### AtxConfig - ATX ็ตๆบๆงๅถ้
็ฝฎ
-
-```rust
-#[derive(Debug, Clone, Serialize, Deserialize)]
-#[serde(default)]
-#[typeshare]
-pub struct AtxConfig {
- /// ๅฏ็จ ATX ๅ่ฝ
- pub enabled: bool,
- /// ็ตๆบๆ้ฎ้
็ฝฎ๏ผ็ญๆๅ้ฟๆๅ
ฑ็จ๏ผ
- pub power: AtxKeyConfig,
- /// ้็ฝฎๆ้ฎ้
็ฝฎ
- pub reset: AtxKeyConfig,
- /// LED ๆฃๆต้
็ฝฎ๏ผๅฏ้๏ผ
- pub led: AtxLedConfig,
- /// WOL ๆฐๆฎๅ
ไฝฟ็จ็็ฝ็ปๆฅๅฃ๏ผ็ฉบๅญ็ฌฆไธฒ = ่ชๅจ๏ผ
- pub wol_interface: String,
-}
-```
-
-#### AudioConfig - ้ณ้ข้
็ฝฎ
-
-```rust
-#[derive(Debug, Clone, Serialize, Deserialize)]
-#[serde(default)]
-#[typeshare]
-pub struct AudioConfig {
- /// ๅฏ็จ้ณ้ข้้
- pub enabled: bool, // ้ป่ฎค false
- /// ALSA ่ฎพๅคๅ็งฐ
- pub device: String, // ้ป่ฎค "default"
- /// ้ณ้ข่ดจ้้ข่ฎพ๏ผ"voice" | "balanced" | "high"
- pub quality: String, // ้ป่ฎค "balanced"
-}
-```
-
-**ๆณจๆ**๏ผ้ๆ ท็ๅบๅฎไธบ 48000Hz๏ผๅฃฐ้ๅบๅฎไธบ 2๏ผ็ซไฝๅฃฐ๏ผ๏ผ่ฟๆฏ Opus ็ผ็ ๅ WebRTC ็ๆไฝณ้
็ฝฎใ
-
-#### WebConfig - Web ๆๅกๅจ้
็ฝฎ
-
-```rust
-#[derive(Debug, Clone, Serialize, Deserialize)]
-#[serde(default)]
-#[typeshare]
-pub struct WebConfig {
- /// HTTP ็ซฏๅฃ
- pub http_port: u16, // ้ป่ฎค 8080
- /// HTTPS ็ซฏๅฃ
- pub https_port: u16, // ้ป่ฎค 8443
- /// ็ปๅฎๅฐๅ
- pub bind_address: String, // ้ป่ฎค "0.0.0.0"
- /// ๅฏ็จ HTTPS
- pub https_enabled: bool, // ้ป่ฎค false
- /// ่ชๅฎไน SSL ่ฏไนฆ่ทฏๅพ
- pub ssl_cert_path: Option,
- /// ่ชๅฎไน SSL ๅฏ้ฅ่ทฏๅพ
- pub ssl_key_path: Option,
-}
-```
-
----
-
-## 3. TypeScript ็ฑปๅ็ๆ
-
-ไฝฟ็จ `#[typeshare]` ๅฑๆง่ชๅจ็ๆ TypeScript ็ฑปๅ๏ผ
-
-```rust
-#[derive(Serialize, Deserialize)]
-#[typeshare]
-pub struct VideoConfig {
- pub device: Option,
- pub width: u32,
- pub height: u32,
-}
-```
-
-็ๆ็ TypeScript๏ผ
-
-```typescript
-export interface VideoConfig {
- device?: string;
- width: number;
- height: number;
-}
-```
-
-็ๆๅฝไปค๏ผ
-
-```bash
-./scripts/generate-types.sh
-# ๆ
-typeshare src --lang=typescript --output-file=web/src/types/generated.ts
-```
-
----
-
-## 4. API ็ซฏ็น
-
-ๆๆ้
็ฝฎ็ซฏ็นๅ้่ฆ **Admin** ๆ้๏ผ้็จ RESTful ่ฎพ่ฎก๏ผๆๅ่ฝๅๅ็ฆปใ
-
-### 4.1 ๅ
จๅฑ้
็ฝฎ
-
-| ็ซฏ็น | ๆนๆณ | ๆ้ | ๆ่ฟฐ |
-|------|------|------|------|
-| `/api/config` | GET | Admin | ่ทๅๅฎๆด้
็ฝฎ๏ผๆๆไฟกๆฏๅทฒ่ฟๆปค๏ผ |
-| `/api/config` | POST | Admin | ๆดๆฐๅฎๆด้
็ฝฎ๏ผๅทฒๅบๅผ๏ผ่ฏทไฝฟ็จๆๅ PATCH๏ผ |
-
-### 4.2 ๅๅ้
็ฝฎ็ซฏ็น
-
-| ็ซฏ็น | ๆนๆณ | ๆ้ | ๆ่ฟฐ |
-|------|------|------|------|
-| `/api/config/video` | GET | Admin | ่ทๅ่ง้ข้
็ฝฎ |
-| `/api/config/video` | PATCH | Admin | ๆดๆฐ่ง้ข้
็ฝฎ๏ผ้จๅๆดๆฐ๏ผ |
-| `/api/config/stream` | GET | Admin | ่ทๅๆต้
็ฝฎ |
-| `/api/config/stream` | PATCH | Admin | ๆดๆฐๆต้
็ฝฎ๏ผ้จๅๆดๆฐ๏ผ |
-| `/api/config/hid` | GET | Admin | ่ทๅ HID ้
็ฝฎ |
-| `/api/config/hid` | PATCH | Admin | ๆดๆฐ HID ้
็ฝฎ๏ผ้จๅๆดๆฐ๏ผ |
-| `/api/config/msd` | GET | Admin | ่ทๅ MSD ้
็ฝฎ |
-| `/api/config/msd` | PATCH | Admin | ๆดๆฐ MSD ้
็ฝฎ๏ผ้จๅๆดๆฐ๏ผ |
-| `/api/config/atx` | GET | Admin | ่ทๅ ATX ้
็ฝฎ |
-| `/api/config/atx` | PATCH | Admin | ๆดๆฐ ATX ้
็ฝฎ๏ผ้จๅๆดๆฐ๏ผ |
-| `/api/config/audio` | GET | Admin | ่ทๅ้ณ้ข้
็ฝฎ |
-| `/api/config/audio` | PATCH | Admin | ๆดๆฐ้ณ้ข้
็ฝฎ๏ผ้จๅๆดๆฐ๏ผ |
-| `/api/config/web` | GET | Admin | ่ทๅ Web ๆๅกๅจ้
็ฝฎ |
-| `/api/config/web` | PATCH | Admin | ๆดๆฐ Web ๆๅกๅจ้
็ฝฎ๏ผ้จๅๆดๆฐ๏ผ |
-
-### 4.3 RustDesk ้
็ฝฎ็ซฏ็น
-
-| ็ซฏ็น | ๆนๆณ | ๆ้ | ๆ่ฟฐ |
-|------|------|------|------|
-| `/api/config/rustdesk` | GET | Admin | ่ทๅ RustDesk ้
็ฝฎ |
-| `/api/config/rustdesk` | PATCH | Admin | ๆดๆฐ RustDesk ้
็ฝฎ |
-| `/api/config/rustdesk/status` | GET | Admin | ่ทๅ RustDesk ๆๅก็ถๆ |
-| `/api/config/rustdesk/password` | GET | Admin | ่ทๅ่ฎพๅคๅฏ็ |
-| `/api/config/rustdesk/regenerate-id` | POST | Admin | ้ๆฐ็ๆ่ฎพๅค ID |
-| `/api/config/rustdesk/regenerate-password` | POST | Admin | ้ๆฐ็ๆ่ฎพๅคๅฏ็ |
-
-### 4.4 ่ฏทๆฑ/ๅๅบ็คบไพ
-
-#### ่ทๅ่ง้ข้
็ฝฎ
-
-```bash
-GET /api/config/video
-```
-
-ๅๅบ๏ผ
-```json
-{
- "device": "/dev/video0",
- "format": "MJPEG",
- "width": 1920,
- "height": 1080,
- "fps": 30,
- "quality": 80
-}
-```
-
-#### ้จๅๆดๆฐ่ง้ข้
็ฝฎ
-
-```bash
-PATCH /api/config/video
-Content-Type: application/json
-
-{
- "width": 1280,
- "height": 720,
- "fps": 60
-}
-```
-
-ๅๅบ๏ผๆดๆฐๅ็ๅฎๆด VideoConfig
-```json
-{
- "device": "/dev/video0",
- "format": "MJPEG",
- "width": 1280,
- "height": 720,
- "fps": 60,
- "quality": 80
-}
-```
-
-**ๆณจๆ**๏ผ
-- ๆๆ PATCH ่ฏทๆฑ้ฝๆฏๆ้จๅๆดๆฐ๏ผๅช้่ฆๆไพ่ฆไฟฎๆน็ๅญๆฎต
-- ๆชๆไพ็ๅญๆฎตไฟๆๅๆๅผไธๅ
-- ๆดๆฐๅ่ฟๅๅฎๆด็้
็ฝฎๅฏน่ฑก
-- ้
็ฝฎๅๆดไผ่ชๅจ่งฆๅ็ธๅ
ณ็ปไปถ้่ฝฝ
-
----
-
-## 5. ้
็ฝฎๅๆด้็ฅ
-
-ConfigStore ๆไพ broadcast channel ็จไบ้
็ฝฎๅๆด้็ฅ๏ผ
-
-```rust
-/// ้
็ฝฎๅๆดไบไปถ
-#[derive(Debug, Clone)]
-pub struct ConfigChange {
- pub key: String,
-}
-
-// ่ฎข้
้
็ฝฎๅๆด
-let mut rx = config_store.subscribe();
-
-// ็ๅฌๅๆดไบไปถ
-while let Ok(change) = rx.recv().await {
- println!("้
็ฝฎ {} ๅทฒๆดๆฐ", change.key);
- // ้่ฝฝ็ธๅ
ณ็ปไปถ
-}
-```
-
-**ๅทฅไฝๆต็จ**๏ผ
-1. ่ฐ็จ `config_store.set()` ๆ `config_store.update()`
-2. ้
็ฝฎๅๅ
ฅๆฐๆฎๅบ๏ผๆไน
ๅ๏ผ
-3. ๅๅญๆงๆดๆฐๅ
ๅญ็ผๅญ๏ผArcSwap๏ผ
-4. ๅ้ `ConfigChange` ไบไปถๅฐ broadcast channel
-5. ๅ็ปไปถ็่ฎข้
่
ๆฅๆถไบไปถๅนถๆง่ก้่ฝฝ้ป่พ
-
-**็ปไปถ้่ฝฝ็คบไพ**๏ผ
-```rust
-// VideoStreamManager ็ๅฌ้
็ฝฎๅๆด
-let mut config_rx = config_store.subscribe();
-tokio::spawn(async move {
- while let Ok(change) = config_rx.recv().await {
- if change.key == "app_config" {
- video_manager.reload().await;
- }
- }
-});
-```
-
----
-
-## 6. ๆฐๆฎๅบ็ปๆ
-
-ConfigStore ไฝฟ็จ SQLite ๅญๅจ้
็ฝฎๅๅ
ถไป็ณป็ปๆฐๆฎ๏ผ
-
-### 6.1 ้
็ฝฎ่กจ
-
-```sql
-CREATE TABLE IF NOT EXISTS config (
- key TEXT PRIMARY KEY,
- value TEXT NOT NULL,
- updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-);
-```
-
-้
็ฝฎไปฅ JSON ๆ ผๅผๅญๅจ๏ผ
-```sql
--- ๅบ็จ้
็ฝฎ
-key: 'app_config'
-value: '{"initialized": true, "video": {...}, "hid": {...}, ...}'
-```
-
-### 6.2 ็จๆท่กจ
-
-```sql
-CREATE TABLE IF NOT EXISTS users (
- id TEXT PRIMARY KEY,
- username TEXT NOT NULL UNIQUE,
- password_hash TEXT NOT NULL,
- is_admin INTEGER NOT NULL DEFAULT 0,
- created_at TEXT NOT NULL DEFAULT (datetime('now')),
- updated_at TEXT NOT NULL DEFAULT (datetime('now'))
-);
-```
-
-### 6.3 ไผ่ฏ่กจ
-
-```sql
-CREATE TABLE IF NOT EXISTS sessions (
- id TEXT PRIMARY KEY,
- user_id TEXT NOT NULL,
- created_at TEXT NOT NULL DEFAULT (datetime('now')),
- expires_at TEXT NOT NULL,
- data TEXT
-);
-```
-
-### 6.4 API ไปค็่กจ
-
-```sql
-CREATE TABLE IF NOT EXISTS api_tokens (
- id TEXT PRIMARY KEY,
- name TEXT NOT NULL,
- token_hash TEXT NOT NULL,
- permissions TEXT NOT NULL,
- expires_at TEXT,
- created_at TEXT NOT NULL DEFAULT (datetime('now')),
- last_used TEXT
-);
-```
-
-**ๅญๅจ็น็น**๏ผ
-- ๆๆ้
็ฝฎๅญๅจๅจๅไธช JSON ๆๆฌไธญ๏ผ`app_config` key๏ผ
-- ๆฏๆฌก้
็ฝฎๆดๆฐ้ฝๆดๆฐๆดไธช JSON๏ผ็ฎๅไบๅกๅค็
-- ไฝฟ็จ `ON CONFLICT` ๅฎ็ฐ upsert ๆไฝ
-- ่ฟๆฅๆฑ ๅคงๅฐไธบ 2๏ผ1 ่ฏป + 1 ๅ๏ผ๏ผ้ๅๅตๅ
ฅๅผ็ฏๅข
-
----
-
-## 7. ไฝฟ็จ็คบไพ
-
-### 7.1 ๅบๆฌ็จๆณ
-
-```rust
-use crate::config::ConfigStore;
-use std::path::Path;
-
-// ๅๅปบ้
็ฝฎๅญๅจ
-let config_store = ConfigStore::new(Path::new("./data/config.db")).await?;
-
-// ่ทๅ้
็ฝฎ๏ผๆ ้๏ผ้ถๆท่ด๏ผ
-let config = config_store.get();
-println!("่ง้ข่ฎพๅค: {:?}", config.video.device);
-println!("ๆฏๅฆๅทฒๅๅงๅ: {}", config.initialized);
-
-// ๆฃๆฅๆฏๅฆๅทฒๅๅงๅ
-if !config_store.is_initialized() {
- println!("็ณป็ปๅฐๆชๅๅงๅ๏ผ่ฏทๅฎๆๅๅง่ฎพ็ฝฎ");
-}
-```
-
-### 7.2 ๆดๆฐ้
็ฝฎ
-
-```rust
-// ๆนๅผ 1: ไฝฟ็จ้ญๅ
ๆดๆฐ๏ผๆจ่๏ผ
-config_store.update(|config| {
- config.video.width = 1280;
- config.video.height = 720;
- config.video.fps = 60;
-}).await?;
-
-// ๆนๅผ 2: ๆดไฝๆฟๆข
-let mut new_config = (*config_store.get()).clone();
-new_config.stream.mode = StreamMode::WebRTC;
-new_config.stream.encoder = EncoderType::Rkmpp;
-config_store.set(new_config).await?;
-```
-
-### 7.3 ่ฎข้
้
็ฝฎๅๆด
-
-```rust
-// ๅจ็ปไปถไธญ็ๅฌ้
็ฝฎๅๆด
-let config_store = state.config.clone();
-let mut rx = config_store.subscribe();
-
-tokio::spawn(async move {
- while let Ok(change) = rx.recv().await {
- tracing::info!("้
็ฝฎ {} ๅทฒๅๆด", change.key);
-
- // ้ๆฐๅ ่ฝฝ้
็ฝฎ
- let config = config_store.get();
-
- // ๆง่ก้่ฝฝ้ป่พ
- if let Err(e) = reload_component(&config).await {
- tracing::error!("้่ฝฝ็ปไปถๅคฑ่ดฅ: {}", e);
- }
- }
-});
-```
-
-### 7.4 ๅจ Handler ไธญไฝฟ็จ
-
-```rust
-use axum::{extract::State, Json};
-use std::sync::Arc;
-
-use crate::config::VideoConfig;
-use crate::state::AppState;
-
-// ่ทๅ่ง้ข้
็ฝฎ
-pub async fn get_video_config(
- State(state): State>
-) -> Json {
- let config = state.config.get();
- Json(config.video.clone())
-}
-
-// ๆดๆฐ่ง้ข้
็ฝฎ
-pub async fn update_video_config(
- State(state): State>,
- Json(update): Json,
-) -> Result> {
- // ๆดๆฐ้
็ฝฎ
- state.config.update(|config| {
- config.video = update;
- }).await?;
-
- // ่ฟๅๆดๆฐๅ็้
็ฝฎ
- let config = state.config.get();
- Ok(Json(config.video.clone()))
-}
-```
-
-### 7.5 ่ฎฟ้ฎๆฐๆฎๅบ่ฟๆฅๆฑ
-
-```rust
-// ConfigStore ่ฟๆไพๆฐๆฎๅบ่ฟๆฅๆฑ ่ฎฟ้ฎ
-// ็จไบ็จๆท็ฎก็ใไผ่ฏ็ฎก็็ญๅ่ฝ
-
-let pool = config_store.pool();
-
-// ๆฅ่ฏข็จๆท
-let user: Option = sqlx::query_as(
- "SELECT * FROM users WHERE username = ?"
-)
-.bind(username)
-.fetch_optional(pool)
-.await?;
-```
-
----
-
-## 8. ้ป่ฎค้
็ฝฎ
-
-็ณป็ป้ฆๆฌก่ฟ่กๆถไผ่ชๅจๅๅปบ้ป่ฎค้
็ฝฎ๏ผ
-
-```rust
-impl Default for AppConfig {
- fn default() -> Self {
- Self {
- initialized: false, // ้่ฆ้่ฟๅๅง่ฎพ็ฝฎๅๅฏผๅฎๆ
- auth: AuthConfig {
- session_timeout_secs: 86400, // 24ๅฐๆถ
- totp_enabled: false,
- totp_secret: None,
- },
- video: VideoConfig {
- device: None, // ่ชๅจๆฃๆต
- format: None, // ่ชๅจๆฃๆตๆไฝฟ็จ MJPEG
- width: 1920,
- height: 1080,
- fps: 30,
- quality: 80,
- },
- stream: StreamConfig {
- mode: StreamMode::Mjpeg,
- encoder: EncoderType::Auto,
- bitrate_preset: BitratePreset::Balanced,
- stun_server: Some("stun:stun.l.google.com:19302".to_string()),
- turn_server: None,
- turn_username: None,
- turn_password: None,
- auto_pause_enabled: false,
- auto_pause_delay_secs: 10,
- client_timeout_secs: 30,
- },
- hid: HidConfig {
- backend: HidBackend::None, // ้่ฆ็จๆทๆๅจๅฏ็จ
- otg_keyboard: "/dev/hidg0".to_string(),
- otg_mouse: "/dev/hidg1".to_string(),
- otg_udc: None, // ่ชๅจๆฃๆต
- otg_descriptor: OtgDescriptorConfig::default(),
- ch9329_port: "/dev/ttyUSB0".to_string(),
- ch9329_baudrate: 9600,
- mouse_absolute: true,
- },
- msd: MsdConfig {
- enabled: true,
- images_path: "./data/msd/images".to_string(),
- drive_path: "./data/msd/ventoy.img".to_string(),
- virtual_drive_size_mb: 16384, // 16GB
- },
- atx: AtxConfig {
- enabled: false, // ้่ฆ็จๆท้
็ฝฎ็กฌไปถ็ปๅฎ
- power: AtxKeyConfig::default(),
- reset: AtxKeyConfig::default(),
- led: AtxLedConfig::default(),
- wol_interface: String::new(), // ่ชๅจๆฃๆต
- },
- audio: AudioConfig {
- enabled: false,
- device: "default".to_string(),
- quality: "balanced".to_string(),
- },
- web: WebConfig {
- http_port: 8080,
- https_port: 8443,
- bind_address: "0.0.0.0".to_string(),
- https_enabled: false,
- ssl_cert_path: None,
- ssl_key_path: None,
- },
- extensions: ExtensionsConfig::default(),
- rustdesk: RustDeskConfig::default(),
- }
- }
-}
-```
-
-**้
็ฝฎๅๅงๅๆต็จ**๏ผ
-1. ็จๆท้ฆๆฌก่ฎฟ้ฎ Web UI๏ผ็ณป็ปๆฃๆตๅฐ `initialized = false`
-2. ้ๅฎๅๅฐๅๅง่ฎพ็ฝฎๅๅฏผ๏ผ`/setup`๏ผ
-3. ็จๆท่ฎพ็ฝฎ็ฎก็ๅ่ดฆๆทใ้ๆฉ่ง้ข่ฎพๅค็ญ
-4. ๅฎๆ่ฎพ็ฝฎๅ๏ผ`initialized` ่ฎพไธบ `true`
-5. ๅ็ปญๅฏ้่ฟ่ฎพ็ฝฎ้กต้ข๏ผ`/settings`๏ผไฟฎๆนๅ้กน้
็ฝฎ
diff --git a/docs/modules/events.md b/docs/modules/events.md
deleted file mode 100644
index 8aa28d0d..00000000
--- a/docs/modules/events.md
+++ /dev/null
@@ -1,353 +0,0 @@
-# Events ๆจกๅๆๆกฃ
-
-## 1. ๆจกๅๆฆ่ฟฐ
-
-Events ๆจกๅๆไพไบไปถๆป็บฟๅ่ฝ๏ผ็จไบๆจกๅ้ด้ไฟกๅ็ถๆๅนฟๆญใ
-
-### 1.1 ไธป่ฆๅ่ฝ
-
-- ไบไปถๅๅธ/่ฎข้
-- ๅค่ฎข้
่
ๅนฟๆญ
-- WebSocket ไบไปถๆจ้
-- ็ถๆๅๆด้็ฅ
-
-### 1.2 ๆไปถ็ปๆ
-
-```
-src/events/
-โโโ mod.rs # EventBus ๅฎ็ฐ
-```
-
----
-
-## 2. ๆถๆ่ฎพ่ฎก
-
-```
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ Event System โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-โโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโ
-โ Video โ โ HID โ โ Audio โ
-โ Module โ โ Module โ โ Module โ
-โโโโโโโโโฌโโโโโโโโโ โโโโโโโโโฌโโโโโโโโโ โโโโโโโโโฌโโโโโโโโโ
- โ โ โ
- โ publish() โ publish() โ publish()
- โโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโ
- โ
- โผ
- โโโโโโโโโโโโโโโโโโโโโโโ
- โ EventBus โ
- โ (broadcast channel) โ
- โโโโโโโโโโโโฌโโโโโโโโโโโ
- โ
- โโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโ
- โ โ โ
- โ subscribe() โ subscribe() โ
- โผ โผ โผ
-โโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโ
-โ WebSocket โ โ DeviceInfo โ โ Internal โ
-โ Handler โ โ Broadcaster โ โ Tasks โ
-โโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโ
-```
-
----
-
-## 3. ๆ ธๅฟ็ปไปถ
-
-### 3.1 EventBus
-
-```rust
-pub struct EventBus {
- /// ๅนฟๆญๅ้ๅจ
- tx: broadcast::Sender,
-}
-
-impl EventBus {
- /// ๅๅปบไบไปถๆป็บฟ
- pub fn new() -> Self {
- let (tx, _) = broadcast::channel(1024);
- Self { tx }
- }
-
- /// ๅๅธไบไปถ
- pub fn publish(&self, event: SystemEvent) {
- let _ = self.tx.send(event);
- }
-
- /// ่ฎข้
ไบไปถ
- pub fn subscribe(&self) -> broadcast::Receiver {
- self.tx.subscribe()
- }
-}
-```
-
-### 3.2 SystemEvent
-
-```rust
-#[derive(Clone, Debug, Serialize)]
-pub enum SystemEvent {
- // ่ง้ขไบไปถ
- StreamStateChanged {
- state: String,
- device: Option,
- resolution: Option,
- fps: Option,
- },
-
- VideoDeviceChanged {
- added: Vec,
- removed: Vec,
- },
-
- // HID ไบไปถ
- HidStateChanged {
- backend: String,
- initialized: bool,
- keyboard_connected: bool,
- mouse_connected: bool,
- mouse_mode: String,
- error: Option,
- },
-
- // MSD ไบไปถ
- MsdStateChanged {
- mode: String,
- connected: bool,
- image: Option,
- error: Option,
- },
-
- MsdDownloadProgress {
- download_id: String,
- downloaded: u64,
- total: u64,
- speed: u64,
- },
-
- // ATX ไบไปถ
- AtxStateChanged {
- power_on: bool,
- last_action: Option,
- error: Option,
- },
-
- // ้ณ้ขไบไปถ
- AudioStateChanged {
- enabled: bool,
- streaming: bool,
- device: Option,
- error: Option,
- },
-
- // ้
็ฝฎไบไปถ
- ConfigChanged {
- section: String,
- },
-
- // ่ฎพๅคไฟกๆฏๆฑๆป
- DeviceInfo {
- video: VideoInfo,
- hid: HidInfo,
- msd: MsdInfo,
- atx: AtxInfo,
- audio: AudioInfo,
- },
-
- // ็ณป็ป้่ฏฏ
- SystemError {
- module: String,
- severity: String,
- message: String,
- },
-
- // RustDesk ไบไปถ
- RustDeskStatusChanged {
- status: String,
- device_id: Option,
- error: Option,
- },
-
- RustDeskConnectionOpened {
- connection_id: String,
- peer_id: String,
- },
-
- RustDeskConnectionClosed {
- connection_id: String,
- peer_id: String,
- reason: String,
- },
-}
-```
-
----
-
-## 4. ่ฎพๅคไฟกๆฏๅนฟๆญๅจ
-
-ๅจ `main.rs` ไธญๅฏๅจ็ๅๅฐไปปๅก๏ผ
-
-```rust
-pub fn spawn_device_info_broadcaster(
- state: Arc,
- events: Arc,
-) -> JoinHandle<()> {
- tokio::spawn(async move {
- let mut rx = events.subscribe();
- let mut debounce = tokio::time::interval(Duration::from_millis(100));
- let mut pending = false;
-
- loop {
- tokio::select! {
- // ๆถๅฐไบไปถ
- result = rx.recv() => {
- if result.is_ok() {
- pending = true;
- }
- }
-
- // ้ฒๆๅฎๆถๅจ
- _ = debounce.tick() => {
- if pending {
- pending = false;
- // ๆถ้่ฎพๅคไฟกๆฏ
- let device_info = state.get_device_info().await;
- // ๅนฟๆญ
- events.publish(SystemEvent::DeviceInfo(device_info));
- }
- }
- }
- }
- })
-}
-```
-
----
-
-## 5. WebSocket ไบไปถๆจ้
-
-```rust
-pub async fn ws_handler(
- ws: WebSocketUpgrade,
- State(state): State>,
-) -> impl IntoResponse {
- ws.on_upgrade(|socket| handle_ws(socket, state))
-}
-
-async fn handle_ws(mut socket: WebSocket, state: Arc) {
- let mut rx = state.events.subscribe();
-
- loop {
- tokio::select! {
- // ๅ้ไบไปถ็ปๅฎขๆท็ซฏ
- result = rx.recv() => {
- if let Ok(event) = result {
- let json = serde_json::to_string(&event).unwrap();
- if socket.send(Message::Text(json)).await.is_err() {
- break;
- }
- }
- }
-
- // ๆฅๆถๅฎขๆท็ซฏๆถๆฏ
- msg = socket.recv() => {
- match msg {
- Some(Ok(Message::Close(_))) | None => break,
- _ => {}
- }
- }
- }
- }
-}
-```
-
----
-
-## 6. ไฝฟ็จ็คบไพ
-
-### 6.1 ๅๅธไบไปถ
-
-```rust
-// ่ง้ขๆจกๅๅๅธ็ถๆๅๆด
-events.publish(SystemEvent::StreamStateChanged {
- state: "streaming".to_string(),
- device: Some("/dev/video0".to_string()),
- resolution: Some(Resolution { width: 1920, height: 1080 }),
- fps: Some(30.0),
-});
-
-// HID ๆจกๅๅๅธ็ถๆๅๆด
-events.publish(SystemEvent::HidStateChanged {
- backend: "otg".to_string(),
- initialized: true,
- keyboard_connected: true,
- mouse_connected: true,
- mouse_mode: "absolute".to_string(),
- error: None,
-});
-```
-
-### 6.2 ่ฎข้
ไบไปถ
-
-```rust
-let mut rx = events.subscribe();
-
-loop {
- match rx.recv().await {
- Ok(SystemEvent::StreamStateChanged { state, .. }) => {
- println!("Stream state: {}", state);
- }
- Ok(SystemEvent::HidStateChanged { backend, .. }) => {
- println!("HID backend: {}", backend);
- }
- Err(_) => break,
- }
-}
-```
-
----
-
-## 7. ๅ็ซฏไบไปถๅค็
-
-```typescript
-// ่ฟๆฅ WebSocket
-const ws = new WebSocket('/api/ws');
-
-ws.onmessage = (event) => {
- const data = JSON.parse(event.data);
-
- switch (data.type) {
- case 'StreamStateChanged':
- updateStreamStatus(data);
- break;
- case 'HidStateChanged':
- updateHidStatus(data);
- break;
- case 'MsdStateChanged':
- updateMsdStatus(data);
- break;
- case 'DeviceInfo':
- updateAllDevices(data);
- break;
- }
-};
-```
-
----
-
-## 8. ๆไฝณๅฎ่ทต
-
-### 8.1 ไบไปถ็ฒๅบฆ
-
-- ไฝฟ็จ็ป็ฒๅบฆไบไปถไพฟไบ็ฒพ็กฎๆดๆฐ
-- DeviceInfo ็จไบๅๅงๅๅๅฎๆๅๆญฅ
-
-### 8.2 ้ฒๆ
-
-- ไฝฟ็จ 100ms ้ฒๆ้ฟๅ
ไบไปถ้ฃๆด
-- ๅๅนถๅคไธชๅฟซ้ๅๆด
-
-### 8.3 ้่ฏฏๅค็
-
-- ๅๅธๅคฑ่ดฅ้้ปๅฟฝ็ฅ (fire-and-forget)
-- ่ฎข้
่
ๆญๅผ่ชๅจๆธ
็
diff --git a/docs/modules/hid.md b/docs/modules/hid.md
deleted file mode 100644
index 5ff9c926..00000000
--- a/docs/modules/hid.md
+++ /dev/null
@@ -1,1153 +0,0 @@
-# HID ๆจกๅๆๆกฃ
-
-## 1. ๆจกๅๆฆ่ฟฐ
-
-HID (Human Interface Device) ๆจกๅ่ด่ดฃๅฐ้ฎ็ๅ้ผ ๆ ไบไปถ่ฝฌๅๅฐ็ฎๆ ่ฎก็ฎๆบ๏ผๆฏ One-KVM ๅฎ็ฐ่ฟ็จๆงๅถ็ๆ ธๅฟๆจกๅใ
-
-### 1.1 ไธป่ฆๅ่ฝ
-
-- ้ฎ็ไบไปถๅค็ (ๆ้ฎใไฟฎ้ฅฐ้ฎ)
-- ้ผ ๆ ไบไปถๅค็ (็งปๅจใ็นๅปใๆป่ฝฎ)
-- ๅคๅชไฝ้ฎๆฏๆ (Consumer Control)
-- ๆฏๆ็ปๅฏนๅ็ธๅฏน้ผ ๆ ๆจกๅผ
-- ๅคๅ็ซฏๆฏๆ (OTGใCH9329)
-- WebSocket ๅ DataChannel ่พๅ
ฅ
-- ่ชๅจ้่ฏฏๆขๅคๅๅฅๅบท็ๆง
-
-### 1.2 USB Endpoint ไฝฟ็จ
-
-OTG ๆจกๅผไธ็ endpoint ๅ้
๏ผ
-
-| ๅ่ฝ | IN ็ซฏ็น | OUT ็ซฏ็น | ่ฏดๆ |
-|------|---------|----------|------|
-| Keyboard | 1 | 1 | ๅธฆ LED ๅ้ฆ |
-| MouseRelative | 1 | 0 | ็ธๅฏน้ผ ๆ |
-| MouseAbsolute | 1 | 0 | ็ปๅฏน้ผ ๆ |
-| ConsumerControl | 1 | 0 | ๅคๅชไฝ้ฎ |
-| **HID ๆป่ฎก** | **4** | **1** | |
-| MSD | 1 | 1 | ๅคงๅฎน้ๅญๅจ |
-| **ๅ
จ้จๆป่ฎก** | **5** | **2** | ๅ
ผๅฎน 6 endpoint ่ฎพๅค |
-
-> ๆณจ๏ผEP0 (ๆงๅถ็ซฏ็น) ็ฌ็ซไบๆฐๆฎ็ซฏ็น๏ผไธ่ฎกๅ
ฅไธ่ฟฐ็ป่ฎกใ
-
-### 1.3 ๆไปถ็ปๆ
-
-```
-src/hid/
-โโโ mod.rs # HidController ไธปๆงๅถๅจ
-โโโ backend.rs # HidBackend trait ๅ HidBackendType
-โโโ otg.rs # OTG USB Gadget ๅ็ซฏๅฎ็ฐ
-โโโ ch9329.rs # CH9329 ไธฒๅฃ HID ๆงๅถๅจๅ็ซฏ
-โโโ consumer.rs # Consumer Control usage codes
-โโโ keymap.rs # JS keyCode ๅฐ USB HID ็่ฝฌๆข่กจ
-โโโ types.rs # ไบไปถ็ฑปๅๅฎไน (KeyboardEvent, MouseEvent็ญ)
-โโโ monitor.rs # ๅฅๅบท็่งๅจ (HidHealthMonitor)
-โโโ datachannel.rs # DataChannel ไบ่ฟๅถๅ่ฎฎ่งฃๆ
-โโโ websocket.rs # WebSocket ไบ่ฟๅถๅ่ฎฎ้้
-```
-
----
-
-## 2. ๆถๆ่ฎพ่ฎก
-
-### 2.1 ๆดไฝๆถๆ
-
-```
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ HID Architecture โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
- Browser Input Events
- โ
- โโโโโโโโโโโดโโโโโโโโโโ
- โ โ
- โผ โผ
-โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
-โ WebSocket โ โ DataChannel โ
-โ Handler โ โ Handler โ
-โ (websocket.rs) โ โ(datachannel.rs) โ
-โโโโโโโโโโฌโโโโโโโโโ โโโโโโโโโโฌโโโโโโโโโ
- โ โ
- โโโโโโโโโโโโฌโโโโโโโโโโ
- โ
- โผ
- โโโโโโโโโโโโโโโโโโโโโโโ
- โ HidController โ
- โ (mod.rs) โ
- โ - send_keyboard() โ
- โ - send_mouse() โ
- โ - send_consumer() โ
- โ - monitor (health) โ
- โโโโโโโโโโโโฌโโโโโโโโโโโ
- โ
- โโโโโโโโโโโโผโโโโโโโโโโโ
- โ โ โ
- โผ โผ โผ
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ
-โ OTG Backendโ โ CH9329 โ โ None โ
-โ (otg.rs) โ โ Backend โ โ (dummy) โ
-โโโโโโโโฌโโโโโโโ โโโโโโฌโโโโโโ โโโโโโโโโโโโ
- โ โ
- โผ โผ
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโ
-โ /dev/hidg* โ โ Serial โ
-โ USB Gadget โ โ Port โ
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโ
- โ โ
- โโโโโโโโฌโโโโโโโ
- โ
- โผ
- โโโโโโโโโโโโโโโ
- โ Target PC โ
- โโโโโโโโโโโโโโโ
-```
-
-### 2.2 ๅ็ซฏ้ๆฉ
-
-```
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ Backend Selection โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-HidBackendType::Otg
- โ
- โโโ ๆฃๆฅ OtgService ๆฏๅฆๅฏ็จ
- โ
- โโโ ่ฏทๆฑ HID ๅฝๆฐ (4ไธช่ฎพๅค, ๅ
ฑ4ไธชIN็ซฏ็น, 1ไธชOUT็ซฏ็น)
- โ โโโ /dev/hidg0 (้ฎ็, 1 IN, 1 OUT for LED)
- โ โโโ /dev/hidg1 (็ธๅฏน้ผ ๆ , 1 IN)
- โ โโโ /dev/hidg2 (็ปๅฏน้ผ ๆ , 1 IN)
- โ โโโ /dev/hidg3 (Consumer Control, 1 IN)
- โ
- โโโ ๅๅปบ OtgBackend (ไป HidDevicePaths)
-
-HidBackendType::Ch9329 { port, baud_rate }
- โ
- โโโ ๆๅผไธฒๅฃ่ฎพๅค
- โ
- โโโ ๅๅงๅ CH9329 ่ฏ็
- โ
- โโโ ๅๅปบ Ch9329Backend
-
-HidBackendType::None
- โ
- โโโ ไธๅๅปบๅ็ซฏ (HID ๅ่ฝ็ฆ็จ)
-```
-
----
-
-## 3. ๆ ธๅฟ็ปไปถ
-
-### 3.1 HidController (mod.rs)
-
-HID ๆงๅถๅจไธป็ฑป๏ผ็ปไธ็ฎก็ๆๆ HID ๆไฝใ
-
-```rust
-pub struct HidController {
- /// OTG Service reference (only used when backend is OTG)
- otg_service: Option>,
-
- /// Active backend
- backend: Arc>>>,
-
- /// Backend type (mutable for reload)
- backend_type: RwLock,
-
- /// Event bus for broadcasting state changes (optional)
- events: RwLock>>,
-
- /// Health monitor for error tracking and recovery
- monitor: Arc,
-}
-
-impl HidController {
- /// Create a new HID controller with specified backend
- pub fn new(backend_type: HidBackendType, otg_service: Option>) -> Self;
-
- /// Set event bus for broadcasting state changes
- pub async fn set_event_bus(&self, events: Arc);
-
- /// Initialize the HID backend
- pub async fn init(&self) -> Result<()>;
-
- /// Shutdown the HID backend and release resources
- pub async fn shutdown(&self) -> Result<()>;
-
- /// Send keyboard event
- pub async fn send_keyboard(&self, event: KeyboardEvent) -> Result<()>;
-
- /// Send mouse event
- pub async fn send_mouse(&self, event: MouseEvent) -> Result<()>;
-
- /// Send consumer control event (multimedia keys)
- pub async fn send_consumer(&self, event: ConsumerEvent) -> Result<()>;
-
- /// Reset all keys (release all pressed keys)
- pub async fn reset(&self) -> Result<()>;
-
- /// Check if backend is available
- pub async fn is_available(&self) -> bool;
-
- /// Get backend type
- pub async fn backend_type(&self) -> HidBackendType;
-
- /// Get backend info
- pub async fn info(&self) -> Option;
-
- /// Get current state as SystemEvent
- pub async fn current_state_event(&self) -> SystemEvent;
-
- /// Get the health monitor reference
- pub fn monitor(&self) -> &Arc;
-
- /// Get current health status
- pub async fn health_status(&self) -> HidHealthStatus;
-
- /// Check if the HID backend is healthy
- pub async fn is_healthy(&self) -> bool;
-
- /// Reload the HID backend with new type
- pub async fn reload(&self, new_backend_type: HidBackendType) -> Result<()>;
-}
-
-pub struct HidInfo {
- /// Backend name
- pub name: &'static str,
- /// Whether backend is initialized
- pub initialized: bool,
- /// Whether absolute mouse positioning is supported
- pub supports_absolute_mouse: bool,
- /// Screen resolution for absolute mouse
- pub screen_resolution: Option<(u32, u32)>,
-}
-```
-
-### 3.2 HidBackend Trait (backend.rs)
-
-```rust
-#[async_trait]
-pub trait HidBackend: Send + Sync {
- /// Get backend name
- fn name(&self) -> &'static str;
-
- /// Initialize the backend
- async fn init(&self) -> Result<()>;
-
- /// Send a keyboard event
- async fn send_keyboard(&self, event: KeyboardEvent) -> Result<()>;
-
- /// Send a mouse event
- async fn send_mouse(&self, event: MouseEvent) -> Result<()>;
-
- /// Send a consumer control event (multimedia keys)
- async fn send_consumer(&self, event: ConsumerEvent) -> Result<()>;
-
- /// Reset all inputs (release all keys/buttons)
- async fn reset(&self) -> Result<()>;
-
- /// Shutdown the backend
- async fn shutdown(&self) -> Result<()>;
-
- /// Check if backend supports absolute mouse positioning
- fn supports_absolute_mouse(&self) -> bool;
-
- /// Get screen resolution (for absolute mouse)
- fn screen_resolution(&self) -> Option<(u32, u32)>;
-
- /// Set screen resolution (for absolute mouse)
- fn set_screen_resolution(&mut self, width: u32, height: u32);
-}
-
-#[derive(Clone, Debug, Serialize, Deserialize)]
-#[serde(tag = "type", rename_all = "lowercase")]
-pub enum HidBackendType {
- /// USB OTG gadget mode
- Otg,
-
- /// CH9329 serial HID controller
- Ch9329 {
- port: String,
- baud_rate: u32,
- },
-
- /// No HID backend (disabled)
- None,
-}
-
-impl HidBackendType {
- /// Check if OTG backend is available on this system
- pub fn otg_available() -> bool;
-
- /// Detect the best available backend
- pub fn detect() -> Self;
-
- /// Get backend name as string
- pub fn name_str(&self) -> &str;
-}
-```
-
-### 3.3 OTG ๅ็ซฏ (otg.rs)
-
-้่ฟ Linux USB OTG gadget ๆจกๆ HID ่ฎพๅคใ
-
-```rust
-pub struct OtgBackend {
- /// Keyboard device path (/dev/hidg0)
- keyboard_path: PathBuf,
- /// Relative mouse device path (/dev/hidg1)
- mouse_rel_path: PathBuf,
- /// Absolute mouse device path (/dev/hidg2)
- mouse_abs_path: PathBuf,
- /// Consumer control device path (/dev/hidg3)
- consumer_path: PathBuf,
-
- /// Keyboard device file
- keyboard_dev: Mutex>,
- /// Relative mouse device file
- mouse_rel_dev: Mutex>,
- /// Absolute mouse device file
- mouse_abs_dev: Mutex>,
- /// Consumer control device file
- consumer_dev: Mutex>,
-
- /// Current keyboard state
- keyboard_state: Mutex,
- /// Current mouse button state
- mouse_buttons: AtomicU8,
-
- /// Last known LED state
- led_state: RwLock,
- /// Screen resolution for absolute mouse
- screen_resolution: RwLock>,
-
- /// UDC name for state checking
- udc_name: RwLock>,
- /// Whether the device is currently online
- online: AtomicBool,
-
- /// Error tracking (for log throttling)
- last_error_log: Mutex,
- error_count: AtomicU8,
- eagain_count: AtomicU8,
-}
-
-impl OtgBackend {
- /// Create OTG backend from device paths provided by OtgService
- pub fn from_handles(paths: HidDevicePaths) -> Result;
-
- /// Set the UDC name for state checking
- pub fn set_udc_name(&self, udc: &str);
-
- /// Check if the UDC is in "configured" state
- pub fn is_udc_configured(&self) -> bool;
-
- /// Check if device is online
- pub fn is_online(&self) -> bool;
-
- /// Read keyboard LED state (non-blocking)
- pub fn read_led_state(&self) -> Result>;
-
- /// Get last known LED state
- pub fn led_state(&self) -> LedState;
-}
-
-/// Keyboard LED state
-#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
-pub struct LedState {
- pub num_lock: bool,
- pub caps_lock: bool,
- pub scroll_lock: bool,
- pub compose: bool,
- pub kana: bool,
-}
-
-impl LedState {
- /// Create from raw byte
- pub fn from_byte(b: u8) -> Self;
-
- /// Convert to raw byte
- pub fn to_byte(&self) -> u8;
-}
-```
-
-#### HID ๆฅๅๆ ผๅผ
-
-```rust
-/// ้ฎ็ๆฅๅ (8 ๅญ่)
-#[derive(Debug, Clone, Default)]
-pub struct KeyboardReport {
- pub modifiers: u8, // Ctrl, Shift, Alt, Meta
- pub reserved: u8, // ไฟ็
- pub keys: [u8; 6], // ๆๅค 6 ไธชๆ้ฎ USB HID code
-}
-
-impl KeyboardReport {
- /// Convert to bytes for USB HID
- pub fn to_bytes(&self) -> [u8; 8];
-
- /// Add a key to the report
- pub fn add_key(&mut self, key: u8) -> bool;
-
- /// Remove a key from the report
- pub fn remove_key(&mut self, key: u8);
-
- /// Clear all keys
- pub fn clear(&mut self);
-}
-
-/// ้ผ ๆ ๆฅๅ (็ธๅฏนๆจกๅผ 4 ๅญ่, ็ปๅฏนๆจกๅผ 6 ๅญ่)
-#[derive(Debug, Clone, Default)]
-pub struct MouseReport {
- pub buttons: u8, // ๆ้ฎ็ถๆ
- pub x: i8, // X ็งปๅจ (-127 ~ 127) for relative
- pub y: i8, // Y ็งปๅจ (-127 ~ 127) for relative
- pub wheel: i8, // ๆป่ฝฎ (-127 ~ 127)
-}
-
-impl MouseReport {
- /// Convert to bytes for USB HID (relative mouse)
- pub fn to_bytes_relative(&self) -> [u8; 4];
-
- /// Convert to bytes for USB HID (absolute mouse)
- pub fn to_bytes_absolute(&self, x: u16, y: u16) -> [u8; 6];
-}
-```
-
-#### ้่ฏฏๆขๅคๆบๅถ
-
-OTG ๅ็ซฏๅฎ็ฐไบๅบไบ PiKVM ๅ JetKVM ็่ชๅจ้่ฏฏๆขๅค๏ผ
-
-- **EAGAIN (errno 11)**: ่ตๆบๆๆถไธๅฏ็จ - ไฝฟ็จ `poll()` ็ญๅพ
่ฎพๅคๅฏๅ๏ผ่ถ
ๆถๅ้้ปไธขๅผ
-- **ESHUTDOWN (errno 108)**: ไผ ่พ็ซฏ็นๅ
ณ้ญ - ๅ
ณ้ญ่ฎพๅคๅฅๆ๏ผไธๆฌกๆไฝๆถ่ชๅจ้ๆฐๆๅผ
-- **Write Timeout**: ไฝฟ็จ 500ms ่ถ
ๆถ (`HID_WRITE_TIMEOUT_MS`)๏ผ่ถ
ๆถๅ้้ปไธขๅผๆฐๆฎ
-- **ๆฅๅฟ้ๆต**: ้ฒๆญขๅคง้้่ฏฏๆฅๅฟๆณๆปฅ
-
-### 3.4 CH9329 ๅ็ซฏ (ch9329.rs)
-
-้่ฟ CH9329 ่ฏ็๏ผไธฒๅฃ่ฝฌ HID๏ผๅฎ็ฐ HID ๅ่ฝใ
-
-```rust
-pub struct Ch9329Backend {
- /// ไธฒๅฃ่ฎพๅค
- port: Mutex>,
-
- /// ่ฎพๅค่ทฏๅพ
- device_path: String,
-
- /// ๆณข็น็
- baud_rate: u32,
-
- /// ๅฝๅ้ฎ็็ถๆ
- keyboard_state: Mutex,
-
- /// ่ฟๆฅ็ถๆ
- connected: AtomicBool,
-}
-
-impl Ch9329Backend {
- /// ๅๅปบ CH9329 ๅ็ซฏ
- pub fn with_baud_rate(device: &str, baud_rate: u32) -> Result;
-
- /// ๅ้ๅฝไปค
- fn send_command(&self, cmd: &[u8]) -> Result>;
-
- /// ๅ้้ฎ็ๆฐๆฎๅ
- fn send_keyboard_packet(&self, report: &KeyboardReport) -> Result<()>;
-
- /// ๅ้้ผ ๆ ๆฐๆฎๅ
- fn send_mouse_packet(&self, report: &[u8], absolute: bool) -> Result<()>;
-}
-```
-
-#### CH9329 ๅ่ฎฎ
-
-```
-ๅธงๆ ผๅผ:
-โโโโโโโโฌโโโโโโโฌโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโ
-โ HEAD โ ADDR โ CMD โ LEN โ DATA โ SUM โ
-โ 0x57 โ 0xAB โ 0xXX โ data_len โ payload โ csum โ
-โโโโโโโโดโโโโโโโดโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโ
-
-ๅฝไปค็ :
-0x02 - ๅ้้ฎ็ๆฐๆฎ
-0x04 - ๅ้็ปๅฏน้ผ ๆ ๆฐๆฎ
-0x05 - ๅ้็ธๅฏน้ผ ๆ ๆฐๆฎ
-0x0E - ่ทๅ่ฏ็ไฟกๆฏ
-```
-
----
-
-## 4. ไบไปถ็ฑปๅ
-
-### 4.1 ้ฎ็ไบไปถ (types.rs)
-
-```rust
-/// Keyboard event type
-#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
-#[serde(rename_all = "lowercase")]
-pub enum KeyEventType {
- Down, // ๆ้ฎๆไธ
- Up, // ๆ้ฎ้ๆพ
-}
-
-/// Keyboard modifier flags
-#[derive(Debug, Clone, Copy, Default, PartialEq, Eq, Serialize, Deserialize)]
-pub struct KeyboardModifiers {
- pub left_ctrl: bool,
- pub left_shift: bool,
- pub left_alt: bool,
- pub left_meta: bool,
- pub right_ctrl: bool,
- pub right_shift: bool,
- pub right_alt: bool,
- pub right_meta: bool,
-}
-
-impl KeyboardModifiers {
- /// Convert to USB HID modifier byte
- pub fn to_hid_byte(&self) -> u8;
-
- /// Create from USB HID modifier byte
- pub fn from_hid_byte(byte: u8) -> Self;
-
- /// Check if any modifier is active
- pub fn any(&self) -> bool;
-}
-
-/// Keyboard event
-#[derive(Debug, Clone, Serialize, Deserialize)]
-pub struct KeyboardEvent {
- /// Event type (down/up)
- #[serde(rename = "type")]
- pub event_type: KeyEventType,
-
- /// Key code (USB HID usage code or JavaScript keyCode)
- pub key: u8,
-
- /// Modifier keys state
- #[serde(default)]
- pub modifiers: KeyboardModifiers,
-
- /// If true, key is already USB HID code (skip js_to_usb conversion)
- #[serde(default)]
- pub is_usb_hid: bool,
-}
-```
-
-### 4.2 ้ผ ๆ ไบไปถ (types.rs)
-
-```rust
-/// Mouse button
-#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
-#[serde(rename_all = "lowercase")]
-pub enum MouseButton {
- Left,
- Right,
- Middle,
- Back,
- Forward,
-}
-
-impl MouseButton {
- /// Convert to USB HID button bit
- pub fn to_hid_bit(&self) -> u8;
-}
-
-/// Mouse event type
-#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
-#[serde(rename_all = "lowercase")]
-pub enum MouseEventType {
- Move, // ็ธๅฏน็งปๅจ
- MoveAbs, // ็ปๅฏนไฝ็ฝฎ
- Down, // ๆ้ฎๆไธ
- Up, // ๆ้ฎ้ๆพ
- Scroll, // ๆป่ฝฎๆปๅจ
-}
-
-/// Mouse event
-#[derive(Debug, Clone, Serialize, Deserialize)]
-pub struct MouseEvent {
- /// Event type
- #[serde(rename = "type")]
- pub event_type: MouseEventType,
-
- /// X coordinate or delta
- #[serde(default)]
- pub x: i32,
-
- /// Y coordinate or delta
- #[serde(default)]
- pub y: i32,
-
- /// Button (for down/up events)
- #[serde(default)]
- pub button: Option,
-
- /// Scroll delta (for scroll events)
- #[serde(default)]
- pub scroll: i8,
-}
-```
-
-### 4.3 Consumer Control ไบไปถ (types.rs)
-
-```rust
-/// Consumer control event (multimedia keys)
-#[derive(Debug, Clone, Serialize, Deserialize)]
-pub struct ConsumerEvent {
- /// USB HID Consumer Control Usage Code
- pub usage: u16,
-}
-
-// ๅธธ็จ Usage Codes (ๅฎไนๅจ consumer.rs)
-pub mod usage {
- pub const PLAY_PAUSE: u16 = 0x00CD;
- pub const STOP: u16 = 0x00B7;
- pub const NEXT_TRACK: u16 = 0x00B5;
- pub const PREV_TRACK: u16 = 0x00B6;
- pub const MUTE: u16 = 0x00E2;
- pub const VOLUME_UP: u16 = 0x00E9;
- pub const VOLUME_DOWN: u16 = 0x00EA;
-}
-```
-
----
-
-## 5. ๆ้ฎๆ ๅฐ
-
-### 5.1 ๆ้ฎ่ฝฌๆข (keymap.rs)
-
-ๆจกๅไฝฟ็จๅบๅฎๅคงๅฐ็ๆฅๆพ่กจ (256 ๅญ่) ๅฎ็ฐ JavaScript keyCode ๅฐ USB HID usage code ็ O(1) ่ฝฌๆขใ
-
-```rust
-/// Convert JavaScript keyCode to USB HID keyCode
-pub fn js_to_usb(js_code: u8) -> Option;
-
-/// Check if a key code is a modifier key
-pub fn is_modifier_key(usb_code: u8) -> bool;
-
-/// Get modifier bit for a modifier key
-pub fn modifier_bit(usb_code: u8) -> Option;
-
-// USB HID key codes ๅฎไนๅจ usb ๅญๆจกๅ
-pub mod usb {
- pub const KEY_A: u8 = 0x04;
- pub const KEY_ENTER: u8 = 0x28;
- pub const KEY_LEFT_CTRL: u8 = 0xE0;
- // ... ็ญ็ญ
-}
-
-// JavaScript key codes ๅฎไนๅจ js ๅญๆจกๅ
-pub mod js {
- pub const KEY_A: u8 = 65;
- pub const KEY_ENTER: u8 = 13;
- // ... ็ญ็ญ
-}
-```
-
-### 5.2 ่ฝฌๆข็คบไพ
-
-```
-JavaScript โ USB HID
-65 (KEY_A) โ 0x04
-13 (ENTER) โ 0x28
-37 (LEFT) โ 0x50
-17 (CTRL) โ 0xE0
-```
-
----
-
-## 6. ่พๅ
ฅๅค็ๅจ
-
-### 6.1 WebSocket Handler (websocket.rs)
-
-ไฝฟ็จไบ่ฟๅถๅ่ฎฎ (ไธ DataChannel ๆ ผๅผ็ธๅ):
-
-```rust
-/// Binary response codes
-const RESP_OK: u8 = 0x00;
-const RESP_ERR_HID_UNAVAILABLE: u8 = 0x01;
-const RESP_ERR_INVALID_MESSAGE: u8 = 0x02;
-
-/// WebSocket HID upgrade handler
-pub async fn ws_hid_handler(
- ws: WebSocketUpgrade,
- State(state): State>
-) -> Response;
-
-/// Handle HID WebSocket connection
-async fn handle_hid_socket(socket: WebSocket, state: Arc);
-
-/// Handle binary HID message (same format as DataChannel)
-async fn handle_binary_message(data: &[u8], state: &AppState) -> Result<(), String>;
-```
-
-### 6.2 DataChannel Handler (datachannel.rs)
-
-็จไบ WebRTC ๆจกๅผไธ็ HID ไบไปถๅค็๏ผไฝฟ็จไบ่ฟๅถๅ่ฎฎใ
-
-#### ไบ่ฟๅถๆถๆฏๆ ผๅผ
-
-```
-ๆถๆฏ็ฑปๅๅธธ้:
-MSG_KEYBOARD = 0x01 // ้ฎ็ไบไปถ
-MSG_MOUSE = 0x02 // ้ผ ๆ ไบไปถ
-MSG_CONSUMER = 0x03 // Consumer Control ไบไปถ
-
-้ฎ็ๆถๆฏ (4 ๅญ่):
-โโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโ
-โ MSG_TYPE โ EVENT โ KEY_CODE โ MODIFIER โ
-โ 0x01 โ 0/1 โ JS code โ bitmask โ
-โโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโ
-EVENT: 0=down, 1=up
-
-้ผ ๆ ๆถๆฏ (7 ๅญ่):
-โโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโฌโโโโโโโโโโโ
-โ MSG_TYPE โ EVENT โ X (i16) โ Y (i16) โ BTN/SCRL โ
-โ 0x02 โ 0-4 โ LE โ LE โ u8/i8 โ
-โโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโโโ
-EVENT: 0=move, 1=moveabs, 2=down, 3=up, 4=scroll
-
-Consumer Control ๆถๆฏ (3 ๅญ่):
-โโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโ
-โ MSG_TYPE โ USAGE CODE (u16 LE) โ
-โ 0x03 โ e.g. 0x00CD โ
-โโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโ
-```
-
-```rust
-/// Parsed HID event from DataChannel
-#[derive(Debug, Clone)]
-pub enum HidChannelEvent {
- Keyboard(KeyboardEvent),
- Mouse(MouseEvent),
- Consumer(ConsumerEvent),
-}
-
-/// Parse a binary HID message from DataChannel
-pub fn parse_hid_message(data: &[u8]) -> Option;
-
-/// Encode events to binary format (for sending to client if needed)
-pub fn encode_keyboard_event(event: &KeyboardEvent) -> Vec;
-pub fn encode_mouse_event(event: &MouseEvent) -> Vec;
-```
-
----
-
-## 7. ๅฅๅบท็่ง
-
-### 7.1 HidHealthMonitor (monitor.rs)
-
-```rust
-/// HID health status
-#[derive(Debug, Clone, PartialEq)]
-pub enum HidHealthStatus {
- /// Device is healthy and operational
- Healthy,
-
- /// Device has an error, attempting recovery
- Error {
- reason: String,
- error_code: String,
- retry_count: u32,
- },
-
- /// Device is disconnected
- Disconnected,
-}
-
-/// HID health monitor configuration
-#[derive(Debug, Clone)]
-pub struct HidMonitorConfig {
- /// Health check interval in milliseconds
- pub check_interval_ms: u64,
- /// Retry interval when device is lost (milliseconds)
- pub retry_interval_ms: u64,
- /// Maximum retry attempts before giving up (0 = infinite)
- pub max_retries: u32,
- /// Log throttle interval in seconds
- pub log_throttle_secs: u64,
- /// Recovery cooldown in milliseconds
- pub recovery_cooldown_ms: u64,
-}
-
-/// HID health monitor
-pub struct HidHealthMonitor {
- /// Current health status
- status: RwLock,
- /// Event bus for notifications
- events: RwLock>>,
- /// Log throttler to prevent log flooding
- throttler: LogThrottler,
- /// Configuration
- config: HidMonitorConfig,
- /// Current retry count
- retry_count: AtomicU32,
- /// Last error code (for change detection)
- last_error_code: RwLock>,
- /// Last recovery timestamp (for cooldown)
- last_recovery_ms: AtomicU64,
-}
-
-impl HidHealthMonitor {
- /// Create a new HID health monitor
- pub fn new(config: HidMonitorConfig) -> Self;
-
- /// Create with default configuration
- pub fn with_defaults() -> Self;
-
- /// Set the event bus for broadcasting state changes
- pub async fn set_event_bus(&self, events: Arc);
-
- /// Report an error from HID operations
- pub async fn report_error(
- &self,
- backend: &str,
- device: Option<&str>,
- reason: &str,
- error_code: &str,
- );
-
- /// Report that a reconnection attempt is starting
- pub async fn report_reconnecting(&self, backend: &str);
-
- /// Report that the device has recovered
- pub async fn report_recovered(&self, backend: &str);
-
- /// Get the current health status
- pub async fn status(&self) -> HidHealthStatus;
-
- /// Get the current retry count
- pub fn retry_count(&self) -> u32;
-
- /// Check if the monitor is in an error state
- pub async fn is_error(&self) -> bool;
-
- /// Check if the monitor is healthy
- pub async fn is_healthy(&self) -> bool;
-
- /// Reset the monitor to healthy state
- pub async fn reset(&self);
-
- /// Check if we should continue retrying
- pub fn should_retry(&self) -> bool;
-
- /// Get the retry interval
- pub fn retry_interval(&self) -> Duration;
-}
-```
-
-#### ้่ฏฏๅค็ๆต็จ
-
-1. **ๆฅๅ้่ฏฏ**: `report_error()` - ๆดๆฐ็ถๆใ้ๆตๆฅๅฟใๅๅธไบไปถ
-2. **้่ฟ้็ฅ**: `report_reconnecting()` - ๆฏ5ๆฌกๅฐ่ฏๅๅธไธๆฌกไบไปถ
-3. **ๆขๅค้็ฅ**: `report_recovered()` - ้็ฝฎ็ถๆใๅๅธๆขๅคไบไปถ
-4. **ๆฅๅฟ้ๆต**: 5็งๅ
ไธ้ๅคๆฅๅฟ็ธๅ้่ฏฏ
-5. **ๆขๅคๅทๅด**: ๆขๅคๅ1็งๅ
ๆๅถ้่ฏฏๆฅๅฟ
-
----
-
-## 8. ็ณป็ปไบไปถ
-
-```rust
-pub enum SystemEvent {
- /// HID state changed
- HidStateChanged {
- backend: String,
- initialized: bool,
- error: Option,
- error_code: Option,
- },
-
- /// HID device lost
- HidDeviceLost {
- backend: String,
- device: Option,
- reason: String,
- error_code: String,
- },
-
- /// HID reconnecting
- HidReconnecting {
- backend: String,
- attempt: u32,
- },
-
- /// HID recovered
- HidRecovered {
- backend: String,
- },
-}
-```
-
----
-
-## 9. ้่ฏฏๅค็
-
-```rust
-pub enum AppError {
- /// HID backend error
- HidError {
- backend: String,
- reason: String,
- error_code: String,
- },
-
- // ... ๅ
ถไป้่ฏฏ็ฑปๅ
-}
-```
-
-ๅธธ่ง้่ฏฏ็ :
-
-- `enoent` - ่ฎพๅคๆไปถไธๅญๅจ (ENOENT)
-- `epipe` - ็ฎก้ๆญๅผ (EPIPE)
-- `eshutdown` - ็ซฏ็นๅ
ณ้ญ (ESHUTDOWN)
-- `eagain` - ่ตๆบๆๆถไธๅฏ็จ (EAGAIN)
-- `eagain_retry` - EAGAIN ้่ฏไธญ (ๅ
้จไฝฟ็จ๏ผไธๆฅๅ็ป็่งๅจ)
-- `enxio` - ่ฎพๅคๆๅฐๅไธๅญๅจ (ENXIO)
-- `enodev` - ่ฎพๅคไธๅญๅจ (ENODEV)
-- `eio` - I/O ้่ฏฏ (EIO)
-- `io_error` - ๅ
ถไป I/O ้่ฏฏ
-- `not_opened` - ่ฎพๅคๆชๆๅผ
-- `init_failed` - ๅๅงๅๅคฑ่ดฅ
-
----
-
-## 10. ไฝฟ็จ็คบไพ
-
-### 10.1 ๅๅงๅ HID ๆงๅถๅจ
-
-```rust
-// ๅๅปบ HID ๆงๅถๅจ (OTG ๆจกๅผ)
-let hid = HidController::new(
- HidBackendType::Otg,
- Some(otg_service.clone())
-);
-
-// ่ฎพ็ฝฎไบไปถๆป็บฟ
-hid.set_event_bus(event_bus.clone()).await;
-
-// ๅๅงๅๅ็ซฏ
-hid.init().await?;
-```
-
-### 10.2 ๅ้้ฎ็ไบไปถ
-
-```rust
-// ๆไธ Ctrl+C
-hid.send_keyboard(KeyboardEvent {
- event_type: KeyEventType::Down,
- key: 67, // JS keyCode for 'C'
- modifiers: KeyboardModifiers {
- left_ctrl: true,
- ..Default::default()
- },
- is_usb_hid: false,
-}).await?;
-
-// ้ๆพ Ctrl+C
-hid.send_keyboard(KeyboardEvent {
- event_type: KeyEventType::Up,
- key: 67,
- modifiers: KeyboardModifiers::default(),
- is_usb_hid: false,
-}).await?;
-```
-
-### 10.3 ๅ้้ผ ๆ ไบไปถ
-
-```rust
-// ็งปๅจ้ผ ๆ ๅฐ็ปๅฏนไฝ็ฝฎ (ๅฑๅนไธญๅฟ)
-hid.send_mouse(MouseEvent {
- event_type: MouseEventType::MoveAbs,
- x: 16384, // 0-32767 ่ๅด (HID ๆ ๅ)
- y: 16384,
- button: None,
- scroll: 0,
-}).await?;
-
-// ็นๅปๅทฆ้ฎ
-hid.send_mouse(MouseEvent::button_down(MouseButton::Left)).await?;
-hid.send_mouse(MouseEvent::button_up(MouseButton::Left)).await?;
-
-// ็ธๅฏน็งปๅจ
-hid.send_mouse(MouseEvent::move_rel(10, -10)).await?;
-
-// ๆป่ฝฎๆปๅจ
-hid.send_mouse(MouseEvent::scroll(-1)).await?;
-```
-
-### 10.4 ๅ้ๅคๅชไฝ้ฎ
-
-```rust
-use crate::hid::consumer::usage;
-
-// ๆญๆพ/ๆๅ
-hid.send_consumer(ConsumerEvent {
- usage: usage::PLAY_PAUSE,
-}).await?;
-
-// ้ณ้ๅขๅ
-hid.send_consumer(ConsumerEvent {
- usage: usage::VOLUME_UP,
-}).await?;
-```
-
-### 10.5 ้ๆฐๅ ่ฝฝๅ็ซฏ
-
-```rust
-// ๅๆขๅฐ CH9329 ๅ็ซฏ
-hid.reload(HidBackendType::Ch9329 {
- port: "/dev/ttyUSB0".to_string(),
- baud_rate: 9600,
-}).await?;
-```
-
----
-
-## 11. ๅธธ่ง้ฎ้ข
-
-### Q: OTG ๆจกๅผไธ้ฎ็/้ผ ๆ ไธๅทฅไฝ?
-
-1. ๆฃๆฅ `/dev/hidg*` ่ฎพๅคๆฏๅฆๅญๅจ: `ls -l /dev/hidg*`
-2. ๆฃๆฅ USB gadget ๆฏๅฆๆญฃ็กฎ้
็ฝฎ: `ls /sys/kernel/config/usb_gadget/`
-3. ๆฃๆฅ UDC ๆฏๅฆ็ปๅฎ: `cat /sys/kernel/config/usb_gadget/*/UDC`
-4. ๆฃๆฅ็ฎๆ PC ๆฏๅฆ่ฏๅซ USB ่ฎพๅค (ๅจ็ฎๆ PC ไธ่ฟ่ก `dmesg` ๆๆฅ็่ฎพๅค็ฎก็ๅจ)
-5. ๆฅ็ One-KVM ๆฅๅฟ: `journalctl -u one-kvm -f`
-
-### Q: CH9329 ๆ ๆณๅๅงๅ?
-
-1. ๆฃๆฅไธฒๅฃ่ฎพๅค่ทฏๅพ: `ls -l /dev/ttyUSB*`
-2. ๆฃๆฅไธฒๅฃๆ้: `sudo chmod 666 /dev/ttyUSB0`
-3. ๆฃๆฅๆณข็น็่ฎพ็ฝฎ (้ป่ฎค 9600)
-4. ไฝฟ็จ `minicom` ๆ `screen` ๆต่ฏไธฒๅฃ่ฟๆฅ:
- ```bash
- minicom -D /dev/ttyUSB0 -b 9600
- ```
-
-### Q: ้ผ ๆ ๅฎไฝไธๅ็กฎ?
-
-1. ไฝฟ็จ็ปๅฏน้ผ ๆ ๆจกๅผ (้ป่ฎค)
-2. ็กฎไฟๅ็ซฏๅ้็ๅๆ ๅจ 0-32767 ่ๅดๅ
-3. ๆฃๆฅๅ็ซฏๆฏๅฆๆญฃ็กฎๅค็ๅฑๅน็ผฉๆพ
-4. ๆฃๆฅๆต่งๅจ็ผฉๆพ็บงๅซ (ๅบไธบ 100%)
-
-### Q: ๆ้ฎๆๅปถ่ฟ?
-
-1. ๆฃๆฅ็ฝ็ปๅปถ่ฟ: `ping `
-2. ไฝฟ็จ WebRTC ๆจกๅผ (DataChannel) ่ไธๆฏ WebSocket
-3. ๅๅฐ็ฝ็ป่ทณๆฐ (้ฟๅ
ๅคๅฑไปฃ็)
-4. ๆฃๆฅๆๅกๅจ CPU ่ด่ฝฝ
-
-### Q: ้ข็นๅบ็ฐ ESHUTDOWN ้่ฏฏ?
-
-่ฟๆฏๆญฃๅธธ็ฐ่ฑก๏ผ้ๅธธๅ็ๅจ๏ผ
-- MSD (ๅคงๅฎน้ๅญๅจ) ่ฎพๅคๆ่ฝฝ/ๅธ่ฝฝๆถ
-- USB ไธปๆบ้ๆฐๆไธพ่ฎพๅคๆถ
-- ็ฎๆ PC ่ฟๅ
ฅไผ็ /ๅค้ๆถ
-
-OTG ๅ็ซฏไผ่ชๅจๅค็่ฟไบ้่ฏฏๅนถ้ๆฐๆๅผ่ฎพๅค๏ผๆ ้ไบบๅทฅๅนฒ้ขใ
-
-### Q: ๅฆไฝๆฅ็ LED ็ถๆ (Num Lock, Caps Lock)?
-
-```rust
-let led_state = otg_backend.led_state();
-println!("Caps Lock: {}", led_state.caps_lock);
-println!("Num Lock: {}", led_state.num_lock);
-```
-
-LED ็ถๆไผๅจ้ฎ็่ฎพๅค็ OUT endpoint ๆฅๆถๅฐๆฐๆฎๆถ่ชๅจๆดๆฐใ
-
----
-
-## 12. ๆง่ฝไผๅ
-
-### 12.1 ้ถๆท่ดๅๅ
ฅ
-
-OTG ๅ็ซฏไฝฟ็จ `write_all()` ็ดๆฅๅๅ
ฅ่ฎพๅคๆไปถ๏ผ้ฟๅ
้ขๅค็ๅ
ๅญๆท่ดใ
-
-### 12.2 ้้ปๅก I/O
-
-ๆๆ่ฎพๅคๆไปถไปฅ `O_NONBLOCK` ๆจกๅผๆๅผ๏ผ้
ๅ `poll()` ๅฎ็ฐ่ถ
ๆถๆงๅถใ
-
-### 12.3 ไบไปถๆนๅค็
-
-ๅ็ซฏๅฏไปฅๆน้ๅ้ๅคไธชไบไปถ๏ผๅ็ซฏ้ไธชๅค็ใๅฏนไบ้ผ ๆ ็งปๅจ๏ผ่ถ
ๆถ็ๅธงไผ่ขซ้้ปไธขๅผใ
-
-### 12.4 ๆฅๅฟ้ๆต
-
-ไฝฟ็จ `LogThrottler` ้ฒๆญขๅคง้้ๅคๆฅๅฟๅฝฑๅๆง่ฝ๏ผ
-- HID ้่ฏฏๆฅๅฟ: 5็ง้ๆต
-- ๆขๅคๅๅทๅด: 1็งๅ
ไธ่ฎฐๅฝๆฐ้่ฏฏ
-
----
-
-## 13. ๅฎๅ
จ่่
-
-### 13.1 ่ฎพๅคๆ้
-
-- OTG gadget ่ฎพๅคๆไปถ (`/dev/hidg*`) ้่ฆ่ฏปๅๆ้
-- ้ๅธธ้่ฆ `root` ๆ้ๆๆทปๅ ็จๆทๅฐ `input` ็ป
-- ๅปบ่ฎฎไฝฟ็จ udev ่งๅ่ชๅจ่ฎพ็ฝฎๆ้
-
-### 13.2 ่พๅ
ฅ้ช่ฏ
-
-- ๆๆๆฅ่ชๅ็ซฏ็ไบไปถ้ฝ็ป่ฟ้ช่ฏ
-- ๆ ๆ็ๆ้ฎ็ ไผ่ขซๅฟฝ็ฅๆๆ ๅฐๅฐ้ป่ฎคๅผ
-- ้ผ ๆ ๅๆ ไผ่ขซ้ๅถๅจๆๆ่ๅดๅ
-
-### 13.3 ่ตๆบ้ๅถ
-
-- ้ฎ็ๆฅๅๆๅคๆฏๆ 6 ไธชๅๆถๆ้ฎ (USB HID ๆ ๅ)
-- ้ผ ๆ ็งปๅจ่ๅด้ๅถๅจ -127~127 (็ธๅฏน) ๆ 0~32767 (็ปๅฏน)
-- ่ถ
ๆถ็ HID ๅๅ
ฅไผ่ขซไธขๅผ๏ผไธไผๆ ้็ญๅพ
-
----
-
-## 14. ่ฐ่ฏๆๅทง
-
-### 14.1 ๅฏ็จ่ฏฆ็ปๆฅๅฟ
-
-```bash
-RUST_LOG=one_kvm::hid=debug ./one-kvm
-```
-
-### 14.2 ็ๆง HID ่ฎพๅค
-
-```bash
-# ็ๆง้ฎ็ไบไปถ
-sudo cat /dev/hidg0 | hexdump -C
-
-# ็ๆง้ผ ๆ ไบไปถ
-sudo cat /dev/hidg1 | hexdump -C
-```
-
-### 14.3 ๆฃๆฅ USB ๆไธพ
-
-ๅจ็ฎๆ PC ไธ:
-
-```bash
-# Linux
-dmesg | grep -i hid
-lsusb
-
-# Windows
-# ๆๅผ่ฎพๅค็ฎก็ๅจ -> ไบบไฝๅญฆ่พๅ
ฅ่ฎพๅค
-```
-
-### 14.4 ๆต่ฏ CH9329
-
-```bash
-# ๅ้ๆต่ฏๅฝไปค (่ทๅ็ๆฌ)
-echo -ne '\x57\xAB\x0E\x00\x0E' > /dev/ttyUSB0
-```
-
----
-
-## 15. ๅ่่ตๆ
-
-- [USB HID Usage Tables 1.12](https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf)
-- [Linux USB Gadget API](https://www.kernel.org/doc/html/latest/usb/gadget_configfs.html)
-- [PiKVM HID Implementation](https://github.com/pikvm/kvmd/blob/master/kvmd/apps/otg/hid/)
-- [JetKVM HID Write Timeout](https://github.com/jetkvm/jetkvm/blob/main/jetkvm/hid.c#L25)
-- [CH9329 Datasheet](http://www.wch.cn/downloads/CH9329DS1_PDF.html)
diff --git a/docs/modules/msd.md b/docs/modules/msd.md
deleted file mode 100644
index bacec741..00000000
--- a/docs/modules/msd.md
+++ /dev/null
@@ -1,617 +0,0 @@
-# MSD ๆจกๅๆๆกฃ
-
-## 1. ๆจกๅๆฆ่ฟฐ
-
-MSD (Mass Storage Device) ๆจกๅๆไพ่ๆๅญๅจ่ฎพๅคๅ่ฝ๏ผๅ
่ฎธๅฐ ISO/IMG ้ๅไฝไธบ USB ๅญๅจ่ฎพๅคๆ่ฝฝๅฐ็ฎๆ ่ฎก็ฎๆบใ
-
-### 1.1 ไธป่ฆๅ่ฝ
-
-- ISO/IMG ้ๅๆ่ฝฝ
-- ้ๅไธ่ฝฝ็ฎก็
-- Ventoy ๅค ISO ๅฏๅจ็
-- ็ญๆๆๆฏๆ
-- ไธ่ฝฝ่ฟๅบฆ่ฟฝ่ธช
-
-### 1.2 ๆไปถ็ปๆ
-
-```
-src/msd/
-โโโ mod.rs # ๆจกๅๅฏผๅบ
-โโโ controller.rs # MsdController (20KB)
-โโโ image.rs # ้ๅ็ฎก็ (21KB)
-โโโ ventoy_drive.rs # Ventoy ้ฉฑๅจ (24KB)
-โโโ monitor.rs # ๅฅๅบท็่ง (9KB)
-โโโ types.rs # ็ฑปๅๅฎไน (6KB)
-```
-
----
-
-## 2. ๆถๆ่ฎพ่ฎก
-
-### 2.1 ๆดไฝๆถๆ
-
-```
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ MSD Architecture โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
- Web API
- โ
- โผ
- โโโโโโโโโโโโโโโโโโโ
- โ MsdController โ
- โ (controller.rs) โ
- โโโโโโโโโโฌโโโโโโโโโ
- โ
- โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโ
- โ โ โ
- โผ โผ โผ
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโโ โโโโโโโโโโโโโ
-โ Image โ โ Ventoy โ โ OTG โ
-โ Manager โ โ Drive โ โ Service โ
-โ (image.rs) โ โ(ventoy.rs)โ โ โ
-โโโโโโโโฌโโโโโโโ โโโโโโโฌโโโโโโ โโโโโโโฌโโโโโโ
- โ โ โ
- โผ โผ โผ
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโโ โโโโโโโโโโโโโ
-โ /data/ โ โ exFAT โ โ MSD โ
-โ images/ โ โ Drive โ โ Function โ
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโโ โโโโโโโโโโโโโ
- โ
- โผ
- โโโโโโโโโโโโโโโโโ
- โ Target PC โ
- โ (USB Drive) โ
- โโโโโโโโโโโโโโโโโ
-```
-
-### 2.2 MSD ๆจกๅผ
-
-```
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ MSD Modes โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ Image Mode โ
-โ โโโโโโโโโโโโโ โ
-โ โ ISO/IMG โ โโโบ MSD LUN โโโบ Target PC sees single drive โ
-โ โ File โ โ
-โ โโโโโโโโโโโโโ โ
-โ ็น็น: โ
-โ - ๅไธช้ๅๆไปถ โ
-โ - ็ดๆฅๆ่ฝฝ โ
-โ - ้ๅ็ณป็ปๅฎ่ฃ
โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ Ventoy Mode โ
-โ โโโโโโโโโโโโโ โ
-โ โ ISO 1 โ โ
-โ โโโโโโโโโโโโโค โโโโโโโโโโโโโ โ
-โ โ ISO 2 โ โโโบ โ Ventoy โ โโโบ Target PC sees bootable drive โ
-โ โโโโโโโโโโโโโค โ Drive โ with ISO selection menu โ
-โ โ ISO 3 โ โโโโโโโโโโโโโ โ
-โ โโโโโโโโโโโโโ โ
-โ ็น็น: โ
-โ - ๅคไธช ISO ๆไปถ โ
-โ - exFAT ๆไปถ็ณป็ป โ
-โ - ๅฏๅจ่ๅ้ๆฉ โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-```
-
----
-
-## 3. ๆ ธๅฟ็ปไปถ
-
-### 3.1 MsdController (controller.rs)
-
-MSD ๆงๅถๅจไธป็ฑปใ
-
-```rust
-pub struct MsdController {
- /// ๅฝๅ็ถๆ
- state: Arc>,
-
- /// ้ๅ็ฎก็ๅจ
- image_manager: Arc,
-
- /// Ventoy ้ฉฑๅจๅจ
- ventoy_drive: Arc>>,
-
- /// OTG ๆๅก
- otg_service: Arc,
-
- /// MSD ๅฝๆฐๅฅๆ
- msd_function: Arc>>,
-
- /// ไบไปถๆป็บฟ
- events: Arc,
-
- /// ๆฐๆฎ็ฎๅฝ
- data_dir: PathBuf,
-}
-
-impl MsdController {
- /// ๅๅปบๆงๅถๅจ
- pub async fn new(
- otg_service: Arc,
- data_dir: PathBuf,
- events: Arc,
- ) -> Result>;
-
- /// ่ทๅ็ถๆ
- pub fn state(&self) -> MsdState;
-
- /// ่ฟๆฅ MSD
- pub async fn connect(&self) -> Result<()>;
-
- /// ๆญๅผ MSD
- pub async fn disconnect(&self) -> Result<()>;
-
- /// ๅๆขๅฐ้ๅๆจกๅผ
- pub async fn set_image(&self, image_id: &str) -> Result<()>;
-
- /// ๅๆขๅฐ Ventoy ๆจกๅผ
- pub async fn set_ventoy(&self) -> Result<()>;
-
- /// ๆธ
้คๅฝๅๆ่ฝฝ
- pub async fn clear(&self) -> Result<()>;
-
- /// ๅๅบ้ๅ
- pub fn list_images(&self) -> Vec;
-
- /// ไธไผ ้ๅ
- pub async fn upload_image(&self, name: &str, data: Bytes) -> Result;
-
- /// ไป URL ไธ่ฝฝ้ๅ
- pub async fn download_image(&self, url: &str) -> Result;
-
- /// ๅ ้ค้ๅ
- pub async fn delete_image(&self, image_id: &str) -> Result<()>;
-
- /// ่ทๅไธ่ฝฝ่ฟๅบฆ
- pub fn get_download_progress(&self, download_id: &str) -> Option;
-}
-
-pub struct MsdState {
- /// ๆฏๅฆๅฏ็จ
- pub available: bool,
-
- /// ๅฝๅๆจกๅผ
- pub mode: MsdMode,
-
- /// ๆฏๅฆๅทฒ่ฟๆฅ
- pub connected: bool,
-
- /// ๅฝๅ้ๅไฟกๆฏ
- pub current_image: Option,
-
- /// ้ฉฑๅจๅจไฟกๆฏ
- pub drive_info: Option,
-
- /// ้่ฏฏไฟกๆฏ
- pub error: Option,
-}
-
-pub enum MsdMode {
- /// ๆชๆฟๆดป
- None,
-
- /// ๅ้ๅๆจกๅผ
- Image,
-
- /// Ventoy ๆจกๅผ
- Drive,
-}
-```
-
-### 3.2 ImageManager (image.rs)
-
-้ๅๆไปถ็ฎก็ๅจใ
-
-```rust
-pub struct ImageManager {
- /// ้ๅ็ฎๅฝ
- images_dir: PathBuf,
-
- /// ้ๅๅ่กจ็ผๅญ
- images: RwLock>,
-
- /// ไธ่ฝฝไปปๅก
- downloads: RwLock>,
-
- /// HTTP ๅฎขๆท็ซฏ
- http_client: reqwest::Client,
-}
-
-impl ImageManager {
- /// ๅๅปบ็ฎก็ๅจ
- pub fn new(images_dir: PathBuf) -> Result;
-
- /// ๆซๆ้ๅ็ฎๅฝ
- pub fn scan_images(&self) -> Result>;
-
- /// ่ทๅ้ๅไฟกๆฏ
- pub fn get_image(&self, id: &str) -> Option;
-
- /// ๆทปๅ ้ๅ
- pub async fn add_image(&self, name: &str, data: Bytes) -> Result;
-
- /// ๅ ้ค้ๅ
- pub fn delete_image(&self, id: &str) -> Result<()>;
-
- /// ๅผๅงไธ่ฝฝ
- pub async fn start_download(&self, url: &str) -> Result;
-
- /// ๅๆถไธ่ฝฝ
- pub fn cancel_download(&self, download_id: &str) -> Result<()>;
-
- /// ่ทๅไธ่ฝฝ่ฟๅบฆ
- pub fn get_download_progress(&self, download_id: &str) -> Option;
-
- /// ้ช่ฏ้ๅๆไปถ
- fn validate_image(path: &Path) -> Result;
-}
-
-pub struct ImageInfo {
- /// ๅฏไธ ID
- pub id: String,
-
- /// ๆไปถๅ
- pub name: String,
-
- /// ๆไปถๅคงๅฐ
- pub size: u64,
-
- /// ๆ ผๅผ
- pub format: ImageFormat,
-
- /// ๅๅปบๆถ้ด
- pub created_at: DateTime,
-
- /// ไธ่ฝฝ็ถๆ
- pub download_status: Option,
-}
-
-pub enum ImageFormat {
- /// ISO ๅ
็้ๅ
- Iso,
-
- /// ๅๅง็ฃ็้ๅ
- Img,
-
- /// ๆช็ฅๆ ผๅผ
- Unknown,
-}
-
-pub struct DownloadProgress {
- /// ๅทฒไธ่ฝฝๅญ่
- pub downloaded: u64,
-
- /// ๆปๅญ่ๆฐ
- pub total: u64,
-
- /// ไธ่ฝฝ้ๅบฆ (bytes/sec)
- pub speed: u64,
-
- /// ้ข่ฎกๅฉไฝๆถ้ด
- pub eta_secs: u64,
-
- /// ็ถๆ
- pub status: DownloadStatus,
-}
-
-pub enum DownloadStatus {
- Pending,
- Downloading,
- Completed,
- Failed(String),
- Cancelled,
-}
-```
-
-### 3.3 VentoyDrive (ventoy_drive.rs)
-
-Ventoy ๅฏๅฏๅจ้ฉฑๅจๅจ็ฎก็ใ
-
-```rust
-pub struct VentoyDrive {
- /// ้ฉฑๅจๅจ่ทฏๅพ
- drive_path: PathBuf,
-
- /// ้ๅ่ทฏๅพ
- images: Vec,
-
- /// ๅฎน้
- capacity: u64,
-
- /// ๅทฒ็จ็ฉบ้ด
- used: u64,
-}
-
-impl VentoyDrive {
- /// ๅๅปบ Ventoy ้ฉฑๅจๅจ
- pub fn create(drive_path: PathBuf, capacity: u64) -> Result;
-
- /// ๆทปๅ ISO
- pub fn add_iso(&mut self, iso_path: &Path) -> Result<()>;
-
- /// ็งป้ค ISO
- pub fn remove_iso(&mut self, name: &str) -> Result<()>;
-
- /// ๅๅบ ISO
- pub fn list_isos(&self) -> Vec;
-
- /// ่ทๅ้ฉฑๅจๅจไฟกๆฏ
- pub fn info(&self) -> DriveInfo;
-
- /// ่ทๅ้ฉฑๅจๅจ่ทฏๅพ
- pub fn path(&self) -> &Path;
-}
-
-pub struct DriveInfo {
- /// ๅฎน้
- pub capacity: u64,
-
- /// ๅทฒ็จ็ฉบ้ด
- pub used: u64,
-
- /// ๅฏ็จ็ฉบ้ด
- pub available: u64,
-
- /// ISO ๅ่กจ
- pub isos: Vec,
-}
-```
-
----
-
-## 4. ็ฑปๅๅฎไน
-
-### 4.1 MSD ้
็ฝฎ
-
-```rust
-#[derive(Serialize, Deserialize)]
-#[typeshare]
-pub struct MsdConfig {
- /// ๆฏๅฆๅฏ็จ MSD
- pub enabled: bool,
-
- /// ้ๅ็ฎๅฝ
- pub images_dir: Option,
-
- /// ้ป่ฎคๆจกๅผ
- pub default_mode: MsdMode,
-
- /// Ventoy ๅฎน้ (MB)
- pub ventoy_capacity_mb: u32,
-}
-
-impl Default for MsdConfig {
- fn default() -> Self {
- Self {
- enabled: true,
- images_dir: None,
- default_mode: MsdMode::None,
- ventoy_capacity_mb: 4096, // 4GB
- }
- }
-}
-```
-
----
-
-## 5. API ็ซฏ็น
-
-| ็ซฏ็น | ๆนๆณ | ๆ่ฟฐ |
-|------|------|------|
-| `/api/msd/status` | GET | ่ทๅ MSD ็ถๆ |
-| `/api/msd/connect` | POST | ่ฟๆฅ MSD |
-| `/api/msd/disconnect` | POST | ๆญๅผ MSD |
-| `/api/msd/images` | GET | ๅๅบ้ๅ |
-| `/api/msd/images` | POST | ไธไผ ้ๅ |
-| `/api/msd/images/:id` | DELETE | ๅ ้ค้ๅ |
-| `/api/msd/images/download` | POST | ไป URL ไธ่ฝฝ |
-| `/api/msd/images/download/:id` | GET | ่ทๅไธ่ฝฝ่ฟๅบฆ |
-| `/api/msd/images/download/:id` | DELETE | ๅๆถไธ่ฝฝ |
-| `/api/msd/set-image` | POST | ่ฎพ็ฝฎๅฝๅ้ๅ |
-| `/api/msd/set-ventoy` | POST | ่ฎพ็ฝฎ Ventoy ๆจกๅผ |
-| `/api/msd/clear` | POST | ๆธ
้คๆ่ฝฝ |
-
-### ๅๅบๆ ผๅผ
-
-```json
-// GET /api/msd/status
-{
- "available": true,
- "mode": "image",
- "connected": true,
- "current_image": {
- "id": "abc123",
- "name": "ubuntu-22.04.iso",
- "size": 4700000000,
- "format": "iso"
- },
- "drive_info": null,
- "error": null
-}
-
-// GET /api/msd/images
-{
- "images": [
- {
- "id": "abc123",
- "name": "ubuntu-22.04.iso",
- "size": 4700000000,
- "format": "iso",
- "created_at": "2024-01-15T10:30:00Z"
- }
- ]
-}
-
-// POST /api/msd/images/download
-// Request: { "url": "https://example.com/image.iso" }
-// Response: { "download_id": "xyz789" }
-
-// GET /api/msd/images/download/xyz789
-{
- "downloaded": 1234567890,
- "total": 4700000000,
- "speed": 12345678,
- "eta_secs": 280,
- "status": "downloading"
-}
-```
-
----
-
-## 6. ไบไปถ
-
-```rust
-pub enum SystemEvent {
- MsdStateChanged {
- mode: MsdMode,
- connected: bool,
- image: Option,
- error: Option,
- },
-
- MsdDownloadProgress {
- download_id: String,
- progress: DownloadProgress,
- },
-
- MsdDownloadComplete {
- download_id: String,
- image_id: String,
- success: bool,
- error: Option,
- },
-}
-```
-
----
-
-## 7. ้่ฏฏๅค็
-
-```rust
-#[derive(Debug, thiserror::Error)]
-pub enum MsdError {
- #[error("MSD not available")]
- NotAvailable,
-
- #[error("Already connected")]
- AlreadyConnected,
-
- #[error("Not connected")]
- NotConnected,
-
- #[error("Image not found: {0}")]
- ImageNotFound(String),
-
- #[error("Invalid image format: {0}")]
- InvalidFormat(String),
-
- #[error("Download failed: {0}")]
- DownloadFailed(String),
-
- #[error("Storage full")]
- StorageFull,
-
- #[error("OTG error: {0}")]
- OtgError(String),
-
- #[error("IO error: {0}")]
- IoError(#[from] std::io::Error),
-}
-```
-
----
-
-## 8. ไฝฟ็จ็คบไพ
-
-### 8.1 ๆ่ฝฝ ISO ้ๅ
-
-```rust
-let msd = MsdController::new(otg_service, data_dir, events).await?;
-
-// ๅๅบ้ๅ
-let images = msd.list_images();
-println!("Available images: {:?}", images);
-
-// ่ฎพ็ฝฎ้ๅ
-msd.set_image("abc123").await?;
-
-// ่ฟๆฅๅฐ็ฎๆ PC
-msd.connect().await?;
-
-// ็ฎๆ PC ็ฐๅจๅฏไปฅ็ๅฐ USB ้ฉฑๅจๅจ...
-
-// ๆญๅผ่ฟๆฅ
-msd.disconnect().await?;
-```
-
-### 8.2 ไป URL ไธ่ฝฝ
-
-```rust
-// ๅผๅงไธ่ฝฝ
-let download_id = msd.download_image("https://example.com/ubuntu.iso").await?;
-
-// ็ๆง่ฟๅบฆ
-loop {
- if let Some(progress) = msd.get_download_progress(&download_id) {
- println!("Progress: {}%", progress.downloaded * 100 / progress.total);
-
- if matches!(progress.status, DownloadStatus::Completed) {
- break;
- }
- }
- tokio::time::sleep(Duration::from_secs(1)).await;
-}
-```
-
-### 8.3 ไฝฟ็จ Ventoy ๆจกๅผ
-
-```rust
-// ๅๆขๅฐ Ventoy ๆจกๅผ
-msd.set_ventoy().await?;
-
-// ่ทๅ้ฉฑๅจๅจไฟกๆฏ
-let state = msd.state();
-if let Some(drive_info) = state.drive_info {
- println!("Capacity: {} MB", drive_info.capacity / 1024 / 1024);
- println!("ISOs: {:?}", drive_info.isos);
-}
-
-// ่ฟๆฅ
-msd.connect().await?;
-```
-
----
-
-## 9. ๅธธ่ง้ฎ้ข
-
-### Q: ้ๅๆ ๆณๆ่ฝฝ?
-
-1. ๆฃๆฅ้ๅๆไปถๅฎๆดๆง
-2. ็กฎ่ฎคๆไปถๆ ผๅผๆญฃ็กฎ
-3. ๆฃๆฅๅญๅจ็ฉบ้ด
-
-### Q: ็ฎๆ PC ไธ่ฏๅซ?
-
-1. ๆฃๆฅ USB ่ฟๆฅ
-2. ๅฐ่ฏ้ๆฐ่ฟๆฅ
-3. ๆฅ็็ฎๆ PC ็่ฎพๅค็ฎก็ๅจ
-
-### Q: ไธ่ฝฝ้ๅบฆๆ
ข?
-
-1. ๆฃๆฅ็ฝ็ป่ฟๆฅ
-2. ไฝฟ็จๆด่ฟ็้ๅๆบ
-3. ๆฃๆฅ็ฃ็ I/O
-
-### Q: Ventoy ๅฏๅจๅคฑ่ดฅ?
-
-1. ๆฃๆฅ็ฎๆ PC BIOS ่ฎพ็ฝฎ
-2. ๅฐ่ฏไธๅ็ๅฏๅจๆจกๅผ
-3. ็กฎ่ฎค ISO ๆไปถๆฏๆ Ventoy
diff --git a/docs/modules/otg.md b/docs/modules/otg.md
deleted file mode 100644
index e5e1a2a3..00000000
--- a/docs/modules/otg.md
+++ /dev/null
@@ -1,667 +0,0 @@
-# OTG ๆจกๅๆๆกฃ
-
-## 1. ๆจกๅๆฆ่ฟฐ
-
-OTG (On-The-Go) ๆจกๅ่ด่ดฃ็ฎก็ Linux USB Gadget๏ผไธบ HID ๅ MSD ๅ่ฝๆไพ็ปไธ็ USB ่ฎพๅค็ฎก็ใ
-
-### 1.1 ไธป่ฆๅ่ฝ
-
-- USB Gadget ็ๅฝๅจๆ็ฎก็
-- HID ๅฝๆฐ้
็ฝฎ (้ฎ็ใ้ผ ๆ )
-- MSD ๅฝๆฐ้
็ฝฎ (่ๆๅญๅจ)
-- ConfigFS ๆไฝ
-- UDC ็ปๅฎ/่งฃ็ป
-
-### 1.2 ๆไปถ็ปๆ
-
-```
-src/otg/
-โโโ mod.rs # ๆจกๅๅฏผๅบ
-โโโ service.rs # OtgService (17KB)
-โโโ manager.rs # OtgGadgetManager (12KB)
-โโโ hid.rs # HID Function (7KB)
-โโโ msd.rs # MSD Function (14KB)
-โโโ configfs.rs # ConfigFS ๆไฝ (4KB)
-โโโ endpoint.rs # ็ซฏ็นๅ้
(2KB)
-โโโ report_desc.rs # HID ๆฅๅๆ่ฟฐ็ฌฆ (6KB)
-```
-
----
-
-## 2. ๆถๆ่ฎพ่ฎก
-
-### 2.1 ่ฎพ่ฎก็ฎๆ
-
-่งฃๅณ HID ๅ MSD ๅ
ฑไบซๅไธไธช USB Gadget ็ๆๆๆ้ฎ้ข๏ผ
-
-```
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ OTG Ownership Model โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
- โโโโโโโโโโโโโโโโโโโ
- โ OtgService โ โโโ ๅฏไธๆๆ่
- โ (service.rs) โ
- โโโโโโโโโโฌโโโโโโโโโ
- โ
- โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโ
- โ โ โ
- โผ โผ โผ
- enable_hid() enable_msd() ็ถๆๆฅ่ฏข
- โ โ
- โโโโโโโโฌโโโโโโโ
- โ
- โผ
- โโโโโโโโโโโโโโโโโโโ
- โOtgGadgetManager โ
- โ (manager.rs) โ
- โโโโโโโโโโฌโโโโโโโโโ
- โ
- โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโ
- โ โ โ
- โผ โผ โผ
-โโโโโโโโโ โโโโโโโโโ โโโโโโโโโ
-โ HID โ โ MSD โ โ UDC โ
-โ Func โ โ Func โ โ Bind โ
-โโโโโโโโโ โโโโโโโโโ โโโโโโโโโ
-```
-
-### 2.2 ConfigFS ็ปๆ
-
-```
-/sys/kernel/config/usb_gadget/one-kvm/
-โโโ idVendor # 0x05ac (Apple)
-โโโ idProduct # 0x0001
-โโโ bcdDevice # 0x0100
-โโโ bcdUSB # 0x0200
-โโโ bMaxPacketSize0 # 64
-โ
-โโโ strings/
-โ โโโ 0x409/ # English
-โ โโโ manufacturer # "One-KVM"
-โ โโโ product # "KVM Device"
-โ โโโ serialnumber # UUID
-โ
-โโโ configs/
-โ โโโ c.1/
-โ โโโ MaxPower # 500
-โ โโโ strings/
-โ โ โโโ 0x409/
-โ โ โโโ configuration # "Config 1"
-โ โโโ (function symlinks)
-โ
-โโโ functions/
-โ โโโ hid.usb0/ # ้ฎ็
-โ โ โโโ protocol # 1 (keyboard)
-โ โ โโโ subclass # 1 (boot)
-โ โ โโโ report_length # 8
-โ โ โโโ report_desc # (binary)
-โ โ
-โ โโโ hid.usb1/ # ็ธๅฏน้ผ ๆ
-โ โ โโโ protocol # 2 (mouse)
-โ โ โโโ subclass # 1 (boot)
-โ โ โโโ report_length # 4
-โ โ โโโ report_desc # (binary)
-โ โ
-โ โโโ hid.usb2/ # ็ปๅฏน้ผ ๆ
-โ โ โโโ protocol # 2 (mouse)
-โ โ โโโ subclass # 0 (none)
-โ โ โโโ report_length # 6
-โ โ โโโ report_desc # (binary)
-โ โ
-โ โโโ mass_storage.usb0/ # ่ๆๅญๅจ
-โ โโโ stall # 1
-โ โโโ lun.0/
-โ โโโ cdrom # 1 (ISO mode)
-โ โโโ ro # 1 (read-only)
-โ โโโ removable # 1
-โ โโโ nofua # 1
-โ โโโ file # /path/to/image.iso
-โ
-โโโ UDC # UDC ่ฎพๅคๅ
-```
-
----
-
-## 3. ๆ ธๅฟ็ปไปถ
-
-### 3.1 OtgService (service.rs)
-
-OTG ๆๅกไธป็ฑป๏ผๆไพ็ปไธ็ USB Gadget ็ฎก็ๆฅๅฃใ
-
-```rust
-pub struct OtgService {
- /// Gadget ็ฎก็ๅจ
- manager: Arc>,
-
- /// ๅฝๅ็ถๆ
- state: Arc>,
-
- /// HID ๅฝๆฐๅฅๆ
- hid_function: Arc>>,
-
- /// MSD ๅฝๆฐๅฅๆ
- msd_function: Arc>>,
-
- /// ่ฏทๆฑ่ฎกๆฐๅจ (lock-free)
- pending_requests: AtomicU8,
-}
-
-impl OtgService {
- /// ๅๅปบๆๅก
- pub fn new() -> Result;
-
- /// ๅฏ็จ HID ๅ่ฝ
- pub async fn enable_hid(&self) -> Result;
-
- /// ็ฆ็จ HID ๅ่ฝ
- pub async fn disable_hid(&self) -> Result<()>;
-
- /// ๅฏ็จ MSD ๅ่ฝ
- pub async fn enable_msd(&self) -> Result;
-
- /// ็ฆ็จ MSD ๅ่ฝ
- pub async fn disable_msd(&self) -> Result<()>;
-
- /// ่ทๅ็ถๆ
- pub fn state(&self) -> OtgServiceState;
-
- /// ๆฃๆฅ HID ๆฏๅฆๅฏ็จ
- pub fn is_hid_enabled(&self) -> bool;
-
- /// ๆฃๆฅ MSD ๆฏๅฆๅฏ็จ
- pub fn is_msd_enabled(&self) -> bool;
-}
-
-pub struct OtgServiceState {
- /// Gadget ๆฏๅฆๆฟๆดป
- pub gadget_active: bool,
-
- /// HID ๆฏๅฆๅฏ็จ
- pub hid_enabled: bool,
-
- /// MSD ๆฏๅฆๅฏ็จ
- pub msd_enabled: bool,
-
- /// HID ่ฎพๅค่ทฏๅพ
- pub hid_paths: Option,
-
- /// ้่ฏฏไฟกๆฏ
- pub error: Option,
-}
-
-pub struct HidDevicePaths {
- pub keyboard: PathBuf, // /dev/hidg0
- pub mouse_relative: PathBuf, // /dev/hidg1
- pub mouse_absolute: PathBuf, // /dev/hidg2
-}
-```
-
-### 3.2 OtgGadgetManager (manager.rs)
-
-Gadget ็ๅฝๅจๆ็ฎก็ๅจใ
-
-```rust
-pub struct OtgGadgetManager {
- /// Gadget ่ทฏๅพ
- gadget_path: PathBuf,
-
- /// UDC ่ฎพๅคๅ
- udc_name: Option,
-
- /// ๆฏๅฆๅทฒๅๅปบ
- created: bool,
-
- /// ๆฏๅฆๅทฒ็ปๅฎ
- bound: bool,
-
- /// ็ซฏ็นๅ้
ๅจ
- endpoint_allocator: EndpointAllocator,
-}
-
-impl OtgGadgetManager {
- /// ๅๅปบ็ฎก็ๅจ
- pub fn new() -> Result;
-
- /// ๅๅปบ Gadget
- pub fn create_gadget(&mut self, config: &GadgetConfig) -> Result<()>;
-
- /// ้ๆฏ Gadget
- pub fn destroy_gadget(&mut self) -> Result<()>;
-
- /// ็ปๅฎ UDC
- pub fn bind_udc(&mut self) -> Result<()>;
-
- /// ่งฃ็ป UDC
- pub fn unbind_udc(&mut self) -> Result<()>;
-
- /// ๆทปๅ ๅฝๆฐ
- pub fn add_function(&mut self, func: &dyn GadgetFunction) -> Result<()>;
-
- /// ็งป้คๅฝๆฐ
- pub fn remove_function(&mut self, func: &dyn GadgetFunction) -> Result<()>;
-
- /// ้พๆฅๅฝๆฐๅฐ้
็ฝฎ
- pub fn link_function(&self, func: &dyn GadgetFunction) -> Result<()>;
-
- /// ๅๆถ้พๆฅๅฝๆฐ
- pub fn unlink_function(&self, func: &dyn GadgetFunction) -> Result<()>;
-
- /// ๆฃๆตๅฏ็จ UDC
- fn detect_udc() -> Result;
-}
-
-pub struct GadgetConfig {
- pub name: String, // "one-kvm"
- pub vendor_id: u16, // 0x05ac
- pub product_id: u16, // 0x0001
- pub manufacturer: String, // "One-KVM"
- pub product: String, // "KVM Device"
- pub serial: String, // UUID
-}
-```
-
-### 3.3 HID Function (hid.rs)
-
-```rust
-pub struct HidFunction {
- /// ้ฎ็ๅฝๆฐ
- keyboard: HidFunctionConfig,
-
- /// ็ธๅฏน้ผ ๆ ๅฝๆฐ
- mouse_relative: HidFunctionConfig,
-
- /// ็ปๅฏน้ผ ๆ ๅฝๆฐ
- mouse_absolute: HidFunctionConfig,
-}
-
-pub struct HidFunctionConfig {
- /// ๅฝๆฐๅ
- pub name: String, // "hid.usb0"
-
- /// ๅ่ฎฎ
- pub protocol: u8, // 1=keyboard, 2=mouse
-
- /// ๅญ็ฑป
- pub subclass: u8, // 1=boot, 0=none
-
- /// ๆฅๅ้ฟๅบฆ
- pub report_length: u8,
-
- /// ๆฅๅๆ่ฟฐ็ฌฆ
- pub report_desc: Vec,
-}
-
-impl HidFunction {
- /// ๅๅปบ HID ๅฝๆฐ
- pub fn new() -> Self;
-
- /// ่ทๅ้ฎ็ๆฅๅๆ่ฟฐ็ฌฆ
- pub fn keyboard_report_desc() -> Vec;
-
- /// ่ทๅ็ธๅฏน้ผ ๆ ๆฅๅๆ่ฟฐ็ฌฆ
- pub fn mouse_relative_report_desc() -> Vec;
-
- /// ่ทๅ็ปๅฏน้ผ ๆ ๆฅๅๆ่ฟฐ็ฌฆ
- pub fn mouse_absolute_report_desc() -> Vec;
-}
-
-impl GadgetFunction for HidFunction {
- fn name(&self) -> &str;
- fn function_type(&self) -> &str; // "hid"
- fn configure(&self, path: &Path) -> Result<()>;
-}
-```
-
-### 3.4 MSD Function (msd.rs)
-
-```rust
-pub struct MsdFunction {
- /// ๅฝๆฐๅ
- name: String,
-
- /// LUN ้
็ฝฎ
- luns: Vec,
-}
-
-pub struct MsdLun {
- /// LUN ็ผๅท
- pub lun_id: u8,
-
- /// ้ๅๆไปถ่ทฏๅพ
- pub file: Option,
-
- /// ๆฏๅฆ CD-ROM ๆจกๅผ
- pub cdrom: bool,
-
- /// ๆฏๅฆๅช่ฏป
- pub readonly: bool,
-
- /// ๆฏๅฆๅฏ็งป้ค
- pub removable: bool,
-}
-
-impl MsdFunction {
- /// ๅๅปบ MSD ๅฝๆฐ
- pub fn new() -> Self;
-
- /// ่ฎพ็ฝฎ้ๅๆไปถ
- pub fn set_image(&mut self, path: &Path, cdrom: bool) -> Result<()>;
-
- /// ๆธ
้ค้ๅ
- pub fn clear_image(&mut self) -> Result<()>;
-
- /// ๅผนๅบไป่ดจ
- pub fn eject(&mut self) -> Result<()>;
-}
-
-impl GadgetFunction for MsdFunction {
- fn name(&self) -> &str;
- fn function_type(&self) -> &str; // "mass_storage"
- fn configure(&self, path: &Path) -> Result<()>;
-}
-```
-
-### 3.5 ConfigFS ๆไฝ (configfs.rs)
-
-```rust
-pub struct ConfigFs;
-
-impl ConfigFs {
- /// ConfigFS ๆ น่ทฏๅพ
- const ROOT: &'static str = "/sys/kernel/config/usb_gadget";
-
- /// ๅๅปบ็ฎๅฝ
- pub fn mkdir(path: &Path) -> Result<()>;
-
- /// ๅ ้ค็ฎๅฝ
- pub fn rmdir(path: &Path) -> Result<()>;
-
- /// ๅๅ
ฅๆไปถ
- pub fn write_file(path: &Path, content: &str) -> Result<()>;
-
- /// ๅๅ
ฅไบ่ฟๅถๆไปถ
- pub fn write_binary(path: &Path, data: &[u8]) -> Result<()>;
-
- /// ่ฏปๅๆไปถ
- pub fn read_file(path: &Path) -> Result;
-
- /// ๅๅปบ็ฌฆๅท้พๆฅ
- pub fn symlink(target: &Path, link: &Path) -> Result<()>;
-
- /// ๅ ้ค็ฌฆๅท้พๆฅ
- pub fn unlink(path: &Path) -> Result<()>;
-
- /// ๅๅบ็ฎๅฝ
- pub fn list_dir(path: &Path) -> Result>;
-}
-```
-
-### 3.6 ็ซฏ็นๅ้
(endpoint.rs)
-
-```rust
-pub struct EndpointAllocator {
- /// ๅทฒไฝฟ็จ็็ซฏ็น
- used_endpoints: HashSet,
-
- /// ๆๅคง็ซฏ็นๆฐ
- max_endpoints: u8,
-}
-
-impl EndpointAllocator {
- /// ๅๅปบๅ้
ๅจ
- pub fn new(max_endpoints: u8) -> Self;
-
- /// ๅ้
็ซฏ็น
- pub fn allocate(&mut self, count: u8) -> Result>;
-
- /// ้ๆพ็ซฏ็น
- pub fn release(&mut self, endpoints: &[u8]);
-
- /// ๆฃๆฅๅฏ็จ็ซฏ็นๆฐ
- pub fn available(&self) -> u8;
-}
-```
-
-### 3.7 ๆฅๅๆ่ฟฐ็ฌฆ (report_desc.rs)
-
-```rust
-pub struct ReportDescriptor;
-
-impl ReportDescriptor {
- /// ๆ ๅ้ฎ็ๆฅๅๆ่ฟฐ็ฌฆ
- pub fn keyboard() -> Vec {
- vec![
- 0x05, 0x01, // Usage Page (Generic Desktop)
- 0x09, 0x06, // Usage (Keyboard)
- 0xA1, 0x01, // Collection (Application)
- 0x05, 0x07, // Usage Page (Key Codes)
- 0x19, 0xE0, // Usage Minimum (224)
- 0x29, 0xE7, // Usage Maximum (231)
- 0x15, 0x00, // Logical Minimum (0)
- 0x25, 0x01, // Logical Maximum (1)
- 0x75, 0x01, // Report Size (1)
- 0x95, 0x08, // Report Count (8)
- 0x81, 0x02, // Input (Data, Variable, Absolute)
- 0x95, 0x01, // Report Count (1)
- 0x75, 0x08, // Report Size (8)
- 0x81, 0x01, // Input (Constant)
- 0x95, 0x06, // Report Count (6)
- 0x75, 0x08, // Report Size (8)
- 0x15, 0x00, // Logical Minimum (0)
- 0x25, 0x65, // Logical Maximum (101)
- 0x05, 0x07, // Usage Page (Key Codes)
- 0x19, 0x00, // Usage Minimum (0)
- 0x29, 0x65, // Usage Maximum (101)
- 0x81, 0x00, // Input (Data, Array)
- 0xC0, // End Collection
- ]
- }
-
- /// ็ธๅฏน้ผ ๆ ๆฅๅๆ่ฟฐ็ฌฆ
- pub fn mouse_relative() -> Vec;
-
- /// ็ปๅฏน้ผ ๆ ๆฅๅๆ่ฟฐ็ฌฆ
- pub fn mouse_absolute() -> Vec;
-}
-```
-
----
-
-## 4. ็ๅฝๅจๆ็ฎก็
-
-### 4.1 ๅๅงๅๆต็จ
-
-```
-OtgService::new()
- โ
- โโโ ๆฃๆต UDC ่ฎพๅค
- โ โโโ ่ฏปๅ /sys/class/udc/
- โ
- โโโ ๅๅปบ OtgGadgetManager
- โ
- โโโ ๅๅงๅ็ถๆ
-
-enable_hid()
- โ
- โโโ ๆฃๆฅ Gadget ๆฏๅฆๅญๅจ
- โ โโโ ๅฆไธๅญๅจ๏ผๅๅปบ Gadget
- โ
- โโโ ๅๅปบ HID ๅฝๆฐ
- โ โโโ hid.usb0 (้ฎ็)
- โ โโโ hid.usb1 (็ธๅฏน้ผ ๆ )
- โ โโโ hid.usb2 (็ปๅฏน้ผ ๆ )
- โ
- โโโ ้
็ฝฎๅฝๆฐ
- โ โโโ ๅๅ
ฅๆฅๅๆ่ฟฐ็ฌฆ
- โ
- โโโ ้พๆฅๅฝๆฐๅฐ้
็ฝฎ
- โ
- โโโ ็ปๅฎ UDC (ๅฆๆช็ปๅฎ)
- โ
- โโโ ็ญๅพ
่ฎพๅค่็นๅบ็ฐ
- โโโ /dev/hidg0, hidg1, hidg2
-```
-
-### 4.2 ๆธ
็ๆต็จ
-
-```
-disable_hid()
- โ
- โโโ ๆฃๆฅๆฏๅฆๆๅ
ถไปๅฝๆฐไฝฟ็จ
- โ
- โโโ ๅฆๆๅชๆ HID๏ผ่งฃ็ป UDC
- โ
- โโโ ๅๆถ้พๆฅ HID ๅฝๆฐ
- โ
- โโโ ๅ ้ค HID ๅฝๆฐ็ฎๅฝ
-
-disable_msd()
- โ
- โโโ ๅไธ...
- โ
- โโโ ๅฆๆๆฒกๆไปปไฝๅฝๆฐ๏ผ้ๆฏ Gadget
-```
-
----
-
-## 5. ้
็ฝฎ
-
-### 5.1 OTG ้
็ฝฎ
-
-```rust
-#[derive(Serialize, Deserialize)]
-#[typeshare]
-pub struct OtgConfig {
- /// ๆฏๅฆๅฏ็จ OTG
- pub enabled: bool,
-
- /// ๅๅ ID
- pub vendor_id: u16,
-
- /// ไบงๅ ID
- pub product_id: u16,
-
- /// ๅๅๅ็งฐ
- pub manufacturer: String,
-
- /// ไบงๅๅ็งฐ
- pub product: String,
-}
-
-impl Default for OtgConfig {
- fn default() -> Self {
- Self {
- enabled: true,
- vendor_id: 0x05ac, // Apple
- product_id: 0x0001,
- manufacturer: "One-KVM".to_string(),
- product: "KVM Device".to_string(),
- }
- }
-}
-```
-
----
-
-## 6. ้่ฏฏๅค็
-
-```rust
-#[derive(Debug, thiserror::Error)]
-pub enum OtgError {
- #[error("No UDC device found")]
- NoUdcDevice,
-
- #[error("Gadget already exists")]
- GadgetExists,
-
- #[error("Gadget not found")]
- GadgetNotFound,
-
- #[error("Function already exists: {0}")]
- FunctionExists(String),
-
- #[error("UDC busy")]
- UdcBusy,
-
- #[error("ConfigFS error: {0}")]
- ConfigFsError(String),
-
- #[error("Permission denied: {0}")]
- PermissionDenied(String),
-
- #[error("Device node not found: {0}")]
- DeviceNodeNotFound(String),
-}
-```
-
----
-
-## 7. ไฝฟ็จ็คบไพ
-
-### 7.1 ๅฏ็จ HID
-
-```rust
-let otg = OtgService::new()?;
-
-// ๅฏ็จ HID
-let paths = otg.enable_hid().await?;
-println!("Keyboard: {:?}", paths.keyboard);
-println!("Mouse relative: {:?}", paths.mouse_relative);
-println!("Mouse absolute: {:?}", paths.mouse_absolute);
-
-// ไฝฟ็จ่ฎพๅค...
-
-// ็ฆ็จ HID
-otg.disable_hid().await?;
-```
-
-### 7.2 ๅฏ็จ MSD
-
-```rust
-let otg = OtgService::new()?;
-
-// ๅฏ็จ MSD
-let mut msd = otg.enable_msd().await?;
-
-// ๆ่ฝฝ ISO
-msd.set_image(Path::new("/data/ubuntu.iso"), true)?;
-
-// ๅผนๅบ
-msd.eject()?;
-
-// ็ฆ็จ MSD
-otg.disable_msd().await?;
-```
-
----
-
-## 8. ๅธธ่ง้ฎ้ข
-
-### Q: ๆพไธๅฐ UDC ่ฎพๅค?
-
-1. ๆฃๆฅๅ
ๆ ธๆฏๅฆๆฏๆ USB Gadget
-2. ๅ ่ฝฝๅฟ
่ฆ็ๅ
ๆ ธๆจกๅ:
- ```bash
- modprobe libcomposite
- modprobe usb_f_hid
- modprobe usb_f_mass_storage
- ```
-3. ๆฃๆฅ `/sys/class/udc/` ็ฎๅฝ
-
-### Q: ๆ้้่ฏฏ?
-
-1. ไปฅ root ่ฟ่ก
-2. ๆ้
็ฝฎ udev ่งๅ
-
-### Q: ่ฎพๅค่็นไธๅบ็ฐ?
-
-1. ๆฃๆฅ UDC ๆฏๅฆๆญฃ็กฎ็ปๅฎ
-2. ๆฅ็ `dmesg` ๆฅๅฟ
-3. ๆฃๆฅ ConfigFS ้
็ฝฎ
-
-### Q: ็ฎๆ PC ไธ่ฏๅซ?
-
-1. ๆฃๆฅ USB ็บฟ็ผ
-2. ๆฃๆฅๆฅๅๆ่ฟฐ็ฌฆ
-3. ไฝฟ็จ `lsusb` ็กฎ่ฎค่ฎพๅค
diff --git a/docs/modules/rustdesk.md b/docs/modules/rustdesk.md
deleted file mode 100644
index 01611b64..00000000
--- a/docs/modules/rustdesk.md
+++ /dev/null
@@ -1,1258 +0,0 @@
-# RustDesk ๆจกๅๆๆกฃ
-
-## 1. ๆจกๅๆฆ่ฟฐ
-
-RustDesk ๆจกๅๅฎ็ฐ RustDesk ๅ่ฎฎ้ๆ,ๅ
่ฎธไฝฟ็จๆ ๅ RustDesk ๅฎขๆท็ซฏ่ฎฟ้ฎ One-KVM ่ฎพๅคใ
-
-### 1.1 ไธป่ฆๅ่ฝ
-
-- RustDesk ๅ่ฎฎๅฎ็ฐ (Protobuf + NaCl ๅ ๅฏ)
-- Rendezvous ๆๅกๅจ (hbbs) ้ไฟก
-- ไธญ็ปงๆๅกๅจ (hbbr) ้ไฟก
-- P2P ็ด่ฟไธไธญ็ปงๅ้
-- ๅฑๅ็ฝ็ด่ฟๆฏๆ
-- ่ง้ข/้ณ้ข/HID ่ฝฌๆข
-- ็ซฏๅฐ็ซฏๅ ๅฏ (Curve25519 + XSalsa20-Poly1305)
-- ็ญพๅ่ฎค่ฏ (Ed25519)
-- ๅจๆ็ผ็ ๅจๅๅ (H264/H265/VP8/VP9)
-- ่พๅ
ฅ่ๆต (้ฒๆญข HID EAGAIN)
-- CapsLock ็ถๆๅๆญฅ
-- ็ฎก้่ชๅจ้่ฎข้
(ๆฏๆ็ญๆดๆฐ)
-
-### 1.2 ๆไปถ็ปๆ
-
-```
-src/rustdesk/
-โโโ mod.rs # RustDeskService ไธปๆๅก็ฑป
-โโโ connection.rs # ๅฎขๆท็ซฏ่ฟๆฅๅค็ (Connection, ConnectionManager)
-โโโ rendezvous.rs # Rendezvous ไธญไป่
(RendezvousMediator)
-โโโ punch.rs # P2P ็ด่ฟๅฐ่ฏไธไธญ็ปงๅ้
-โโโ crypto.rs # NaCl ๅ ๅฏ (Curve25519 + Ed25519)
-โโโ config.rs # ้
็ฝฎ็ฎก็ (RustDeskConfig)
-โโโ hid_adapter.rs # HID ไบไปถ่ฝฌๆข (RustDesk โ One-KVM)
-โโโ frame_adapters.rs # ้ณ่ง้ขๅธง่ฝฌๆข (้ถๆท่ดไผๅ)
-โโโ protocol.rs # Protobuf ๅ่ฎฎๅ
่ฃ
-โโโ bytes_codec.rs # ๅ้ฟๅธง็ผ่งฃ็
-```
-
----
-
-## 2. ๆถๆ่ฎพ่ฎก
-
-### 2.1 RustDesk ็ฝ็ปๆถๆ
-
-```
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ RustDesk Network Architecture โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
-โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ
-โ RustDesk โ โ One-KVM โ
-โ Client โ โ Device โ
-โโโโโโโโฌโโโโโโโ โโโโโโโโฌโโโโโโโ
- โ โ
- โ 1. ๆฅ่ฏข่ฎพๅคๅฐๅ โ
- โโโโโโโโโโโโโโโโโโโโโโโบโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- โ โ hbbs โ โ
- โ โ (Rendezvous)โ โ
- โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
- โ 2. ่ฟๅๅฐๅ โ
- โ โ
- โ 3a. ็ดๆฅ่ฟๆฅ (ๅฆๆๅฏ่พพ) โ
- โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- โ โ
- โ 3b. ไธญ็ปง่ฟๆฅ (ๅฆๆ NAT) โ
- โโโโโโโโโโโโโโโโโโโโโโโบโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- โ โ hbbr โ โ
- โ โ (Relay) โ โ
- โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- โ โ
- โ 4. ๅปบ็ซๅ ๅฏ้้ โ
- โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- โ โ
- โ 5. ไผ ่พ่ง้ข/้ณ้ข/HID โ
- โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-```
-
-### 2.2 ๆจกๅๅ
้จๆถๆ
-
-```
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ RustDesk Module Architecture โ
-โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-
- โโโโโโโโโโโโโโโโโโโ
- โ RustDeskService โ
- โโโโโโโโโโฌโโโโโโโโโ
- โ
- โโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโ
- โ โ โ
- โผ โผ โผ
-โโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโ
-โ Rendezvous โ โ Connection โ โ Crypto โ
-โ Mediator โ โ Manager โ โ (Keys) โ
-โโโโโโโโโโฌโโโโโโโโโโ โโโโโโโโโโฌโโโโโโโโโโ โโโโโโโโโโโโโโโโโ
- โ โ
- โ UDP โ TCP (P2P/Relay/Intranet)
- โผ โผ
-โโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ
-โ hbbs Server โ โ Connections โ
-โ (Registration) โ โ โโโโโโโโโโโโโโโโ โ
-โโโโโโโโโโโโโโโโโโโโ โ โ Connection 1 โ โ
- โ โ Connection 2 โ โ
- โ โโโโโโโโโโโโโโโโ โ
- โโโโโโโโโโฌโโโโโโโโโโ
- โ
- โโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโ
- โ โ โ
- โผ โผ โผ
-โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
-โ HID Adapter โ โ Frame Adapters โ โ Input Throttler โ
-โ (Event Conv) โ โ (Zero-Copy) โ โ (Anti-EAGAIN) โ
-โโโโโโโโโฌโโโโโโโโ โโโโโโโโโโฌโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
- โ โ
- โผ โผ
-โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-โ HID โ โ Video/Audio Manager โ
-โ Controller โ โ (Shared Pipeline) โ
-โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
-```
-
----
-
-## 3. ๆ ธๅฟ็ปไปถ
-
-### 3.1 RustDeskService (mod.rs)
-
-RustDesk ๆๅกไธป็ฑป,็ฎก็ๆดไธช RustDesk ๅ่ฎฎ้ๆใ
-
-```rust
-pub struct RustDeskService {
- config: Arc>,
- status: Arc>,
- rendezvous: Arc>>>,
- rendezvous_handle: Arc>>>,
- tcp_listener_handle: Arc>>>,
- listen_port: Arc>,
- connection_manager: Arc,
- video_manager: Arc,
- hid: Arc,
- audio: Arc,
- shutdown_tx: broadcast::Sender<()>,
-}
-
-impl RustDeskService {
- /// ๅๅปบๆฐๆๅกๅฎไพ
- pub fn new(
- config: RustDeskConfig,
- video_manager: Arc,
- hid: Arc,
- audio: Arc,
- ) -> Self;
-
- /// ๅฏๅจๆๅก (ๅฏๅจ Rendezvous ๆณจๅๅ TCP ็ๅฌ)
- pub async fn start(&self) -> anyhow::Result<()>;
-
- /// ๅๆญขๆๅก
- pub async fn stop(&self) -> anyhow::Result<()>;
-
- /// ้ๅฏๆๅก (็จไบ้
็ฝฎๆดๆฐ)
- pub async fn restart(&self, config: RustDeskConfig) -> anyhow::Result<()>;
-
- /// ่ทๅ่ฎพๅค ID
- pub fn device_id(&self) -> String;
-
- /// ่ทๅๆๅก็ถๆ
- pub fn status(&self) -> ServiceStatus;
-
- /// ่ทๅ Rendezvous ็ถๆ
- pub fn rendezvous_status(&self) -> Option;
-
- /// ่ทๅ่ฟๆฅๆฐ้
- pub fn connection_count(&self) -> usize;
-
- /// ่ทๅ TCP ็ๅฌ็ซฏๅฃ
- pub fn listen_port(&self) -> u16;
-
- /// ไฟๅญๅญๆฎ (ๅฏ้ฅๅ UUID) ๅฐ้
็ฝฎ
- /// ่ฟๅๆดๆฐๅ็้
็ฝฎ (ๅฆๆๆๅๆด)
- pub fn save_credentials(&self) -> Option;
-}
-
-pub enum ServiceStatus {
- Stopped,
- Starting,
- Running,
- Error(String),
-}
-```
-
-**ไธป่ฆๆต็จ:**
-1. **ๅฏๅจๆต็จ**: ๅๅงๅๅ ๅฏ โ ๅฏๅจ TCP ็ๅฌๅจ โ ๅๅปบ Rendezvous Mediator โ ่ฎพ็ฝฎๅ่ฐ โ ๅผๅงๆณจๅๅพช็ฏ
-2. **่ฟๆฅๅค็**: P2P ็ด่ฟๅฐ่ฏ โ ไธญ็ปงๅ้ โ ๅฑๅ็ฝ็ด่ฟ
-3. **ๅๆญขๆต็จ**: ๅ้ๅๆญขไฟกๅท โ ๅ
ณ้ญๆๆ่ฟๆฅ โ ๅๆญข Rendezvous โ ็ญๅพ
ไปปๅก็ปๆ
-
-### 3.2 RendezvousMediator (rendezvous.rs)
-
-Rendezvous ๆๅกๅจ้ไฟกไธญไป่
,ๅค็่ฎพๅคๆณจๅใๅฟ่ทณ็ปดๆคๅ่ฟๆฅ่ฏทๆฑใ
-
-```rust
-pub struct RendezvousMediator {
- config: Arc>,
- keypair: Arc>>, // Curve25519 ๅ ๅฏๅฏ้ฅ
- signing_keypair: Arc>>, // Ed25519 ็ญพๅๅฏ้ฅ
- status: Arc>,
- uuid: Arc>, // ่ฎพๅค UUID (ๆไน
ๅ)
- uuid_needs_save: Arc>,
- serial: Arc>, // ้
็ฝฎๅบๅๅท
- key_confirmed: Arc>, // ๅ
ฌ้ฅๆณจๅ็กฎ่ฎค
- keep_alive_ms: Arc>,
- relay_callback: Arc>>,
- punch_callback: Arc>>,
- intranet_callback: Arc>>,
- listen_port: Arc>, // TCP ็ๅฌ็ซฏๅฃ
- shutdown_tx: broadcast::Sender<()>,
-}
-
-impl RendezvousMediator {
- /// ๅๅปบๆฐ็ Rendezvous ไธญไป่
- pub fn new(config: RustDeskConfig) -> Self;
-
- /// ๅฏๅจๆณจๅๅพช็ฏ
- pub async fn start(&self) -> anyhow::Result<()>;
-
- /// ๅๆญขไธญไป่
- pub fn stop(&self);
-
- /// ่ทๅๆ็ๆๅ ๅฏๅฏ้ฅๅฏน
- pub fn ensure_keypair(&self) -> KeyPair;
-
- /// ่ทๅๆ็ๆ็ญพๅๅฏ้ฅๅฏน
- pub fn ensure_signing_keypair(&self) -> SigningKeyPair;
-
- /// ่ฎพ็ฝฎ TCP ็ๅฌ็ซฏๅฃ
- pub fn set_listen_port(&self, port: u16);
-
- /// ่ฎพ็ฝฎไธญ็ปง่ฏทๆฑๅ่ฐ
- pub fn set_relay_callback(&self, callback: RelayCallback);
-
- /// ่ฎพ็ฝฎ P2P ็ฉฟๅญๅ่ฐ
- pub fn set_punch_callback(&self, callback: PunchCallback);
-
- /// ่ฎพ็ฝฎๅฑๅ็ฝ่ฟๆฅๅ่ฐ
- pub fn set_intranet_callback(&self, callback: IntranetCallback);
-
- /// ่ทๅๅฝๅ็ถๆ
- pub fn status(&self) -> RendezvousStatus;
-
- /// ๆฃๆฅ UUID ๆฏๅฆ้่ฆไฟๅญ
- pub fn uuid_needs_save(&self) -> bool;
-
- /// ๆ ่ฎฐ UUID ๅทฒไฟๅญ
- pub fn mark_uuid_saved(&self);
-}
-
-pub enum RendezvousStatus {
- Disconnected, // ๆช่ฟๆฅ
- Connecting, // ๆญฃๅจ่ฟๆฅ
- Connected, // ๅทฒ่ฟๆฅไฝๆชๆณจๅ
- Registered, // ๅทฒๆณจๅ
- Error(String), // ้่ฏฏ็ถๆ
-}
-
-/// ไธญ็ปง่ฏทๆฑๅ่ฐ
-/// ๅๆฐ: (rendezvous_addr, relay_server, uuid, socket_addr, device_id)
-pub type RelayCallback = Arc, String) + Send + Sync>;
-
-/// P2P ็ฉฟๅญๅ่ฐ
-/// ๅๆฐ: (peer_addr, rendezvous_addr, relay_server, uuid, socket_addr, device_id)
-pub type PunchCallback = Arc, String, String, String, Vec, String) + Send + Sync>;
-
-/// ๅฑๅ็ฝ่ฟๆฅๅ่ฐ
-/// ๅๆฐ: (rendezvous_addr, peer_socket_addr, local_addr, relay_server, device_id)
-pub type IntranetCallback = Arc, SocketAddr, String, String) + Send + Sync>;
-```
-
-**ๅ
ณ้ฎๆบๅถ:**
-- **UDP ้ไฟก**: ไฝฟ็จ UDP ไธ hbbs ๆๅกๅจ้ไฟก
-- **ๅๅฏ้ฅ็ณป็ป**: Curve25519 ็จไบๅ ๅฏ,Ed25519 ็จไบ็ญพๅ
-- **UUID ๆไน
ๅ**: ้ฟๅ
้ๆฐๆณจๅๆถ็ UUID_MISMATCH ้่ฏฏ
-- **ๅฐๅๆททๆท**: ไฝฟ็จ `AddrMangle` ็ผ็ ๅฐๅ้ฟๅ
้ฒ็ซๅข็ฏกๆน
-- **ไธ็ง่ฟๆฅๆจกๅผ**: P2P ็ด่ฟใไธญ็ปง่ฟๆฅใๅฑๅ็ฝ็ด่ฟ
-
-### 3.3 Connection & ConnectionManager (connection.rs)
-
-ๅฎขๆท็ซฏ่ฟๆฅๅค็,ๅ
ๅซ่ฟๆฅ็ๅฝๅจๆ็ฎก็ๅๆฐๆฎไผ ่พใ
-
-```rust
-/// ๅไธชๅฎขๆท็ซฏ่ฟๆฅ
-pub struct Connection {
- id: u32,
- device_id: String,
- peer_id: String,
- state: Arc>,
- signing_keypair: SigningKeyPair,
- temp_keypair: (box_::PublicKey, box_::SecretKey), // ๆฏ่ฟๆฅไธดๆถๅฏ้ฅ
- password: String,
- hid: Option>,
- audio: Option>,
- video_manager: Option>,
- session_key: Option,
- encryption_enabled: bool,
- negotiated_codec: Option