Files
templates/tools/dsview/decoders/pwm_waveform

ШИМ → синус / PWM waveform

В SETGUI: DSView → Анализаторы SET → ШИМ → синус · 1–3 канала. В нативном списке DSView: Пользовательские → PWM waveform. Выберите PWM A; PWM B/C необязательны. Каждый вход получает собственную цветную кривую с общей временной шкалой записи и строку заполнения. Для большего числа входов добавьте ещё один экземпляр декодера.

Всё перечисленное ниже — опции этого же анализатора PWM waveform:

  • PWM topology / Схема ШИМ: two-level — один вход на фазу; npc-three-level — классический NPC, четыре затвора S1…S4 сверху вниз. Прежние входы PWM A/B/C соответствуют S1; дополнительные A2/A3/A4, B2/B3/B4, C2/C3/C4 — остальным затворам. Для трёх фаз нужны 12 входов. Каждая подключённая фаза требует все четыре сигнала.
  • Waveform / Форма сигнала: envelope показывает средний уровень, switching — приближённое коммутационное напряжение по состояниям затворов. Для двух уровней шкала −1…+1; для NPC — −1, 0, +1 (соответственно −Udc/2, нейтраль, +Udc/2). Это относительные уровни: напряжение шины, аналоговые выбросы и скорость переключения не измеряются.
  • Theta ABC 0-360 deg / Угол вектора: отдельный график θ по всем трём огибающим. Они интерполируются к общему времени; преобразование Кларка удаляет синфазную составляющую, затем вычисляется atan2(β, α). 0° соответствует положительному направлению оси A. При амплитуде вектора менее 0,02 о.е. угол не определяется; переход 360→0 рисуется разрывом. Это угол восстановленного вектора напряжения, не измерение угла ротора или магнитного потока двигателя.
  • Calculated triangle / Расчётная несущая: отдельная строка одного треугольника −1…+1 либо двух синфазных смещённых треугольников NPC (−1…0 и 0…+1). Период задаётся окном или оценивается по одноимённым фронтам первой подключённой фазы. Начальная фаза условна: внутренний счётчик модулятора и его реальную несущую цифровой захват не измеряет.
  • Phase angles AB BC CA / Углы между фазами: измеренные сдвиги A→B, B→C, C→A в диапазоне −180…+180°. Положительный знак означает запаздывание второй фазы. Используются одноимённые пересечения огибающих и последний полный период каждой фазы; старые данные через два периода без обновления не выводятся. При разгоне это локальная оценка сдвига. Для двух подключённых фаз выводится только доступная пара.

NPC: 1100 → +1, 0110 → 0, 0011 → −1. Остальные состояния, включая все выключенные ключи во время dead-time, имеют неизвестное напряжение и отмечаются отдельной строкой. В коммутационном виде это разрывы. Огибающая оценивается по известной части периода с явной подписью valid; при покрытии менее 95% период пропускается и история поля сбрасывается. Поэтому короткие паузы дают приближённую оценку, а длительные нарушения не маскируются нейтралью. Для устойчивого усреднения, особенно при насыщении, укажите известную Carrier Hz; автоматический режим использует начала ненулевых импульсов одинакового знака и заново синхронизируется при смене полуволны.

Таблица NPC: Output Voltage and Switching States. Преобразование координат: Microchip Clarke Transformation.

В настройках Decoders → PWM waveform → Waveform layout / Вид графиков:

  • split — отдельные области A/B/C с общей временной шкалой (по умолчанию).
  • combined — все видимые кривые в одной области с общей шкалой −1…+1.

Цвета сохраняются в обоих режимах: A — голубой, B — жёлтый, C — зелёный. Неподключённые и скрытые каналы не занимают место в общем графике. Выбранный режим сохраняется вместе с настройками декодера в записи DSL. Высота текстовых аннотаций ограничена высотой шрифта плюс 2 экранных пикселя (по 1 сверху и снизу), включая увеличение высоты дорожки анализатора.

Строка PWM carrier / field каждого канала показывает измеренную среднюю несущую ШИМ и электрическую частоту поля за полный период огибающей, в Гц. Она появляется после двух восходящих пересечений уровня заполнения 50%. Время пересечения интерполируется между точками кривой; гистерезис ±1 процентный пункт заполнения подавляет дрожание около 50%. При разгоне частота обновляется каждый электрический период. Фильтр Low-pass влияет также на измеряемую огибающую. Для постоянного заполнения, неполного периода и огибающей, не пересекающей полосу 49–51%, частота поля не выводится. Это электрическая частота модуляции, а не механическая частота вращения.

Кривая — измеренное заполнение 2 * Ton / T - 1, а не искусственный синус. 50% соответствует нулю, 0% — −1, 100% — +1. Значения между серединами периодов соединены прямыми. Это нормированная модуляция, не измерение напряжения, тока или выхода силового LC-фильтра. Для SVPWM в ней остаётся синфазная составляющая: декодер не вычитает фазы друг из друга.

  • Active level: независимая инверсия каждого входа.
  • Carrier Hz = 0: измерение между активными фронтами, включая изменения частоты. Начальный и конечный неполные периоды пропускаются. При пропавших импульсах период становится длиннее; постоянные 0/1 автоматически не восстанавливаются. Для насыщения используйте заданную несущую.
  • Carrier Hz > 0: интегрирование заполнения в равных временных окнах длиной 1/f, начиная с начала области декодирования. Работает на 0/100%. Окна не синхронизированы с фронтами; при неверной несущей или быстро меняющейся модуляции возможны биения/искажения. В строке заполнения window обозначает частоту окна, а PWM carrier — частоту между фактическими активными фронтами. Пока не получены два фронта или после отсутствия фронтов дольше двух последних измеренных периодов несущая помечается unavailable. Неполное последнее окно пропускается.
  • Low-pass time constant (ms): 0 отключает фильтр; положительное значение включает фильтр первого порядка. Он подавляет пульсации, но вносит задержку и ослабление. Для начала используйте 0.

Для уверенного восстановления нужны десятки отсчётов на период несущей и достаточная длительность записи для нескольких периодов синуса.

Ядро: python/logic_analyzer/decoders/pwm_waveform.py; адаптер и ядро входят в protocol-files.json. Установщик копирует их по обычной схеме. Кривая требует сборки DSView с pwm-waveform.patch и native/pwm_waveform.h (штатный tools/dsview/build.py включает оба). В старом/стандартном DSView будут только числовые аннотации.

Проверки: python -m unittest discover -s tools/dsview/tests -p "test_pwm*.py".

Опции NPC в реальном DSView проверяет python tools/dsview/tests/check_pwm_npc_native.py --runtime C:/path/to/dsview --output C:/path/to/npc-check. Добавьте --mode envelope или --layout split для второго вида основной кривой либо раздельных фаз. Сценарий не использует оборудование.

Длинные записи отображаются через индекс минимумов и максимумов: обзорная перерисовка выдаёт не более двух отрезков на пиксель независимо от количества периодов. Одиночные выбросы сохраняются; при увеличении масштаба возвращаются исходные сегменты. Полные числовые аннотации остаются в таблице и экспорте. Индекс очищается вместе с записью при повторном анализе.

Проверка нативного индекса и миллиона периодов (Windows, MSYS2 UCRT64 с Qt 5): python -m unittest discover -s tools/dsview/tests -p test_pwm_envelope.py. Тест сравнивает экстремумы с полным перебором, проверяет увеличение масштаба, разрывы, повторное заполнение и ограниченное число экранных отрезков.

Нативная проверка (Python с PySide6, Windows):

python tools/dsview/tests/check_pwm_native.py --runtime C:/path/to/dsview --output C:/path/to/pwm-check

Она создаёт синтетическую трёхфазную запись, открывает её в отдельном DSView, сохраняет pwm-native.png и закрывает процесс. На изображении должны быть три синусоиды со сдвигом 120°. Аппаратный захват не запускается. По умолчанию проверяется split; добавьте --layout combined, чтобы проверить наложение трёх фаз. Параметр --max-height 4X увеличивает высоту дорожек: кривые растут, а текстовые блоки должны оставаться высотой шрифта плюс 2 пикселя.

Для проверки длинного захвата добавьте --seconds 10 --carrier-hz 20000 --timeout 60. Тест ждёт подтверждения полного декодирования, проверяет ответы потока интерфейса на WM_NULL с тайм-аутом в одну секунду и сохраняет итоговый экран в pwm-complete.png.