thumby-rs

这是一个Rust crate，可用于与TinyCircuits Thumby设备接口。

下载并安装二进制文件

1. 导航到发布页面。
2. 从Assets下拉菜单中下载.uf2文件。
3. 确保您的Thumby处于BOOTSEL模式
   • 通过将顶部的开关切换到右侧来打开您的Thumby。
   • 在按住D-pad上的down按钮的同时，通过将开关切换到左侧来关闭您的Thumby。
   • 继续按住down按钮，再次打开您的Thumby。
   • 您的Thumby现在应已连接到您的系统。
4. 将下载的.uf2文件移动到您的Thumby上。它应该会自动卸载。

下载和运行示例的说明

1. 下载Rust。
2. 运行setup.sh脚本。这需要Bash CLI，在Windows上可能通过Git Bash获得。
3. 确保您的Thumby处于BOOTSEL模式
   • 通过将顶部的开关切换到右侧来打开您的Thumby。
   • 在按住D-pad上的down按钮的同时，通过将开关切换到左侧来关闭您的Thumby。
   • 继续按住down按钮，再次打开您的Thumby。
   • 您的Thumby现在应已连接到您的系统。
4. 可选：安装Visual Studio Code。
5. 克隆此仓库
   gitclone https://github.com/jngo102/thumby-rs
6. 如果您已安装Visual Studio Code，您可以通过打开命令面板(Ctrl/Cmd+Shift+P)，执行Deploy to Thumby任务，然后回答提示来快速将部署到连接的Thumby。
7. 如果您未安装Visual Studio Code，您可以打开一个终端，导航到克隆仓库的路径：cd /path/to/thumby-rs，并运行命令cargo build --example {exampleName}，其中{exampleName}应替换为示例文件夹中可找到的示例名称。
8. 构建完成后，导航到生成的二进制文件：cd ./target/thumbv6m-none-eabi/debug/examples/{exampleName}
9. 运行命令 elf2uf2-rs {exampleName} 将 ELF 二进制文件转换为 Thumby 可用的 UF2 二进制文件。
10. 将生成的 UF2 文件复制到已挂载的 Thumby 位置。它应该会自动卸载。

在项目中使用此软件包

1. 将 rp2040-hal 模板项目 克隆到您的计算机上。
2. 在 IDE 中打开克隆的文件夹。
3. 在 Cargo.toml 文件中，在 [dependencies] 下，添加 thumby = "^0"。
4. 现在您可以开始导入 thumby-rs 模块以用于您的游戏。
5. 如果您有 Visual Studio Code，建议安装 rust-analyzer 扩展。