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 以及其他一些我目前无法列出的贡献者。