Введение

Примечание о переводе: это русскоязычная версия книги. Оригинал на английском языке является основным, поэтому при расхождениях ориентируйтесь на него. Код, сообщения в логах и тексты интерфейса оставлены на английском языке, так же как в самих проектах.

Цель этой книги — дать подробное руководство по началу работы с языком программирования Rust на устройствах ESP32-C3 от Espressif.

Книга проведёт вас через создание приложения на Rust в режиме no_std с использованием esp-hal. По ходу дела мы будем работать с разной аппаратной периферией. Подробнее о приложении, которое мы будем создавать, рассказано в главе Обзор проекта.

Мы предполагаем, что вы уже знакомы с Rust; подробности см. в главе Предварительные требования.

Если у вас возникнут технические вопросы или проблемы, вы можете присоединиться к сообществу esp-rs в Matrix. Сообщество открыто для всех.

Как пользоваться этой книгой

Эта книга рассчитана на чтение от начала до конца. Последующие главы опираются на понятия, введённые в предыдущих главах, а ранние главы могут опускать детали, которые раскрываются позже.

Исходный код приложения, которое мы будем создавать, находится в каталоге no-std-training/project этого репозитория.

Принятые в книге обозначения

В книге используются значки для выделения разных видов информации:

• ✅ Призыв к действию.
• ⚠️ Предупреждения и сведения, которым нужно уделить особое внимание.
• 🔎 Подробности, которые углубляют тему, но не обязательны для понимания дальнейшего материала.
• 💡 Подсказки, которые могут помочь при выполнении упражнений.

Пример примечания: примечания, подобные этому, содержат полезную информацию

В некоторых файлах на Rust вы можете встретить якорные комментарии:

// ANCHOR: test
let foo = 1;
...
// ANCHOR_END: test

Якорные комментарии можно игнорировать: они нужны только для того, чтобы выделять фрагменты кода в книге. См. документацию mdBook.

Повторное использование материалов

Эта книга распространяется под следующими лицензиями:

• Код, содержащийся в книге, распространяется на условиях как лицензии MIT, так и Apache License v2.0.
• Текст, изображения и диаграммы в книге распространяются на условиях лицензии Creative Commons CC-BY-SA v4.0.

Если вы хотите использовать наш текст или изображения в своей работе, вы должны:

• Указать соответствующее авторство (например, упомянуть эту книгу на слайде и привести ссылку на нужную страницу).
• Привести ссылку на лицензию CC-BY-SA v4.0.
• Указать, если вы каким-либо образом изменили материал, и опубликовать свои изменения на тех же условиях лицензии.