ESP向けRustブック
The Rust on ESP Book (docs.espressif.com)
要約
本書は、Espressif製品上でRustを用いた組み込み開発を始めるためのガイドです。ツールの使い方、ソフトウェアスタックの構造、基本的なワークフローを解説し、読者がより高度なトピックに進むための準備を整えます。組み込み開発の経験がないRust開発者も対象としており、低レベルプログラミングの概念も適宜紹介されます。
全文翻訳
The Rust on ESP Book
キーボードショートカット
← または → で章間を移動
S または / でブック内を検索
? でこのヘルプを表示
Esc でこのヘルプを非表示
[画像]
Preface
Espressif製品での組み込みRust開発ガイドへようこそ。この本は、当社のツールとエコシステムの使用を開始し、慣れるのを助けるために設計されています。その過程で、ソフトウェアスタックの構造を紹介し、プロジェクト生成とツールの基本的なワークフローを説明します。最終的には、リファレンスドキュメントや外部トレーニングリソースを通じて、より高度な資料を探求できるようになるでしょう。
Who This Book Is For
この本は、組み込み開発に興味があるRust開発者を対象としており、組み込みシステムでの経験がない場合でも対象となります。低レベルプログラミングの概念に多少精通していると役立つかもしれませんが、重要なアイデアは登場時に紹介するように努めます。もし、基本的な知識を広げたい場合は、追加のResourcesを検討してください。
Stability and Availability
安定性には努めていますが、APIの改善、パフォーマンスの向上、新機能の導入に伴い、定期的な変更が発生する可能性があることをユーザーは理解しておく必要があります。すでに安定化されているModulesは、セマンティックバージョニング(SemVer)に従い、破壊的な変更の対象とはなりません。しかし、esp-halの一部や特定のドライバなどのunstableな機能は活発に開発されており、SemVerの保証の対象外です。これは、これらのunstableコンポーネントを使用すると、Rustのnightlyコンパイラを使用する場合と同様に、単純なcargo updateでプロジェクトが破損する可能性があることを意味します。このような不安定さは、まだ急速に進化している広範なRust組み込みエコシステム全体に共通するものです。頻繁な変更を予想し、依存関係を注意深く追跡してください。すべての主要なクレートについて、リリース間のマイグレーションガイドを提供し、最新の状態を保つのを支援します。
Additional Resources
この本で扱われている特定の概念に慣れていない場合や、理解を深めたい場合は、以下のリソースが役立つかもしれません。
| Resource | Description |
|---|---|
| The Rust Programming Language | 組み込み開発に飛び込む前に、Rustの基本を学びましょう。 |
| The Embedded Rust Book | RustのEmbedded Working Groupからのリソース集です。 |
Embedded Rust (no_std) on Espressif | Espressif SoCでのno_std環境での作業ガイドです。 |
| Awesome ESP Rust | Espressif製品向けのRustプログラミング言語での開発リソースのリストです。 |
| Awesome Embedded Rust | Rustプログラミング言語での組み込みおよび低レベルプログラミングに関連するリソースのリストで、有用なクレートのセレクションも含まれています。 |
Contributing to This Book
この本の作業は、このリポジトリで調整されています。
指示に従うのが難しい場合や、不明瞭なセクションを見つけた場合は、issue trackerで報告してください。タイポ修正や明確さ向上のためのプルリクエスト形式での貢献はいつでも歓迎です!
Support and Community
ヘルプが必要な場合、質問がある場合、またはesp-rsに関連するトピックについて議論したい場合は、Matrixでコミュニティチャットに参加してください。
この本が、Espressif製品でRustを使用して堅牢で効率的かつ安全な組み込みアプリケーションを構築するための知識と自信を提供してくれることを願っています。始めましょう!