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日

#208 in 机器人技术


2 crate 中使用

MIT 许可证

10KB
152 代码行

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 库。它提供了一个简单的模拟器,可以在没有真实 ftSwarm 的情况下测试您的代码。要使用它,将其添加到您的 Cargo.toml 依赖项中。

[dependencies]
ftswarm_emulator = "0.2.2"

我如何贡献?

欢迎贡献!如果您对这个项目感兴趣,可以通过测试软件、编写文档或贡献代码来帮助。如果您想贡献,请随意提出一个问题或拉取请求。如果您打算添加新功能,最好先打开一个问题,以便先与我确认,以避免您正在开发的项目已经处于开发中。

ftswarm-rs 的许可方式是什么?

ftswarm-rs 在 MIT 许可下发布。您可以在存储库根目录下的 LICENSE 文件中找到许可文本。


联系方式:[email protected]

依赖项

~1.7–2.7MB
~52K SLoC