write

Запишите пакетные данные о протоколе BLE LL в PCAP или файл PCAPNG

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

    Синтаксис

    write(pcapObj,packet,timestamp)
    write(pcapObj,packet,timestamp,Name,Value)

    Описание

    write(pcapObj,packet,timestamp) записи Bluetooth® низкая энергия (BLE) соединяют слой (слой ссылки) пакетные данные о протоколе к PCAP или файлу PCAPNG, заданному в объекте средства записи файла BLE PCAP, pcapObj. Введите packet задает пакет протокола BLE LL и вход timestamp задает пакетное время поступления.

    пример

    write(pcapObj,packet,timestamp,Name,Value) задает опции с помощью одного или нескольких аргументов пары "имя-значение". Например, 'PacketFormat','bits' устанавливает формат пакетов протокола BLE LL вдребезги.

    Примеры

    свернуть все

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

    Скрипт Open Live Script

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

    pcapObj = blePCAPWriter;

    Сгенерируйте пакет BLE LL.

    cfgLLData = bleLLDataChannelPDUConfig('LLID', ...
    'Data (start fragment/complete)');
payload = '0E00050014010A001F004000170017000000';
llDataPDU = bleLLDataChannelPDU(cfgLLData, payload);
connAccessAddress = de2bi(hex2dec('E213BC42'), 32)';
llpacket = [connAccessAddress; llDataPDU];

    Запишите пакет BLE LL в файл PCAP.

    timestamp = 0; % Number of microseconds
write(pcapObj,llpacket,timestamp,'PacketFormat','bits');

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

    Скрипт Open Live Script

    Создайте объект средства записи файла BLE PCAPNG, задав имя и расширение файла PCAPNG.

    pcapObj = blePCAPWriter('FileName','sampleBLELL', ...
    'FileExtension','pcapng');

    Сгенерируйте пакет BLE LL.

    cfgLLData = bleLLDataChannelPDUConfig('LLID', ...
    'Data (start fragment/complete)');
payload = '0E00050014010A001F004000170017000000';
llDataPDU = bleLLDataChannelPDU(cfgLLData,payload);
connAccessAddress = de2bi(hex2dec('E213BC42'),32)';
llpacket = [connAccessAddress; llDataPDU];

    Запишите пакет BLE LL в файл PCAPNG.

    timestamp = 12800000; % Number of microseconds
write(pcapObj,llpacket,timestamp,'PacketFormat','bits');

    Входные параметры

    свернуть все

    Примечание

    blePCAPWriter объект не перезаписывает существующий PCAP или файл PCAPNG. Во время каждого вызова этого объекта задайте уникальный PCAP или имя файла PCAPNG.

    Средство записи файла BLE PCAP возражает в виде blePCAPWriter объект.

    Пакет протокола BLE LL в виде одного из этих значений.

    • Вектор с бинарным знаком – Это значение представляет биты.

    • Вектор символов – Это значение представляет октеты в шестнадцатеричном формате.

    • Строковый скаляр – Это значение представляет октеты в шестнадцатеричном формате.

    • Числовой вектор с каждым элементом в области значений [0, 255] – Это значение представляет октеты в десятичном формате.

    • n-by-2 символьный массив – В этом значении, каждая строка представляет октет в шестнадцатеричном формате.

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

    Пакетное время поступления с 1/1/1970 в виде неотрицательного целого числа. Это значение должно быть описано в микросекундах.

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

    Аргументы в виде пар имя-значение

    Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

    Пример: 'PacketFormat','bits' устанавливает формат пакетов протокола BLE LL вдребезги.

    Пакетные метаданные протокола BLE LL в виде разделенной запятой пары, состоящей из PhyHeader и одно из этих значений.

    • Вектор с бинарным знаком – Это значение представляет биты.

    • Вектор символов – Это значение представляет октеты в шестнадцатеричном формате.

    • Строковый скаляр – Это значение представляет октеты в шестнадцатеричном формате.

    • Числовой вектор с каждым элементом в области значений [0, 255] – Это значение представляет октеты в десятичном формате.

    • n-by-2 символьный массив – В этом значении, каждая строка представляет октет в шестнадцатеричном формате.

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

    Прокомментируйте для пакета протокола BLE LL в виде разделенной запятой пары, состоящей из PacketComment и вектор символов или строковый скаляр.

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

    Формат пакета протокола BLE LL в виде разделенной запятой пары, состоящей из PacketFormat и 'octets' или 'bits'. Если это значение задано как 'octets', packet задан как одно из этих значений.

    • Вектор с бинарным знаком – Это значение представляет биты.

    • Вектор символов – Это значение представляет октеты в шестнадцатеричном формате.

    • Строковый скаляр – Это значение представляет октеты в шестнадцатеричном формате.

    • Числовой вектор с каждым элементом в области значений [0, 255] – Это значение представляет октеты в десятичном формате.

    • n-by-2 символьный массив – В этом значении, каждая строка представляет октет в шестнадцатеричном формате.

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

    Формат физического уровня (PHY) заголовок в виде разделенной запятой пары, состоящей из PhyHeaderFormat и 'octets' или 'bits'. Если это значение задано как 'octets', PhyHeader может быть задан как одно из этих значений.

    • Вектор с бинарным знаком – Это значение представляет биты.

    • Вектор символов – Это значение представляет октеты в шестнадцатеричном формате.

    • Строковый скаляр – Это значение представляет октеты в шестнадцатеричном формате.

    • Числовой вектор с каждым элементом в области значений [0, 255] – Это значение представляет октеты в десятичном формате.

    • n-by-2 символьный массив – В этом значении, каждая строка представляет октет в шестнадцатеричном формате

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

    Ссылки

    [1] Tuexen, M. “Следующее поколение PCAP (Pcapng) Формат файла Получения”. 2020. https://www.ietf.org/.

    [2] Группа, Tcpdump. “Репозиторий Общественности Tcpdump/Libpcap”. Полученный доступ 20 мая 2020. https://www.tcpdump.org.

    [3] “Development/LibpcapFileFormat - Wiki Wireshark”. Полученный доступ 20 мая 2020. https://www.wireshark.org/.

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

    Генерация кода C/C++
    Генерация кода C и C++ с помощью MATLAB® Coder™.

    Смотрите также

    Объекты

    Введенный в R2020b

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

    Поддержка

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