ШИМ → синус / 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.