#raspberry-pi-pico #raspberry-pi #no-std #extra

sys no-std pico-sdk-sys

树莓派 Pico SDK 的 FFI 绑定

2 个版本

0.1.1 2024 年 7 月 14 日
0.1.0 2024 年 7 月 14 日

嵌入式开发 中排名 278

每月下载 22

MIT 许可证

440KB
6.5K SLoC

pico-sdk-rs

Rust 编程语言的 Pico SDK 绑定。

[!WARNING] 大多数绑定由 rust-bindgen 生成。如果缺少任何绑定,请 创建一个问题

目录

入门指南

由于此 crate 依赖于 Pico C SDK 和其他工具(参见官方文档),因此必须先下载或编译这些工具。此 crate 将自动为您下载或编译这些工具,但也可能手动下载,并且 crate 将相应地获取它们。

先决条件

如果工具已存在于您的系统上,则将使用它们。

否则,以下依赖项是编译和构建此 crate 所必需的

环境变量

  • PICO_SDK_PATH Pico SDK 的路径。
  • PICO_EXTRAS_PATH Pico SDK extras 的路径。(可选)
  • PICO_TOOLCHAIN_PATH Arm GNU 工具链的路径。它必须包含 arm-none-eabibinincludelib 文件夹。
  • PATH 此 crate 在 PATH 中搜索 ninja,因此请确保 ninja 在 PATH 中。

用法

将其添加到您的 Cargo.toml

[dependencies]
pico-sdk-sys = "0.1.0"

有关详细信息,请参阅 官方文档。示例可以在 kaganege/pico-sdk-rs-examples 中找到。

功能

默认情况下启用 enable-stdio-usb 功能。

  • pico-w:启用 WiFi 支持。
  • extras:添加 pico-extras 绑定。
  • alloc:使用 Arm GNU 工具链的分配器。
  • enable-stdio-uart:启用通过 UART 记录。
  • enable-stdio-usb:启用通过 USB 记录。
  • full:启用 extrasalloc 功能。

Rust 版本要求

pico-sdk-rs 与稳定 Rust 一起工作,并且通常也与最新的先前稳定版本一起工作。

Pico SDK 版本

目前此库使用 pico-sdk 1.5.1(或更高补丁版本)。

许可证

基于MIT许可协议(LICENSEopensource.org/licenses/MIT

依赖项

~0.1–5MB
~94K SLoC