write

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

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

    Синтаксис

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

    Описание

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

    пример

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

    Примеры

    свернуть все

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

    Открыть Live Script

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

    pcapObj = blePCAPWriter;

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

    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');

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

    Открыть Live Script

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

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

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

    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');

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

    свернуть все

    Примечание

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

    Объект средства записи файлов BLE PCAP, заданный как blePCAPWriter объект.

    Пакет протокола LL BLE, заданный в качестве одного из следующих значений.

    • Двоичный вектор - Это значение представляет биты.

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

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

    • Числовой вектор с каждым элементом в области значений [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 в битах.

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

    • Двоичный вектор - Это значение представляет биты.

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

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

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

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

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

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

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

    Формат пакета протокола LL BLE, заданный как разделенная разделенными запятой парами, состоящая из 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 Next Generation (Pcapng) Capture File Format». 2020. https://www.ietf.org/.

    [2] Группа, The Tcpdump. «Общий репозиторий Tcpdump/Libpcap». Доступ к 20 мая 2020 года. https://www.tcpdump.org.

    [3] «Development/LibpcapFileFormat - The Wireshark Wiki». Доступ к 20 мая 2020 года. https://www.wireshark.org/.

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

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

    .

    См. также

    Объекты

    Введенный в R2020b

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

    Поддержка

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