4 个版本

0.2.2 2024 年 4 月 3 日
0.2.1 2024 年 3 月 30 日
0.2.0 2024 年 3 月 15 日
0.1.0 2024 年 3 月 14 日

#211 in 机器人学

21 每月下载量
ftswarm_emulator 中使用

MIT 许可证

65KB
1.5K SLoC

ftswarm-rs | ftSwarm 协议的 Rust 实现

此项目专门设计用于与 ftSwarm 一起使用。如果您还没有一些,可以在此 订购。

什么是 ftSwarm?

ftSwarm 项目的目标是构建小型网络控制器,用于 DIY 和玩具应用。由于它们相互连接,它们可以像一群蜂群一样行动。

例如,它们可以充当几个独立的机器人,共同完成任务。在更大的模型中,控制器可以安装在接近执行器和传感器的不同位置 - 一起控制整个模型。

最初,该项目是为与 fischertechnik 一起使用而设计的。由于安装槽与 Makerbeam 配置文件兼容,ftSwarms 可以用于许多 DIY 项目。

什么是 ftswarm-rs?

要控制 ftSwarm,您有两种选择:将您的代码嵌入 ftSwarm 固件中,或将其用作哑设备,从中央计算机控制。此存储库是第二种选择的实现。

已经有一个 ftSwarm 协议的 Python 实现,但我想有一个 Rust 实现,所以这就是它。

ftswarm-rs 的当前状态是什么?

该项目处于早期开发阶段。以下功能已实现

  • 连接到 ftSwarm
  • 向 ftSwarm 发送命令
  • 从 ftSwarm 接收数据
  • 错误恢复
  • 为测试目的模拟 ftSwarm

以下功能尚未实现

  • 实现摇杆支持
  • 实现步进电机支持
  • 实现 I2C 订阅

使用 ftswarm-rs

如果您在这里,您可能已经熟悉 Rust。如果不熟悉,可以在 此处 找到 Rust 的良好介绍。要使用 ftswarm-rs,您可以将其添加到您的 Cargo.toml 中的依赖项。

[dependencies]
ftswarm = "0.2.2"

要在您的代码中使用它,请查看crates/ftswarm/examples目录中的示例。

如果您想在没有实际ftSwarm的情况下进行测试,可以使用ftswarm-emulator crate。它提供了一个简单的模拟器,可以用于在不拥有真实ftSwarm的情况下测试您的代码。要使用它,请将其添加到您的Cargo.toml中的依赖项。

[dependencies]
ftswarm_emulator = "0.2.2"

如何进行贡献?

欢迎贡献!如果您对这个项目感兴趣,可以通过测试软件、编写文档或贡献代码来帮助。如果您想进行贡献,请随时打开一个issue或pull request。如果您计划添加新功能,最好先打开一个issue与我确认,以避免您正在开发的项目已经有人在开发。

ftswarm-rs的许可信息是什么?

ftswarm-rs采用MIT许可。您可以在仓库根目录下的LICENSE文件中找到许可文本。


联系方式:[email protected]

依赖项

~5–12MB
~129K SLoC