BLE под микроскопом (ATTы GATTы...)

    image

    BLE под микроскопом (ATTы GATTы...)

    Часть 1, обзорная

    Уже прошло довольно большое время, с тех пор, когда вышла первая спецификация на Bluetooth 4.0. И, хотя тема BLE очень интересна, она до сих пор отталкивает многих разработчиков, из-за своей сложности. В своих предыдущих статьях я рассматривал в основном самый нижний уровень Link Layer и Physical Layer. Это позволяло не обращаться к таким сложным и запутанным понятиям как протокол атрибутов(ATT) и общий профиль атрибутов (GATT). Однако деваться некуда, не понимая их, невозможно разрабатывать совместимые устройства. Сегодня я хотел бы поделиться с вами этими знаниями. В своей статье я буду опираться на учебник для начинающих с сайта Nordic-а. Итак, давайте приступим.

    Почему всё так сложно?


    На мой взгляд, сразу было понятно, что управление устройствами через смартфоны — тема очень перспективная и долгоиграющая. Поэтому её решили структурировать сразу и по-максимуму. Что бы производители различных гаджетов не придумывали свои протоколы, которые потом будут не совместимы. Отсюда и сложность. Уже на первом этапе в протокол BLE попытались втиснуть всё что только было возможно. И не важно пригодится это в последствии или нет. Кроме того, предусмотрели возможность расширения списка устройств на будущее.

    Давайте взглянем на картинку, где нарисована схема протокола BLE. Он состоит из нескольких слоев. Самый нижний, физический слой (PHY) отвечает за радиоканал устройства. Link Layer(LL) содержит всю последовательность байтов в передаваемом сообщении. В прошлых статьях мы изучали именно его. Host Controller Interface (HCI) — это протокол обмена между слоями или микросхемами BLE, если Controller и Host реализованы на разных чипах. За формирование пакетов, деление на кадры, контролем ошибок и сборку пакетов отвечает Logical Link Control and Adaptation Protocol (L2CAP). За шифрование пакетов отвечает Security Manager Protocol (SMP). Профиль общего доступа (GAP) отвечает за первоначальный обмен данными между устройствами, для определения «Who is who». К нему так же относятся scanning и advertising. В этой статье я остановлюсь на двух оставшихся частях протокола — GATT и ATT. GATT является надстройкой над ATT, поэтому они сильно переплетены.

    image

    Для упрощения повествования, я бы хотел обратиться к аналогии. Я её где то слышал и хотел бы поддержать. Представьте себе BLE устройство в качестве книжного шкафа с несколькими полками. Каждая полка — это отдельная тематика. К примеру, у нас есть полки с фантастикой, математикой, энциклопедиями. На каждой полке стоят книги с указанной темой. А в некоторых книгах есть даже бумажные закладки с записями. Кроме того, у нас есть небольшой бумажный каталог всех книг. Если помните школьные библиотеки — это узкий ящик с бумажными карточками. При такой аналогии шкаф — это профиль нашего устройства. Полки — это сервисы, книги — характеристики, а каталог — это таблица атрибутов. Закладки в книгах — это дескрипторы, о которых я так же расскажу позже, более подробно.

    Все, кто разрабатывал устройства, знает, что во многих проектах есть похожие куски кода. Дело в том, что многие устройства имеют сходный функционал. К примеру, если устройства работают от аккумуляторов, то проблема зарядки и контроля их уровня, будет одинаковой. То же касается и датчиков. Собственно, объектно-ориентированный подход в программировании «предоставляет возможность создавать объекты, которые соединяют свойства и поведения в самостоятельный союз, который затем можно многоразово использовать». На мой взгляд, в BLE была предпринята попытка похожего подхода. Группой Bluetooth Special Interest Group (SIG) были разработаны профили. Устройства от разных производителей, имеющие одинаковые профили, должны без труда работать друг с другом. Профили в свою очередь состоят из сервисов, а сервисы из характеристик, дополняемых дескрипторами. В общем случае это может выглядеть так:

    image

    Для примера, рассмотрим схему профиля heart rate monitor (фитнес браслет). Он состоит из двух сервисов и нескольких характеристик. Из неё сразу становится понятна иерархия профиля. Характеристика контрольной точки сбрасывает общий подсчет расходов калорий в ноль.

    1. Сервис сердечного ритма включает три характеристики (0x180D):
        a) Обязательная характеристика частоты сердечных сокращений (0х2A37)
        б) Опционная характеристика положения датчика тела (0x2A38)
        в) Условная характеристика контрольной точки сердечного ритма (0x2A39)
    2. Сервис обслуживания батареи (0x180F):
        a) Обязательная характеристика уровня заряда батареи (0x2A19)

    UUID


    Для того, чтобы мы могли однозначно обращаться к элементам профиля (сервисам, характеристикам и дескрипторам) нужно все их как то пронумеровать. Для этой цели вводят такое понятие как Universally Unique ID (UUID) или Универсальный уникальный идентификатор. В скобках каждой строки как раз и указан UUID. И здесь есть одна особенность. Для UUID решили использовать код длиной 16 и 128 бит. Зачем, спросите вы? В протоколе BLE всё подчинено сохранению энергии. Поэтому размерность в 16 бит вполне разумна. Вряд ли в ближайшем будущем будет создано больше 65тыс. уникальных сервисов и характеристик. На данный момент всё что могли, уже посчитали (помните откуда это — «он и вас посчитал» :-)) Пронумерованные элементы профилей, сервисов, характеристик и дескрипторов вы можете посмотреть по ссылкам.

    Однако, я думаю, все помнят историю с 4-мя байтами IPv4 адреса в интернете. Сначала думали что хватит, а теперь всё никак не перейдем на IPv6 адресацию. Что бы не повторять этой ошибки и дать простор шаловливым ручкам самодельщиков, SIG сразу решила ввести ещё и 128-ми битные UUID. Это лично мне напоминает нелицензионный диапазон 433МГц, который был дан на откуп всевозможным Кулибиным от радиоканала. В нашем случае, на откуп был отдан 128-ми битный идентификатор сервисов и характеристик. Это означает что мы, для своих сервисов и устройств, можем использовать практически любое 128 битное значение. Всё равно вероятность придумать одинаковый UUID стремится к нулю.

    На самом деле, короткие 16-ти битные UUID имеют своё расширение до 128-ми битного значения. В спецификации это расширение называется Bluetooth Base UUID и имеет значение 00000000-0000-1000-8000-00805F9B34FB. Если, к примеру, 16-ти битный UUID аттрибута имеет значение 0x1234, то эквивалентный ему 128-ми битный UUID будет иметь значение 00001234-0000-1000-8000-00805F9B34FB. И даже приводится соответствующая формула:

                                    128_bit_value = 16_bit_value * 2^96 + Bluetooth_Base_UUID

    Откуда взялось это магическое число, мне не известно. Если кто нибудь из читателей знает — пусть напишет в комментариях (Пользователь с ником Sinopteek уже сделал это. Смотрите комментарии). Что касается придумывания 128-ти битных UUID, то в принципе можно воспользоваться специальным генератором, который сделает это за вас.

    ATTы GATTы...


    Собственно дальше начинается самое интересное. Я напомню, что ATT основан на клиентском-серверном отношении. Сейчас мы рассматриваем устройство сервера. Он содержит такую информацию, как значения датчиков, состояние выключателя света, данные о местоположении и т.д. Теперь, когда все «участники нашего парада» пронумерованы, надо как то их размещать в памяти устройства. Для этого мы помещаем их в таблицу, которая называется таблицей атрибутов. Запомните это хорошенько. Это самое сердце BLE. Именно его мы и будем рассматривать в дальнейшем. Теперь каждую строчку мы будем называть аттрибутом. Эта таблица находится в глубине стека и, как правило, мы не имеем к ней прямого доступа. Мы её инициализируем и к ней обращаемся, но что там происходит внутри, от нас скрыто за семью печатями.

    Рассмотрим картинку из спецификации, однако перед этим, хочу сразу обратить внимание на частую путаницу в терминах, а именно в дескрипторах. Роль дескриптора — дополнить описание характеристики. Когда надо расширить её возможности, тогда и применяют дескрипторы. Они так же являются аттрибутами, и так же, наравне с сервисами и характеристиками, располагаются в таблице аттрибутов. Мы подробно разберем их во второй части статьи. Однако иногда дескрипторами называют номер строки в таблице аттрибутов. Это надо иметь ввиду. Мы же, что бы не путаться, будем для этих целей использовать термин «указатель атрибута».
    image

    Итак атрибут — это дискретное значение, которое имеет следующие свойства, связанные с ним:
    1. Указатель атрибута (Attribute Handle) — это индекс таблицы, соответствующий атрибуту
    2. Тип атрибута (Attribute Type) — это UUID, который описывает его тип
    3. Значение аттрибута (Attribute Value) — это данные, индексируемые указателем атрибута
    4. Разрешения атрибутов (Attribute Permissions) — это часть атрибута, разрешения, которые не     могут быть прочитаны или записаны с использованием протокола атрибутов

    Как всё это понимать? Указатель аттрибута — это, условно говоря, его номер в нашей таблице.
    Он позволяет клиенту ссылаться на атрибут в запросах чтения или записи. Мы можем нумеровать наши строчки (аттрибуты) от 0x0001 до 0xFFFF. В нашей ассоциации с книжным шкафом — это номер карточки в бумажном каталоге. Аналогично, как в каталоге библиотеки, карточки располагаются в порядке увеличения номера. Номер каждой последующей строчки должен быть больше предыдущей. Как и в библиотеке, иногда теряются некоторые карточки, так и у нас — в нумерации строк могут быть промежутки. Это допускается. Главное, что бы они шли по нарастающей.

    Тип атрибута определяет что представляет собой данный атрибут. По аналогии с языком Си,
    где есть булевые, числовые переменные и строки, так и здесь. По типу аттрибута мы узнаем
    с чем мы имеем дело и как нам дальше с этим аттрибутом работать. Ниже мы рассмотрим некоторые специфичные типы аттрибутов. Например «сервисная декларация» (0х2800), «декларация характеристики» (0х2803), «декларация дескриптора» (0x2902).

    Значение аттрибута — это собственно его значение, простите за тавтологию. Если тип аттрибута это строка, то значением аттрибута может быть например слоган «Hello World !!!». Если тип аттрибута это «сервисная декларация», то значением его является сам сервис. А иногда это информация о том, где найти другие атрибуты и их свойства.

    Разрешения атрибутов позволяют серверу понять разрешен ли доступ на чтение или запись.
    Обратите внимание, что эти разрешения применяются только к значению атрибута, а не к указателю, типу и самому полю разрешений. Т.е. если разрешена запись аттрибута, то мы можем поменять к примеру, строчку «Hello World !!!» на строчку «Good morning». Но не можем запретить запись новой строки или, поменять тип аттрибута и обозначить строку как «сервисная декларация». При обращении клиента к серверу, клиент запрашивает его аттрибуты. Это позволяет клиенту узнать что может предоставить сервер. Хотя не обязательно читать и записывать значения.

    Как это выглядит


    Концепция GATT заключается в том, чтобы сгруппировать атрибуты в таблице атрибутов вместе в очень специфическом и логическом порядке. Давайте более внимательно рассмотрим профиль частоты сердечных сокращений, приведенный ниже. Самый левый столбик этой таблицы не обязательный. Он просто описывает нам чем является эта строчка (аттрибут). Все остальные столбцы нам уже знакомы.

    image

    В верхней части каждой группы мы всегда имеем атрибут объявления сервиса. Его тип всегда равен 0x2800, а указатель зависит от того, сколько атрибутов уже присутствует в таблице. Его разрешения всегда доступны только для чтения, без какой-либо проверки подлинности или авторизации. Об этих понятиях мы поговорим чуть позже. Значение — это еще один UUID, определяющий, что это за служба. В Таблице значение равно 0x180D, что определяется Bluetooth SIG как сервис частоты сердечных сокращений.

    Вслед за объявлением сервиса, следует объявление характеристики. По форме оно аналогично объявлению сервиса. Его UUID всегда имеет значение 0x2803, а разрешения так же всегда доступны только для чтения без какой-либо проверки подлинности или авторизации. Давайте посмотрим на поле Attribute Value, которое включает некоторые данные. Оно всегда содержит указатель, UUID и набор свойств. Эти три элемента описывают последующее объявление значения характеристики. Указатель естественным образом обозначает место объявления значения характеристики в таблице атрибутов. UUID описывает, какой тип информации или значения мы можем ожидать. Например, значение температуры, состояние выключателя света или какое-либо другое произвольное значение. И наконец свойства, которые описывают, как можно взаимодействовать с характеристическим значением.

    Тут нас поджидает ещё один подводный камень. Он связан с разрешениями аттрибутов и свойствами характеристик. Давайте мы посмотрим на картинку свойств битового поля из спецификации.

    image

    Как видите, здесь так же присутствуют поля, дающие возможности чтения и записи. Вы можете задаться вопросом, почему у нас есть разрешения на чтение/запись для атрибута и свойства
    чтения/записи для значения характеристики? Разве они не должны быть всегда одинаковыми? Дело в том, что свойства для значения характеристики, фактически являются только рекомендациями для клиента, используемыми в ГАТТ и прикладных слоях. Это просто подсказки о том, что клиент может ожидать от атрибута объявления характеристики. Давайте с этим разберемся поподробнее. Какие виды разрешений существуют у аттрибута?

    1. Разрешения доступа:
         — чтение
         — запись
         — чтение и запись
    2. Разрешение аутентификации:
         — аутентификация требуется
         — аутентификация не требуется
    3. Разрешение авторизации:
         — авторизация требуется
         — авторизация не требуется

    Главное отличие разрешения аттрибутов от свойств характеристик состоит в том, что первые относятся к серверам, а вторые к клиентам. У сервера может быть разрешено чтение значения характеристики, но при этом стоять требование аутентификации или авторизации. Поэтому при запросе клиентом свойств характеристики, мы получим, что чтение разрешено. Но при попытке чтения получим ошибку. Поэтому можно смело говорить о приоритете разрешений над свойствами. Знание о том, какие разрешения есть у аттрибута, мы, со стороны клиента, получить не можем.

    Дескриптор


    Вернемся к нашей таблице. После объявления значения характеристики, возможны следующие объявления аттрибутов:
    1. Новое объявление характеристики (в сервисе может быть много характеристик)
    2. Новая декларация сервиса (в таблице может быть их много)
    3. Объявление дескриптора

    В случае характеристики измерения частоты сердечных сокращений, в нашей таблице, объявление значения характеристики сопровождается объявлением дескриптора. Дескриптор — это атрибут с дополнительной информацией о характеристике. Существует несколько видов дескрипторов. О них мы подробно поговорим во второй части этой статьи. Сейчас же мы коснемся только дескриптора конфигурации характеристик клиента (Client Characteristic Configuration Descriptor — CCCD). Он имеет UUID равную 0х2902. При помощи этого дескриптора клиент имеет возможность включить на сервере индикацию или нотификацию. Разница между ними небольшая, но всё таки есть. Нотификация не требует подтверждения в получении со стороны клиента. Индикация же этого требует, хотя она и происходит на уровне GATT, не доходя до уровня приложения. Зачем так, спросите вы? Увы, это мне не ведомо. Скажу лишь, что специалисты Nordic-а рекомендуют использовать нотификацию. Тем более, что проверка целостности пакета (при помощи CRC) происходит в обоих случаях.

    Заключение


    В конце статьи я хотел бы сказать вот о чем. Последняя таблица несколько запутанна. Однако я остановился на ней из-за того, что она приводится в статье, на которую я опираюсь. Во второй части своей статьи я намерен углубиться в спецификацию BlueTooth 4.0. Там нас ждут более корректные схемы и рисунки. В третьей части, я хотел бы разобрать лог, полученный при помощи программы Wireshark от одного из гаджетов и увидеть «в живую» всю ту теорию, которую мы с вами изучаем.

    Сотрудник Группы Компаний «Цезарь Сателлит»
    Печерских Владимир

    Похожие публикации

    AdBlock похитил этот баннер, но баннеры не зубы — отрастут

    Подробнее
    Реклама

    Комментарии 19

      0
      Благодарю за очередную полезную статью! Ждём продолжения.
        0
        Планирую сначала сделать практическую, третью часть, ну а потом уже написать вторую, с погружением в спецификацию. Что бы во второй части не пропустить описание тех фреймов, что будут в третьей. Запутанно получилось, ну да ладно.
        0
        Про BLE есть хорошая бесплатная книга от Мохаммада Афане (https://www.novelbits.io/introduction-to-bluetooth-low-energy-book/)
          0
          Знаете, Solfar, а мне книга Мохаммада Афане понравилась. Спасибо за ссылку. С удовольствием полистал. На большую глубину она правда не претендует, да и к тому же на английском языке. Зато в популярной форме старается донести сложные понятия. Спасибо
            0

            Он действительно не углублялся, но я, как embedded-разработчик нашёл ее очень полезной. Настолько, что перевёл ее зимой полностью на русский. Лежит, ждёт, когда ещё раз вычитаю и отшлифую перевод)

        0
        Спасибо за отличный материал! Можете уточнить, HID — профили устройства, как-то задействованы? Они чем-то отличаются от GATT?
          0
          Честно говоря, я с HID BLE устройствами не работал. Знаю только что у NORDIC-а в примерах есть пара проектов HID устройств. Клавиатура и мышка. К тому же посмотрел в списке характеристик www.bluetooth.com/specifications/gatt/characteristics на сайте. Там есть две характеристики: HID Control Point (0x2A4C) и HID Information (0x2A4A). Так что для работы с HID устройствами, скорее всего, применяют ту же модель, что я изложил в статье. Либо используют сервисы с данным и характеристиками, либо на их основе создают свои собственные сервисы.
          0
          Есть стандарт HID over GATT. HID устройство представляется как набор атрибутов. Но я с этим профилем не работал.
          +1
          Спасибо что постарались раскрыть тему BLE на хабре. Мне сложно оценивать понятность статьи для начинающих, потому что я имею некоторый опыт работы с BLE и знаю что там внутри. Но хотелось бы продолжить вашу аналогию с книжной полкой. Для вышестоящего уровня приложений нужны полки (сервисы) с книгами (характеристиками). Но на нижестоящем уровне на самом деле нет ни полок ни обложек. Есть только атрибуты (листы) у каждого из которых есть handle и прочее содержимое. Одна характеристика (книга) может состоять из нескольких атрибутов (листов), уложенных подряд. А книжная полка (сервис) может состоять из нескольких характеристик (книг) уложенных подряд. А вот листов в книге может быть несколько. Некоторые обязательные, например chacteristic declaration, своего рода «обложка» и основное содержимое characteristic value, и опциональные такие как characteristic user description (своего рода комментарии автора), client characteristic properties, и прочее.
            0
            Стараюсь понемногу. В русском сегменте интернета очень мало статей по BLE. Если бы специалисты не ленились и больше делились своими знаниями, то выиграли бы все. Спасибо за комментарий
              0
              Судя по описанию такая штука с описанием аттрибутов, типов и имен, появляется рано или поздно в любой системе описания данных. Ближайшая аналогия которую могу вспомнить — Active Directory.
              И правда, хорошо что обо всем сразу подумали, чтобы не костыляли криворукие.
              0
              Формат UUID используемый в Bluetooth описывается в ISO/IEC 11578. Сам UUID состоит из 2 основных частей: времени и уникального идентификатора (MAC). Если не погружаться глубоко, то см. ru.wikipedia.org/wiki/UUID
              Пропустив 00000000-0000-1000-8000-00805F9B34FB через сервис www.famkruithof.net/uuid/uuidgen?typeReq=1 мы получаем первый день Григорианского календаря — Friday, October 15, 1582 at 12:00:00 AM
              А последняя часть — MAC-адрес ПК на котором был сгенерирован базовый UUID. Это был HP (на момент регистрации Compaq) https://macaddress.webwat.ch/hwaddr/00:80:5F#simname.
                0
                Спасибо. Очень рад, что получил ответ на давно мучавший меня вопрос. В статье я добавил одну строчку с указанием Вашего ника. Пусть народ просвещается.
                0
                Спасибо за интересную статью.
                А нет ли у Вас ошибки в таблице атрибутов (раздел «Как это выглядит»)? Вы ниже пишете, что дескриптор конфигурации характеристик клиента (Client Characteristic Configuration Descriptor — CCCD) имеет UUID равную 0х2902, а в таблице для него стоит UUID «Standard UUIDservice» равный 0x2800.
                0

                Во-первых, спасибо за полезную и нужную информацию. Во-вторых по содержанию — немного не понял: доступ устанавливается через разрешения, но тут же вы пишете "При помощи этого дескриптора клиент имеет возможность включить на сервере индикацию или нотификацию." Так при чем здесь дескриптор если нотификация устанавливается через разрешения?

                Только полноправные пользователи могут оставлять комментарии. Войдите, пожалуйста.

                Самое читаемое