Создание устройства Matter

1. Введение

Matter – это протокол подключения, который открывает новые возможности для разработки умных устройств. В этой практической работе вы создадите свое первое устройство Matter. Чтобы узнать больше о Matter, посетите Центр разработчиков Google Home или сайт Connectivity Standards Alliance.

Что вы узнаете

  • Как интегрировать физическое устройство с Matter.
  • Как вводить в эксплуатацию устройства Matter и управлять ими с помощью Google Home.

Что вам понадобится

2. Как настроить среду

Как идентифицировать устройство с последовательным интерфейсом

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

  1. Подключите плату к компьютеру с помощью USB-кабеля.
  2. Найдите устройство в файловой системе /dev. Чтобы сузить область поиска, укажите префикс устройства. Espressif ESP32 использует /dev/ttyUSBx:
    user@host $ ls /dev/ttyUSB*
    /dev/ttyUSB0
    

Настройте контроллер

Настройте хаб, используя тот же аккаунт Google, который вы планируете использовать для этой практической работы.

Как настроить среду разработки

Требования

Эти инструкции были протестированы на Debian Linux и должны работать в большинстве дистрибутивов Linux на базе Debian, включая Ubuntu. Если вы работаете с другим дистрибутивом Linux, процедура настройки зависимостей может отличаться от описанной ниже.

Установка зависимостей

Выполните следующую команду, чтобы установить необходимые двоичные файлы пакета Linux, которые могут быть ещё не установлены:

$ sudo apt-get install git gcc g++ pkg-config libssl-dev libdbus-1-dev \
libglib2.0-dev libavahi-client-dev ninja-build python3-venv python3-dev \
python3-pip unzip libgirepository1.0-dev libcairo2-dev libreadline-dev screen

Настройте SDK

Для продолжения практической работы вам понадобится Espressif SDK (Espressif IoT Development Framework или ESP-IDF).

  1. Создайте каталог для ESP-IDF:
    $ mkdir ~/esp-idf_tools
    
  2. Клонируйте ESP-IDF из GitHub в этот каталог:
    $ cd ~/esp-idf_tools
    $ git clone -b v4.4.3 --recursive https://github.com/espressif/esp-idf.git
    
  3. Завершите установку набора инструментов:
    $ cd ./esp-idf
    $ ./install.sh
    $ cd ~/
    

Как настроить Matter SDK

  1. Клонируйте хранилище Matter с открытым исходным кодом:
    $ git clone https://github.com/project-chip/connectedhomeip.git
    $ cd ./connectedhomeip
    $ git fetch origin v1.0-branch
    $ git checkout FETCH_HEAD
    
  2. Получите подмодули хранилища:
    $ ./scripts/checkout_submodules.py --shallow --platform esp32
    
  3. Запустите среду разработки Matter:
    $ source ./scripts/bootstrap.sh
    

3. Google Home Developer Console

Google Home Developer Console – это веб-приложение, в котором вы управляете интеграциями Matter с Google Home.

Любое устройство Matter, прошедшее сертификацию Connectivity Standards Alliance (Alliance), работает в экосистеме Google Home. Устройства, которые находятся в разработке и не сертифицированы, можно вводить в эксплуатацию в экосистеме Google Home при определенных условиях. Подробную информацию можно найти в разделе Ограничения на подключение.

Создайте проект разработчика

Перейдите в Google Home Developer Console:

  1. Нажмите Создать проект.
  2. Введите уникальное название проекта и нажмите Создать проект. Диалоговое окно "Создать проект"
  3. Нажмите + Добавить интеграцию. Откроется экран Ресурсы Matter, где вы можете ознакомиться с документацией для разработчиков Matter и информацией о некоторых инструментах.
  4. Когда вы будете готовы продолжить, нажмите Далее: разработка. Откроется страница Контрольный список Matter.
  5. Нажмите Далее: настройка.
  6. На странице Настройка введите название продукта.
  7. Нажмите Выберите тип устройства и выберите тип устройства в раскрывающемся меню (в данном случае Light).
  8. В поле Vendor ID (VID) (Идентификатор поставщика) выберите Test VID (Тестовый идентификатор поставщика), а затем в раскрывающемся меню Test VID (Тестовый идентификатор поставщика) выберите 0xFFF1. В поле Product ID (PID) (Идентификатор продукта (PID)) введите 0x8000 и нажмите Save & continue (Сохранить и продолжить), а затем на следующей странице нажмите Save (Сохранить). Используйте именно эти значения VID/PID, так как от них зависят дальнейшие шаги практической работы.
    Настройка проекта
  9. Теперь вы увидите интеграцию в разделе Интеграции Matter.
  10. Перезагрузите контроллер, чтобы он получил последнюю конфигурацию проекта интеграции Matter. Если вы измените VID или PID позже, вам также потребуется перезагрузить устройство после сохранения проекта, чтобы изменения вступили в силу. Подробнее о том, как перезапустить устройства Google Nest или Google Wifi…

4. Соберите устройство

Все примеры Matter находятся в папке examples в репозитории GitHub. Доступно несколько примеров, но в этой практической работе мы сосредоточимся на lighting-app.

В этом примере показано простое устройство, которое отображается в Google Home как светильник, реагирующий на команды включения и выключения. Управление настоящим электрическим светом выходит за рамки этой практической работы.

Настройте сборку

  1. Настройте Matter SDK и активируйте среду сборки Matter:
    $ cd ~/esp-idf_tools/esp-idf
    $ source export.sh
    $ cd ~/connectedhomeip
    $ source ./scripts/activate.sh
    
  2. Включите Ccache, чтобы ускорить процесс сборки:
    $ export IDF_CCACHE_ENABLE=1
    
  3. Перейдите в каталог сборки lighting-app ESP32 и задайте целевую архитектуру:
    $ cd ./examples/lighting-app/esp32
    $ idf.py set-target esp32
    
    1. Запустите утилиту настройки:
      $ idf.py menuconfig
      
    2. Выберите Demo -> Device Type и установите для параметра Device Type значение ESP32-DevKitC.
    3. Чтобы вернуться в меню верхнего уровня, нажмите стрелку влево.
    4. Нажмите Component config --->.
    5. Нажмите CHIP Device Layer --->.
    6. Нажмите Device Identification Options --->.
    7. В качестве значения Vendor ID укажите идентификатор VID, назначенный Alliance, или тестовый идентификатор VID.
    8. Установите для Product ID значение PID, которое вы задали для интеграции Matter в Google Home Developer Console.
    9. Нажмите S, чтобы сохранить.
    10. Нажмите Ввод, чтобы принять путь по умолчанию, по которому будет сохранена конфигурация.
    11. Нажмите Return, чтобы закрыть диалоговое окно подтверждения сохранения.
    12. Нажмите Q, чтобы выйти из утилиты настройки.

Запустите сборку

Вызовите скрипт сборки:

idf.py build

Сборка должна завершиться без ошибок.

Программирование устройства

  1. Подключите плату разработчика к компьютеру с помощью USB-кабеля.
  2. Удалите с устройства все предыдущие версии встроенного ПО. Если к компьютеру подключена только одна плата разработчика, параметр -p {device} можно не указывать – устройство будет обнаружено автоматически.
    idf.py -p {device} erase-flash
    
  3. Скопируйте новое приложение на плату разработчика с помощью следующей команды:
    idf.py -p {device} flash
    

Дополнительную информацию о вариантах прошивки можно найти на странице документации Espressif esptool.py.

5. Подключитесь к устройству

  1. Откройте окно терминала.
  2. Запишите, в каком каталоге вы находитесь, а затем подключитесь к новому устройству Matter с помощью GNU screen:
    $ screen -L {device} 115200
    
  3. Если консоль пуста, нажмите кнопку RESET (СБРОСИТЬ), чтобы запустить процесс загрузки устройства.

6. Настройте устройство

Примечание. Этот шаг будет успешным, только если вы уже настроили проект в Google Home Developer Console.

Nest Hub

Чтобы добавить устройство в сеть Matter, нужен контроллер. Это устройство Google Nest, например Nest Hub (второе поколение), которое поддерживает Matter и будет служить как пограничным маршрутизатором для устройств с поддержкой Thread, так и локальным путем выполнения для маршрутизации намерений умного дома.

Ознакомьтесь со списком поддерживаемых контроллеров, чтобы узнать, какие из них поддерживают Matter.

Перед началом процесса ввода в эксплуатацию убедитесь, что:

  • Ваш хаб связан с тем же аккаунтом Google, который вы использовали для входа в Google Home Console.
  • Контроллер подключен к той же сети Wi-Fi, что и компьютер, на котором запущено виртуальное устройство Matter.
  • Ваш контроллер находится в той же структуре, которую вы используете в приложении Google Home. (Значок дома в Google Home Graph представляет вашу структуру).

Подключите устройство

Подключите устройство, следуя инструкциям для ESP32.

Примечание. Если вы используете M5STACK, помните, что после прошивки его экран останется пустым, поэтому вам придется просматривать QR-код, используя URL-адрес, который появляется в консоли. Вы также можете ввести код подключения вручную.

Пример вывода консоли с URL QR-кода:

I (1926) chip[DL]: Done driving station state, nothing else to do...
I (1936) chip[SVR]: SetupQRCode: [MT:X.XXXXXXXXXXXXXXXXX]
I (1936) chip[SVR]: Copy/paste the below URL in a browser to see the QR Code:
I (1946) chip[SVR]: https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3XX.KXXXXXXXXXXXXXXXX
I (1956) chip[SVR]: Manual pairing code: [XXXXXXXXXXX]]

Устранение неполадок

Не удалось выполнить инициализацию

Дополнительные советы по устранению неполадок можно найти на странице устранения неполадок Matter.

7. Управление устройством

После того как устройство с поддержкой Matter будет успешно введено в эксплуатацию и появится в приложении Google Home в виде лампочки, вы можете попробовать управлять им с помощью Google Ассистента, приложения Google Home или симулятора Google Ассистента в расширении Google Home для VS Code.

Google Ассистент

Используйте Google Ассистента на телефоне или хабе, чтобы переключать состояние устройства с помощью голосовых команд, например "Окей, Google, включи свет".

Другие примеры команд вы найдете в разделе Как управлять устройствами умного дома с помощью голосовых команд статьи Как управлять устройствами умного дома, добавленными в приложение Google Home.

Приложение Google Home

Вы можете нажать на ярлыки Вкл. и Выкл. рядом со значком лампочки в приложении Google Home.

Подробнее о том, как управлять устройствами в приложении Google Home…

Симулятор Google Ассистента

В расширении Google Home для VS Code с помощью симулятора Google Ассистента вы можете отправлять команды на устройство, используя интерфейс, похожий на чат.

8. Поздравляем!

Вы успешно создали и ввели в эксплуатацию свое первое устройство Matter. Здорово!

В этой практической работе вы узнали:

  • Установите среду разработки Matter, выполнив все требования.
  • Создайте и запустите устройство Matter.
  • Ввод в эксплуатацию и управление устройством из Google Home.

Чтобы узнать больше о Matter, ознакомьтесь со следующими материалами: