Exponenta Banner
exponenta event banner

wlanMPDUDecode

Декодируйте MPDU

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

Синтаксис

[cfgMAC,payload,status] = wlanMPDUDecode(mpdu,cfgPHY)
[cfgMAC,payload,status] = wlanMPDUDecode(___,'DataFormat',format)

Описание

пример

[cfgMAC,payload,status] = wlanMPDUDecode(mpdu,cfgPHY) возвращает модули эксплуатационных данных MAC (MSDUs), payload, путем декодирования входа MAC protocol data unit (MPDU), mpdu, для данного физического уровня (PHY) объект cfgPHY настройки формата. Функция также возвращает status, который указывает на результат декодирования MPDU, и cfgMAC, объект настройки wlanMACFrameConfig.

пример

[cfgMAC,payload,status] = wlanMPDUDecode(___,'DataFormat',format) задает формат данных входа MPDU, который будет декодироваться.

Примеры

свернуть все

Скрипт Open Live Script

Создайте объект настройки кадра ВЛАНА МАКА для кадра данных QoS, и затем сгенерируйте данные QoS MPDU в форме октета.

txCfgMAC = wlanMACFrameConfig('FrameType','QoS Data');
mpduOctets = wlanMACFrame(randi([0 255],1,40),txCfgMAC);

Преобразуйте MPDU в битную форму.

mpdu = reshape(de2bi(hex2dec(mpduOctets), 8)',[],1);

Создайте не высокий формат пропускной способности (non-HT-format) объект настройки с настройками по умолчанию.

cfgPHY = wlanNonHTConfig;

Возвратите MSDUs путем декодирования MPDU для заданной настройки формата PHY.

[rxCfgMAC,payload,status] = wlanMPDUDecode(mpdu,cfgPHY);
Скрипт Open Live Script

Создайте объект настройки кадра ВЛАНА МАКА для кадра данных QoS, затем сгенерируйте данные QoS MPDU в форме октета.

txCfgMAC =  wlanMACFrameConfig('FrameType','QoS Data');
mpdu = wlanMACFrame(randi([0 255],1,40),txCfgMAC);

Создайте non-HT-format объект настройки с настройками по умолчанию.

cfgPHY = wlanNonHTConfig;

Возвратите MSDUs путем декодирования MPDU для заданной настройки формата PHY.

[rxCfgMAC,payload,status] = wlanMPDUDecode(mpdu,cfgPHY,'DataFormat','octets');
Скрипт Open Live Script

Deaggregate VHT-формат A-MPDU и декодируют извлеченный MPDUs.

Создайте объект настройки кадра ВЛАНА МАКА для VHT-формата A-MPDU.

txCfgMAC = wlanMACFrameConfig('FrameType','QoS Data','FrameFormat','VHT');

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

cfgPHY = wlanVHTConfig;

Сгенерируйте случайную полезную нагрузку восьми MSDUs.

txPayload =  repmat({randi([0 255],1,40)},1,8);

Сгенерируйте A-MPDU, содержащий восемь MPDUs для заданного MAC и настроек PHY.

ampdu = wlanMACFrame(txPayload,txCfgMAC,cfgPHY);

Возвратите список MPDUs deaggregating A-MPDU. Отобразите состояние deaggregation и CRC разделителя.

[mpduList, delimiterCRCFail, status] = ... 
    wlanAMPDUDeaggregate(ampdu,cfgPHY,'DataFormat','octets');
disp(status)
    Success

disp(delimiterCRCFail)
   0   0   0   0   0   0   0   0

Декодируйте весь MPDUs в извлеченном списке.

if strcmp(status,'Success')
    for i = 1:numel(mpduList)
        if ~delimiterCRCFail(i)
            [cfgMAC, payload, decodeStatus] = ...
                wlanMPDUDecode(mpduList{i},cfgPHY,'DataFormat','octets');
        end
    end
end

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

свернуть все

MPDU, который будет декодироваться, заданный как одно из этих значений:

  • бинарный вектор, представляющий MPDU в битной форме;

  • числовые октеты представления вектора в десятичном формате, где каждый элемент является целым числом в интервале [0, 255];

  • скаляр строки представление MPDU как октеты в шестнадцатеричном формате;

  • вектор символов, представляющий MPDU как октеты в шестнадцатеричном формате;

  • символьный массив, где каждая строка представляет октет в шестнадцатеричном формате.

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

Настройка формата PHY, заданная как объект типа wlanHESUConfig, wlanVHTConfig, wlanHTConfig, wlanNonHTConfig. Этот объект задает настройку формата PHY и ее применимые свойства.

Формат входа MPDU, заданного как 'bits' или 'octets'.

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

Выходные аргументы

свернуть все

Настройка кадра MAC, возвращенная как объект wlanMACFrameConfig.

Один или несколько MSDUs, возвращенные как массив ячеек символьных массивов. Функция возвращает символьный массив для каждого MSDU. В этих символьных массивах каждая строка является шестнадцатеричным представлением октета. Для каждого кадра MAC, который не содержит данных, функция возвращает payload как массив пустой ячейки.

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

Состояние декодирования MPDU, возвращенного как неположительное целое число в интервале [–20, 0]. Каждое значение status соответствует члену класса перечисления wlanMACDecodeStatus, который указывает на состояние декодирования кадра MAC согласно этой таблице.

Перечислимая величинаЧлен класса перечисленияДекодирование состояния
0SuccessКадр MAC успешно декодируется
–1FCSFailedПоследовательность проверки кадра (FCS) перестала работать
–2InvalidProtocolVersionНедопустимая версия протокола
–3UnsupportedFrameTypeНеподдерживаемый тип кадра
–4UnsupportedFrameSubtypeНеподдерживаемый подтип кадра
–5NotEnoughDataНедостаточные данные, чтобы декодировать кадр
–6UnsupportedBAVariantНеподдерживаемый вариант Блока кадр Ack
–7UnknownBitmapSizeНеизвестный растровый размер
–8UnknownAddressExtModeНеизвестный режим расширения адреса
–9MalformedAMSDULengthУродливый агрегированный модуль эксплуатационных данных MAC (A-MSDU) с недопустимой длиной
–10MalformedSSIDУродливый сервис установил идентификатор (SSID) информационный элемент (IE)
–11MalformedSupportedRatesIEУродливый поддерживаемый IE уровней
–12MalformedIELengthУродливое поле длины IE
–13MissingMandatoryIEsОбязательные пропавшие без вести IES
–14NoMPDUFoundНикакой MPDU не найден в A-MPDU
–15CorruptedAMPDUВсе разделители в данном А-МПДУ привели контроль циклическим избыточным кодом (CRC) к сбою
–16InvalidDelimiterLengthНедопустимое поле длины в разделителе MPDU
–17MaxAMSDULenthExceededA-MSDU превысил максимальный предел длины
–18MaxMPDULengthExceededMPDU превысил максимальный предел длины
–19MaxMMPDULengthExceededКадр управления MAC превысил максимальный предел длины
–20MaxMSDULengthExceededMSDU превысил максимальный предел длины

Перечислимая величина кроме 0 означает это MPDU декодирование не пройдено. Если декодирование перестало работать, вывод cfgMAC не отображает свойств, и вывод payload возвращен как массив пустой ячейки.

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

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

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

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

Функции

Объекты

Введенный в R2019a

Документация WLAN Toolbox
Поддержка