Files
templates/tools/dsview/tests/test_pwm_motor.py
T

180 lines
28 KiB
Python

"""Независимые электрические проверки модели двигателя и цифрового адаптера.""" # Проверки не требуют анализатора, GUI или установленного sigrok.
import cmath # Комплексное сопротивление схемы замещения даёт независимый эталон установившегося тока.
import importlib.util # Исходные модули загружаются напрямую из канонической поставки templates.
import math # Синусоидальные напряжения и допуски выражаются в физических единицах СИ.
from pathlib import Path # Пути вычисляются относительно самого набора тестов.
import sys # Заглушка sigrok действует только при импорте адаптера.
import types # Минимальный модуль окружения не зависит от установленного DSView.
import unittest # Проверки доступны в стандартном Python без сторонних зависимостей.
from unittest.mock import patch # Подмена импортов ограничивается контекстом одной проверки.
ROOT = Path(__file__).resolve().parents[3] # Корень templates содержит общую Python-модель и инструменты DSView.
SPEC = importlib.util.spec_from_file_location('motor_core_test', ROOT / 'python/logic_analyzer/decoders/pwm_motor.py') # Проверяется фактический исходник поставляемого физического ядра.
core = importlib.util.module_from_spec(SPEC) # Отдельное пространство имён исключает установленную устаревшую копию модели.
SPEC.loader.exec_module(core) # Классы модели доступны без импорта остальных протоколов проекта.
class MotorTests(unittest.TestCase): # Эталоны проверяют физические свойства, а не воспроизводят матричный алгоритм реализации.
def test_sine_matches_independent_steady_state_equivalent_circuit(self): # Установившийся ток сравнивается с классической Т-схемой замещения при разных скольжениях.
omega, peak, dt = math.tau * 50, 230.0, 0.0001 # Поле 50 Гц, фазная амплитуда 230 В и шаг представления 100 мкс задают независимый режим испытания.
for rpm in (0, 1440, 1500, 1560, -1440): # Неподвижный ротор, двигатель, синхронная скорость, рекуперация и реверс проверяют знак вращательных членов.
with self.subTest(rpm=rpm): # Ошибка указывает механическую скорость, при которой нарушен эталон.
motor = core.InductionMotor(speed_rpm=rpm) # Используются явно документированные примерные параметры двигателя.
for step in range(20000): # Две секунды позволяют затухнуть электрическим переходным процессам.
voltage = peak * cmath.exp(1j * omega * (step + 0.5) * dt) # Значение в середине интервала аппроксимирует непрерывный источник с малой известной погрешностью.
motor.advance(dt, core.phases(voltage)) # Воздействие подаётся как три реальных фазных напряжения.
slip = 1 - rpm * 2 * math.tau / 60 / omega # Две пары полюсов переводят механическую скорость ротора в относительное скольжение.
magnetizing = 1j * omega * 0.15 # Примерная взаимная индуктивность 150 мГн переводится в комплексное сопротивление на 50 Гц.
if abs(slip) < 1e-10: # При нулевом скольжении ветвь приведённого ротора имеет бесконечное активное сопротивление.
parallel = magnetizing # Остаётся только ток намагничивания и ток потерь статора.
else: # В остальных режимах роторная ветвь содержит активную часть Rr/s и индуктивность рассеяния.
rotor = 0.8 / slip + 1j * omega * 0.005 # 0,8 Ом и 5 мГн соответствуют независимой схеме замещения одной обмотки.
parallel = magnetizing * rotor / (magnetizing + rotor) # Параллельное соединение ветвей ротора и намагничивания вычисляется по закону Ома.
expected = peak / (1.0 + 1j * omega * 0.005 + parallel) # Последовательные потери статора и рассеяние дают эталон комплексного фазного тока.
self.assertLess(abs(motor.current - expected), abs(expected) * 0.002) # Амплитуда и фазовый сдвиг должны совпасть с независимым эталоном в пределах 0,2 процента.
def test_constant_voltage_matches_ohms_law_at_locked_rotor(self): # При постоянном токе и неподвижном роторе установившийся ток определяется сопротивлением статора.
motor = core.InductionMotor(speed_rpm=0) # Нулевая скорость исключает генераторную ЭДС вращения.
result = motor.advance(10, (100, -50, -50)) # Десять секунд значительно превосходят постоянные времени примерной машины.
self.assertAlmostEqual(result[0], 100, places=7) # При Rs=1 Ом напряжение 100 В создаёт ток 100 А.
self.assertAlmostEqual(sum(result), 0, places=12) # Трёхпроводная модель не создаёт паразитный ток нейтрали.
def test_transition_is_independent_of_plot_sampling(self): # Число точек графика не должно изменять физический ток при неизменном напряжении.
one, many = core.InductionMotor(), core.InductionMotor() # Начальные параметры и состояния обоих независимых двигателей одинаковы.
one.advance(0.05, (180, -130, -50)) # Один большой интервал проверяет устойчивость точного решения.
for step in range(500): # Второй расчёт разбивает те же 50 мс на небольшие участки.
many.advance(0.0001, (180, -130, -50)) # Физическое воздействие не меняется при добавлении выходных точек.
self.assertLess(abs(one.current - many.current), 1e-8) # Совпадение отделяет модельную точность от частоты отображения.
self.assertLess(abs(one.flux - many.flux), 1e-9) # Поток ротора также не зависит от выходной сетки.
def test_invalid_physical_parameters_are_rejected(self): # Неконечные и нефизические значения не должны доходить до матричной экспоненты.
for settings in ({'rs': 0}, {'rr': -1}, {'lls_mh': 0}, {'llr_mh': -1}, {'lm_mh': float('nan')}, {'pole_pairs': 1.5}, {'speed_rpm': float('inf')}): # Граничные условия проверяют разные физические входы.
with self.subTest(settings=settings), self.assertRaises(ValueError): # Для каждого некорректного параметра ожидается явная диагностика.
core.InductionMotor(**settings) # Ошибка должна обнаруживаться при создании модели.
class InverterTests(unittest.TestCase): # Электрическая топология проверяется отдельно от переходной модели двигателя.
def gates(self, upper, lower=None, inner=None): # Набор затворов следует публичному порядку входов адаптера.
return tuple(upper) + tuple(lower if lower is not None else [None] * 3) + tuple(inner if inner is not None else [None] * 6) # Необязательные входы отличаются от измеренного логического нуля.
def test_two_level_dc_voltage_scales_current(self): # Удвоение напряжения в линейной модели должно удвоить ток каждого проводника.
values = [] # Сохраняем две независимые оценки после одинакового переключения.
for dc in (300, 600): # Различается только полное напряжение между шинами звена.
model = core.PwmMotor(1000000, dc_voltage=dc) # Частота 1 МГц переводит 1000 отсчётов в одну миллисекунду.
model.update(0, self.gates((1, 0, 0))) # Первое состояние задаёт положительное линейное напряжение фазы A.
values.append(model.update(1000)[3]) # Постоянный участок рассчитывается даже без единого дополнительного фронта.
for small, large in zip(*values): # Каждая фаза должна соблюдать ту же линейную зависимость.
self.assertAlmostEqual(large, 2 * small, places=8) # Никакая нормировка графика не участвует в физических амперах.
def test_common_mode_voltage_does_not_drive_floating_star(self): # Одинаковое переключение всех плеч не создаёт линейных напряжений.
model = core.PwmMotor(1000) # Симметричная машина подключена звездой без нейтрального провода.
model.update(0, self.gates((1, 1, 1))) # Все выходы подключены к одной и той же положительной шине.
self.assertEqual(model.update(100)[3], (0, 0, 0)) # Синфазный ШИМ не должен вызывать ложный двигательному току сигнал.
def test_three_level_encoding_and_midpoint_imbalance(self): # P/N-кодировка должна различать плюс, среднюю точку и минус.
model = core.PwmMotor(1000, topology='3-level P/N', dc_voltage=600, midpoint_percent=60) # Дисбаланс 60/40 процентов создаёт шины +360 и −240 В.
model.update(0, self.gates((1, 0, 0), (0, 0, 1))) # Команды фаз равны 10, 00 и 01 соответственно.
self.assertEqual(model.poles, (360, 0, -240)) # Ни один из трёх уровней не выводится из заполнения других фаз.
self.assertEqual(model.warnings, ()) # Все три команды допустимы для P/N.
def test_npc_twelve_gates_match_signed_three_level_commands(self): # Реальные Q1…Q4 должны создавать те же напряжения, что явная кодировка P/N.
npc = core.PwmMotor(1000000, topology='3-level NPC') # Четыре ключа на фазу требуют двенадцати назначенных входов.
pn = core.PwmMotor(1000000, topology='3-level P/N') # Сравниваем электрическое воздействие, а не внутренние булевы поля.
npc.update(0, self.gates((1, 0, 0), (0, 0, 1), (1, 0, 1, 1, 0, 1))) # Q1…Q4 фаз A/B/C равны 1100, 0110 и 0011.
pn.update(0, self.gates((1, 0, 0), (0, 0, 1))) # P/N фаз A/B/C равны 10, 00 и 01.
self.assertEqual(npc.poles, pn.poles) # Разные входные кодировки должны давать одинаковые полюсные напряжения.
self.assertEqual(npc.update(1000)[3], pn.update(1000)[3]) # Совпадение физических токов проверяет весь путь до модели двигателя.
def test_delta_reports_line_currents(self): # Для тех же сопротивлений обмотки линейный постоянный ток треугольника втрое больше звезды.
values = [] # Сохраняем установившиеся токи двух схем подключения.
for connection in ('star', 'delta'): # Меняется соединение обмоток при одинаковых параметрах каждой обмотки.
model = core.PwmMotor(1000, connection=connection, speed_rpm=0) # Неподвижный ротор и постоянное напряжение дают простой независимый эталон.
model.update(0, self.gates((1, 0, 0))) # Полюсное напряжение инвертора одинаково в обоих опытах.
values.append(model.update(10000)[3]) # Десять секунд обеспечивают завершение электрического переходного процесса.
self.assertAlmostEqual(values[1][0], 3 * values[0][0], places=6) # График должен показывать именно ток провода, а не ток одной ветви треугольника.
def test_invalid_or_missing_gates_are_explicit(self): # Невозможные комбинации не должны выглядеть как достоверно рассчитанное напряжение.
model = core.PwmMotor(1000, topology='3-level P/N') # В этом режиме нижние команды всех фаз обязательны.
with self.assertRaises(ValueError): # Служебное отсутствие канала не равнозначно команде средней точки.
model.update(0, self.gates((1, 0, 0))) # Назначены только три верхних входа вместо шести.
model.update(0, self.gates((1, 0, 0), (1, 0, 0))) # Команда 11 в фазе A недопустима.
self.assertIn('invalid gates 11', model.warnings[0]) # Предупреждение должно содержать реальную ошибочную комбинацию.
with self.assertRaises(ValueError): # Время не может двигаться назад при потоковом декодировании.
model.update(-1) # Проверяется явная ошибка входной временной отметки.
def test_active_low_preserves_electrical_waveform(self): # Глобальная инверсия затворных сигналов не должна менять физическое воздействие.
high, low = core.PwmMotor(1000), core.PwmMotor(1000, active_high=False) # Различается только настройка активной полярности входов.
high.update(0, self.gates((1, 0, 0))) # Высокоактивный верхний ключ A подключает фазу к положительной шине.
low.update(0, self.gates((0, 1, 1))) # Инвертированные физические уровни задают те же включённые ключи.
self.assertEqual(high.update(10)[3], low.update(10)[3]) # Токи совпадают после нескольких периодических точек без фронтов.
def test_interval_warnings_belong_to_previous_gate_state(self): # Восстановление допустимой команды не должно скрывать ошибку предшествующего участка тока.
model = core.PwmMotor(1000, topology='3-level P/N') # Команды P/N позволяют явно подать невозможное одновременное включение.
model.update(0, self.gates((1, 0, 0), (1, 0, 0))) # На первом интервале фаза A имеет недопустимую комбинацию 11.
model.update(10, self.gates((1, 0, 0), (0, 0, 0))) # В конце интервала входы переключаются в допустимое состояние 10.
self.assertEqual(model.warnings, ()) # Новый интервал уже имеет определённое выходное напряжение.
self.assertIn('invalid gates 11', model.interval_warnings[0]) # Завершённый пакет сохраняет реальную недостоверность предыдущих десяти отсчётов.
class AdapterTests(unittest.TestCase): # Минимальный движок ожидания проверяет настоящий цикл decode на постоянном участке и на фронтах.
def decoder(self, settings=None): # Каждая проверка получает новый адаптер и собственный журнал выходов.
class FakeDecoder: # Совпадают только необходимые адаптеру публичные методы sigrok.
def register(self, kind): # Дескриптор позволяет различать аннотации и структурированный поток.
return kind # Нативная библиотека для этого теста не нужна.
def has_channel(self, index): # В базовом опыте назначены три двухуровневых верхних команды.
return index < 3 # Отсутствующие нижние ключи моделируются идеальными комплементарными парами.
def put(self, start, end, output, data): # Выходы собираются без изменения типов и единиц данных адаптера.
self.emitted.append((start, end, output, data)) # Время и содержимое доступны независимым утверждениям теста.
def wait(self, conditions): # Виртуальный захват содержит фронт на отсчёте 23 и заканчивается на отсчёте 103.
if conditions == {}: # Начальный запрос должен вернуть уровни без ожидания первого фронта.
self.samplenum = 0 # Область декодирования начинается с первого отсчёта.
else: # Следующее событие выбирается между фактическим фронтом и точкой периодической сетки.
boundary = self.samplenum + conditions[-1]['skip'] # Последнее условие адаптера задаёт максимальный интервал до новой точки.
self.samplenum = min(boundary, 23) if self.samplenum < 23 else boundary # Фронт не должен пропасть между узлами выходной сетки.
if self.samplenum > 103: # Окончание захвата не создаёт вымышленного полного выходного окна.
self.samplenum = 103 # Последний известный отсчёт используется штатным end.
raise EOFError # Тестовая остановка имитирует завершение wait в движке декодирования.
return ([1, 0, 0] if self.samplenum < 23 else [0, 1, 0]) + [255] * 9 # Уровни меняются одновременно; служебные 255 отсутствующих входов фильтруются адаптером.
stub = types.ModuleType('sigrokdecode') # Окружение импорта ограничено заглушкой публичных констант.
stub.Decoder, stub.OUTPUT_ANN, stub.OUTPUT_PYTHON, stub.SRD_CONF_SAMPLERATE = FakeDecoder, 0, 1, 10000 # Значения выходов различимы в журнале теста.
with patch.dict(sys.modules, {'sigrokdecode': stub, 'common.setgui_decoders.pwm_motor': core}): # Реальный адаптер связывается с фактической проверяемой моделью.
spec = importlib.util.spec_from_file_location('motor_adapter_test', ROOT / 'tools/dsview/decoders/pwm_motor/pd.py') # Загружается исходный модуль, который попадёт в runtime.
module = importlib.util.module_from_spec(spec) # Независимый экземпляр исключает влияние предыдущих настроек.
spec.loader.exec_module(module) # Определение класса выполняется в контролируемом окружении sigrok.
decoder = module.Decoder() # Состояние двигателя сбрасывается штатным конструктором.
decoder.options = {option['id']: option['default'] for option in decoder.options} # Настройки по умолчанию воспроизводят поведение диалога DSView.
decoder.options.update(settings or {}) # Проверка может изменить шкалу или частоту отображения.
decoder.emitted, decoder.samplenum = [], 0 # Выходной журнал и временная отметка начинаются с пустого захвата.
decoder.metadata(stub.SRD_CONF_SAMPLERATE, 1000000) # Частота 1 МГц задаёт 10 отсчётов на точку при выходе 100 кГц.
decoder.start() # Оба типа выхода регистрируются перед decode.
return decoder # Дальнейшая проверка запускает настоящий цикл адаптера.
def test_real_decode_keeps_edges_constant_spans_units_and_final_tail(self): # Один сценарий проверяет временную сетку, фронты, амперы и конец записи.
decoder = self.decoder() # Используются реальные настройки по умолчанию, включая частоту 100 кГц.
with self.assertRaises(EOFError): # Конец виртуальной записи штатно прерывает ожидание событий.
decoder.decode() # Выполняется фактический код адаптера без ручного вызова его внутренних методов.
decoder.samplenum, decoder.last_samplenum = 100, 103 # DSView сохраняет samplenum последнего wait и передаёт окончание записи отдельным атрибутом.
decoder.end() # Последний частичный интервал до отсчёта 103 должен быть сохранён.
packets = [event for event in decoder.emitted if event[2] == 1] # Структурированный поток содержит ненормированные линейные токи.
self.assertEqual(packets[0][0], 0) # Начальный постоянный участок до первого фронта не теряется.
self.assertEqual(packets[-1][1], 103) # Конец не округляется до следующего полного окна в 110 отсчётов.
self.assertIn(23, [event[1] for event in packets]) # Фронт между точками 20 и 30 должен завершить собственный сегмент.
self.assertTrue(all(event[3][1]['unit'] == 'A' and event[3][1]['estimated'] for event in packets)) # Амперы и расчётный характер доступны следующему анализатору.
self.assertTrue(all(abs(sum(event[3][1][key] for key in ('ia', 'ib', 'ic'))) < 1e-9 for event in packets)) # Все выходные точки соблюдают первый закон Кирхгофа.
warnings = [event for event in decoder.emitted if event[2] == 0 and event[3][0] == 3] # Диагностическая строка должна охватить всю оценённую запись.
self.assertEqual((warnings[0][0], warnings[-1][1]), (0, 103)) # Даже неизменная диагностика завершается при end.
def test_plot_clipping_keeps_unclipped_amperes(self): # Узкая шкала не должна ограничивать физический расчёт двигателя.
decoder = self.decoder({'plot_range_a': 0.001}) # Один миллиампер намного меньше токов выбранного испытательного напряжения.
with self.assertRaises(EOFError): # Виртуальная запись заканчивается тем же механизмом, что и обычный сценарий.
decoder.decode() # Адаптер рассчитывает ток, превышающий заданную графическую шкалу.
decoder.end() # Превышение шкалы должно попасть и в последний интервал диагностики.
packets = [event[3][1] for event in decoder.emitted if event[2] == 1] # Численные результаты извлекаются из структурированного выхода.
self.assertTrue(any(abs(packet['ia']) > 0.001 and packet['outside_plot_range'] for packet in packets)) # Истинные амперы сохраняются при насыщении только изображения.
curves = [event for event in decoder.emitted if event[2] == 0 and event[3][0] < 3] # Только графические классы используют служебный формат PWM1.
self.assertTrue(all(abs(float(value)) <= 1 for event in curves for value in event[3][1][-1].split()[1:])) # Координаты остаются совместимыми с ограниченным нативным индексом экстремумов.
if __name__ == '__main__': # Набор можно запускать отдельно от GUI и других тестов проекта.
unittest.main() # Код возврата отражает численные и интеграционные проверки.