WifiLapper/Pitside 控制檯幫助檔案
幫助填寫以下大綱併為專案做出貢獻！
Pitside 控制檯 - Wifilapper 資料庫/分析工具
目錄
1 Pitside 控制檯入門 2
1.1 安裝/解除安裝 2
1.2 使用 Pitside 控制檯開啟/建立資料庫 3
1.3 選擇比賽環節 4
1.4 更改比賽環節 5
1.5 顯示圈速資料 5
1.6 選擇參考圈 6
1.7 選擇 X 軸 7
1.8 選擇 Y 軸資料通道 8
1.9 平移/縮放 9
1.10 設定評論 9
1.11 顯示檢視 - 地圖 vs. 資料繪圖 10
2 高階選項 11
2.1 操作 SETTINGS.TXT 檔案 11
2.2 選項選單 12
2.2.1 公里/小時、英里/小時、米/秒：12
2.2.2 按時間排序圈速列表、按圈速排序圈速列表：12
2.2.3 顯示所有最佳成績：13
2.2.4 顯示車手最佳成績：13
2.2.5 顯示參考圈：13
2.2.6 在資料點之間繪製線條：13
2.2.7 使用深色背景進行繪圖：13
2.2.8 繪圖選項…：13
2.3 將資料繪製為圖表 vs. 僅值 13
2.4 設定僅值資料通道的警報限制 15
2.5 向 Wifilapper 手機發送訊息 16
2.6 牽引力圓 17
2.7 使用時間 X 軸顯示來顯示長期趨勢 18
2.8 Wifi 點 19
2.9 未來增強功能（列印/複製） 20
3 Wifilapper 資料庫管理 20
3.1 重新命名比賽環節 20
3.2 合併比賽環節 21
3.3 將資料匯出到 .CSV 格式 21
4 貢獻者/致謝 21
1 Pitside 控制檯入門
1.1 安裝/解除安裝
Pitside 控制檯目前包含一個單個 EXE 檔案和一些輔助檔案。它們都包含在位於此處的壓縮 ZIP 檔案中。
要安裝 Pitside 控制檯，只需將此檔案的內容解壓縮到 IA32/64 計算機上的首選目錄即可。您還可以在使用 Linux 或 OSx 作業系統的虛擬機器中執行它。
解壓縮檔案後，建議您右鍵單擊 PitsideConsole.exe 檔案並選擇建立快捷方式。建立此快捷方式後，您可以將其複製/移動到計算機上的任何位置。
要解除安裝 Pitside 控制檯，只需刪除解壓縮檔案的資料夾即可。沒有對登錄檔進行任何更改，因此這將完全從您的機器中刪除 Pitside。
1.2 使用 Pitside 控制檯開啟/建立資料庫
要執行 Pitside 控制檯，只需雙擊可執行檔案 PitsideConsole.exe 或您為它建立的快捷方式。
將顯示一個啟動畫面，其中包含有關 Wifilapper 專案以及如何為其做出貢獻的資訊。單擊此影像上的任何位置，將彈出一個視窗，要求您選擇一個 Wifilapper 資料庫。您有兩個選擇
1) 開啟現有的 Wifilapper 資料庫：瀏覽到您儲存現有 .wflp 資料庫的資料夾，然後雙擊該檔案。這將開啟資料庫並顯示下一個螢幕。
2) 建立一個新的 Wifilapper 資料庫：瀏覽到您要儲存新的 .wflp 資料庫的位置，並在對話方塊中輸入所需的名稱。該資料庫將被建立，您將直接進入主 Pitside 程式。
1.3 選擇比賽環節
如果您打開了現有資料庫，將顯示比賽環節螢幕。如果資料庫中沒有儲存比賽，則對話方塊列表將為空。只需單擊“取消”按鈕，您將進入主 Pitside 程式。如果您在會話期間儲存資料，則下次載入此資料庫時將顯示這些比賽。
如果您已經在此資料庫中儲存了一些比賽環節，則將顯示它們。單擊您要檢視的比賽環節，然後單擊“確定”按鈕。如果您只想設定 Pitside 以收集新的比賽環節，您可以單擊“取消”，然後將顯示一個空白的主 Pitside 程式。您也可以選擇一個現有的比賽環節並載入它，隨著新比賽資料的接收，Pitside 將將其收集為新的比賽環節並提醒您。
1.4 更改比賽環節
要更改為不同的比賽環節，請單擊“資料”選單選項，然後選擇“切換比賽環節”。將顯示選擇比賽環節的相同對話方塊。按照上述步驟載入所需的比賽。
1.5 顯示圈速資料
一旦選擇了現有的比賽環節或記錄了來自即時比賽環節的一些圈速，一些資料應該會顯示在 Pitside 的主視窗中。Pitside 的功能與 UNIX 程式非常相似，視窗部分僅在滑鼠懸停在它們上時更新。將滑鼠移到主顯示區域上，將顯示一個或多個圖表。
第一圈資料可能看起來很不尋常，因為這是從維修區駛入賽道的“出圈”。如果記錄了超過 1 圈（並在 Pitside 視窗左下角的“圈速列表”區域顯示），您可以單擊其他圈速以檢視它們的資料。
當“圈速列表”中顯示多圈時，您可以選擇單個圈速，也可以使用 Shift-單擊、Ctrl-單擊和滑鼠拖動來選擇多圈。每個圈速將在顯示的圖表中用顏色編碼。
1.6 選擇參考圈
Pitside 將隨著時間的推移收集的速度/位置/加速度資料轉換為所需的圖形顯示（例如：速度 vs. 距離）。為了有效地進行此轉換，Pitside 要求使用者識別典型的參考圈，其他圈速將與該圈速進行比較。要設定或更改參考圈，請在“圈速列表”中突出顯示該比賽環節的典型圈速。選擇此圈速後，單擊“用作參考圈”按鈕。
使用者通常希望使用參考圈將出彎速度、剎車點等與最快圈速或車手最快圈速進行比較。這可以透過突出顯示所需的最快圈速，然後單擊“用作參考圈”按鈕來實現。所有其他圈速都不會與該參考圈進行比較。
1.7 選擇 X 軸
預設情況下，Pitside 在您開啟應用程式時選擇距離通道作為預設通道。您可以透過單擊“X 軸”列表框中的所需通道來選擇任何其他資料通道用作 X 軸。
一次只能選擇一個通道作為 X 軸。在 Wifilapper 提供的預設通道中，以下通道最適合 X 軸顯示
1) 距離：這將找到所有顯示圈速中距離最近的點。這是最常見的 X 軸顯示通道。
2) 時間：這對於顯示發動機監控器等大部分恆定資料的長期趨勢很有用。它也用於圈速彙總顯示。
3) 圈速：您可以比較不同圈速在圈速相同時刻的汽車位置。
1.8 選擇 Y 軸資料通道
Pitside 的 Y 軸顯示預設值為速度。您可以使用此圖表來比較最高速度、出彎速度和其他駕駛員輔助功能。當選擇正確的參考圈時，這是一個強大的工具。對於每個突出顯示的圈速，詳細資訊將在圖表中以文字形式顯示。
可以選擇多個 Y 軸通道，這與 X 軸不同。使用 Shift-單擊、Ctrl-單擊或將滑鼠拖動到所需的通道上以顯示。以下列出了一些最適合 Y 軸顯示的預設通道
1) 速度：預設值，也是最實用的。
2) 時間差：這將顯示當前圈速比參考圈快或慢多少，而距離最近的位置是滑鼠箭頭所在的距離。這是確定比較圈速和車手時何時獲得或損失時間的最有用的工具。
3) 圈速彙總：這用於顯示多個圈速的圖表，顯示它們的圈速。這可用於確定車手的穩定性或是否圈速逐圈提高。
4) X/Y 加速度：雖然手機的振動可能會降低其實用性，但它仍然可以作為駕駛員輔助工具。
5) 自定義通道：如果您將 OBD2 掃描器或 IOIO 板連線到手機並正在記錄發動機管理資料，將顯示其他資料通道。您可以將它們視為簡單的圖表，也可以以更緊湊的“僅值”方式顯示它們。這將在高階選項部分中進一步討論。
1.9 平移/縮放
如果使用者需要，可以移動圖表並放大或縮小。單擊圖表顯示區域以使其成為活動顯示，然後您可以按住滑鼠左鍵並移動滑鼠進行平移。可以使用滾輪進行放大或縮小特定區域。
您可以透過單擊滑鼠右鍵重置平移/縮放。
1.10 設定評論 您可以為現有圈速或新獲得的圈速新增評論。使用評論對話方塊輸入您想要的資訊（車手姓名很常見）。在評論對話方塊中輸入一些文字後，在“圈速列表”中突出顯示一個或多個圈速，然後單擊“設定評論”按鈕。該評論將顯示在所有選定圈速的“圈速列表”中。
在“評論”對話方塊中輸入文字後，所有後續接收的圈速都將新增該評論。因此，如果您想將第一場比賽環節標記為“Bob”，請在“評論”對話方塊中輸入 Bob，所有接收的圈速都將新增“Bob”。當下一位車手上車時，請不要忘記更改姓名。
1.11 顯示檢視 - 地圖 vs. 資料繪圖
Pitside 主螢幕頂部有兩個單選按鈕選項，一個是“地圖”，另一個是“資料繪圖”。這些按鈕切換主顯示和子顯示上顯示的內容。
“地圖”按鈕將賽道地圖移至主顯示區域。您可以平移/縮放此賽道地圖以檢視特定的彎道或賽道區域，並檢視車手是如何進入/駛出該區域的。
“資料繪圖”按鈕顯示所有選定圈速的資料圖表。您可以以相同的方式平移/縮放這些圖表。
2 高階選項
2.1 操作 SETTINGS.TXT 檔案
幾個 Pitside 設定在“Settings.txt”檔案中的預設值中設定。此檔案位於與 PitsideConsole.exe 應用程式相同的資料夾中。如果您希望 Pitside 的啟動行為不同於當前的預設行為，您可以使用文字編輯器（記事本或寫字板都可以）更改它，並對檔案進行更改。
以下是可更改的設定順序
1) -是否執行 http 伺服器 (0 = 不執行。1 = 執行) Pitside 透過該伺服器與 Web UI 通訊。必須啟用此功能才能使用 Web UI 檢視內容。
2) -HTTP 伺服器埠 (埠 80 最易使用。較大的埠號，如 63938，不太可能被阻止)
3) -速度單位 (0 = KMH，1 = MPH，2 = M/S)
4) -繪製圖形點或線 (0 = 點，1 = 線)
5) -圖形繪圖顏色方案 (0 = 灰色背景，1 = 黑色背景)
2.2 選項選單
可以透過更改選項選單中的專案來覆蓋 Settings.txt 中設定的預設選項。這裡還有其他顯示選項。
2.2.1 公里/小時、英里/小時、米/秒
在這些 3 個選項之間切換以設定您的速度單位。一次只能選擇一個選項。
2.2.2 按時間排序圈速列表、按圈速排序圈速列表
在這些選項之間切換將按時間順序或按圈速（最快的排在最前面）對圈速列表進行排序。按圈速排序可以幫助確定要設定為參考圈的最快的圈速。
2.2.3 顯示所有最佳成績
選中此選項將在顯示的所有圖表中新增最佳圈速。這可以作為駕駛員輔助工具，除了參考圈之外。目前使用此選項的一個問題是，當資料庫較大時，Pitside 的響應速度會受到顯著影響。對於長時間耐力賽，建議不要選中此選項。
2.2.4 顯示車手最佳成績
這將顯示每個車手的最佳圈速，假設圈速列表中添加了不同的評論。這可以幫助確定車隊中誰是更好的車手，但可能會引發爭端 。目前使用此選項的一個問題是，當資料庫較大時，Pitside 的響應速度會受到顯著影響。對於長時間耐力賽，建議不要選中此選項。
2.2.5 顯示參考圈速
此選項切換所有圖表中顯示參考圈速的功能。在某些顯示（牽引力圓、圈速摘要、加速）中，顯示參考圈速只會增加混亂，因此添加了此選項。
2.2.6 在資料點之間繪製線
在每個圖表的每個資料點和每個資料集的連線線之間切換。如果您想檢視收集的所有資料點，這很有用。
2.2.7 對繪圖使用深色背景
在淺灰色和黑色資料圖表背景之間切換。使用對您來說最能顯示資料的選項。
2.2.8 繪圖選項……。
在第 2.3 節“將資料繪製為圖表與僅值”中詳細介紹
2.3 將資料繪製為圖表與僅值
“繪圖選項”選單允許使用者選擇如何顯示給定比賽可用的各種資料通道。選擇“選項”/“繪圖選項……”，將出現以下視窗
將顯示為已載入比賽階段可用的所有唯一資料通道。不會顯示基本資料通道和派生資料通道（距離、速度、時間、圈速、圈速摘要、成績單）。然後，使用者可以透過單擊相應的單選按鈕來選擇哪些資料通道將顯示為圖表或僅值。
“僅值”顯示是最多 5 個數據通道的關鍵統計資訊可以顯示的地方。通常，“僅值”顯示區域用於顯示跟蹤不隨時間顯著變化的關鍵引數的資料通道的關鍵統計資訊。發動機管理（高度、油壓、冷卻液溫度、機油溫度、燃油量）是通常選擇的典型引數。
請注意，資料通道需要在 Y 軸列表中選擇才能顯示，就像圖形顯示一樣。
2.4 設定僅值資料通道的報警限值
一旦選擇了僅值資料通道，使用者可以選擇為每個通道設定報警限值。這可以透過在“繪圖選項……”對話方塊的“下限”和“上限”列中輸入適當的限值（上限、下限或兩者）來完成。
如果一個或多個數據通道的最小值或最大值超過使用者選擇的上下限，則 Pitside 螢幕上將出現一個警告通知框。按照說明操作，瞭解如何刪除警告對話方塊並採取相應的措施。
2.5 向 Wifilapper 手機發送訊息
可以從 Pitside 向車內的 Wifilapper 應用程式傳送簡短訊息。要確保成功，需要滿足幾個條件。首先，手機需要能夠在賽道上連線到 Wi-Fi 網路。其次，Wifilapper 應用程式需要在手機上執行並收集圈速資料。
更優選的傳送訊息到手機的方法是，假設手機具有簡訊功能，就是使用手機中設定的字首字串向其號碼傳送簡訊。這種方法允許從 Wifilapper 向維修區的手機發送確認訊息。透過 Pitside 直接傳送訊息時，無法進行確認。
如果仍然希望透過 Pitside 傳送訊息，請單擊“傳送訊息”按鈕，將出現以下對話方塊。
在頂部的“訊息”行中鍵入您想要的訊息。“顯示時間”欄位允許您選擇訊息在車內手機螢幕上顯示多長時間（以分鐘為單位）。預設設定為 1 分鐘。“傳送嘗試時間”是一個設定，它告訴 Pitside 多長時間（以分鐘為單位）嘗試將訊息傳送到手機。
在實際傳送訊息之前，請確保汽車已連線到 Wi-Fi 網路，然後單擊“確定”按鈕。如果手機在傳送訊息時未連線，則手機不太可能成功接收訊息。當 Pitside 在“評論”輸入區域下方顯示“手機 IP: xxx.xxx.xxx.xxx”時，您可以知道汽車已成功連線到網路。
建議使用者在比賽前測試訊息功能，以便熟悉它。
2.6 牽引力圓
牽引力圓圖是 Pitside Console 中顯示的一種專用圖表，需要在 Pitside 中設定特定的顯示設定才能正常工作。以下是使用者需要按照的步驟，以便成功為一個圈速顯示牽引力圓，假設 Pitside 正在顯示預設的距離/速度資料圖
1) 在“選項”選單中取消選中“在資料點之間繪製線”。
2) 在“選項”選單中取消選中“顯示參考圈速”。
3) 在 Y 軸選擇框中選擇“Y-加速度”資料通道。您應該會看到 Y-加速度資料顯示在圖表中。
4) 在 X 軸選擇框中選擇“Y-加速度”資料通道。一條資料線應該以圖表的形式顯示出來。
5) 在 Y 軸選擇框中選擇“X-加速度”資料通道。圖形螢幕可能為空白或顯示反向牽引力圓。
6) 在 X 軸選擇框中選擇“X-加速度”資料通道。一條資料線應該以圖表的形式顯示出來。
7) 在 Y 軸選擇框中選擇“Y-加速度”資料通道。牽引力圓圖現在應該成功顯示。
您可能需要將 X 軸切換回距離，並重復步驟 3-7，以便在您選擇顯示不同的圈速時。
2.7 使用時間 X 軸顯示來顯示長期趨勢 時間 X 軸是一個特殊資料通道，用於顯示可能在比單個圈速更長的時間範圍內發生的趨勢。這對於檢視圈速摘要和發動機管理資料（例如溫度、油壓、高度等）非常有用。您必須從圈速列表中選擇多個圈速才能顯示圖表。
2.8 Wi-Fi 點 Wi-Fi 點是一種顯示，用於顯示手機連線到網路的 Wi-Fi 訊號強度足夠強的位置。您可以透過將 Wi-Fi 點 X 與 Wi-Fi 點 Y 作為資料圖表顯示來確定汽車在賽道上的哪個位置成功連線到 Wi-Fi 網路。
2.9 未來增強功能（列印/複製） Pitside 中有幾個選單項仍在等待開發時間才能變得活躍。目前，這些功能是列印和複製功能。這些功能可能會包含在未來的 Pitside Console 版本中，但現在選擇這些專案不會造成任何問題，但也不會執行任何操作。
3 Wifilapper 資料庫管理
Pitside 中的“資料”選單選項包含多個操作，可幫助您管理比賽階段和 .wflp 資料庫。
3.1 切換比賽階段 此選項用於切換到與當前活動比賽階段不同的比賽階段。將顯示一個視窗，其中顯示所有可用的比賽階段；選擇您想要的比賽階段，它將成為分析的活動資料集。
如果您想選擇另一個 .wflp 資料庫進行分析，請選擇“開啟 .wflp DB”選項。瀏覽並選擇您想要的資料庫和比賽階段進行分析。
3.2 編輯/重新命名比賽階段
比賽階段名稱最初是在 Android 手機上的 Wifilapper 應用程式中設定的。然而，通常會使用相同的比賽名稱錄製和儲存多個比賽階段，這使得在 Pitside 中進行識別變得困難。
您可以透過使用“資料”/“編輯/合併比賽階段”選單選項從 Pitside 中更改一個或多個比賽階段的名稱。將顯示當前 .wflp 資料庫中包含的所有比賽階段。選擇您想要更改名稱的一個或多個比賽階段（Shift-單擊或 Ctrl-單擊在此處有效），然後單擊“重新命名”按鈕。輸入您的新名稱並確認。使用“切換比賽階段”選項來檢視或載入包含已更改名稱的比賽階段列表。
3.3 合併比賽階段
您可以在 Pitside 中將一個或多個比賽階段合併到一個單獨的比賽階段，方法是使用資料/“編輯/合併比賽階段”選單選項。當前 .wflp 資料庫中包含的所有比賽階段將被顯示。選擇您要合併到一個單獨階段的一個或多個比賽階段（可以使用 Shift-點選或 Ctrl-點選），然後點選“合併”按鈕。一個警告確認框將彈出，為您提供一些關於何時合併階段有意義以及何時沒有意義的指導。如果您選擇確認合併，Pitside 將自動載入合併的階段並將其設為活動階段。
3.4 將資料匯出到 .CSV 格式
比賽階段資料可以從 Wifilapper 匯出到逗號分隔變數 (.CSV) 格式，其他分析和顯示應用程式可以使用此格式。Pitside 在資料輸出格式方面支援 DASHWARE 應用程式。這允許使用者將賽道地圖和其他元素，例如儀表，疊加到為特定比賽收集的影片流上。
要匯出資料，首先選擇要匯出到 .CSV 檔案的圈數。然後選擇資料/“將所選圈數匯出到 .CSV 格式”。選擇輸出檔案的名稱（.CSV 將自動新增），然後點選 Pitside 將進行處理，處理時間取決於所選圈數的多少。完成後，該檔案可供其他程式使用。
4 貢獻者/鳴謝
許多人對 Wifilapper 和 Pitside 應用程式的現狀做出了重要貢獻。首先是 Art Hare，他從無到有建立了整個專案，然後決定將其作為開源專案釋出。接下來是 Jason Willis，他幫助開發了 SQL 資料庫程式碼並建立了 Web UI 基礎。Keith Jones 也幫助改進了 Pitside Console 應用程式的編碼。
最後，Wifilapper 社群中有許多人提出了改進建議並發現了程式碼中的各種錯誤。其中包括 Enduroracer、Cgorton 以及其他一些我目前無法列出的貢獻者。