LWCJacky

RMVC人臉追蹤系統 軟體操作手冊

2025/3/6 手冊RMVC人臉追蹤系統

# 軟體依賴文件說明

  1. rmvc_pro_v1.exe
    • 主要執行文件
    • V1 代表本目前執行文件的版本
  2. csic.dest
    • 外掛組件
  3. config.ini
    • 配置文件(用於參數的調整)
  4. app.log
    • 事件紀錄文件(用於紀錄每次執行的初始化報告和錯誤警告)
    • 可用於使用者遇到故障時的除錯依據
  5. LIC.dat
    • 啟動腳本(重要依賴，缺少此文件無法執行)

# 配置文件說明

# config.ini
[settings]
port = COM7
baudrate=115200
draw_grid= true
cam_id=0
[PID_X]
Kp = 0.004
Ki = 0.006
Kd = 0.005
setpoint = 0
output_limits_min = -3
output_limits_max = 3
rate_limit = 0.5

[PID_Y]
Kp = 0.004
Ki = 0.006
Kd = 0.005
setpoint = 0
output_limits_min = -3
output_limits_max = 3
rate_limit = 0.5

  • [settings] 初始設定項

    • port = COM7 連接控制器串口的COM點 可以在裝置管理員中找到(COM和LPT)可通過重複拔插接 判斷那個COM點拔除後消失 插入後出現，選擇此COM點 例如 COM5 即修改 port = COM5 (區分大小寫)
    • baudrate=115200 通訊速度的設定(無須修改)
    • draw_grid= true 使否啟用人臉網格描繪，在true的情況下，會啟動人臉網格描繪 設定為false時即設定關閉人臉網格描繪
    • cam_id=0 這是定義要使用哪個視訊鏡頭 某些情況下 一台電腦可能會出現1顆以上的鏡頭，初始值為0 可能不是期望的設備，可以嘗試修改成1或2選擇第二第三顆鏡頭

  • [pid_y] [pid_x] 此區域的參數內容為調整 y軸追蹤的細部控制參數，修改後可能會導致無法正常追蹤

    • pid調整
      Kp = 0.004
Ki = 0.006
Kd = 0.005
      以上三個參數為調整常見的kp(比例)ki(穩態積分)kd(阻尼)控制
    • 目標值設定 setpoint = 0 如果你想讓系統以中心點進行追蹤預設值為0即可 可在-+300間做設定
    • 機構輸出的上限和下限
      output_limits_min = -3
output_limits_max = 3
      pid控制器的輸出會依照這兩個參數去轉換輸出
    • 限制每次迭代的增益量 rate_limit = 0.5

# 注意事項

  • 執行的資賴文件全部都是必要存在少一個都無法執行
  • 請將所有依賴文件放置在exe文件相同資料夾內
  • exe文件的放置路徑必須為英文，使用非英文路徑可能會發生依賴無法讀取的問題

# 使用條款

  1. 授權範圍 本軟體僅限於教育用途，使用者必須獲得授權後方可使用。 授權使用者不得修改、反向工程、反編譯或對本軟體進行任何形式的逆向操作。

  1. 版權與所有權

    本軟體及其所有內容的版權歸 LEE, WEI-CHIEH 所有。未經授權的修改、 反向工程或分發行為均被嚴格禁止。

  1. 授權費用

    本軟體提供訂閱制授權，不提供永久授權。訂閱授權可免費向作者 LEE, WEI-CHIEH 申請， 任何在無授權的情況下使用軟體的行為均被嚴禁。

  1. 限制與責任免除

    本軟體僅提供演算法的輸出。對於因使用本軟體而導致的下位機故障或其他特殊情況，作者不承擔任何責任。

  1. 保障條款

    使用者必須遵守所在國家和地區的相關法律和規範，並免除作者對於使用者違法行為的任何連帶責任。

  1. 終止條款

    LEE, WEI-CHIEH 保留在任何時刻單方面終止授權的權利，並有權要求使用者立即刪除所有軟體副本。

  1. 隱私政策

    本軟體遵守台灣相關法律規範，不收集個人資料，但會收集部分 LOG 資料以進行除錯用途。 除非使用者主動提供資料，所有數據僅會保存在本地電腦上，不會向外傳輸。