From f7e7e3eb72bbb67fb2880e51f5f4f7445f4e2e77 Mon Sep 17 00:00:00 2001 From: accusys Date: Sun, 29 Mar 2026 13:53:14 +0800 Subject: [PATCH] Add GS <--> GC interaction analysis --- GS_GC_Interaction.md | 281 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 281 insertions(+) create mode 100644 GS_GC_Interaction.md diff --git a/GS_GC_Interaction.md b/GS_GC_Interaction.md new file mode 100644 index 0000000..f0f1807 --- /dev/null +++ b/GS_GC_Interaction.md @@ -0,0 +1,281 @@ +# GS (DtrGuiSrv) <--> GC (GUI Client) 互動分析 + +## 系統架構 + +``` +┌─────────────────────────────────────────────────────────────────────┐ +│ RAIDGuard X 系統架構 │ +├─────────────────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────────┐ ┌─────────────────┐ │ +│ │ GC (GUI) │ │ GS (Server) │ │ +│ │ RAIDGuard X │◄────────►│ DtrGuiSrv │ │ +│ │ (Java Swing) │ Port │ (C Program) │ │ +│ │ │ 8922 │ │ │ +│ └─────────────────┘ └────────┬────────┘ │ +│ │ │ +│ ▼ │ +│ ┌─────────────────┐ │ +│ │ In-Band API │ │ +│ │ (RAID Controller)│ │ +│ │ Port 8922 │ │ +│ └─────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────────────────┘ +``` + +## 通訊流程 + +### 1. 連線建立 + +``` +GC (Client) GS (Server) + │ │ + │──── connect(8922) ─────────────────►│ + │◄──── accept() ─────────────────────│ + │ │ + │──── Phase1: Length ────────────────►│ + │◄──── Phase1: Ack ───────────────────│ + │ │ + │──── Phase2: Data ──────────────────►│ + │◄──── Phase2: Response ──────────────│ + │ │ + │ ... (重複) ... │ + │ │ + │──── close() ───────────────────────►│ +``` + +### 2. 傳輸協議 (TCP Port 8922) + +GS 作為 TCP Server，監聽 Port 8922。 + +```c +// cNetWork.c +#define DTR_GUI_PORT 8922 + +SHORT InitialSrvSocket(ULONG SerPortNum, ULONG ClientConnectionAllow) { + server_sockfd = socket(AF_INET, SOCK_STREAM, 0x00); + bind(server_sockfd, ...); + listen(server_sockfd, ClientConnectionAllow); + return server_sockfd; +} +``` + +## 請求類型 + +| Request Type | 值 | 說明 | +|-------------|-----|------| +| REQ_INBAND_COMMAND | 0x01 | In-Band 命令 (轉發到 RAID 控制器) | +| REQ_SERVER_CONFIG | 0x02 | 伺服器設定 (SMTP, Email 等) | + +### Request 格式 + +``` +┌─────────────────────────────────────────────────────────────┐ +│ Request Package │ +├─────────────────────────────────────────────────────────────┤ +│ Byte 0 │ Byte 1 │ Byte 2-3 │ Byte 4+ │ +├─────────────────────────────────────────────────────────────┤ +│ Req Type │ Phase Code │ Length │ Data │ +│ (0x01/0x02)│ │ (LE) │ │ +└─────────────────────────────────────────────────────────────┘ +``` + +### Response 格式 + +``` +┌─────────────────────────────────────────────────────────────┐ +│ Response Package │ +├─────────────────────────────────────────────────────────────┤ +│ Byte 0 │ Byte 1 │ Byte 2 │ Byte 3+ │ +├─────────────────────────────────────────────────────────────┤ +│ Phase Code │ Req Code │ Ctrl No │ Data / Error Code │ +│ 0x50 │ │ │ │ +└─────────────────────────────────────────────────────────────┘ +``` + +## 處理流程 + +### GS 端處理 (cNetWork.c) + +```c +// 主迴圈 +while(1) { + client_sockfd = accept(server_sockfd, ...); + + // 接收請求 + GUITrans(client_sockfd, pInBuffer, ...); // Phase 1 + GUITrans(client_sockfd, pInBuffer, ...); // Phase 2 + + // 解析請求類型 + switch(pInBuffer[0]) { + case REQ_INBAND_COMMAND: // 0x01 + // 取得 Controller ID + iCtlrID = SNtoCtlrID(sSN); + + // 轉發到 RAID 控制器 + bStatus = HandleInBandReq(&ReqPackage, iCtlrID, &usInBandErrCode); + break; + + case REQ_SERVER_CONFIG: // 0x02 + // 處理伺服器設定 + bStatus = HandleSrvConfigReq(&ReqPackage); + break; + } + + // 發送回應 + ServerGUITrans(&ReqPackage); +} +``` + +## GC 端請求範例 + +### 1. 取得頁面資料 (GET_PAGE) + +```java +// InBandAPI/SendCmd.java + +// 組建命令 +byte[] bCmds = new byte[...]; +bCmds[0] = 0x00; // Phase Code +bCmds[1] = 0x00; // Request Code +bCmds[2] = 0x00; // Controller No +bCmds[3] = 0x01; // OpCode: GET_PAGE +bCmds[4] = 0x03; // Length +bCmds[5] = pageCode; // Page Code (0x00, 0x01, 0x07, etc.) +``` + +### 2. 發送密碼 (SEND_PASSWORD) + +```java +bCmds[3] = 0x1D; // OpCode: SEND_PASSWORD +bCmds[4] = 0x08; // Length (8 bytes) +// bCmds[5-12] = password bytes +``` + +### 3. 取得事件 (Get InBand Event) + +```java +bCmds[0] = 0xFF; // Phase Code +bCmds[1] = 0x00; // Request Code +bCmds[2] = 0x00; // Controller No +bCmds[3] = 0x02; // OpCode: Get Event +``` + +## 資料傳輸函數 + +### GS 端 (cNetWork.c) + +```c +UCHAR GUITrans(SHORT sd, PUCHAR pInBuffer, ULONG InBufferLength, SHORT flg_trans) { + while(LastByte) { + if(flg_trans == SERVER_READ) { + ByteSend = recv(sd, pBaseAddr, LastByte, 0x00); + } else if(flg_trans == SERVER_WRITE) { + ByteSend = send(sd, pBaseAddr, LastByte, 0x00); + } + LastByte -= ByteSend; + pBaseAddr += ByteSend; + } + return SYSOK; +} + +UCHAR ServerGUITrans(PNET_REQ_PACKAGE pReqPackage) { + // Phase 1: 傳輸長度 + if(pReqPackage->direction == SERVER_READ) { + // 接收長度 + } else { + // 發送長度 + Phase1Buf[0] = TRANS_PHASE1; + Phase1Buf[1] = (Length & 0xFF); + Phase1Buf[2] = ((Length >> 8) & 0xFF); + } + + // Phase 2: 傳輸資料 + pReqPackage->pOutBuffer[0] = TRANS_PHASE2; + GUITrans(..., SERVER_WRITE); + + return SYSOK; +} +``` + +## 錯誤處理 + +### 錯誤回應格式 + +``` +Byte 0: Phase Code +Byte 1: Request Code +Byte 2: Controller Number +Byte 3: Error Code +Byte 4-5: InBand Error Code (LSB ~ MSB) +``` + +### 常見錯誤碼 + +| 錯誤碼 | 說明 | +|--------|------| +| 0x50 | 成功 (Success) | +| 0x4x | 失敗 (Fail) | +| SYSFAIL_SERSVE_RESEND_FAIL | 傳輸失敗 | +| SYSFAIL_INBAND_SN_NOT_MATCH | SN 不匹配 | + +## 關鍵檔案對應 + +### GS 端 (C) + +| 檔案 | 功能 | +|------|------| +| cNetWork.c | TCP 網路通訊 | +| cInBand.c | In-Band API 處理 | +| cPollingEvent.c | 事件輪詢 | +| cMail.c | Email 發送 | +| cShareMem.c | 共享記憶體 | + +### GC 端 (Java) + +| 檔案 | 功能 | +|------|------| +| SendCmd.java | TCP 通訊封裝 | +| CmdQueue.java | 命令排程 | +| PageDataDB.java | 資料儲存 | +| frmMain.java | 主介面 | + +## 通訊序列圖 + +``` +GC GS RAID Controller + │ │ │ + │── TCP Connect(8922) ──►│ │ + │◄── Accept ─────────────│ │ + │ │ │ + │── REQ_INBAND_COMMAND ─►│ │ + │ (GET_PAGE) │ │ + │ │── InBand Protocol ───────►│ + │ │◄── Page Data ───────────│ + │◄─ Page Data ──────────│ │ + │ │ │ + │── REQ_INBAND_COMMAND ─►│ │ + │ (SEND_PASSWORD) │ │ + │ │── InBand Protocol ───────►│ + │ │◄── Status ──────────────│ + │◄─ Status ─────────────│ │ + │ │ │ + │── TCP Close ──────────│ │ +``` + +## 連接埠 + +| Port | 用途 | +|------|------| +| 8922 | GC ↔ GS 主要通訊 | +| 8922 | GS ↔ RAID Controller | +| 162 | SNMP Trap (可選) | + +## 實作重點 + +1. **雙向通訊**: GS 同時連接 GC (客戶端) 和 RAID Controller (硬體) +2. **協議轉發**: GS 將 GC 的請求轉發給 RAID Controller +3. **錯誤回傳**: 錯誤從 RAID Controller → GS → GC +4. **長連接**: 使用 TCP keep-alive 維持連線 +5. **共享記憶體**: GS 與本機 RAID Driver 共享資料