Files
templates/tools/dsview/decoders/pwm_waveform

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

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

Кривая — измеренное заполнение 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%. Окна не синхронизированы с фронтами; при неверной несущей или быстро меняющейся модуляции возможны биения/искажения. В таблице указана частота окна, а не измеренная частота ШИМ. Неполное последнее окно пропускается.
  • 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_waveform.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°. Аппаратный захват не запускается.