Files
templates/python/automotive/__init__.py
T
Andrey 4825465583 Добавить общее ядро автомобильной диагностики и порт SETGUI
Вынести ISO-TP, OBD-II, UDS, профили, сервисный автомат, журнал и симулятор программирования в переносимый модуль C11.

Добавить единый ABI и тонкий Python-порт, переносимые тесты и независимую сборку CMake. Оставить неподтверждённые фирменные команды и реальную запись ECU отключёнными.
2026-11-17 17:31:28 +03:00

46 lines
9.3 KiB
Python

import ctypes as ct # C ABI является единственным источником протокольных правил, формул и диагностических состояний.
from pathlib import Path # Приложение передаёт абсолютный путь к отдельной automotive DLL.
class Event(ct.Structure): # Структура отражает только стабильный ABI, а не внутреннее устройство протокольных контекстов.
_fields_ = [(name, ct.c_uint32) for name in ('kind', 'ecu', 'service', 'parameter', 'code')] + [('value', ct.c_int32), ('text', ct.c_char * 96)] # Типы и порядок точно соответствуют auto_event_t версии ABI 1.
@property # Декодирование UTF-8 является преобразованием представления, без интерпретации протокольных байтов.
def message(self): return bytes(self.text).decode('utf-8', errors='replace') # Числовой исходник кода сохраняется независимо от локализованного текста.
class DiagnosticEngine: # Тонкий host-порт хранит буфер C и сигнатуры функций без алгоритмического fallback.
def __init__(self, library): # Отсутствующая библиотека делает действия недоступными и не заменяется Python-кодеком.
self.library = ct.CDLL(str(Path(library).resolve())) # Загружает отдельную библиотеку, не заменяя SETProtocol уже работающих вкладок.
signatures = {'diagnostic_abi_version': (ct.c_uint32, []), 'diagnostic_context_size': (ct.c_uint32, []), 'diagnostic_init': (ct.c_int, [ct.c_void_p, ct.c_uint32]), 'diagnostic_enable': (None, [ct.c_void_p, ct.c_int]), 'diagnostic_request': (ct.c_int, [ct.c_void_p, ct.c_uint32, ct.c_uint32, ct.c_uint32, ct.c_int, ct.c_uint32]), 'diagnostic_scan': (ct.c_int, [ct.c_void_p, ct.c_uint32]), 'diagnostic_uds': (ct.c_int, [ct.c_void_p, ct.c_uint32, ct.c_uint32, ct.c_uint32, ct.c_uint32]), 'diagnostic_feed': (None, [ct.c_void_p, ct.c_uint32, ct.c_void_p, ct.c_uint32, ct.c_int, ct.c_uint32]), 'diagnostic_poll': (None, [ct.c_void_p, ct.c_uint32]), 'diagnostic_busy': (ct.c_int, [ct.c_void_p]), 'diagnostic_supported': (ct.c_int, [ct.c_void_p, ct.c_uint32, ct.c_uint32]), 'diagnostic_pid_count': (ct.c_uint32, []), 'diagnostic_pid_code': (ct.c_uint32, [ct.c_uint32]), 'diagnostic_pid_name': (ct.c_char_p, [ct.c_uint32]), 'diagnostic_pid_unit': (ct.c_char_p, [ct.c_uint32]), 'diagnostic_error': (None, [ct.c_void_p, ct.c_uint32]), 'diagnostic_event': (ct.c_int, [ct.c_void_p, ct.POINTER(Event)]), 'diagnostic_tx': (ct.c_int, [ct.c_void_p, ct.POINTER(ct.c_uint32), ct.c_void_p, ct.POINTER(ct.c_uint32), ct.POINTER(ct.c_uint32)])} # Механическое описание типов исключает усечение указателей на 64-битной Windows.
for name, (result, arguments) in signatures.items(): function = getattr(self.library, name); function.restype = result; function.argtypes = arguments # Все вызовы получают явный ABI до первого обращения к контексту.
if self.library.diagnostic_abi_version() != 1: raise RuntimeError('Неподдерживаемая версия automotive ABI') # Несовместимая DLL не используется молча.
self.memory = ct.create_string_buffer(self.library.diagnostic_context_size()) # Память контекста принадлежит экземпляру порта и живёт до его уничтожения.
self.check(self.library.diagnostic_init(self.memory, len(self.memory))) # C проверяет размер, выравнивание и создаёт пассивный контекст.
@staticmethod # Обработка результатов не воспроизводит диагностический протокол.
def check(status): # Значения соответствуют общим diag_status_t публичного ABI.
if status != 0: raise RuntimeError(f'Диагностика: статус {status}') # Ошибка не подменяется физическим значением ноль.
def enable(self, enabled): self.library.diagnostic_enable(self.memory, bool(enabled)) # Само разрешение не создаёт кадров.
def scan(self, now): return self.library.diagnostic_scan(self.memory, now) # Поиск и PID-карты целиком обрабатываются C-ядром.
def request(self, service, parameter, target, now, confirmed=False): return self.library.diagnostic_request(self.memory, service, parameter, target, confirmed, now) # Подтверждение сброса передаётся только после отдельного действия UI.
def uds(self, target, service, parameter, now): return self.library.diagnostic_uds(self.memory, target, service, parameter, now) # Запрещённый SID будет отклонён внутри C независимо от UI.
def feed(self, identifier, data, extended, now): # Преобразует транспортные байты в указатель ABI, не разбирая PCI/SID/PID.
data = bytes(data); buffer = ct.create_string_buffer(data); self.library.diagnostic_feed(self.memory, identifier, buffer, len(data), extended, now) # C сам проверяет Classic CAN DLC до копирования payload.
def poll(self, now): self.library.diagnostic_poll(self.memory, now) # Монотонное время Qt передаётся непосредственно автоматам C.
@property # Планировщику UI нужен только признак занятости, а не внутренние состояния ISO-TP.
def busy(self): return bool(self.library.diagnostic_busy(self.memory)) # Сканирование диапазонов PID также считается занятым состоянием.
def supported(self, target, pid): return self.library.diagnostic_supported(self.memory, target, pid) # Неизвестная карта остаётся -1, а не превращается в разрешение опроса.
def catalog(self): # Создаёт только представление неизменяемого C-каталога.
return [(self.library.diagnostic_pid_code(i), self.library.diagnostic_pid_name(i).decode('utf-8'), self.library.diagnostic_pid_unit(i).decode('utf-8')) for i in range(self.library.diagnostic_pid_count())] # Формулы и список PID не копируются в Python.
def outputs(self): # Выдаёт готовые CAN-кадры до полного опустошения ограниченной C-очереди.
result = [] # Список содержит только транспортные поля, не новую диагностическую модель.
for _ in range(16): # Бюджет не даёт повреждённой DLL заблокировать GUI бесконечным перечислением.
identifier, length, extended = ct.c_uint32(), ct.c_uint32(), ct.c_uint32(); data = (ct.c_uint8 * 8)() # Каждый выходной буфер соответствует Classic CAN.
status = self.library.diagnostic_tx(self.memory, ct.byref(identifier), data, ct.byref(length), ct.byref(extended)) # Готовые wire-байты приходят из C.
if status == 1: break # DIAG_EMPTY завершает перечисление без ошибки.
self.check(status); result.append((identifier.value, bytes(data[:length.value]), bool(extended.value))) # Никакой дополнительный PCI или SID в Python не создаётся.
return result # Владелец адаптера обязан проверить результат фактического send.
def events(self): # Возвращает уже проверенные значения, VIN, DTC и диагностические ошибки.
result = [] # Очередь принадлежит C-контексту, а возвращаемые записи являются независимыми копиями.
for _ in range(128): # Ограничивает работу GUI при большой пачке событий.
entry = Event(); status = self.library.diagnostic_event(self.memory, ct.byref(entry)) # Размер записи закреплён версией ABI.
if status == 1: break # Пустая очередь не означает ошибку сеанса.
self.check(status); result.append(entry) # Физическое значение уже выражено в тысячных единицы C-каталога.
return result # Отображение не интерпретирует сырые ECU-ответы повторно.
def transport_error(self): self.library.diagnostic_error(self.memory, 6) # DIAG_IO отменяет сеанс после фактического разрыва адаптера.