BBS-FW 开源固件使用教程

1. 项目介绍

BBS-FW 是一个开源固件项目，旨在替代 Bafang 原厂固件，适用于 BBSHD 和 BBS02 电机控制器。该项目几乎实现了原厂固件的所有功能，并添加了额外的特性。BBS-FW 兼容所有与原厂 Bafang 固件兼容的显示屏，并提供了一个自定义配置工具，因为 BafangConfigTool 由于支持的参数不同而不兼容。

主要特性

• 更高的功率输出：无需硬件修改即可获得更高的功率（最大 33A）。
• 无电压上限：软件中没有电压上限，默认可以运行到 63V（组件的最大额定值）。
• 低电压支持：支持低电压截止，例如 36V 电池。
• 平滑的油门/PAS 覆盖：提供平滑的油门和踏板辅助系统（PAS）覆盖。
• 可选的街道合法和越野辅助级别：通过按键组合切换。
• 支持设置道路速度限制和踏频限制：每个辅助级别都可以设置。
• 巡航辅助级别：支持在没有踏板或油门输入的情况下提供电机功率。
• 温度和低电压渐进式限制：逐步降低电机功率以保护电池和电机。

2. 项目快速启动

2.1 下载固件

首先，从 GitHub 仓库下载最新的固件版本：

git clone https://github.com/danielnilsson9/bbs-fw.git
cd bbs-fw

2.2 安装固件

根据项目提供的安装指南，使用以下命令进行固件的安装：

# 假设你已经按照指南连接好了硬件
python flash_firmware.py --firmware_path=path_to_firmware.bin

2.3 配置固件

使用项目提供的配置工具进行固件的配置：

# 启动配置工具
python config_tool.py

在配置工具中，你可以设置各种参数，如电压、电流限制、辅助级别等。

3. 应用案例和最佳实践

3.1 应用案例

BBS-FW 广泛应用于各种电动自行车改装项目中，特别是那些需要更高功率输出的场景。例如，一些用户将其应用于山地自行车，以获得更强的爬坡能力。

3.2 最佳实践

• 逐步增加功率：在初次使用时，建议逐步增加功率设置，以确保电机和电池的稳定性。
• 定期检查温度：使用过程中，定期检查电机和控制器的温度，避免过热。
• 备份原厂固件：在刷入新固件之前，建议备份原厂固件，以便在需要时恢复。

4. 典型生态项目

4.1 相关项目

• BafangConfigTool：虽然 BBS-FW 不兼容 BafangConfigTool，但了解原厂工具的功能有助于更好地理解 BBS-FW 的配置。
• Endless-Sphere Forum：这是一个活跃的电动自行车改装社区，用户可以在其中分享经验和技术讨论。

4.2 社区支持

• GitHub Issues：在 GitHub 仓库中提交问题，获取开发者和其他用户的帮助。
• Endless-Sphere Forum：参与社区讨论，获取更多实际应用中的建议和解决方案。

通过以上步骤，你可以快速上手并充分利用 BBS-FW 开源固件，提升你的电动自行车性能。