3 个版本
0.1.2 | 2023年6月14日 |
---|---|
0.1.1 | 2023年6月9日 |
0.1.0 | 2023年6月9日 |
#934 in 硬件支持
用于 f-xoss-util
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