#devices #computer #free #ble #offline #satellite #xoss

f-xoss

释放您的XOSS设备:用于与XOSS自行车计算机通信的库

3 个版本

0.1.2 2023年6月14日
0.1.1 2023年6月9日
0.1.0 2023年6月9日

#934 in 硬件支持


用于 f-xoss-util

MPL-2.0 许可证

66KB
1.5K SLoC

f-xoss: 释放您的Xoss设备

无云版的Xoss伴侣应用重新实现

支持

目前,此应用仅测试了Xoss Nav自行车计算机。其他Xoss自行车计算机似乎使用相同的协议,但我还没有研究支持它们。

功能

此应用允许您

  • 从您的设备下载训练数据(Garmin FIT格式)
  • 获取卫星GPS辅助数据(使用u-blox AssistNow Offline 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令牌。您可以在这里免费获取一个。您也可以直接按回车键跳过此步骤,但卫星数据将不会更新。

4. 同步!

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

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

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

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

依赖项

~16–48MB
~771K SLoC