Расширить DSView осциллографом и декодерами двигателя и сигма-дельта

This commit is contained in:
2026-11-12 15:00:41 +03:00
parent fa5ea166a9
commit 1fc88684d5
41 changed files with 4147 additions and 151 deletions
+138
View File
@@ -0,0 +1,138 @@
# ШИМ 2/3 уровня → токи асинхронного двигателя
В SETGUI: **DSView → Анализаторы SET → ШИМ 2/3 уровня → токи асинхронного двигателя**.
В списке декодеров DSView: **Пользовательские → PWM motor currents**.
На общей временной шкале отображаются расчётные линейные **Ia, Ib, Ic в амперах**:
A — голубой, B — жёлтый, C — зелёный. `Waveform layout` переключает
совмещённый (`combined`) и раздельный (`split`) вид.
Это модельная оценка. Напряжения звена и ШИМ недостаточно, чтобы однозначно
определить реальный ток: нужны параметры двигателя, скорость и начальное
электромагнитное состояние. Значения по умолчанию — демонстрационный пример,
они не являются параметрами подключённой машины.
## Входы и уровни
Обязательные `A/B/C P / Q1` — верхние команды трёх фаз.
Режим выбирается вручную в `Inverter / Уровни и кодировка`.
| Режим | Назначенные входы | Соответствие напряжению полюса |
|---|---|---|
| `2-level` | 3 верхние команды | 1 → +Uверх, 0 → −Uниз; идеальная комплементарная пара |
| `2-level` с нижними ключами | 3 верхние и 3 нижние команды | 10 → +Uверх, 01 → −Uниз; 00 → приближение обратных диодов |
| `3-level P/N` | 3 команды P и 3 команды N | 10 → +Uверх, 00 → средняя точка, 01 → −Uниз; 11 недопустимо |
| `3-level NPC` | 12 затворов: Q1, Q2, Q3, Q4 каждой фазы | 1100 → +Uверх, 0110 → средняя точка, 0011 → −Uниз |
В NPC физический порядок Q1…Q4 идёт сверху вниз по плечу. В диалоге сначала
расположены Q1 всех фаз, затем Q4 всех фаз, затем Q2/Q3 каждой фазы.
Назначать входы нужно по их именам, а не по порядку физических каналов прибора.
Нижние команды двухуровневой схемы назначаются либо все три, либо ни одной.
Для NPC необходимы все двенадцать входов. `Gate active level` инвертирует
все назначенные входы одновременно.
`Total DC link` — полное напряжение между положительной и отрицательной
шинами, **не напряжение одного конденсатора**. При Udc = 600 В и `Upper DC
link = 50%` уровни равны +300, 0 и −300 В. При 60% уровни +360, 0 и −240 В.
Напряжение считается постоянным на всей записи; пульсации звена по отдельному
аналоговому каналу в этой версии не измеряются.
Токи интегрируются по фактическим длительностям состояний ключей. Одинаковые
потенциалы всех фаз не создают ток плавающей звезды. Заполнение ШИМ не
подменяется искусственным синусом и не сглаживается перед расчётом.
Постоянные команды, включая 0/100%, также обрабатываются.
## Настройка двигателя
| Параметр | Смысл |
|---|---|
| `Winding` | `star` — звезда без нейтрального провода; `delta` — симметричный треугольник |
| `Stator R` | Сопротивление **одной обмотки** статора, Ом |
| `Rotor R referred` | Сопротивление ротора, приведённое к одной обмотке статора, Ом |
| `Stator leakage` | Индуктивность рассеяния статора, мГн |
| `Rotor leakage referred` | Индуктивность рассеяния ротора, приведённая к статору, мГн |
| `Magnetizing` | Взаимная индуктивность намагничивания, мГн |
| `Pole pairs` | Целое число пар полюсов, не число полюсов |
| `Fixed rotor speed` | Механическая скорость ротора, об/мин; отрицательное значение означает обратное вращение |
| `Initial rotor flux linkage` | Начальное потокосцепление ротора, Вб·виток = В·с |
| `Initial flux angle` | Начальный угол потока относительно оси A, градусы |
| `Initial line Ia/Ib` | Начальные линейные токи; Ic = −Ia−Ib, А |
| `Plot +/- range` | Полушкала графика, А; не ограничивает физический расчёт |
| `Plot sampling` | Частота дополнительных точек графика, Гц; каждый фактический фронт также создаёт точку |
Параметры обмотки и параметры эквивалентной звезды нельзя смешивать.
Для `delta` задайте параметры фактической обмотки треугольника; декодер
сам преобразует токи ветвей в линейные токи проводов инвертора.
Ток нулевой последовательности, циркулирующий внутри треугольника,
в симметричной модели не учитывается.
При поле 50 Гц и двух парах полюсов синхронная скорость равна 1500 об/мин.
Например, 1440 об/мин задаёт скольжение 4%. `speed = 0` описывает включение
с неподвижным ротором и нарастание потока. **Скорость остаётся постоянной**:
механический разгон, момент нагрузки и инерция в этой версии не рассчитываются.
Поэтому для участка разгона нужна отдельная оценка скорости; одна постоянная
настройка не воспроизводит весь механический переходный процесс.
Нулевые начальные токи и поток соответствуют невозбуждённому двигателю.
Если запись начинается в рабочем режиме, начальный участок содержит
переходный процесс модели: задайте известные начальные условия или
анализируйте установившуюся часть достаточно длинной записи.
## Уравнения и точность
Используется линейная αβ-модель короткозамкнутого асинхронного двигателя
в неподвижных осях статора. Для комплексных векторов тока `is` и
потокосцепления ротора `ψr`:
```text
Lr = Llr + Lm
k = Lm / Lr
Lσ = Lls + Lm·Llr/Lr
ωr = 2π · pole_pairs · speed_rpm / 60
dψr/dt = Rr·k·is − (Rr/Lr − jωr)·ψr
dis/dt = (vs − Rs·is − k·dψr/dt) / Lσ
```
Между фронтами используется аналитическая матричная экспонента для
постоянного напряжения. Изменение частоты точек графика не меняет решение
на неизменном участке. Чем выше частота точек, тем точнее криволинейный
переход передаётся отрезками на экране. Интервалы изменения проводимости
обратных диодов определяются приближённо на этой же сетке.
Физическая основа модели и обозначения параметров:
[MathWorks: Induction Motor](https://www.mathworks.com/help/mcb/ref/inductionmotor.html),
[MathWorks: Induction Machine Squirrel Cage](https://www.mathworks.com/help/simscape-electrical/ref/inductionmachinesquirrelcage.html).
Не моделируются магнитное насыщение, потери в стали, температурное изменение
сопротивлений, скин-эффект ротора, падения напряжения на силовых ключах,
паразитные ёмкости и высокочастотные выбросы. Без параметров конкретного
двигателя и проверки по датчику тока нельзя заявить погрешность относительно
реального агрегата.
Строка `Model / gate warnings` помечает токи как расчётные. При недопустимой
комбинации затворов используется последний определённый потенциал
соответствующей фазы и выдаётся предупреждение: оценка тока на этом участке
недостоверна. Интервалы полностью закрытого плеча отмечаются как приближение
диодной проводимости. Частичные состояния NPC в dead time также помечаются
как неоднозначные, их нельзя принимать за достоверную модель коммутации.
При выходе за `Plot +/- range` обрезается только изображение, появляется
предупреждение; реальные амперы сохраняются в таблице и в Python-выходе
`CURRENTS`. Увеличьте шкалу для просмотра полного размаха.
## Сборка и проверка
Ядро: `python/logic_analyzer/decoders/pwm_motor.py`. Адаптер и ядро входят
в общую ведомость `protocol-files.json`, доступны штатному установщику.
В обычном DSView выводятся числовые аннотации. Для цветных кривых и шкалы
в амперах требуется пересборка нативного DSView штатным рецептом с
`pwm-waveform.patch` и `motor-currents.patch`.
```powershell
python -m unittest discover -s tools/dsview/tests -p test_pwm_motor.py -v
```
Независимый эталон — комплексное сопротивление Т-схемы замещения:
проверяются амплитуда и фаза на неподвижном роторе, рабочем скольжении,
синхронной скорости, рекуперации и реверсе с допуском 0,2% относительно
идеализированной схемы. Этот допуск относится к математической проверке,
а не к точности восстановления реального тока.
@@ -0,0 +1 @@
from .pd import Decoder # Стандартная точка входа sigrok регистрирует декодер асинхронного двигателя.
+108
View File
@@ -0,0 +1,108 @@
"""Фазные токи асинхронного двигателя из двух- или трёхуровневого ШИМ.""" # Аннотации работают и без расширенного графического рендерера.
import math # Масштаб графика и частота выходных точек проверяются до начала декодирования.
import sigrokdecode as srd # Штатный API DSView предоставляет цифровые входы и выходные аннотации.
from common.setgui_decoders.pwm_motor import PwmMotor # Единственная реализация модели поставляется из переносимого ядра templates.
class Decoder(srd.Decoder): # Адаптер только связывает события sigrok с общей физической моделью.
api_version = 3 # DSView использует третью версию API ожидания фронтов.
id = 'pwm_motor' # Постоянный идентификатор связывает меню, сохранённые DSL и нативный рендерер.
name = 'PWM motor currents' # Короткое имя различает расчётные токи и существующую огибающую заполнения.
longname = 'PWM 2/3-level / induction motor phase currents' # Полное имя доступно в поиске анализаторов DSView.
desc = 'Estimated induction motor line currents in amperes from switching states; motor parameters required.' # Подсказка явно сообщает расчётный характер токов.
license = 'gplv2+' # Лицензия совместима с остальными переносимыми декодерами поставки.
inputs = ['logic'] # Декодер получает реальные логические затворные сигналы без базового UART или CAN.
outputs = ['pwm_motor'] # Структурированный выход позволяет повторно использовать токи в стеке анализаторов.
tags = ['Clock/timing', 'Util'] # Стандартные категории сохраняют совместимость со штатным поиском DSView.
channels = tuple({'id': ch + '_p', 'name': ch.upper() + ' P / Q1', 'desc': 'Upper gate or positive-level command'} for ch in 'abc') # Верхние команды всех трёх фаз обязательны для восстановления линейных напряжений.
optional_channels = tuple({'id': ch + '_n', 'name': ch.upper() + ' N / Q4', 'desc': 'Lower gate; required for 3-level modes'} for ch in 'abc') + tuple({'id': ch + '_q' + str(q), 'name': ch.upper() + ' Q' + str(q), 'desc': 'NPC inner gate; required in 3-level NPC'} for ch in 'abc' for q in (2, 3)) # Дополнительные входы поддерживают шесть команд P/N и двенадцать затворов NPC.
options = ( # Физические параметры задаются для одной обмотки; роторные величины приведены к статору.
{'id': 'topology', 'desc': 'Inverter / Уровни и кодировка', 'default': '2-level', 'values': ('2-level', '3-level P/N', '3-level NPC')}, # Режим определяет таблицу преобразования логических входов в полюсные напряжения.
{'id': 'dc_voltage', 'desc': 'Total DC link / Полное Udc (V)', 'default': 560.0}, # Пример 560 В относится ко всему звену между шинами плюс и минус.
{'id': 'midpoint_percent', 'desc': 'Upper DC link / Верхняя половина (%)', 'default': 50.0}, # 50 процентов соответствует двум равным конденсаторам трёхуровневого звена.
{'id': 'connection', 'desc': 'Winding / Соединение обмоток', 'default': 'star', 'values': ('star', 'delta')}, # На графике в обоих случаях выводятся линейные токи проводов A, B, C.
{'id': 'active_level', 'desc': 'Gate active level / Активный уровень', 'default': 'high', 'values': ('high', 'low')}, # Общая полярность применяется ко всем назначенным затворам.
{'id': 'rs', 'desc': 'Stator R / R статора (ohm)', 'default': 1.0}, # Пример сопротивления одной обмотки статора в омах необходимо заменить параметром двигателя.
{'id': 'rr', 'desc': 'Rotor R referred / R ротора приведённое (ohm)', 'default': 0.8}, # Сопротивление ротора задаётся приведённым к одной обмотке статора.
{'id': 'lls_mh', 'desc': 'Stator leakage / L рассеяния статора (mH)', 'default': 5.0}, # Индуктивность рассеяния отличается от полной индуктивности обмотки.
{'id': 'llr_mh', 'desc': 'Rotor leakage referred / L рассеяния ротора (mH)', 'default': 5.0}, # Значение ротора также должно быть приведено к статору.
{'id': 'lm_mh', 'desc': 'Magnetizing / L намагничивания (mH)', 'default': 150.0}, # Взаимная индуктивность задаёт магнитный поток линейной ненасыщенной модели.
{'id': 'pole_pairs', 'desc': 'Pole pairs / Число пар полюсов', 'default': 2}, # Две пары полюсов дают синхронную скорость 1500 об/мин при поле 50 Гц.
{'id': 'speed_rpm', 'desc': 'Fixed rotor speed / Скорость ротора (rpm)', 'default': 1440.0}, # Постоянная механическая скорость задаёт скольжение; ноль моделирует неподвижный ротор.
{'id': 'initial_flux', 'desc': 'Initial rotor flux linkage / Начальный поток (Wb)', 'default': 0.0}, # Нулевое начальное потокосцепление соответствует невозбуждённой машине.
{'id': 'flux_angle', 'desc': 'Initial flux angle / Угол потока (deg)', 'default': 0.0}, # Угол начального вектора отсчитывается от оси фазы A к оси β.
{'id': 'ia', 'desc': 'Initial line Ia / Начальный Ia (A)', 'default': 0.0}, # Ток A задаёт одно из двух независимых начальных состояний трёхпроводной системы.
{'id': 'ib', 'desc': 'Initial line Ib / Начальный Ib (A)', 'default': 0.0}, # Третий ток автоматически равен минус сумме Ia и Ib.
{'id': 'plot_range_a', 'desc': 'Plot +/- range / Шкала графика +/- (A)', 'default': 100.0}, # Масштаб меняет только отрисовку, а не расчёт или физическую амплитуду.
{'id': 'output_hz', 'desc': 'Plot sampling / Точек графика в секунду (Hz)', 'default': 100000}, # Сетка 100 кГц дополняет обязательные точки каждого фронта и работает при постоянных уровнях.
{'id': 'waveform_layout', 'desc': 'Waveform layout / Вид графиков', 'default': 'combined', 'values': ('combined', 'split')}, # Три фазных тока можно совместить или разнести по отдельным областям.
) # Значения сохраняются штатным механизмом настроек и DSL-сессий.
annotations = (('current-a', 'Estimated Ia (A)'), ('current-b', 'Estimated Ib (A)'), ('current-c', 'Estimated Ic (A)'), ('warnings', 'Model / gate warnings')) # Первые три класса используют контракт сегментов графического рендерера.
annotation_rows = (('wave_a', 'Ia estimate (A)', (0,)), ('wave_b', 'Ib estimate (A)', (1,)), ('wave_c', 'Ic estimate (A)', (2,)), ('warnings', 'Model / gate warnings', (3,))) # Идентификаторы wave_a…wave_c поддерживают прежние цвета и индекс экстремумов.
def __init__(self): # Конструктор не обращается к частоте захвата до получения metadata.
self.reset() # Каждый экземпляр анализатора начинает с независимого состояния двигателя.
def reset(self): # Повторное декодирование не должно использовать токи или поток предыдущей записи.
self.samplerate, self.model, self.warning_start, self.warning_text = None, None, None, None # Диагностика и физическое состояние сбрасываются совместно.
self.clipped = False # Превышение шкалы прежней записи не переносится в новый расчёт.
def metadata(self, key, value): # Движок сообщает фактическую частоту цифрового захвата.
if key == srd.SRD_CONF_SAMPLERATE: # Остальные метаданные не участвуют в переводе отсчётов в секунды.
self.samplerate = value # Частота применяется при создании модели после валидации настроек.
def start(self): # Выходные дескрипторы создаются штатным механизмом sigrok.
self.out_ann = self.register(srd.OUTPUT_ANN) # Аннотации доступны в таблице результатов и на графиках.
self.out_python = self.register(srd.OUTPUT_PYTHON) # Структурированные данные содержат ненормированные амперы.
def _emit(self, event): # Представление сегмента не изменяет физических токов модели.
if event is None: # Первый отсчёт или повторная временная отметка не образуют интервала.
return # Нулевая длительность не создаёт ложную линию на графике.
start, end, before, after = event # Время хранится в отсчётах, оба вектора тока заданы в амперах.
clipped = max(abs(value) for value in before + after) > self.scale # Превышение пользовательской шкалы должно быть видно в диагностике.
self.clipped = clipped # Состояние масштаба используется общей диагностической строкой текущего интервала.
for phase in range(3): # Каждый линейный провод получает отдельный цветной сегмент и физическую подпись.
label = 'Estimated I{}={:+.6f} A{}'.format('ABC'[phase], after[phase], ' [outside plot range]' if clipped else '') # Таблица сохраняет реальную амплитуду даже при выходе кривой за шкалу.
self.put(start, end, self.out_ann, [phase, [label, 'PWM1 {:.12g} {:.12g}'.format(max(-1, min(1, before[phase] / self.scale)), max(-1, min(1, after[phase] / self.scale)))]]) # За границей шкалы ограничивается только геометрия; физические амперы сохраняются в подписи и структурированном выходе.
self.put(start, end, self.out_python, ['CURRENTS', {'ia': after[0], 'ib': after[1], 'ic': after[2], 'unit': 'A', 'estimated': True, 'warnings': self.model.interval_warnings, 'outside_plot_range': clipped}]) # Диагностика относится к завершённому электрическому интервалу, а не к следующей команде затворов.
def _warning(self, sample, final=False): # Одинаковая диагностика объединяется в один интервал вместо повторения на каждой точке графика.
text = 'Estimated induction motor currents; fixed speed; motor parameters and initial state required.' # Постоянная пометка предотвращает восприятие оценки как измеренных токов.
if self.model.warnings: # Невозможные команды ключей и модель диодов дополняют общую оговорку о расчёте.
text += ' ' + '; '.join(self.model.warnings) # В подпись включаются конкретные фазы и состояния затворов.
if getattr(self, 'clipped', False): # Ограниченная шкалой геометрия должна сопровождаться заметным предупреждением.
text += ' Current exceeds plot range; increase +/- A.' # Пользователь может расширить шкалу без изменения физической модели двигателя.
if self.warning_text is not None and (final or text != self.warning_text) and sample > self.warning_start: # Завершённый интервал выводится при смене условий или окончании записи.
self.put(self.warning_start, sample, self.out_ann, [3, [self.warning_text]]) # Диагностика видна на соответствующем по времени участке захвата.
if final or text != self.warning_text: # Начало нового интервала совпадает с изменением модельной достоверности.
self.warning_start, self.warning_text = sample, text # Повторяющийся текст не раздувает число аннотаций.
def decode(self): # Ожидание фронтов дополняется сеткой, поэтому постоянный ШИМ 0/100 процентов также рассчитывается.
if not self.samplerate: # Без частоты нельзя перевести длительность затворных команд в физическое время.
raise ValueError('Cannot estimate motor current without samplerate.') # Расчёт не подменяет неизвестную частоту условной константой.
self.scale, output = float(self.options['plot_range_a']), float(self.options['output_hz']) # Шкала в амперах и частота точек задаются независимо от параметров двигателя.
if not math.isfinite(self.scale) or self.scale <= 0 or not math.isfinite(output) or output <= 0: # Нулевой масштаб и неконечная сетка не допускаются.
raise ValueError('Plot range and plot sample rate must be finite and positive.') # Исправление настройки не требует изменения записи.
if self.options['active_level'] not in ('high', 'low') or self.options['waveform_layout'] not in ('combined', 'split'): # Повреждённые сохранённые опции не интерпретируются произвольно.
raise ValueError('Invalid gate polarity or waveform layout.') # Явная ошибка сохраняет смысл полярности сигналов.
keys = ('topology', 'dc_voltage', 'midpoint_percent', 'connection', 'rs', 'rr', 'lls_mh', 'llr_mh', 'lm_mh', 'pole_pairs', 'speed_rpm', 'initial_flux', 'flux_angle', 'ia', 'ib') # В ядро передаются только физические параметры модели.
self.model = PwmMotor(self.samplerate, active_high=self.options['active_level'] == 'high', **{key: self.options[key] for key in keys}) # Проверка схемы и единиц выполняется единственной общей реализацией.
present = tuple(self.has_channel(index) for index in range(12)) # Неназначенные необязательные входы не считаются логическим нулём.
pins = list(self.wait({})) # Копирование освобождает внутренний tuple DSView перед следующим ожиданием.
self.model.update(self.samplenum, tuple(pins[index] if present[index] else None for index in range(12))) # Первый набор уровней определяет начальные состояния ключей.
self._warning(self.samplenum) # Отметка расчётного характера начинается с первого фактического отсчёта записи.
step = max(1, round(self.samplerate / output)) # Шаг в целых отсчётах ограничивается разрешением исходного захвата.
boundary = self.samplenum + step # Равномерная сетка привязана к началу выбранной области декодирования.
edges = [{index: 'e'} for index in range(12) if present[index]] # Одновременные фронты считываются одним набором уровней.
while True: # Завершение захвата штатно останавливает wait без достраивания неизвестного сигнала.
pins = list(self.wait(edges + [{'skip': max(1, boundary - self.samplenum)}])) # События ключей обрабатываются даже между соседними точками сетки.
self._emit(self.model.update(self.samplenum, tuple(pins[index] if present[index] else None for index in range(12)))) # Старое напряжение интегрируется до фронта, новая команда действует после него.
self._warning(self.samplenum) # Изменившиеся ошибки затворов получают собственный временной интервал.
if self.samplenum >= boundary: # Фронт точно на сетке не должен создавать второй сегмент нулевой длины.
boundary += ((self.samplenum - boundary) // step + 1) * step # Сетка остаётся равномерной независимо от количества переключений между её узлами.
def end(self): # Последний доступный отсчёт завершает только известную часть записи.
if self.model is not None and self.model.sample is not None: # Ошибка настроек до первого отсчёта не оставляет пригодного физического состояния.
last = max(self.samplenum, getattr(self, 'last_samplenum', self.samplenum)) # DSView передаёт фактический конец через last_samplenum, отдельно от последнего сработавшего wait.
self._emit(self.model.update(last)) # Завершается только известный хвост записи до её фактической правой границы.
self._warning(last, final=True) # Последний диагностический интервал сохраняется даже при неизменных ключах.
+96 -3
View File
@@ -6,6 +6,72 @@
цветную кривую с общей временной шкалой записи и строку заполнения.
Для большего числа входов добавьте ещё один экземпляр декодера.
Всё перечисленное ниже — опции **этого же анализатора 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](https://e2e.ti.com/cfs-file/__key/communityserver-discussions-components-files/38/Three_2D00_Level-Converters_2D00_1.pdf).
Преобразование координат: [Microchip Clarke Transformation](https://onlinedocs.microchip.com/oxy/GUID-0A4BC4EE-29F5-4736-8125-17139B84E7B5-en-US-2/GUID-92ACB0C5-9954-44B5-8583-47F0E6960A32.html).
В настройках **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. Значения между серединами
периодов соединены прямыми. Это нормированная модуляция, не измерение
@@ -20,8 +86,11 @@
- **Carrier Hz > 0**: интегрирование заполнения в равных временных окнах
длиной `1/f`, начиная с начала области декодирования. Работает на 0/100%.
Окна не синхронизированы с фронтами; при неверной несущей или быстро
меняющейся модуляции возможны биения/искажения. В таблице указана частота
окна, а не измеренная частота ШИМ. Неполное последнее окно пропускается.
меняющейся модуляции возможны биения/искажения. В строке заполнения
`window` обозначает частоту окна, а `PWM carrier` — частоту между
фактическими активными фронтами. Пока не получены два фронта или после
отсутствия фронтов дольше двух последних измеренных периодов несущая
помечается `unavailable`. Неполное последнее окно пропускается.
- **Low-pass time constant (ms)**: 0 отключает фильтр; положительное значение
включает фильтр первого порядка. Он подавляет пульсации, но вносит задержку
и ослабление. Для начала используйте 0.
@@ -35,7 +104,23 @@
`native/pwm_waveform.h`** (штатный `tools/dsview/build.py` включает оба).
В старом/стандартном DSView будут только числовые аннотации.
Проверки: `python -m unittest discover -s tools/dsview/tests -p test_pwm_waveform.py`.
Проверки: `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):
@@ -46,3 +131,11 @@ python tools/dsview/tests/check_pwm_native.py --runtime C:/path/to/dsview --outp
Она создаёт синтетическую трёхфазную запись, открывает её в отдельном DSView,
сохраняет `pwm-native.png` и закрывает процесс. На изображении должны быть
три синусоиды со сдвигом 120°. Аппаратный захват не запускается.
По умолчанию проверяется `split`; добавьте `--layout combined`, чтобы проверить
наложение трёх фаз. Параметр `--max-height 4X` увеличивает высоту дорожек:
кривые растут, а текстовые блоки должны оставаться высотой шрифта плюс 2 пикселя.
Для проверки длинного захвата добавьте `--seconds 10 --carrier-hz 20000
--timeout 60`. Тест ждёт подтверждения полного декодирования, проверяет
ответы потока интерфейса на WM_NULL с тайм-аутом в одну секунду и сохраняет
итоговый экран в `pwm-complete.png`.
+113 -13
View File
@@ -1,6 +1,13 @@
"""PWM envelope on up to three independent logic channels."""
import sigrokdecode as srd
from common.setgui_decoders.pwm_waveform import PwmChannel
from common.setgui_decoders.pwm_waveform import PwmChannel, NpcChannel, PhaseAnalysis # Общие ядра восстанавливают два уровня, стойку NPC и согласованный трёхфазный вектор без зависимости от интерфейса.
def short_frequency(value): # Компактная подпись сохраняет обе частоты даже при небольшой ширине электрического периода на экране.
if value is None: # Отсутствующее измерение не должно выглядеть как нулевая частота.
return '?' # Короткий знак оставляет место второму, доступному измерению.
scale, unit = (1000000, 'MHz') if value >= 1000000 else (1000, 'kHz') if value >= 1000 else (1, 'Hz') # Приставки СИ переводят герцы в кило- и мегагерцы без изменения физического значения.
return '{:.3g}{}'.format(value / scale, unit) # Три значащие цифры достаточны для обзорной подписи; полная точность остаётся в первой строке аннотации.
class Decoder(srd.Decoder):
@@ -17,17 +24,27 @@ class Decoder(srd.Decoder):
optional_channels = (
{'id': 'b', 'name': 'PWM B', 'desc': 'Second PWM input'},
{'id': 'c', 'name': 'PWM C', 'desc': 'Third PWM input'},
*tuple({'id': ch + str(gate), 'name': ch.upper() + str(gate), 'desc': 'NPC ' + ch.upper() + ' S' + str(gate) + ' (top to bottom)'} for ch in 'abc' for gate in (2, 3, 4)), # Прежние A/B/C становятся S1 фаз; дополнительные девять входов завершают 12 затворов NPC, сохраняя совместимость записей DSL.
)
options = tuple(
{'id': 'active_' + ch, 'desc': 'PWM ' + ch.upper() + ' active level',
'default': 'high', 'values': ('high', 'low')} for ch in 'abc'
) + (
{'id': 'input_mode', 'desc': 'PWM topology / Схема ШИМ', 'default': 'two-level', 'values': ('two-level', 'npc-three-level')}, # NPC использует четыре затвора на фазу, обычный режим сохраняет один вход на фазу.
{'id': 'waveform_mode', 'desc': 'Waveform / Форма сигнала', 'default': 'envelope', 'values': ('envelope', 'switching')}, # Envelope выводит средние уровни, switching — оценку коммутационного напряжения непосредственно по состояниям затворов.
{'id': 'show_theta', 'desc': 'Theta ABC 0-360 deg / Угол вектора', 'default': 'no', 'values': ('no', 'yes')}, # θ является отдельной опцией и требует всех трёх восстановленных фаз.
{'id': 'show_carrier', 'desc': 'Calculated triangle / Расчётная несущая', 'default': 'no', 'values': ('no', 'yes')}, # Треугольник восстанавливается по периодам и не выдаётся за измеренную аналоговую несущую.
{'id': 'show_phase_angles', 'desc': 'Phase angles AB BC CA / Углы между фазами', 'default': 'no', 'values': ('no', 'yes')}, # Знаковые сдвиги фаз измеряются по одноимённым пересечениям огибающих.
{'id': 'waveform_layout', 'desc': 'Waveform layout / Вид графиков', 'default': 'split', 'values': ('split', 'combined')}, # Split сохраняет отдельную область каждого входа; combined совмещает цветные кривые на общей шкале −1…+1.
{'id': 'carrier_hz', 'desc': 'Carrier Hz (0 = edge-to-edge)', 'default': 0},
{'id': 'smoothing_ms', 'desc': 'Low-pass time constant (ms, 0 = off)', 'default': 0.0},
)
annotations = (
('wave-a', 'Wave A'), ('wave-b', 'Wave B'), ('wave-c', 'Wave C'),
('duty-a', 'Duty A'), ('duty-b', 'Duty B'), ('duty-c', 'Duty C'),
('frequency-a', 'PWM carrier / field A'), ('frequency-b', 'PWM carrier / field B'), ('frequency-c', 'PWM carrier / field C'), # Индексы 6–8 дополняют прежние аннотации, сохраняя контракт графических строк 0–2.
('theta', 'Theta ABC (deg)'), ('carrier', 'Calculated carrier'), ('phase-angles', 'Phase lag (deg)'), # Индексы 9–11 отделяют графические углы и несущую от числового измерения сдвигов.
('npc-unknown-a', 'NPC A unknown'), ('npc-unknown-b', 'NPC B unknown'), ('npc-unknown-c', 'NPC C unknown'), # Индексы 12–14 явно обозначают комбинации затворов, по которым напряжение не определяется.
)
annotation_rows = (
('wave_a', 'A: -1 .. +1', (0,)),
@@ -36,6 +53,13 @@ class Decoder(srd.Decoder):
('duty_a', 'A duty / frequency', (3,)),
('duty_b', 'B duty / frequency', (4,)),
('duty_c', 'C duty / frequency', (5,)),
('frequency_a', 'A PWM carrier / field', (6,)), # Длинная аннотация охватывает полный период поля и показывает обе частоты канала A при обзорном масштабе.
('frequency_b', 'B PWM carrier / field', (7,)), # Независимый расчёт канала B сохраняет его собственную частоту и положение электрического периода.
('frequency_c', 'C PWM carrier / field', (8,)), # Для необязательного канала C строка заполняется только при фактическом подключении.
('wave_theta', 'Theta ABC: 0 .. 360 deg', (9,)), # Нормированный графический контракт переводится в электрические градусы подписью шкалы и числовыми аннотациями.
('wave_carrier', 'Calculated triangle / NPC pair', (10,)), # Одна общая строка показывает один треугольник для двух уровней или два смещённых треугольника NPC.
('phase_angles', 'Phase lag A->B / B->C / C->A (deg)', (11,)), # Положительное значение означает запаздывание второй указанной фазы.
('npc_unknown', 'NPC dead-time / unknown voltage', (12, 13, 14)), # Недопустимое состояние не маскируется фиктивным нулём коммутационного напряжения.
)
def __init__(self):
@@ -44,6 +68,11 @@ class Decoder(srd.Decoder):
def reset(self):
self.samplerate = None
self.channels_state = {}
self._mode, self._npc = 'envelope', False # Старые сохранённые настройки продолжают открываться как обычная огибающая двухуровневого ШИМ.
self._show_theta = self._show_carrier = self._show_angles = False # Дополнительные расчётные строки включаются только явными опциями данного экземпляра.
self._phase_channels = {ch: (ch,) for ch in range(3)} # Прежняя нумерация A/B/C сохраняется для тестов, записей и обычного режима.
self._raw, self._theta_previous = {}, None # Координаты коммутаций и предыдущий θ принадлежат только текущему декодированию.
self._phase_analysis, self._last_pins = None, None # Согласование фаз и завершающий снимок не переносятся в следующую запись.
def metadata(self, key, value):
if key == srd.SRD_CONF_SAMPLERATE:
@@ -53,30 +82,105 @@ class Decoder(srd.Decoder):
self.out_ann = self.register(srd.OUTPUT_ANN)
def _update(self, pins):
self._last_pins = list(pins) # sigrok повторно использует свой кортеж; независимая копия нужна для корректного завершения окон.
for ch, state in self.channels_state.items():
for event in state.update(self.samplenum, pins[ch]):
label = 'D={:.3f}% {}'.format(event['duty'] * 100,
('window ' if state.window else 'f=') + '{:.3f} Hz'.format(event['frequency']))
inputs = [pins[index] for index in self._phase_channels[ch]] # В NPC одному восстановленному каналу соответствуют четыре физических входа.
level = state.state(inputs) if self._npc else (1 if bool(inputs[0]) == state.active_high else -1) # Двухуровневый уровень нормирован к ±1, а неопределённая комбинация NPC остаётся None.
if self._mode == 'switching' or self._npc: # Коммутационный график и предупреждения NPC используют ту же временную последовательность цифровых состояний.
self._switching(ch, level) # Неизвестные интервалы разрывают кривую и явно отмечаются отдельной аннотацией.
for event in state.update(self.samplenum, inputs if self._npc else inputs[0]): # Ядра получают собственный формат входа, сохраняя единый формат восстановленных результатов.
carrier = '{:.3f} Hz'.format(event['carrier_frequency']) if event['carrier_frequency'] is not None else 'unavailable' # Не подменяем измеренную несущую заданной частотой окна или устаревшим значением после исчезновения фронтов.
window = ' window={:.3f} Hz'.format(event['frequency']) if state.window else '' # Частота интегрирования обозначается отдельно и только в режиме заданной несущей.
label = 'D={:.3f}% PWM carrier={}{}'.format(event['duty'] * 100, carrier, window) # Подпись каждого периода явно связывает несущую с измеренными фронтами ШИМ.
if self._npc: # В NPC D является эквивалентным заполнением среднего уровня, а не временем включения одного ключа.
label = 'NPC mean={:+.6f} valid={:.3f}% PWM carrier={}{}'.format(2 * event['duty'] - 1, 100 * event['valid_fraction'], carrier, window) # Доля известного времени показывает влияние исключённых коммутационных пауз на оценку.
self.put(event['start'], event['end'], self.out_ann,
[3 + ch, [label, '{:.2f}%'.format(event['duty'] * 100)]])
field = event['field'] # Дополнительная строка появляется только после завершения полного электрического периода.
if field is not None: # Неполные периоды и постоянное заполнение не создают числового результата поля.
carrier = '{:.3f} Hz'.format(field['carrier_frequency']) if field['carrier_frequency'] is not None else 'unavailable' # Средняя несущая измеряется независимо от числа окон восстановления за период поля.
field_text = 'Field={:.3f} Hz'.format(field['frequency']) # Частота огибающей выражена в электрических герцах, без пересчёта в механические обороты.
carrier_short, field_short = short_frequency(field['carrier_frequency']), short_frequency(field['frequency']) # При обзорном масштабе приставки СИ позволяют одновременно прочитать несущую и поле.
self.put(field['start'], field['end'], self.out_ann, [6 + ch, ['PWM carrier={} {}'.format(carrier, field_text), 'PWM={} / {}'.format(carrier, field_text), 'PWM={} F={}'.format(carrier_short, field_short), '{}/{}'.format(carrier_short, field_short)]]) # Все варианты подписи сохраняют порядок «несущая / поле», включая самый короткий для узкого периода.
previous = event['previous']
if previous is not None:
if previous is not None and self._mode == 'envelope': # Переключение вида меняет только график; частоты и углы всегда рассчитываются по огибающим.
# Last label is the versioned native renderer contract.
self.put(previous[0], event['midpoint'], self.out_ann, [ch, [
'PWM {}: {:+.6f}'.format('ABC'[ch], event['value']),
'PWM1 {:.9f} {:.9f}'.format(previous[1], event['value'])]])
if self._show_carrier and ch == min(self.channels_state): # Общая расчётная несущая использует периоды первой подключённой фазы и не дублируется для B/C.
self._curve(10, event['start'], event['midpoint'], -1, 1, 'Calculated carrier') # Первая половина условного периода линейно поднимается от минимума к максимуму.
self._curve(10, event['midpoint'], event['end'], 1, -1, 'Calculated carrier') # Вторая половина завершает треугольник без накопления ошибки времени.
if self._phase_analysis is not None: # При выключенных угловых опциях согласование фаз не тратит время на длинных записях.
if event['previous'] is None: # Новая история огибающей означает начало записи либо разрыв неизвестного состояния NPC.
self._theta_previous = None # График θ не соединяется через интервал, где одна из фаз не была восстановлена.
vector = self._phase_analysis.add(ch, event) # Точки всех фаз интерполируются к общему наблюдавшемуся времени.
if self._show_theta and vector is not None: # Начальная неполная тройка фаз не создаёт угла пространственного вектора.
self._theta(vector) # Переход 360→0 разрывается на границе, сохраняя правильную пилообразную форму.
if self._show_angles and event['field'] is not None and ch == min(self.channels_state): # Один полный период опорной фазы задаёт интервал числового результата всех доступных пар.
angles = self._phase_analysis.differences(event['midpoint']) # Сдвиг вычисляется из фактических фазовых часов, а не из заданных 120 градусов.
if angles: # Устаревшие или ещё не измеренные пары не должны получать числовую подпись.
labels = [' '.join('{}={:+.3f} deg'.format(pair, value) for pair, value in angles.items()), ' / '.join('{:+.1f}'.format(value) for value in angles.values())] # Полная подпись сохраняет направление каждой пары; короткая следует порядку заголовка.
self.put(event['field']['start'], event['field']['end'], self.out_ann, [11, labels]) # Значения доступны на временной диаграмме, в таблице результатов и при экспорте.
def _curve(self, kind, start, end, a, b, label): # Все расчётные кривые используют существующий индекс экстремумов и контракт PWM1.
start, end = round(start), round(end) # Целые номера отсчётов требуются API аннотаций sigrok.
if end > start: # Пустой интервал не может быть сегментом индексированной кривой.
self.put(start, end, self.out_ann, [kind, [label, 'PWM1 {:.9f} {:.9f}'.format(max(-1, min(1, a)), max(-1, min(1, b)))]]) # Ограничение защищает нативный контракт нормированных значений от машинного округления.
def _switching(self, ch, level): # Импульсная осциллограмма строится по сменам состояний без выдуманных аналоговых выбросов.
previous = self._raw.get(ch) # Предыдущее состояние определяет уровень между двумя цифровыми событиями.
if previous is not None and self.samplenum > previous[0]: # Совпадающие события не создают отрицательную или нулевую длительность.
start, old = previous # Начало интервала и уровень относятся только к выбранной фазе.
if old is None: # Ни одна из трёх штатных комбинаций NPC не определяла напряжение на этом участке.
self.put(start, self.samplenum, self.out_ann, [12 + ch, ['NPC {}: unknown voltage / dead-time'.format('ABC'[ch]), 'unknown']]) # Неизвестное время остаётся видимым даже при выборе огибающей.
elif self._mode == 'switching': # Основная графическая строка может показывать коммутации вместо средней огибающей.
corner = self.samplenum - 1 if level is not None and level != old else self.samplenum # Фронт занимает один отсчёт, поскольку аналоговая скорость переключения не измерена.
self._curve(ch, start, max(start, corner), old, old, 'Switching {}: {:+d}'.format('ABC'[ch], old)) # Постоянный уровень сохраняет точную длительность между событиями захвата.
if level is not None and level != old: # Через неизвестный уровень не проводится выдуманный соединительный фронт.
self._curve(ch, max(start, corner), self.samplenum, old, level, 'Switching {} edge'.format('ABC'[ch])) # Нормированный переход отображается только в пределах разрешения записи.
self._raw[ch] = (self.samplenum, level) # Следующее событие продолжит график только от текущего достоверного состояния.
def _theta(self, vector): # Угол общего вектора выводится отдельно от углов между фазами.
sample, angle = vector['sample'], vector['theta'] # Координата соответствует единому времени A/B/C после интерполяции.
previous = self._theta_previous # Предыдущая точка нужна для графика и обнаружения циклического перехода через нуль.
if angle is not None and previous is not None: # Нулевая амплитуда или разрыв не соединяются произвольным направлением вектора.
start, old = previous # Угол выражен в градусах до преобразования в нативную шкалу −1…+1.
if abs(angle - old) <= 180: # Обычный участок не пересекает границу электрического оборота.
self._curve(9, start, sample, old / 180 - 1, angle / 180 - 1, 'Theta={:.3f} deg'.format(angle)) # Подпись содержит физическую величину, а renderer получает нормированные концы.
else: # Циклическое значение должно сбрасываться вертикально, а не проходить ложные промежуточные углы.
forward = old > angle # Направление определяет границу +360→0 либо 0→+360.
delta = angle - old + (360 if forward else -360) # Кратчайшее изменение восстанавливает непрерывный угол на одном малом интервале.
boundary = start + ((360 if forward else 0) - old) * (sample - start) / delta # Линейная интерполяция определяет момент перехода через границу оборота.
self._curve(9, start, boundary, old / 180 - 1, 1 if forward else -1, 'Theta wrap') # Первая часть заканчивается на достигнутой границе шкалы.
self._curve(9, boundary, sample, -1 if forward else 1, angle / 180 - 1, 'Theta={:.3f} deg'.format(angle)) # Вторая часть начинается с противоположного края без ложной диагонали.
self._theta_previous = (sample, angle) if angle is not None else None # Неопределённое направление явно разрывает историю угла.
def decode(self):
if not self.samplerate:
raise ValueError('Cannot decode without samplerate.')
self.channels_state = {ch: PwmChannel(self.samplerate,
self._npc = self.options.get('input_mode', 'two-level') == 'npc-three-level' # Отсутствующая опция старой записи сохраняет прежнюю схему одного входа на фазу.
self._mode = self.options.get('waveform_mode', 'envelope') # Вид кривой не меняет численные измерения заполнения, частот и углов.
self._show_theta, self._show_carrier, self._show_angles = (self.options.get(key, 'no') == 'yes' for key in ('show_theta', 'show_carrier', 'show_phase_angles')) # Все дополнительные расчёты включаются независимо в настройках одного анализатора.
self._phase_channels = {ch: (ch, 3 + ch * 3, 4 + ch * 3, 5 + ch * 3) if self._npc else (ch,) for ch in range(3)} # S1 сохраняет прежние индексы A/B/C, а S2…S4 последовательно занимают девять новых входов.
for ch, indices in self._phase_channels.items(): # Неполная стойка NPC не должна трактоваться как неподключённый или нулевой уровень фазы.
connected = [self.has_channel(index) for index in indices] # Наличие проверяется для каждого физического затвора отдельно.
if any(connected) and not all(connected): # Каждая используемая фаза NPC требует всех четырёх управляющих сигналов.
raise ValueError('NPC phase {} requires all four gates S1..S4 (top to bottom).'.format('ABC'[ch])) # Понятная ошибка предотвращает неверную реконструкцию из неполных входов.
channel_class = NpcChannel if self._npc else PwmChannel # Один и тот же экземпляр декодера поддерживает две схемы без отдельного анализатора.
self.channels_state = {ch: channel_class(self.samplerate, # Тип канала определяет преобразование цифровых состояний в средний уровень.
self.options['active_' + 'abc'[ch]] == 'high',
self.options['carrier_hz'], self.options['smoothing_ms'])
for ch in range(3) if self.has_channel(ch)}
if self._show_theta and len(self.channels_state) != 3: # Для угла пространственного вектора нужны три реальные огибающие, а не предположение о симметричной нагрузке.
raise ValueError('Theta requires all three phases A/B/C.') # Отсутствующая фаза не достраивается искусственной синусоидой.
if self._show_angles and len(self.channels_state) < 2: # Межфазный угол невозможно измерить по одному подключённому входу.
raise ValueError('Phase angles require at least two phases.') # В двухфазной записи рассчитываются только доступные пары.
self._phase_analysis = PhaseAnalysis(self.samplerate) if self._show_theta or self._show_angles else None # Выключенные опции сохраняют прежнюю стоимость обработки обычного ШИМ.
pins = list(self.wait({}))
self._update(pins)
while True:
conditions = [{ch: 'e'} for ch in self.channels_state]
conditions = [{index: 'e'} for ch in self.channels_state for index in self._phase_channels[ch]] # В NPC пробуждение вызывается каждым затвором, включая короткие dead-time и запрещённые комбинации.
boundaries = [s.next_boundary() for s in self.channels_state.values()
if s.next_boundary() is not None]
if boundaries:
@@ -85,9 +189,5 @@ class Decoder(srd.Decoder):
self._update(pins)
def end(self):
# Complete fixed windows only; never infer a partial edge-based period.
if self.channels_state:
pins = [0, 0, 0]
for ch, state in self.channels_state.items():
pins[ch] = state.level == state.active_high
self._update(pins)
if self.channels_state and self._last_pins is not None: # Последний снимок содержит все двенадцать затворов NPC либо прежние входы A/B/C.
self._update(self._last_pins) # Завершаются только полные окна и постоянные участки; отсутствующие фронты и неполные периоды не выдумываются.
@@ -0,0 +1,50 @@
# Сигма-дельта: DATA + CLK
Декодер `sigma_delta` восстанавливает сигнал из однобитного потока
сигма-дельта модулятора (PDM) с отдельным тактовым входом. В SETGUI он
доступен в меню анализаторов как **Сигма-дельта · DATA/CLK, sinc1/2/3**,
в обычном списке DSView — как **Sigma-delta**.
Назначьте захваченные линии **DATA** и **CLK**. Выберите фронт приёма согласно
документации модулятора: `rising` или `falling`. Если полярность DATA обратная,
включите `Invert DATA`. Биты принимаются на фронтах CLK даже при постоянном DATA;
начальный уровень захвата до первого выбранного фронта не считается битом.
Для нескольких модуляторов добавьте несколько экземпляров анализатора с общим CLK.
| Настройка | Значение и смысл |
| --- | --- |
| Decimation filter | `sinc1`, `sinc2`, `sinc3`; по умолчанию `sinc3` |
| Decimation / OSR | Целое число входных тактов на выходной отсчёт: 1–65536; по умолчанию 256 |
| Bipolar full-scale input | Положительное напряжение идеального входа при 100% единиц; по умолчанию 1 В |
Выход CIC нормируется на усиление `OSR**order`: нулевая плотность соответствует
−1, плотность 50% — нулю, 100% — +1. Напряжение равно нормированному значению,
умноженному на `Bipolar full-scale input`. Это идеальный масштаб модулятора,
который следует брать из его документации; напряжение питания и опорное напряжение
не обязательно совпадают с этим параметром. Код — биполярное целое в диапазоне
`−OSR**order … +OSR**order`, без привязки к разрядности конкретного АЦП.
В таблице результатов доступны нормированное значение и код, напряжение,
фильтрованная плотность единиц, частота CLK и выходная частота `CLK / OSR`.
Для sinc2/3 плотность взвешена фильтром и отличается от простого подсчёта
единиц последнего блока. Амплитуда восстанавливается и без метаданных частоты
захвата; частоты в герцах тогда не выводятся.
Начальные `order − 1` выходных блоков пропускаются до установления фильтра.
Неполный блок в конце записи не выдаётся. Аннотация охватывает фронты последнего
блока OSR; фильтр сохраняет причинную задержку и не сдвигает результат назад.
Групповая задержка sincN равна `N × (OSR − 1) / 2` периодов CLK.
Изменение выбранного фронта, инверсии или OSR требует повторного декодирования.
Поддерживается однобитный поток с отдельным CLK. Для готовых слов АЦП по SPI
используйте соответствующий SPI-декодер; Manchester без отдельного CLK здесь
не разбирается. Точность ограничена захватом: пропущенные тактовые фронты
невозможно восстановить автоматически.
Двухлинейный интерфейс и семейство sinc1/2/3 описаны в
[TI SDFM Interface Design](https://software-dl.ti.com/processor-industrial-sw/esd/motor_control_sdk/am243x/11_00_00_06/docs/api_guide_am243x/SDFM_DESIGN.html).
Реализация фильтра находится в `python/logic_analyzer/decoders/sigma_delta.py`.
Общая ведомость `protocol-files.json` включает адаптер и ядро в сборку DSView
и в `install_decoders.ps1`; после установки перезапустите DSView.
Проверки: `python -m unittest discover -s tools/dsview/tests -p test_sigma_delta.py -v`.
@@ -0,0 +1 @@
from .pd import Decoder # Стандартная точка входа sigrok загружает адаптер сигма-дельта потока из этого пакета.
+87
View File
@@ -0,0 +1,87 @@
"""Восстановление сигма-дельта потока DATA/CLK с децимацией sinc1, sinc2 или sinc3.""" # Адаптер использует API sigrok версии 3 и переносимое ядро фильтра.
import math # Проверка конечности исключает NaN и бесконечности в масштабе напряжения и частоте захвата.
import sigrokdecode as srd # DSView предоставляет каналы, ожидание фронтов и вывод аннотаций.
from common.setgui_decoders.sigma_delta import SigmaDeltaFilter # Установщик переносит каноническое ядро в закрытый пакет DSView.
class Decoder(srd.Decoder): # Один экземпляр анализирует один однобитный модулятор с отдельной тактовой линией.
api_version = 3 # Этот контракт поддерживается штатным libsigrokdecode DSView.
id = 'sigma_delta' # Постоянный идентификатор используется установщиком, меню и сохранёнными сессиями.
name = 'Sigma-delta' # Короткое имя доступно в штатном поиске декодеров DSView.
longname = 'Sigma-delta / PDM with clock' # Полное имя уточняет формат однобитного потока с внешним CLK.
desc = 'Reconstructs a clocked 1-bit sigma-delta stream using sinc1/2/3 decimation.' # Описание отличает вход модулятора от готовых слов АЦП по SPI.
license = 'gplv2+' # Лицензия согласована с соседними адаптерами sigrok.
inputs = ['logic'] # Декодер подключается непосредственно к цифровым линиям захвата.
outputs = ['sigma_delta'] # Структурированные отсчёты могут использоваться последующим Python-декодером.
tags = ['Util'] # Общая категория поддерживается стандартными установками sigrok.
channels = ( # Оба сигнала обязательны, поскольку плотность единиц измеряется по тактам, а не длительности импульсов.
{'id': 'data', 'name': 'DATA', 'desc': 'Sigma-delta bit stream'}, # Первый вход содержит уровень однобитного модулятора.
{'id': 'clk', 'name': 'CLK', 'desc': 'Modulator clock'}, # Второй вход определяет моменты приёма DATA.
) # Отдельные экземпляры декодера позволяют анализировать несколько модуляторов с общим CLK.
options = ( # Настройки сохраняются обычным механизмом DSView без внешних файлов.
{'id': 'clock_edge', 'desc': 'Sampling edge', 'default': 'rising', 'values': ('rising', 'falling')}, # Фронт выбирается согласно документации подключённого модулятора.
{'id': 'filter', 'desc': 'Decimation filter', 'default': 'sinc3', 'values': ('sinc1', 'sinc2', 'sinc3')}, # Более высокий порядок сильнее подавляет высокочастотную составляющую потока.
{'id': 'decimation', 'desc': 'Decimation / OSR (clock cycles)', 'default': 256}, # R входных тактов формируют один выходной отсчёт; допустимы значения 1–65536.
{'id': 'invert', 'desc': 'Invert DATA', 'default': 'no', 'values': ('no', 'yes')}, # Инверсия меняет полярность до прохождения фильтра.
{'id': 'full_scale', 'desc': 'Bipolar full-scale input (V)', 'default': 1.0}, # Это идеальный вход при 100 процентах единиц, а не обязательно напряжение питания или опоры.
) # По умолчанию напряжение численно совпадает с нормированной амплитудой при масштабе ±1 В.
annotations = ( # Числовые строки работают и в standalone DSView без специальной нативной отрисовки.
('value', 'Normalized value'), # Индекс ноль показывает восстановленную биполярную амплитуду.
('voltage', 'Input voltage'), # Индекс один показывает амплитуду с заданным физическим масштабом.
('density', 'Filtered one density'), # Индекс два даёт фильтрованную плотность единиц для диагностики полярности.
('rate', 'Clock / output rate'), # Индекс три связывает частоту захваченного CLK с выходной частотой децимации.
) # Аннотации создаются на каждый установившийся полный выходной блок.
annotation_rows = ( # Каждая величина имеет независимую строку в таблице результатов.
('value', 'Value: -1 .. +1', (0,)), # Диапазон соответствует идеальным крайним плотностям ноль и единица.
('voltage', 'Input voltage', (1,)), # Размерность напряжения указана и в подписи каждого отсчёта.
('density', 'Filtered density', (2,)), # Для sinc2/3 это взвешенная плотность, а не простое число единиц последнего блока.
('rate', 'CLK / output rate', (3,)), # Частота доступна только при наличии метаданных частоты захвата.
) # Порядок строк сохраняет совпадение с индексами классов аннотаций.
def __init__(self): # DSView создаёт объект до передачи параметров и метаданных.
self.reset() # Новый анализ не наследует состояние предыдущего захвата.
def reset(self): # Частота захвата может отсутствовать: амплитуду всё равно можно восстановить по CLK.
self.samplerate = None # Пока метаданные не получены, частоты в герцах не вычисляются.
def metadata(self, key, value): # Частота захвата приходит отдельным сообщением движка sigrok.
if key == srd.SRD_CONF_SAMPLERATE: # Остальные метаданные не относятся к переводу номеров отсчётов в секунды.
if not math.isfinite(value) or value <= 0: # Частота должна быть конечной положительной величиной в отсчётах в секунду.
raise ValueError('Samplerate must be finite and positive.') # Некорректные метаданные не должны порождать деление на ноль.
self.samplerate = value # Частота используется только для измерений CLK и выходного потока.
def start(self): # Выходы регистрируются после создания объекта и до вызова decode.
self.out_ann = self.register(srd.OUTPUT_ANN) # Аннотации остаются доступны обычному окну результатов DSView.
self.out_python = self.register(srd.OUTPUT_PYTHON) # Числа передаются без потерь от форматирования текстовых подписей.
def decode(self): # Ожидание только выбранных фронтов уменьшает число обращений к движку захвата.
if not self.has_channel(0) or not self.has_channel(1): # Достоверное восстановление требует и DATA, и тактовой линии.
raise ValueError('Both DATA and CLK channels are required.') # Служебное значение отсутствующего входа нельзя считать реальными битами.
filters = {'sinc1': 1, 'sinc2': 2, 'sinc3': 3} # Отображение фиксирует число каскадов без разбора произвольной строки.
if self.options['filter'] not in filters or self.options['clock_edge'] not in ('rising', 'falling') or self.options['invert'] not in ('no', 'yes'): # Повреждённая сохранённая сессия должна явно сообщать о неверной настройке.
raise ValueError('Invalid filter, sampling edge or DATA polarity.') # Не подставляем другой режим фильтрации незаметно для пользователя.
state = SigmaDeltaFilter(self.options['decimation'], filters[self.options['filter']], self.options['invert'] == 'yes') # Ядро проверяет целочисленный OSR и сбрасывает память CIC.
full_scale = float(self.options['full_scale']) # Физический масштаб задаётся положительным напряжением идеального верхнего предела.
if not math.isfinite(full_scale) or full_scale <= 0: # Нулевой и неконечный масштаб делают физический результат бессмысленным.
raise ValueError('Bipolar full-scale input must be finite and positive.') # Отрицательная полярность задаётся отдельной опцией инверсии DATA.
edge = 'r' if self.options['clock_edge'] == 'rising' else 'f' # API sigrok обозначает нарастающий и спадающий фронты буквами r и f.
block_start, previous_sample = None, None # Границы блока и предыдущий такт нужны для аннотаций и измерения частоты.
while True: # Завершение захвата останавливает wait штатным механизмом sigrok без дополнения неполного блока.
pins = list(self.wait({1: edge})) # Копируем уровни выбранного фронта в список: DSView повторно заполняет внутренний tuple и требует освобождать его до следующего wait.
sample = self.samplenum # Номер отсчёта задаёт фактически наблюдавшееся время фронта.
if state.phase == 0: # Первый бит очередного блока определяет его начало независимо от прогрева фильтра.
block_start = sample # Начальный уровень записи до первого фронта не считается битом.
event = state.feed(pins[0]) # В фильтр поступает именно дискретный уровень DATA, без интегрирования ширины импульса.
if event is not None: # Первые N минус один блоков и неполные окна намеренно не создают результата.
intervals = state.decimation - 1 # Между R захваченными фронтами находится R минус один полный период CLK.
elapsed = sample - block_start if intervals else sample - previous_sample if previous_sample is not None else 0 # При R=1 частота измеряется между соседними выходными отсчётами.
clock = self.samplerate * (intervals or 1) / elapsed if self.samplerate and elapsed > 0 else None # Начальный одиночный фронт не позволяет достоверно измерить частоту.
event.update(voltage=event['value'] * full_scale, clock_hz=clock, output_hz=clock / state.decimation if clock is not None else None) # Напряжение и частота вычисляются из фильтрованной амплитуды и захваченного CLK.
event.update(decimation=state.decimation, order=state.order) # Структурированный результат содержит параметры для однозначной интерпретации кода.
self.put(block_start, sample, self.out_ann, [0, ['Value={:+.6f} code={}/{}'.format(event['value'], event['code'], event['gain']), '{:+.6f}'.format(event['value'])]]) # Точная шкала кода явно показывает усиление R**N.
self.put(block_start, sample, self.out_ann, [1, ['Input={:+.9g} V'.format(event['voltage']), '{:+.6g} V'.format(event['voltage'])]]) # Физическое значение сохраняет знак биполярного модулятора.
self.put(block_start, sample, self.out_ann, [2, ['Filtered ones={:.6f}%'.format(event['density'] * 100), '{:.3f}%'.format(event['density'] * 100)]]) # Множитель сто переводит долю единиц в проценты.
if clock is not None: # Без частоты захвата вывод амплитуды продолжается, а строка герц остаётся пустой.
self.put(block_start, sample, self.out_ann, [3, ['CLK={:.9g} Hz output={:.9g} Hz'.format(clock, event['output_hz'])]]) # Частота децимации равна частоте CLK, делённой на OSR.
self.put(block_start, sample, self.out_python, ['SAMPLE', event]) # Следующий декодер получает один пакет на каждый действительный результат фильтра.
previous_sample = sample # Запоминаем предыдущий реальный фронт даже во время начального установления.