bleChannelSelection

Индекс канала BLE для соединения, периодической рекламы и изохронных событий

развернуть все на странице

Требуется загрузка: Чтобы использовать bleChannelSelection, сначала загрузите библиотеку Communications Toolbox™ для Bluetooth® Протокол. Для получения дополнительной информации см. раздел «Получение и управление дополнениями». Другой способ см. в разделе Библиотека Communications Toolbox для обмена файлами протокола Bluetooth.

Описание

The bleChannelSelection Системная object™ выбирает индекс канала с низкой энергией (BLE) Bluetooth на основе алгоритма, заданного свойством Algorithm.

Чтобы выбрать индекс канала BLE:

  1. Создайте bleChannelSelection Объекту и установите его свойства.

  2. Вызывайте объект с аргументами, как будто это функция.

Дополнительные сведения о работе системных объектов см. в разделе «Что такое системные объекты?».

Создание

Синтаксис

csa = bleChannelSelection
csa = bleChannelSelection(Name,Value)

Описание

пример

csa = bleChannelSelection создает выбранный по умолчанию Системный объект канала BLE.

csa = bleChannelSelection(Name,Value)устанавливает свойства с помощью одной или нескольких пар "имя-значение". Заключайте каждое имя свойства в кавычки. Для примера, bleChannelSelection('Algorithm',2) задает индекс канала BLE на основе алгоритма 2.

Свойства

расширить все

Примечание

Для получения дополнительной информации о свойствах выбора канала BLE смотрите том 6, часть B, раздел 4,5,8 Спецификации ядра Bluetooth [2].

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

Если свойство настраивается, можно изменить его значение в любой момент.

Для получения дополнительной информации об изменении значений свойств смотрите Разработку системы в MATLAB Использование Системных объектов.

Тип алгоритма выбора канала BLE, заданный как 1 или 2 представляющий Алгоритм 1 или Алгоритм 2, соответственно. Алгоритм 1 выбирает индекс канала для событий соединения. Алгоритм 2 выбирает индекс канала для событий соединения, периодических рекламных событий и LE изохронных событий.

Типы данных: double

Счетчик шага, заданный как целое число в области значений [5, 16]. Это свойство задает счетчик шага скачка между каналами данных. Если вы задаете свойство Algorithm равным 1Системный объект использует это свойство как входной параметр.

Типы данных: double

Уникальный адрес соединения, заданный как восьмиэлементный вектор символов или строковый скаляр, обозначающий шестнадцатеричное значение с четырьмя октетами. Это значение задает уникальный 32-битный адрес для ссылки слоя соединения между двумя устройствами. Если вы задаете свойство Algorithm равным 2Системный объект использует это свойство как входной параметр.

Типы данных: char | string

Список используемых (хороших) каналов данных, заданный как вектор из целых чисел в области значений [0, 36]. Длина вектора должна быть больше 1. По крайней мере, два канала должны быть установлены как используемые (хорошие) каналы. Это свойство задает набор хороших каналов, классифицированных ведущим.

Типы данных: double

Флаг для включения или отключения выбора изохронного канала событий, заданный как 0 (false) или 1 (true). Значение 1 (true) значение выбирает канал для изохронных событий с помощью Алгоритма 2.

Типы данных: logical

Счетчик изохронных событий, заданный как целое число в области значений [0, 65535]. Это свойство задает счетчик для каждого изохронного события.

Зависимости

Чтобы включить это свойство, задайте значение свойства SubeventChannelSelection 1 (true).

Типы данных: double

Subevent counter, заданный как целое число в области значений [1, 31]. Это свойство задает счетчик для каждого подэвента.

Зависимости

Чтобы включить это свойство, задайте значение свойства SubeventChannelSelection 1 (true).

Типы данных: double

Это свойство доступно только для чтения.

Индекс канала для текущего события, заданный как 0. Это свойство задает индекс канала для события соединения, периодического рекламного события и изохронного события.

Типы данных: double

Это свойство доступно только для чтения.

Счетчик текущего события, заданный как 0. Это свойство задает счетчик событий для события подключения и периодического рекламного события.

Типы данных: double

Использование

Синтаксис

channelIndex = csa

Описание

пример

channelIndex = csa выбирает индекс канала на основе применимых свойств. Во время каждого вызова этой функции обновляйте значения свойств IsochronousEventCounter и SubeventNumber. Во время каждого вызова этой функции системный объект должен обновить SubeventNumber свойство последовательно.

Функции объекта

Чтобы использовать функцию объекта, задайте системный объект в качестве первого входного параметра. Например, чтобы освободить системные ресурсы системного объекта с именем obj, используйте следующий синтаксис:

release(obj)

расширить все

cloneСоздайте повторяющийся системный объект
isLockedОпределите, используется ли системный объект
stepЗапуск алгоритма системного объекта
releaseОтпустите ресурсы и допустите изменения в значениях свойств системного объекта и входных характеристиках
resetСброс внутренних состояний Системного объекта

Примеры

свернуть все

Этот пример использует:

Открыть Live Script

Создайте Системный объект выбора канала BLE, чтобы выбрать индекс канала BLE на основе алгоритма выбора канала 1.

csa = bleChannelSelection
csa = 
  bleChannelSelection with properties:

       Algorithm: 1
    HopIncrement: 5
    UsedChannels: [1x37 double]
    ChannelIndex: 0
    EventCounter: 0

Установите счетчик шага 7. Затем задайте набор используемых (хороших) каналов, классифицированных Мастером, и отобразите свойства объекта.

csa.HopIncrement = 7;
csa.UsedChannels = [0 2 24 6 10 14 26 30 34 36]
csa = 
  bleChannelSelection with properties:

       Algorithm: 1
    HopIncrement: 7
    UsedChannels: [0 2 6 10 14 24 26 30 34 36]
    ChannelIndex: 0
    EventCounter: 0

Выберите индекс канала BLE из соответствующего системного объекта с помощью Алгоритма 1 (алгоритма по умолчанию).

channelIndex = csa()
channelIndex = 30

Создайте другой Системный объект выбора канала BLE, чтобы выбрать индекс канала BLE, на этот раз путем определения типа выбора канала Алгоритм 2.

csa2 = bleChannelSelection('Algorithm',2);

Установите уникальный адрес подключения. Затем задайте набор используемых (хороших) каналов, классифицированных Мастером, и отобразите свойства объекта.

csa2.AccessAddress = '8E89BED6';
csa2.UsedChannels = [9 10 21 22 23 33 34 35 36]
csa2 = 
  bleChannelSelection with properties:

                   Algorithm: 2
               AccessAddress: '8E89BED6'
    SubeventChannelSelection: 0
                UsedChannels: [9 10 21 22 23 33 34 35 36]
                ChannelIndex: 0
                EventCounter: 0

Выберите индекс канала BLE из соответствующего системного объекта с помощью Алгоритма 2.

channelIndex2 = csa2()
channelIndex2 = 35

Этот пример использует:

Открыть Live Script

Создайте Системный объект выбора канала BLE со значениями по умолчанию. 

csa = bleChannelSelection
csa = 
  bleChannelSelection with properties:

       Algorithm: 1
    HopIncrement: 5
    UsedChannels: [1x37 double]
    ChannelIndex: 0
    EventCounter: 0

Установите алгоритм выбора канала BLE равным 2. Этот алгоритм поддерживает выбор канала для событий соединения, периодических рекламных событий и LE изохронных событий. Включите выбор субевентного канала.

csa.Algorithm = 2;
csa.SubeventChannelSelection = true;

Укажите уникальный адрес подключения и набор используемых (хороших) каналов, классифицированных мастером.

csa.AccessAddress = '8E89BED6';
csa.UsedChannels  = [9 10 21 22 23 33 34 35 36];

В первом изохронном событии выберите индекс канала для первого подменю.

csa.IsochronousEventCounter = 0;
csa.SubeventNumber = 1;
channelIndex = csa()
channelIndex = 35

В первом изохронном событии выберите индекс канала для второго подэвента.

csa.SubeventNumber = 2;
channelIndex = csa()
channelIndex = 10

Ссылки

[1] Веб-сайт Bluetooth Technology. Bluetooth Technology Website | Официальный сайт Bluetooth Technology. Доступ к 22 ноября 2019 года. https://www.bluetooth.com/.

[2] Группа специальных интересов Bluetooth (SIG). Bluetooth Core Спецификации. Версия 5.2. https://www.bluetooth.com/.

Расширенные возможности

.

См. также

Функции

Объекты

Темы

Введенный в R2019b

Документация Communications Toolbox

Поддержка

Для просмотра документации необходимо авторизоваться на сайте