Exponenta Banner
exponenta event banner

blePCAPWriter

Запись файлов PCAP или PCAPNG пакетов LL BLE

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

    Для использования blePCAPWriter сначала загрузите библиотеку Communications Toolbox™ Library для протокола Bluetooth ®. Дополнительные сведения см. в разделе Получение надстроек и управление ими. Кроме того, см. библиотеку Communications Toolbox Library для обмена файлами по протоколу Bluetooth.

    Описание

    blePCAPWriter запись сгенерированных и восстановленных пакетов уровня линии связи (LL) Bluetooth с низкой энергией (BLE) в файл захвата пакетов (PCAP) или захвата пакетов следующего поколения (PCAPNG) (.pcap или .pcapngсоответственно).

    Создание

    Синтаксис

    obj = blePCAPWriter
    obj = blePCAPWriter (имя, значение)

    Описание

    obj = blePCAPWriter создает объект записи файлов BLE PCAP или PCAPNG по умолчанию, который записывает пакеты BLE LL в файл PCAP или PCAPNG соответственно.

    пример

    obj = blePCAPWriter(Name,Value) Задает свойства, используя одну или несколько пар имя-значение. Заключите каждое имя свойства в кавычки. Например, ('FileExtension','pcapng') устанавливает расширение файла как .pcapng.

    Свойства

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

    Примечание

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

    Имя файла PCAP или PCAPNG, указанного как вектор символьной строки или скаляр строки.

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

    Порядок байтов, указанный как 'little-endian' или 'big-endian'.

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

    Тип файла, указанный как 'pcap' или 'pcapng'.

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

    Комментарий для файла PCAPNG, указанный как символьный вектор или строковый скаляр.

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

    Имя интерфейса, на котором захватываются пакеты BLE, указанное как символьный вектор или строковый скаляр.

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

    Флаг для указания наличия заголовка физического уровня (PHY), указанного как logical 1 (true) или 0 (false).

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

    Объект записи файлов PCAP или PCAPNG, указанный как pcapWriter или pcapngWriter объект.

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

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

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

    Примеры

    свернуть все

    В этом примере используются:

    Открыть сценарий в реальном времени

    Создайте объект записи файлов PCAP BLE, указав имя файла PCAP.

    pcapObj = blePCAPWriter('FileName','writeblepacket');

    Создайте пакет LL BLE.

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

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

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

    В этом примере используются:

    Открыть сценарий в реальном времени

    Создайте объект модуля записи файлов PCAPNG BLE, указав имя и расширение файла 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];

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

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

    В этом примере используются:

    Открыть сценарий в реальном времени

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

    pcapObj = pcapngWriter('FileName','sampleBLELL',  ...
    'FileComment','This is a sample file');

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

    blePCAP = blePCAPWriter('PCAPWriter',pcapObj,'PhyHeaderPresent',true);

    Создайте пакет LL BLE.

    cfgLLAdv = bleLLAdvertisingChannelPDUConfig;
cfgLLAdv.PDUType = 'Advertising indication';
cfgLLAdv.AdvertisingData = '020106';
llDataPDU = bleLLAdvertisingChannelPDU(cfgLLAdv);
connAccessAddress = de2bi(hex2dec('E213BC42'),32)';
llpacket = [connAccessAddress;llDataPDU];

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

    PhyHeaderBytes = [39 10 8 1 10 10 10 10 15 00];
timestamp = 18912345; % Number of microseconds
write(blePCAP,llpacket,timestamp,'PacketFormat','bits', ...
    'PhyHeader',PhyHeaderBytes,'PacketComment','This is the first packet');

    Ссылки

    [1] Tuexen, М. «Формат файла захвата PCAP следующего поколения (Pcapng)». 2020. https://www.ietf.org/.

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

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

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

    Создание кода C/C + +
    Создайте код C и C++ с помощью MATLAB ® Coder™

    .

    См. также

    Объекты

    Представлен в R2020b

    Документация по инструментам связи

    Поддержка