Утилита uuidgen [1] и её онлайн-версия [2] позволяют генерировать уникальные идентификаторы вида:

$ uuidgen
25fced92-e106-4959-a5d7-623fb1dcaa5c

Такие же идентификаторы можно генерировать с помощью официального ESP-IDF компонента k0i05/esp_uuid [3].

Добавить компонент esp_uuid в проект ESP-IDF можно двумя основными способами: через Менеджер компонентов (проще) или вручную. Оба пути надежны и используют официальную инструкцию Espressif, но первый вариант современнее и предпочтительнее.

Ниже в таблице сравниваются эти подходы:

[Установка через IDF Component Manager]

IDF Component Manager [4] это встроенный в ESP-IDF инструмент, который автоматически загружает компонент и все его зависимости в папку managed_components вашего проекта. Для этого:

1. Откройте терминал в корневой директории вашего проекта.

2. Выполните команду для добавления зависимости в главный (main) компонент:

idf.py add-dependency k0i05/esp_uuid

Замечание: в ответе системы командной строки может потребоваться запуск команды idf.py reconfigure.

3. Если ваш проект использует несколько компонентов и вы хотите добавить зависимость в конкретный из них (например, my_component в папке components/):

idf.py add-dependency --component=my_component k0i05/esp_uuid

После этого Mенеджер добавит запись в файл idf_component.yml компонента и при следующей сборке проекта автоматически скачает esp_uuid и поместит его в managed_components. Этот метод обеспечивает автоматическое управление версиями компонента.

[Установка вручную (добавление в папку components)]

Это классический метод, работающий без менеджера зависимостей. Он лучше всего подходит, если у вас уже есть локальные файлы компонента или вы хотите его модифицировать.

1. Скачайте компонент: gолучите исходный код esp_uuid с официальной страницы в реестре компонентов Espressif [3] или из репозитория GitHub автора.

2. Создайте папку для компонента: в корне вашего проекта ESP-IDF должна быть папка components (если её нет, то создайте). Поместите в неё папку с исходным кодом библиотеки, например, components/esp_uuid. Структура проекта должна получиться такой:

    ваше_приложение/
    ├── CMakeLists.txt
    ├── sdkconfig
    └── components/
        └── esp_uuid/    ← ваш компонент
            ├── CMakeLists.txt
            ├── include/
            └── src/

3. После этого система сборки ESP-IDF автоматически обнаружит и включит компонент при следующей сборке проекта.

[Использование компонента в коде]

Независимо от способа установки, чтобы начать генерировать UUID в вашем приложении, подключите заголовочный файл в uuid.h модуле, где планируете использовать функции компонента (например в модуле main.c):

#include < uuid.h>

Используйте API:

// Инициализация генератора:
uuid_init();
// Генерация UUID в виде строки (например, "f3b9e8d2-351a-4a4f-9c8a-7f1e5d2c6b8a"):
const char* my_uuid = uuid_generate();

ESP_LOGI("TAG", "UUID: %s", my_uuid);

Компонент поддерживает разные режимы генерации (например, UUID версии 4 или полностью случайный), управляемые через uuid_set_mode().

[Советы и устранение неполадок]

 ● Не изменяйте файлы внутри managed_components — эта папка генерируется автоматически. Если нужно внести изменения, скопируйте компонент в components и работайте с копией.

● Если компонент не находится:

- Убедитесь, что структура папок правильная.
- Попробуйте выполнить idf.py fullclean, а затем idf.py reconfigure, чтобы система сборки пересканировала компоненты.

● Принудительное отключение Менеджера (если он мешает): установите переменную окружения IDF_COMPONENT_MANAGER=0 перед запуском сборки.

[Ссылки]

1. uuidgen(1) site:man7.org.
2. Freshly generated UUIDs site:uuidgen.org. 
3. k0i05/esp_uuid site:espressif.com.
4. ESP-IDF Component Manager.