Расширить DSView осциллографом и декодерами двигателя и сигма-дельта
This commit is contained in:
@@ -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 регистрирует декодер асинхронного двигателя.
|
||||
@@ -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) # Последний диагностический интервал сохраняется даже при неизменных ключах.
|
||||
@@ -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`.
|
||||
|
||||
@@ -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 загружает адаптер сигма-дельта потока из этого пакета.
|
||||
@@ -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 # Запоминаем предыдущий реальный фронт даже во время начального установления.
|
||||
Reference in New Issue
Block a user