{"draftJsState":{"blocks":[{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Доброго здоровья, уважаемые читатели!","type":"unstyled","key":"1vcv3"},{"data":{},"depth":0,"entityRanges":[{"key":0,"length":44,"offset":71}],"inlineStyleRanges":[],"text":"Данная статья - несколько сокращенная версия статьи на основном сайте: https://kotyara12.ru/iot/components-esp-idf/. На основном сайте более удобное оформление, можно скопировать тексты программ (если они есть), а также иногда вносятся исправления. Выводы делайте сами.","type":"blockquote","key":"6c7u6"},{"data":{"image":{"id":"6a93dccb1d2728606e95e0d6"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"38oa2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":62,"offset":43,"style":"BOLD"},{"length":27,"offset":211,"style":"BOLD"}],"text":"В данной статье попробуем разобраться, как подключать сторонние компоненты (библиотеки) к проекту ESP-IDF (то есть не входящие в состав основного ядра ESP-IDF). Во второй части статьи весьма кратко рассказано о реестре компонентов ESP-IDF. Статья предназначена для тех, кто хочет разобраться в программировании ESP32 с использованием фреймворка ESP-IDF и Arduino core в режиме ESP-IDF плюс Arduino as component.","type":"unstyled","key":"agvon"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":15,"offset":21,"style":"STRIKE"}],"text":"Компоненты в ESP-IDF и с чем их едят","type":"header-two","key":"eka6n"},{"data":{},"depth":0,"entityRanges":[{"key":1,"length":22,"offset":12}],"inlineStyleRanges":[{"length":152,"offset":0,"style":"BOLD"},{"length":46,"offset":386,"style":"BOLD"},{"length":39,"offset":434,"style":"BOLD"}],"text":"Компонент в системе сборки ESP-IDF — это независимый и переиспользуемый пакет кода, который является базовым строительным блоком для создания приложений. Основная идея компонентов — реализовать модульность кода. Это как конструктор Lego: вы собираете своё приложение из отдельных «кирпичиков» (компонентов), каждый из которых отвечает за свою задачу. Такой подход позволяет реализовать повторное использование кода в разных проектах, делает структуру проекта более понятной, что упрощает разработку и дельнейшую поддержку.","type":"unstyled","key":"ebt1v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":19,"offset":0,"style":"BOLD"},{"length":23,"offset":58,"style":"BOLD"},{"length":20,"offset":117,"style":"BOLD"},{"length":27,"offset":203,"style":"BOLD"}],"text":"Компоненты ESP-IDF по своему общему смыслу очень похожи на библиотеки Arduino IDE, но есть и принципиальные отличия. Компоненты в ESP-IDF — это более «продвинутая» и строгая версия, если сравнивать их с библиотеками из Arduino IDE.","type":"unstyled","key":"croja"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":18,"offset":21,"style":"ITALIC"},{"length":18,"offset":42,"style":"ITALIC"}],"text":"С одной стороны цель компонента ESP-IDF и библиотеки Arduino одна и та же: это способ повторно использовать готовый код — Вы не пишете драйвер для дисплея или датчика каждый раз с нуля, а берете готовую «библиотеку/компонент» и подключаете к проекту. И там, и там есть файлы .c/.cpp (исходники) и .h (заголовочные файлы). Вы можете скачать готовый компонент из интернета (например, из реестра ESP или с GitHub) так же, как вы скачиваете библиотеку через менеджер библиотек Arduino или с GitHub.","type":"unstyled","key":"npp5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":19,"offset":34,"style":"BOLD"},{"length":20,"offset":184,"style":"BOLD"}],"text":"Но есть и принципиальное отличие. Компонент в ESP-IDF — это «библиотека на стероидах», то есть более профессиональный инструмент для профессиональной сборки с системой зависимостей, а библиотека в Arduino — это чаще всего просто «папка с кодом». Компонент умеет управлять своими версиями, зависимостями от других компонентов и параметрами сборки, и делает это не через «авось скомпилируется», а через строгую систему CMake.","type":"unstyled","key":"8uhpf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":24,"offset":0,"style":"BOLD"},{"length":12,"offset":53,"style":"BOLD"},{"length":12,"offset":110,"style":"BOLD"}],"text":"Управление зависимостями. Допустим, у нас есть некая библиотека A, которая использует для своей работы другую библиотеку B. В этом случае:","type":"unstyled","key":"3vo0g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В Arduino IDE вы должны будете сами найти и установить в систему библиотеку B. Если версии библиотек не совпадают — проект падает с сотнями ошибок.","type":"unordered-list-item","key":"6i90i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":88,"style":"BOLD"},{"length":14,"offset":108,"style":"BOLD"}],"text":"В ESP-IDF управление зависимостями автоматическое. Компонент четко прописывает в файлах idf_component.yml и CMakeLists.txt, какие составные компоненты ему нужны и каких версий. Система сборки сама скачает и подключит их к проекту – вам не нужно об этом заботится.","type":"unordered-list-item","key":"36kri"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":34,"offset":0,"style":"BOLD"}],"text":"Настройка (конфигурация) библиотек. Иногда требуется изменить параметры какой-то библиотеки – например выбрать частоту SPI или пин GPIO. Как правило, это делается путем определения #define в коде или через параметры в конструкторе.","type":"unstyled","key":"97vrq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В Arduino IDE вам придется делать это либо через параметры командной строки или редактировать исходный код библиотеки.","type":"unordered-list-item","key":"fl12q"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":56,"style":"BOLD"}],"text":"В CMake легко и удобно задавать параметры через систему menuconfig (текстовое или графическое меню, с помощью которого можно задать параметры для всего проекта целиком, включая все подключенные компоненты). Вы сможете зайти в настройки компонента (если они предусмотрены разработчиком компонента, разумеется) и изменить их, не залезая в исходники компонента.","type":"unordered-list-item","key":"1ok13"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":0,"style":"BOLD"}],"text":"Правила сборки.","type":"unstyled","key":"c888j"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Arduino IDE сама решает, какие файлы компилировать, а какие нет. Обычно компилируется всё подряд в папке src библиотеки. В связи с этим иногда возникают проблемы.","type":"unordered-list-item","key":"bqnuu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":35,"style":"BOLD"}],"text":"У компонента есть специальный файл CMakeLists.txt – в нем разработчик сам указывает: какие файлы компилировать, какие папки с заголовками показывать наружу, а какие скрывать. Это дает полный контроль над процессом сборки компонента и включения его в проект.","type":"unordered-list-item","key":"cdeuj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Какие компоненты можно использовать в проекте ESP-IDF","type":"header-three","key":"3mfbo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В экосистеме ESP-IDF компоненты можно получить из нескольких основных источников, ниже приведен исчерпывающий список всех возможных способов подключить сторонний код к вашему проекту.","type":"unstyled","key":"5n9eh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":29,"offset":0,"style":"BOLD"},{"length":20,"offset":131,"style":"BOLD"},{"length":8,"offset":258,"style":"BOLD"},{"length":15,"offset":291,"style":"BOLD"},{"length":8,"offset":338,"style":"BOLD"},{"length":7,"offset":249,"style":"ITALIC"},{"length":13,"offset":378,"style":"ITALIC"}],"text":"Встроенные компоненты ESP-IDF\nЭто библиотеки, которые уже идут в основном составе самого фреймворка ESP-IDF. Они находятся в папке $IDF_PATH/components и являются основой для работы с системой, встроенными контроллерами, периферийными устройствами.\nПримеры: freertos (операционная система), esp_driver_gpio (работа с цифровыми выводами), esp_http (HTTP-клиент) и многие другие.\nИспользование: Чтобы их подключить к проекту, вам достаточно добавить соответствующий заголовочный файл #include в код – больше ничего не требуется. Добавлять зависимость от компонента в CMakeLists.txt в секции REQUIRES в этом случае не нужно! Эти компоненты нужны практически в любом проекте, и разработчики ESP-IDF сделали их доступными “из коробки”, чтобы не загромождать файлы сборки повторяющимися строчками.","type":"unordered-list-item","key":"55s1m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":28,"offset":0,"style":"BOLD"},{"length":11,"offset":216,"style":"BOLD"},{"length":11,"offset":543,"style":"BOLD"},{"length":19,"offset":645,"style":"BOLD"},{"length":27,"offset":96,"style":"ITALIC"},{"length":18,"offset":245,"style":"ITALIC"},{"length":11,"offset":510,"style":"ITALIC"}],"text":"Локальные компоненты проекта\nЭто компоненты, которые вы создаете сами и храните непосредственно внутри папки вашего проекта – это могут быть различные составные части большого проекта. Обычно их размещают в каталоге components/ в корне проекта.\nКогда использовать: Этот метод хорошо подходит для кода, который необходимо вынести из основного файла проекта для удобства, но который не планируется повторно использовать в других проектах, либо для прототипов и кастомизированных вариантов системных компонентов.\nОсобенность: Компоненты из папки components/ имеют наивысший приоритет при сборке и могут переопределять компоненты с тем же именем из managed_components/. Это удобно, если нужно модифицировать какой-либо стандартный компонент без правки его исходников.","type":"unordered-list-item","key":"dktmp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":46,"offset":0,"style":"BOLD"},{"length":30,"offset":245,"style":"BOLD"},{"length":14,"offset":428,"style":"BOLD"},{"length":62,"offset":508,"style":"BOLD"},{"length":15,"offset":168,"style":"ITALIC"},{"length":14,"offset":377,"style":"ITALIC"},{"length":7,"offset":500,"style":"ITALIC"}],"text":"Локальные общие компоненты (вне папки проекта)\nЕсли у вас есть набор собственных компонентов, которые вы одновременно используете в разных проектах, вы можете хранить (и редактировать) их в отдельной общей папке (например это может быть каталог $MY_LIBS/my_common_components/). В этом случае компоненты подключаются к системе сборки CMake напрямую, минуя менеджер компонентов.\nИспользование: Укажите путь к этой папке в главном CMakeLists.txt вашего проекта с помощью переменной EXTRA_COMPONENT_DIRS\nПример: set(EXTRA_COMPONENT_DIRS \"$ENV{MY_LIBS}/my_common_components\").","type":"unordered-list-item","key":"devns"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":22,"offset":0,"style":"BOLD"},{"length":20,"offset":58,"style":"BOLD"},{"length":19,"offset":439,"style":"BOLD"},{"length":20,"offset":58,"style":"ITALIC"},{"length":20,"offset":80,"style":"ITALIC"}],"text":"Управляемые компоненты\nИх поиском и установкой занимается менеджер компонентов. Менеджер компонентов интегрируется с системой сборки ESP-IDF для загрузки и управления компонентами из реестра компонентов и других источников – локальных папок, GitHub и т.д. Это стандартный способ подключения библиотек из реестра (но не только) к проекту ESP-IDF. Как правило, менеджер компонентов скачивает или копирует подключаемые библиотеки в каталог в managed_components/ вашего проекта. Но это не точно.","type":"unordered-list-item","key":"6vhvl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"При сборке компоненты ищутся в определенном порядке, который выглядит так:","type":"unstyled","key":"83f7u"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":40,"style":"BOLD"}],"text":"Локальные компоненты проекта — из папки components/ в корне вашего проекта.","type":"ordered-list-item","key":"4qh07"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":14,"style":"BOLD"},{"length":14,"offset":80,"style":"BOLD"}],"text":"Компоненты из EXTRA_COMPONENT_DIRS — папки с компонентами, которые вы указали в CMakeLists.txt.","type":"ordered-list-item","key":"em301"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":60,"style":"BOLD"},{"length":20,"offset":60,"style":"ITALIC"}],"text":"Управляемые компоненты — их поиском и установкой занимается менеджер компонентов.","type":"ordered-list-item","key":"eo66j"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":23,"offset":56,"style":"ITALIC"}],"text":"Встроенные компоненты ESP-IDF — системные компоненты из папки установки ESP-IDF.","type":"ordered-list-item","key":"fkie8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":159,"style":"BOLD"},{"length":19,"offset":219,"style":"BOLD"}],"text":"Если в нескольких источниках окажутся компоненты с одинаковыми именами, будет использован тот, который найден в источнике с более высоким приоритетом (т.е. из components/ вашего проекта перекроет системный компонент из IDF_PATH/components). Это удобно, если вам нужно модифицировать стандартный драйвер.","type":"unstyled","key":"34gei"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Менеджер компонентов (IDF Component Manager)","type":"header-three","key":"4rkmj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":192,"style":"BOLD"},{"length":18,"offset":315,"style":"BOLD"}],"text":"Это основной инструмент для управления зависимостями вашего проекта на ESP-IDF, который автоматически скачивает и подключает нужные компоненты (библиотеки) заданной версии. Он использует файл idf_component.yml в вашем проекте, находит все указанные в нем зависимости от сторонних компонентов и скачивает их в папку managed_components. Это избавляет вас от ручного поиска и копирования нужных библиотек. Особенно если вы открыли чужой проект из интернета – скачали проект, открыли его – а все библиотеки-компоненты подтянулись “волшебным образом”.","type":"unstyled","key":"77e5d"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":0,"style":"BOLD"}],"text":"Менеджер компонентов может получать компоненты из:","type":"unstyled","key":"7e1i0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"ESP Component Registry – центрального реестра компонентов Espressif (его мы обсудим ниже)","type":"unordered-list-item","key":"61paq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"из Git-репозитория","type":"unordered-list-item","key":"13dgb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"из локальной папки.","type":"unordered-list-item","key":"3q34a"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":48,"style":"BOLD"},{"length":54,"offset":113,"style":"BOLD"},{"length":20,"offset":190,"style":"BOLD"},{"length":12,"offset":225,"style":"BOLD"},{"length":18,"offset":284,"style":"BOLD"},{"length":20,"offset":190,"style":"ITALIC"}],"text":"Например: вы хотите добавить в проект фреймворк Arduino core как компонент ESP-IDF, вы просто выполняете команду idf.py add-dependency \"espressif/arduino-esp32^3.3.10\", и при сборке проекта менеджер компонентов сам скачает и Arduino core и все вложенные зависимости. При этом в папке managed_components появляются копии для всех компонентов, готовые к компиляции вместе с вашим проектом (в том числе локальных).","type":"unstyled","key":"1nc8j"},{"data":{},"depth":0,"entityRanges":[{"key":2,"length":21,"offset":297}],"inlineStyleRanges":[],"text":"По умолчанию диспетчер компонентов загружает компоненты из реестра компонентов ESP через интернет во время сборки. Если вы работаете в изолированной среде, в сети с ограниченным доступом или просто хотите получать воспроизводимые сборки без сетевых зависимостей, вы можете указать решателю версий локальный репозиторий.","type":"unstyled","key":"7t134"},{"data":{},"depth":0,"entityRanges":[{"key":3,"length":58,"offset":48},{"key":4,"length":103,"offset":157}],"inlineStyleRanges":[{"length":46,"offset":0,"style":"BOLD"},{"length":48,"offset":107,"style":"BOLD"}],"text":"Официальная документация IDF Component Manager: https://docs.espressif.com/projects/idf-component-manager/\nДокументация в составе ESP-IDF Programming Guide: https://docs.espressif.com/projects/esp-idf/en/latest/esp32/API-guides/tools/idf-component-manager.html","type":"unstyled","key":"82eiv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Файл манифеста idf_component.yml","type":"header-three","key":"c7itd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":211,"style":"ITALIC"},{"length":20,"offset":211,"style":"BOLD"}],"text":"Файл манифеста — это цифровой список “покупок” для вашего проекта. В нём вы пишете: “Для моего проекта мне нужен компонент А, версии не ниже 2.0”. Когда вы запускаете сборку (нажимаете кнопку “Скомпилировать”), менеджер компонентов читает этот список и автоматически скачивает все эти компоненты из интернета прямо в ваш проект. Как курьер, который привозит продукты по вашему списку.","type":"unstyled","key":"fup2n"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":5,"style":"BOLD"}],"text":"Файл idf_component.yml лежит в папке вашего проекта (обычно рядом с main). Выглядит он так:","type":"unstyled","key":"631de"},{"data":{"image":{"id":"6a93dd6a3209730b2dcf97b0"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"85lno"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Что здесь написано:","type":"unstyled","key":"efr05"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":0,"style":"BOLD"},{"length":19,"offset":81,"style":"BOLD"},{"length":7,"offset":178,"style":"BOLD"}],"text":"dependencies — раздел “зависимости” (то, что менеджер документов должен скачать).espressif/led_strip — имя компонента (как название библиотеки в Arduino, но с указанием автора).\n>=2.0.0 — версия (скачай версию 2.0.0 или новее).\n","type":"unordered-list-item","key":"19ee5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"А теперь магия, которой в Arduino нет.","type":"unstyled","key":"f0ov1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":9,"offset":32,"style":"BOLD"},{"length":6,"offset":192,"style":"BOLD"},{"length":6,"offset":240,"style":"BOLD"},{"length":20,"offset":292,"style":"BOLD"},{"length":6,"offset":415,"style":"BOLD"},{"length":6,"offset":204,"style":"ITALIC"},{"length":20,"offset":292,"style":"ITALIC"}],"text":"Допустим, вы добавили компонент led_strip. А для этого компонента внутри него программист написал (в своём собственном файле манифеста idf_component.yml): “Для моей работы мне нужен компонент driver“. Вы ничего не знаете про этот компонент driver – вы даже не подозреваете, что он нужен. Но менеджер компонентов сам зайдёт внутрь скачанного компонента, прочитает его манифест, увидит там зависимость от компонента driver и автоматически скачает его тоже. Вам не нужно ничего искать, скачивать и разбираться с ошибками “не найден такой-то файл”. Всё происходит само.","type":"unstyled","key":"bgafe"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":5,"style":"BOLD"}],"text":"Файл idf_component.yml может содержать два основных раздела:","type":"unstyled","key":"gicn"},{"data":{},"depth":0,"entityRanges":[{"key":5,"length":12,"offset":0}],"inlineStyleRanges":[],"text":"dependencies – зависимости вашего проекта от компонентов","type":"unordered-list-item","key":"1dbua"},{"data":{},"depth":0,"entityRanges":[{"key":6,"length":7,"offset":0}],"inlineStyleRanges":[],"text":"targets – цели, то есть семейства SoC","type":"unordered-list-item","key":"iia5"},{"data":{},"depth":0,"entityRanges":[{"key":7,"length":12,"offset":7}],"inlineStyleRanges":[],"text":"Раздел dependencies по своей сути является обязательным. Этот раздел представляет собой список (словарь), где каждый элемент — это название зависимости от какой-то библиотеки. Менеджер компонентов поддерживает следующие типы источников зависимостей:","type":"unstyled","key":"a68rn"},{"data":{},"depth":0,"entityRanges":[{"key":8,"length":34,"offset":0}],"inlineStyleRanges":[],"text":"Зависимости от локального каталога","type":"unordered-list-item","key":"7228o"},{"data":{},"depth":0,"entityRanges":[{"key":9,"length":18,"offset":0}],"inlineStyleRanges":[],"text":"Зависимости от Git","type":"unordered-list-item","key":"vh4g"},{"data":{},"depth":0,"entityRanges":[{"key":10,"length":38,"offset":0}],"inlineStyleRanges":[],"text":"Зависимости от реестра компонентов ESP","type":"unordered-list-item","key":"cirrb"},{"data":{},"depth":0,"entityRanges":[{"key":11,"length":22,"offset":0}],"inlineStyleRanges":[],"text":"Зависимость от ESP-IDF","type":"unordered-list-item","key":"2150f"},{"data":{},"depth":0,"entityRanges":[{"key":12,"length":75,"offset":173}],"inlineStyleRanges":[{"length":17,"offset":154,"style":"BOLD"},{"length":1,"offset":247,"style":"STRIKE"}],"text":"Поддерживаются условные зависимости, в том числе и от опций системы KConfig. В рамках данной статьи у меня нет цели подробно описывать все элементы файла idf_component.yml, подробнее про формат файла манифеста вы можете почитать самостоятельно тута.","type":"unstyled","key":"ec5bl"},{"data":{},"depth":0,"entityRanges":[{"key":13,"length":96,"offset":26}],"inlineStyleRanges":[{"length":24,"offset":0,"style":"BOLD"}],"text":"Официальная документация: https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html","type":"unstyled","key":"e1qei"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Подключение библиотек через IDF Component Manager","type":"header-three","key":"183ul"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Подключить к проекту необходимый компонент можно двумя основными способами:","type":"unstyled","key":"bcgpc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":18,"style":"BOLD"}],"text":"с помощью команды add-dependency для командной строки","type":"unordered-list-item","key":"dkjda"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"или через создание файла манифеста вручную – в любом текстовом редакторе","type":"unordered-list-item","key":"5k7du"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Также есть вариант подключения компонентов через графический интерфейс в ESP-IDF Eclipse Plugin.","type":"unstyled","key":"f4lsv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":21,"offset":95,"style":"BOLD"}],"text":"Если вы ничего не знаете про файл манифеста, да и не хотите знать – то это ваш способ. Команда idf.py add-dependency автоматически создаст или обновит нужный файл манифеста для вашего проекта. Для библиотек из реестра компонентов это самый быстрый и рекомендуемый способ.","type":"unstyled","key":"ciihl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"idf.py add-dependency \"namespace/name^version\"","type":"unstyled","key":"c1jah"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":16,"offset":57,"style":"BOLD"}],"text":"Например, чтобы добавить компонент для “драйвера” кнопки espressif/button версии 4.1.3 (или выше) выполните следующую команду в VSCode: > ESP-IDF: Open ESP-IDF Terminal:","type":"unstyled","key":"brcs9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"$ idf.py add-dependency \"espressif/button^4.1.3\"","type":"unstyled","key":"cddct"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"После этого вы должны получить примерно следующее сообщение:","type":"unstyled","key":"7mqte"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Executing action: add-dependency\nNOTICE: Successfully added dependency \"espressif/button\": \"^4.1.3\" to component \"main\"\nNOTICE: If you want to make additional changes to the manifest file at path /blink/main/idf_component.yml manually, please refer to the documentation: https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html","type":"unstyled","key":"f1ooj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":54,"style":"BOLD"}],"text":"Этой командой в вашем проекте будет создан новый файл idf_component.yml со следующим содержимым:","type":"unstyled","key":"2unnr"},{"data":{"image":{"id":"6a93dda66061fd54d6c4eb38"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"chetl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":18,"offset":88,"style":"BOLD"},{"length":18,"offset":225,"style":"BOLD"}],"text":"Этот файл заставит менеджер компонентов скачать компонент и все его зависимости в папку managed_components вашего проекта. Для выполнения этого необходимо запустить сборку проекта или выполнить команду реконфигурации проекта idf.py reconfigure.","type":"unstyled","key":"1ia47"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":22,"offset":106,"style":"BOLD"}],"text":"Далее, чтобы использовать компонент в вашем коде, необходимо подключить соответствующий заголовочный файл #include \"бла-бла-бла\" и вызвать функции, указанные в документации и папке компонента.","type":"unstyled","key":"chdvs"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":47,"offset":0,"style":"BOLD"}],"text":"Чтобы подключить компонент напрямую из Git-репо, укажите опцию --git и, при необходимости, --git-path и --git-ref:","type":"unstyled","key":"8heia"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"$ idf.py add-dependency my_component --git https://github.com//.git --git-path components/my_component --git-ref v1.2.3","type":"unstyled","key":"668sb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"✍️ Способ 2: Ручное создание манифеста (файл idf_component.yml)","type":"header-three","key":"6ia7m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":71,"style":"BOLD"}],"text":"Однако никто не запрещает вам создать или редактировать файл манифеста idf_component.yml вручную. Этот способ дает больше гибкости, так как позволяет подключать не только компоненты из реестра компонентов, но и из локальных папок.","type":"unstyled","key":"er5km"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":15,"style":"BOLD"},{"length":4,"offset":101,"style":"BOLD"}],"text":"Файл манифеста idf_component.yml должен находиться в корне вашего компонента (по умолчанию — в папке main вашего проекта). Вы можете создать этот файл в любом текстовом редакторе (plain text UTF-8) или просто выполните команду:","type":"unstyled","key":"3s13v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"idf.py create-manifest","type":"unstyled","key":"9lc4o"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":26,"style":"BOLD"}],"text":"Примеры содержимого файла idf_component.yml:","type":"unstyled","key":"i29d"},{"data":{"image":{"id":"6a93dded392ba733ee976753"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"3sidc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"hud1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":57,"offset":53,"style":"ITALIC"},{"length":18,"offset":92,"style":"BOLD"}],"text":"Иногда стандартное поведение менеджера компонентов — копировать локальный компонент в папку managed_components — не удобно. Например когда вы ведете разработку собственно самого компонента в другой папке. В этом случае код компонента должен оставаться в исходной локальной папке, без копирования в папку проекта.","type":"unstyled","key":"6tu48"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для решения этой задачи в ESP-IDF существует несколько официальных способов, которые позволяют использовать компонент при сборке прямо из его исходной директории без копирования.","type":"unstyled","key":"1h0qc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":41,"offset":58,"style":"ITALIC"},{"length":82,"offset":179,"style":"ITALIC"},{"length":17,"offset":149,"style":"BOLD"}],"text":"Этот метод специально создан для описанного выше случая — разработки уже опубликованного компонента “на месте”. Он описан в официальной документации idf_component.yml как способ “временно переопределить компонент, который существует в реестре, локальной версией“.","type":"unstyled","key":"5vni6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":8,"style":"BOLD"},{"length":13,"offset":102,"style":"BOLD"}],"text":"В файле idf_component.yml вы указываете зависимость от компонента из реестра, а затем добавляете поле override_path, которое указывает на локальную папку с вашим разрабатываемым компонентом:","type":"unstyled","key":"9gfs7"},{"data":{"image":{"id":"6a93de2eb550ae50d7f838d1"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"ade1o"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Подключение библиотек “по ссылке”","type":"header-three","key":"ash96"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":57,"offset":53,"style":"ITALIC"},{"length":18,"offset":92,"style":"BOLD"}],"text":"Иногда стандартное поведение менеджера компонентов — копировать локальный компонент в папку managed_components — не удобно. Например когда вы ведете разработку собственно самого компонента в другой папке. В этом случае код компонента должен оставаться в исходной локальной папке, без копирования в папку проекта.","type":"unstyled","key":"5hf0f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для решения этой задачи в ESP-IDF существует несколько официальных способов, которые позволяют использовать компонент при сборке прямо из его исходной директории без копирования.","type":"unstyled","key":"3okt4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Способ 1: Использование override_path","type":"header-three","key":"4ftg8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":41,"offset":58,"style":"ITALIC"},{"length":82,"offset":179,"style":"ITALIC"},{"length":17,"offset":149,"style":"BOLD"}],"text":"Этот метод специально создан для описанного выше случая — разработки уже опубликованного компонента “на месте”. Он описан в официальной документации idf_component.yml как способ “временно переопределить компонент, который существует в реестре, локальной версией“.","type":"unstyled","key":"e6kb3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":8,"style":"BOLD"},{"length":13,"offset":102,"style":"BOLD"}],"text":"В файле idf_component.yml вы указываете зависимость от компонента из реестра, а затем добавляете поле override_path, которое указывает на локальную папку с вашим разрабатываемым компонентом:","type":"unstyled","key":"6vr37"},{"data":{"image":{"id":"6a93de480dfc373ede7c79af"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"cfrm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Такой подход часто используется в примерах внутри самого компонента, чтобы пример всегда использовал актуальную версию кода по указанному пути, а не из реестра.","type":"unstyled","key":"867q1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Способ 2: Использование локального пути (path)","type":"header-three","key":"3orsl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":4,"offset":226,"style":"BOLD"}],"text":"Этот метод подходит для использования компонентов, которые еще не опубликованы или полностью локальны. Он более простой, но менее гибкий в плане переключения между локальной и опубликованной версией. Вы просто указываете поле path с относительным или абсолютным путем до директории компонента .","type":"unstyled","key":"dv8c"},{"data":{"image":{"id":"6a93de60bd681406bdae126d"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"7ktfv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Способ 3: Через систему сборки CMakeLists.txt","type":"header-three","key":"1koss"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":34,"style":"BOLD"},{"length":14,"offset":145,"style":"BOLD"},{"length":20,"offset":210,"style":"BOLD"}],"text":"Можно вообще не создавать никаких idf_component.yml, а вместо этого воспользоваться стандартным инструментарием системы сборки. В корневом файле CMakeLists.txt вашего проекта для этого предназначена переменная EXTRA_COMPONENT_DIRS. Вы просто перечисляете в ней пути к папкам, где лежат ваши компоненты.","type":"unstyled","key":"fhgf4"},{"data":{"image":{"id":"6a93de77bf162671f3203ffc"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"7f6sn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Этот способ лучше всего подходит, когда вы разрабатываете компонент самостоятельно и хотите, чтобы он использовался при сборке непосредственно из его текущей папки, без копирования.","type":"unstyled","key":"7iff1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Схема версионирования компонентов","type":"header-three","key":"bup7l"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":25,"offset":55,"style":"ITALIC"}],"text":"Вы, наверное, заметили, что при подключении библиотеки можно (но не обязательно) указывать версию библиотеки или диапазон версий. Указание версии компонента позволяет устранить (либо существенно снизить) риск того, что Ваш проект может внезапно перестать собираться, когда в новой версии какого-либо компонента произошли несовместимые изменения.","type":"unstyled","key":"6p0tp"},{"data":{},"depth":0,"entityRanges":[{"key":14,"length":84,"offset":194}],"inlineStyleRanges":[],"text":"Все компоненты должны обязательно следовать строгой схеме управления версиями, похожей на Semantic Versioning. Поэтому, если вы создаете свой компонент, то также должны следовать этим правилам. Подробное описание системы версионирования ESP-IDF в оригинале вы можете найти здесь.","type":"unstyled","key":"b1pbo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Полный номер версии выглядит так:","type":"unstyled","key":"4ld2q"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":43,"offset":0,"style":"BOLD"}],"text":"major.minor.patch~revision-prerelease+build","type":"unstyled","key":"667qu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"где поля означают следующее:","type":"unstyled","key":"ives"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"},{"length":8,"offset":7,"style":"BOLD"}],"text":"major (Основная): Увеличивается при несовместимых изменениях в API. Переход на новую мажорную версию может потребовать изменений в вашем коде.","type":"unordered-list-item","key":"3rvsf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"},{"length":8,"offset":7,"style":"BOLD"}],"text":"minor (Минорная): Увеличивается при добавлении нового функционала, который обратно совместим с прежними версиями.","type":"unordered-list-item","key":"5n8kh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":5,"offset":0,"style":"BOLD"},{"length":4,"offset":7,"style":"BOLD"}],"text":"patch (Патч): Увеличивается, когда в данной версии выходят только исправления ошибок, без изменения API.","type":"unordered-list-item","key":"56k0f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":9,"offset":0,"style":"BOLD"},{"length":7,"offset":11,"style":"BOLD"}],"text":"~revision (Ревизия): Это опциональное поле. Оно используется, когда компонент зависит от другого пакета, и в нём есть изменения, не затрагивающие основной код. Например, в версии 0.1.2~3 ревизия равна 3.","type":"unordered-list-item","key":"d6ulk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":0,"style":"BOLD"},{"length":9,"offset":13,"style":"BOLD"}],"text":"-prerelease (Пре-релиз): Опциональное поле для обозначения нестабильных версий (alpha, beta, rc). Версия с этим суффиксом считается ниже, чем версия без него. Пример: 1.0.0-beta1.","type":"unordered-list-item","key":"5lg48"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":6,"offset":0,"style":"BOLD"},{"length":6,"offset":8,"style":"BOLD"}],"text":"+build (Сборка): Ещё одно опциональное поле для метаданных сборки. Оно игнорируется при определении старшинства версии.","type":"unordered-list-item","key":"did3l"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Приоритет версий определяется сравнением полей слева направо. Например, 1.0.0 всегда новее, чем 0.9.0.","type":"unstyled","key":"2mgs3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Как задать версию компонента","type":"header-three","key":"c7qr9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":18,"style":"BOLD"},{"length":2,"offset":180,"style":"BOLD"},{"length":1,"offset":184,"style":"BOLD"},{"length":2,"offset":187,"style":"BOLD"},{"length":1,"offset":191,"style":"BOLD"},{"length":2,"offset":194,"style":"BOLD"},{"length":12,"offset":198,"style":"BOLD"}],"text":"В файле манифеста idf_component.yml вы можете указать не только конкретную версию компонента, но и гибкий диапазон версий. Это делается с помощью специальных операторов сравнения: >=, >, ==, <, <=, !=, ~=, ~, ^.","type":"unstyled","key":"5l052"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":74,"style":"STRIKE"},{"length":25,"offset":99,"style":"BOLD"},{"length":2,"offset":178,"style":"BOLD"},{"length":2,"offset":274,"style":"BOLD"}],"text":"Как задать конкретную версию компонента – Вы наверное уже поняли – просто добавьте воды укажите её espressif/button: ==4.1.3. Чисто технически, можно опустить оператор сравнения == (согласно правилам синтаксиса, если оператор не указан, он по умолчанию интерпретируется как ==), но делать так не рекомендуется.","type":"unordered-list-item","key":"ds1ie"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":62,"style":"BOLD"}],"text":"Можно указать несколько условий, перечислив их через запятую: >=1.0.0,<2.0.0 – это означает, что означает “любая версия с мажорной единицей”.","type":"unordered-list-item","key":"7dbdg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":1,"offset":57,"style":"BOLD"},{"length":5,"offset":97,"style":"BOLD"},{"length":5,"offset":104,"style":"BOLD"},{"length":5,"offset":114,"style":"BOLD"},{"length":5,"offset":131,"style":"BOLD"},{"length":14,"offset":227,"style":"BOLD"},{"length":14,"offset":74,"style":"ITALIC"}],"text":"В сравнении версий можно использовать символ подстановки * – он означает “любое значение” в поле major, minor или patch. Например, ==1.* означает “любая версия с мажорной единицей”, что эквивалентно приведенному выше выражению >=1.0.0,<2.0.0.","type":"unordered-list-item","key":"54qdp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":2,"offset":18,"style":"BOLD"},{"length":7,"offset":108,"style":"BOLD"},{"length":15,"offset":139,"style":"BOLD"}],"text":"Совместимый релиз ~= – это выражение разрешает обновления компонентов в пределах указанной минорной версии, ~=1.2.3 эквивалентно выражению >=1.2.3, <2.0.0.","type":"unordered-list-item","key":"dieea"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":1,"offset":27,"style":"BOLD"},{"length":6,"offset":70,"style":"BOLD"},{"length":15,"offset":100,"style":"BOLD"}],"text":"Совместимый минорный релиз ~ – позволяет обновления на уровне патчей, ~1.2.3 эквивалентно выражению >=1.2.3,==1.2.*.","type":"unordered-list-item","key":"amao5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":1,"offset":27,"style":"BOLD"},{"length":6,"offset":133,"style":"BOLD"},{"length":14,"offset":185,"style":"BOLD"},{"length":6,"offset":204,"style":"BOLD"},{"length":14,"offset":248,"style":"BOLD"},{"length":34,"offset":87,"style":"ITALIC"},{"length":32,"offset":150,"style":"ITALIC"},{"length":31,"offset":214,"style":"ITALIC"}],"text":"Совместимый мажорный релиз ^– самый популярный подход. Позволяет обновления в пределах крайнего левого ненулевого разряда. Выражение ^1.2.3 означает “любая версия с мажорной единицей” (>=1.2.3,<2.0.0), а ^0.2.3 — “любая версия с минорной двойкой” (>=0.2.3,<0.3.0).","type":"unordered-list-item","key":"46s9g"},{"data":{},"depth":0,"entityRanges":[{"key":15,"length":84,"offset":0}],"inlineStyleRanges":[],"text":"Подробное описание системы версионирования ESP-IDF в оригинале вы можете найти здесь.","type":"unstyled","key":"5m5u6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Реестр компонентов","type":"header-two","key":"859qi"},{"data":{},"depth":0,"entityRanges":[{"key":16,"length":22,"offset":441}],"inlineStyleRanges":[{"length":12,"offset":9,"style":"STRIKE"},{"length":26,"offset":412,"style":"BOLD"},{"length":22,"offset":441,"style":"BOLD"}],"text":"Когда то давным-давно одним из наиболее существенных недостатков разработки на ESP-IDF считалось отсутствие сторонних библиотек для различных сенсоров, экранов и других устройств. Что, безусловно, создавало определенные трудности в освоении этого фреймворка и отталкивало многих программистов. Однако в настоящее время ситуация радикально изменилась. C выходом ESP-IDF 5.0 стал активно развиваться и пополняться реестр компонентов ESP-IDF – ESP Component Registry, который представляет собой централизованное хранилище компонентов (библиотек) для ESP-IDF и решает проблему “велосипедостроения”.","type":"unstyled","key":"4pfp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Что такое реестр компонентов ESP и когда он появился?","type":"header-three","key":"fqc03"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":221,"style":"BOLD"}],"text":"Это официальный каталог библиотек для фреймворка ESP-IDF, где можно найти и скачать и (или опубликовать ваши собственные) готовые компоненты и примеры для ESP-IDF. Процесс его активного наполнения начался с выхода версии ESP-IDF v5.0 (самый конец 2022 года). В этом релизе компания Espressif приняла стратегическое решение: некоторый компоненты, которые раньше были частью ядра фреймворка, были из него удалены и перенесены в этот реестр. Это было сделано для того, чтобы основная часть ESP-IDF стала более легкой, а все вспомогательные библиотеки были опциональными и легко подключаемыми через менеджер пакетов. Например на тот момент были “вынесены” в реестр LibSodium, mDNS, FreeModbus и некоторые другие. На этом этот процесс не закончился, в последних версиях ESP-IDF из ядра исключен ESP-MQTT и некоторые другие библиотеки.","type":"unstyled","key":"2hpa3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":19,"offset":41,"style":"BOLD"}],"text":"Однако не стоит ошибочно полагать, что в реестре компонентов содержаться только исключенные из ядра компоненты. Судя по всему, в Espressif очень серьезно озаботились проблемой отсутствия прикладных библиотек и активно работают над наполнением реестра дополнительными компонентами. На момент написания статьи в реестре уже находится около 1000 библиотек для самых разных программистских нужд. Большинство из них “официальные” компоненты, то есть созданы самой Espressif, но есть и достаточно большое количество компонентов сторонних разработчиков, например LVGL, Waveshare. Вы также можете при желании опубликовать в реестре и ваши собственные компоненты.","type":"unstyled","key":"agcfu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Небольшой кусочек реестра компонентов","type":"header-three","key":"ei7bs"},{"data":{},"depth":0,"entityRanges":[{"key":17,"length":18,"offset":0}],"inlineStyleRanges":[{"length":9,"offset":111,"style":"ITALIC"},{"length":125,"offset":369,"style":"ITALIC"},{"length":125,"offset":369,"style":"BOLD"}],"text":"Реестр компонентов даже на текущий момент довольно большой, а будет еще больше. В таблице ниже вы можете найти некоторые компоненты, представленные в реестре на текущий момент. Разумеется, в этой таблице присутствует очень малая часть списка – я физически не смогу дублировать весь реестр сюда. Тогда зачем все это? Цель данного списка – только продемонстрировать, что сейчас в реестре компонентов почти наверняка можно найти готовый компонент для вашей задачи или драйвер для вашего устройства. Например драйверов LCD дисплеев в реестре компонентов аж на 10 страниц поисковой выдачи. Я также поместил некоторые компоненты, которые лично мне интересны.","type":"unstyled","key":"bhdmq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Большая часть представленных ниже компонентов разработана в Espressif. На мой взгляд, это очень даже неплохо – так как гарантирует, что при создании компонента применялся унифицированный подход (обратите внимание на драйверы LCD – почти все они созданы на базе другого компонента) и максимально использовались аппаратные возможности микроконтроллера (вместо программной эмуляции). А не “кто во что горазд”, как это часто бывает с библиотеками Arduino. Но и библиотеки сторонних производителей также присутствуют в данной таблице.","type":"unstyled","key":"3uhkl"},{"data":{"image":{"id":"6a93deac8cc7991f42deeeeb"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"an6hd"},{"data":{"image":{"id":"6a93deb8506b0a2bee14a075"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"6plr7"},{"data":{"image":{"id":"6a93dec7b7488948dcb48dfd"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"9li2g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Локальное зеркало реестра компонентов","type":"header-three","key":"34rg5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":29,"offset":289,"style":"BOLD"}],"text":"Реестр компонентов – это, конечно же, очень хорошо и удобно. Но менеджер компонентов каждый раз лезет в интернет, и каждый раз скачивает исходники с GitHub-а. Для автономных систем без доступа к сети интернет это неприемлемо. Для подобных случаев разработчики предусмотрели режим создания частичного локального зеркала.","type":"unstyled","key":"8jl7b"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Основная идея заключается в том, чтобы один раз скачать необходимые компоненты из официального реестра в специальную папку на вашем компьютере или внутреннем сервере, а затем перенастроить инструмент управления компонентами так, чтобы он обращался к этой локальной копии в первую очередь.","type":"unstyled","key":"bkqc9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Это достигается в два этапа:","type":"unstyled","key":"dvqoq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":16,"offset":0,"style":"BOLD"},{"length":7,"offset":49,"style":"BOLD"}],"text":"Создание зеркала. Для этого используется утилита compote. Она может синхронизировать как отдельные компоненты, так и все зависимости, необходимые для конкретного проекта. Например, команда linux для синхронизации всех компонентов, нужных вашему проекту, выглядит так:\ncompote registry sync --project-dir /path/to/your/project /path/to/your/local/mirrorилиcompote registry sync --project-dir D:/my_project C:/my_components_mirror/storageМожно также синхронизировать только последние версии или компоненты в определенном диапазоне версий, чтобы сэкономить место на диске.","type":"ordered-list-item","key":"66e5b"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":56,"offset":0,"style":"BOLD"},{"length":25,"offset":148,"style":"BOLD"},{"length":10,"offset":210,"style":"BOLD"},{"length":17,"offset":293,"style":"BOLD"},{"length":26,"offset":546,"style":"BOLD"}],"text":"Настройка менеджера компонентов на использование зеркала. Чтобы система знала о вашем локальном зеркале, его нужно указать в конфигурационном файле idf_component_manager.yml. Этот файл обычно находится в папке .espressif в вашей домашней директории. В нем нужно добавить или изменить параметр local_storage_url:profiles:default:local_storage_url:- file:///path/to/your/local/mirror # Путь к вашему зеркалуСистема будет проверять компоненты в локальном зеркале в первую очередь, и только если их там нет, обратится к официальному онлайн-реестру.\nВажное правило для Windows: используйте префикс file:// и прямые слэши / (не обратные \\)profiles:default:local_storage_url:- file://C:/my_components_mirror/storage/","type":"ordered-list-item","key":"9to6c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Альтернатива: используйте компоненты из локальных папок","type":"header-three","key":"rgv5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":241,"style":"BOLD"}],"text":"Если вам не нужно создавать полное зеркало реестра, а требуется просто подключить свою собственную библиотеку, которая лежит на диске, это делается еще проще. Вы можете просто разместить предварительно скаченный компонент из реестра в папке components вашего проекта, и сборщик ESP-IDF автоматически его подхватит без обращения к официальному реестру.","type":"unstyled","key":"au2u2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":37,"style":"BOLD"}],"text":"Либо, как вариант, в файле манифеста idf_component.yml можно указать путь к локальному компоненту, если он хранится отдельно от проекта.","type":"unstyled","key":"8inob"},{"data":{"image":{"id":"6a93df0d65ee500e433f26c4"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"cl2n6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Ссылки","type":"header-two","key":"dhcng"},{"data":{},"depth":0,"entityRanges":[{"key":18,"length":22,"offset":0}],"inlineStyleRanges":[{"length":22,"offset":0,"style":"BOLD"}],"text":"ESP Component Registry","type":"unordered-list-item","key":"43o2r"},{"data":{},"depth":0,"entityRanges":[{"key":19,"length":30,"offset":0}],"inlineStyleRanges":[{"length":30,"offset":0,"style":"BOLD"}],"text":"IDF Component Registry – guide","type":"unordered-list-item","key":"f1aa"},{"data":{},"depth":0,"entityRanges":[{"key":20,"length":29,"offset":0}],"inlineStyleRanges":[{"length":29,"offset":0,"style":"BOLD"}],"text":"IDF Component Manager – guide","type":"unordered-list-item","key":"1gelo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"6s1up"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"7q4ba"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"y0WZZz1kM5bz4crnMHD7"}],"entityMap":{"11":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#esp-idf-dependency","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#esp-idf-dependency"},"mutability":"MUTABLE","type":"LINK"},"12":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html"},"mutability":"MUTABLE","type":"LINK"},"13":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#component-dependencies","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#component-dependencies"},"mutability":"MUTABLE","type":"LINK"},"14":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/versioning.html","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/versioning.html"},"mutability":"MUTABLE","type":"LINK"},"15":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/versioning.html","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/versioning.html"},"mutability":"MUTABLE","type":"LINK"},"16":{"data":{"href":"https://components.espressif.com/","url":"https://components.espressif.com/"},"mutability":"MUTABLE","type":"LINK"},"17":{"data":{"href":"https://components.espressif.com/","url":"https://components.espressif.com/"},"mutability":"MUTABLE","type":"LINK"},"18":{"data":{"href":"https://components.espressif.com/","url":"https://components.espressif.com/"},"mutability":"MUTABLE","type":"LINK"},"19":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/"},"mutability":"MUTABLE","type":"LINK"},"0":{"data":{"url":"https://kotyara12.ru/iot/components-esp-idf/"},"mutability":"MUTABLE","type":"LINK"},"1":{"data":{"href":"https://kotyara12.ru/iot/esp-idf-builder/","url":"https://kotyara12.ru/iot/esp-idf-builder/"},"mutability":"MUTABLE","type":"LINK"},"2":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/use/how_to_offline_usage.html#how-to-use-component-manager-offline","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/use/how_to_offline_usage.html#how-to-use-component-manager-offline"},"mutability":"MUTABLE","type":"LINK"},"3":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/","url":"https://docs.espressif.com/projects/idf-component-manager/"},"mutability":"MUTABLE","type":"LINK"},"4":{"data":{"href":"https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/tools/idf-component-manager.html","url":"https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/tools/idf-component-manager.html"},"mutability":"MUTABLE","type":"LINK"},"5":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#id14","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#id14"},"mutability":"MUTABLE","type":"LINK"},"6":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#id13","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#id13"},"mutability":"MUTABLE","type":"LINK"},"7":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#id14","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#id14"},"mutability":"MUTABLE","type":"LINK"},"8":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#local-directory-dependencies","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#local-directory-dependencies"},"mutability":"MUTABLE","type":"LINK"},"9":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#git-dependencies","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#git-dependencies"},"mutability":"MUTABLE","type":"LINK"},"20":{"data":{"href":"https://docs.espressif.com/projects/esp-idf/en/v6.0.2/esp32c2/api-guides/tools/idf-component-manager.html","url":"https://docs.espressif.com/projects/esp-idf/en/v6.0.2/esp32c2/api-guides/tools/idf-component-manager.html"},"mutability":"MUTABLE","type":"LINK"},"10":{"data":{"href":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#esp-component-registry-dependencies","url":"https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#esp-component-registry-dependencies"},"mutability":"MUTABLE","type":"LINK"}}},"mentions":[]}