f-xoss：解放您的Xoss设备

一个无云的Xoss伴侣应用程序的重实现

支持

目前，这仅在Xoss Nav自行车电脑上进行了测试。其他Xoss自行车电脑似乎使用相同的协议，但我还没有研究支持它们。

功能

此应用程序允许您

• 从您的设备下载锻炼数据（Garmin FIT格式）
• 获取卫星GPS辅助数据（使用u-blox AssistNow离线API）

尚未实现

• 将地图数据上传到设备
• 将轨迹上传到设备
• 编辑设备设置
• 自定义面板布局

使用方法

1. 安装应用程序

您可以在Linux或macOS上使用bash安装程序

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/DCNick3/f-xoss/releases/latest/download/f-xoss-util-installer.sh | sh

Windows上的powershell安装程序

irm https://github.com/DCNick3/f-xoss.git/releases/download/f-xoss-util-installer.ps1 | iex

或者，可以使用cargo binstall

cargo binstall f-xoss-util

最后，您可以从源代码构建它，使用cargo install

cargo install f-xoss-util

1.1.（可选）您还可以使用以下命令安装shell自动完成

bash

f-xoss-util completion bash > ~/.local/share/bash-completion/completions/f-xoss-util

fish

f-xoss-util completion fish > ~/.config/fish/completions/f-xoss-util.fish

zsh

f-xoss-util completion zsh > ~/.zsh/completions/_f-xoss-util

2.0.（仅限Linux）调整BLE连接监督超时

如果您正在使用Linux，您需要在配对之前增加BLE连接监督超时，因为默认值对于设备来说太低，会导致文件传输期间的超时。

要更改超时，请编辑/etc/bluetooth/main.conf并在[LE]部分添加/取消注释以下行

[LE]
ConnectionSupervisionTimeout=400

请注意，重启bluetoothd不足以应用更改，您需要重新启动系统。卸载所有蓝牙相关的内核模块也会起作用，但由于有很多依赖项，所以重新启动系统更简单。

2.1.与您的设备配对

您将使用标准操作系统工具进行此操作。要将Xoss Nav切换到配对模式，您需要进入菜单并选择“连接XOSS”菜单项。

如果您已与其他设备配对，它将显示“XOSS#1234”。您需要先通过在下拉菜单中选择“删除”选项来取消配对。

3. 生成配置文件

接下来，您应该使用f-xoss-util setup命令来生成配置文件。

首先，它会要求您从所有可用的蓝牙设备中选择XOSS设备。

然后，它会要求您提供用于更新卫星数据的u-blox AssistNow令牌。您可以在此处免费获取一个。您也可以直接按Enter键跳过此步骤，但卫星数据将不会更新。

4. 同步！

现在您可以使用f-xoss-util dev sync命令定期同步您的设备。

这将确保时间设置正确，卫星数据更新，并下载锻炼数据。

锻炼数据将保存到数据目录中，格式为Garmin FIT。

您可以使用f-xoss-util paths获取数据目录的路径。