Exponenta Banner
exponenta event banner

blePCAPWriter

PCAP или PCAPNG файл средства записи пакетов BLE LL

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

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

    Описание

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

    Создание

    Синтаксис

    obj = blePCAPWriter
    obj = blePCAPWriter(Name,Value)

    Описание

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

    пример

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

    Свойства

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

    Примечание

    The 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Запись пакетных данных протокола BLE LL в файл PCAP или PCAPNG

    Примеры

    свернуть все

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

    Открыть Live Script

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

    Запишите пакет 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');

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

    Открыть Live Script

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

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

    Создайте объект средства записи файлов BLE PCAP, задающий средство записи файлов 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];

    Запишите пакет BLE LL в файл 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, 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

    Поддержка