Подготовка
В этой главе описаны учебные материалы, необходимое оборудование и инструкции по установке.
Значки и форматирование
В книге мы используем значки, чтобы выделять разные виды информации:
- ✅ Призыв к действию.
- ⚠️ Предупреждения и детали, требующие особого внимания.
- 🔎 Сведения, которые углубляются в тему, но не обязательны для понимания дальнейшего материала.
- 💡 Подсказки, которые могут помочь при выполнении упражнений.
Пример заметки: заметки такого вида содержат полезную информацию.
Аннотации в коде
В некоторых файлах Rust встречаются якорные комментарии:
// ANCHOR: test
let foo = 1;
...
// ANCHOR_END: test
Якорные комментарии можно игнорировать: они нужны только для того, чтобы вставлять фрагменты кода в эту книгу. См. документацию mdBook.
Необходимое оборудование
- Rust ESP Board: доступна на Mouser и AliExpress. Полный список продавцов.
- Кабель USB-C, подходящий для подключения платы к компьютеру разработчика.
- Точка доступа Wi-Fi с выходом в Интернет.
Дополнительный отладчик или программатор не нужен.
Симуляция проектов
Некоторые проекты можно симулировать, хотя бы частично, с помощью Wokwi. Вот список проектов с поддержкой симуляции Wokwi:
intro/hello-worldintro/http-clientadvanced/i2c-sensor-readingadvanced/i2c-driveradvanced/button-interrupt
Перед запуском любого проекта для симуляции нужно установить расширение. Чтобы симулировать один проект:
- Нажмите F1, выберите
Wokwi: Select Config Fileи укажитеwokwi.tomlнужного проекта.- Отредактируйте соответствующий
wokwi.toml, чтобы симулировать упражнение или решение.
- Отредактируйте соответствующий
- Соберите проект в режиме
debug. - Снова нажмите F1 и выберите
Wokwi: Start Simulator.
Также можно отладить проект.
Проверка готовности к работе
⚠️ Если вы участвуете в курсе, который ведёт Ferrous Systems, настоятельно советуем подготовиться по инструкциям этой главы хотя бы за один рабочий день до начала, чтобы убедиться, что всё готово. Если возникнут проблемы или понадобится поддержка, свяжитесь с нами.
⚠️ Если вы используете ESP32-C3-DevKitC-02, некоторые выводы и адреса ведомых устройств будут отличаться: плата похожа, но не идентична. Это касается решений в advanced/i2c-sensor-reading/ и advanced/i2c-driver/, где выводы и адреса для ESP32-C3-DevKitC-02 закомментированы.