Files
templates/python/set_devices/firmware.py
T
Andrey afdf62cfa4 Добавить проверку Flash SCI, системные диалоги и векторизацию PDF
Расширить протокол SCI проверкой содержимого Flash и комплектом RAM-ядер.
Добавить утилиту векторизации PDF с OCR, общие диалоги DSView и проверки.
2026-11-18 16:03:53 +03:00

96 lines
5.0 KiB
Python

# Клиентское представление образа и подготовки передачи прошивки. Парсинг и проверки образа
# отделены от физического программатора; этап передачи использует уже проверенные данные и
# метаданные.
"""@file firmware.py
@brief Проверка образов и переносимая машина блочной передачи прошивки.
Реализует загрузку и валидацию образов прошивки из различных форматов файлов,
проверку целостности данных, и логику передачи образов на устройство.
"""
from __future__ import annotations
from dataclasses import dataclass
from pathlib import Path
from firmware_image.core import FirmwareImageError, contiguous_image, image_digest
@dataclass(frozen=True)
class FirmwareImage:
"""@brief Загруженный образ прошивки с метаданными.
@param path Путь к исходному файлу образа
@param data Бинарные данные образа
@param base_address Адрес начала загрузки (для Intel HEX формата)
@param version Номер версии прошивки
"""
path: Path
data: bytes
base_address: int = 0
version: int = 0
@property
def crc32(self) -> int:
return int(image_digest(self.data)[0], 16)
@property
def sha256(self) -> str:
return image_digest(self.data)[1].lower()
@classmethod
def load(cls, path: str | Path, maximum_size: int = 2 * 1024 * 1024) -> "FirmwareImage":
file_path = Path(path)
raw = file_path.read_bytes()
if file_path.suffix.lower() == ".hex":
data, base = _parse_intel_hex(raw, maximum_size)
elif file_path.suffix.lower() == ".bin":
data, base = raw, 0
else:
raise FirmwareImageError("Поддерживаются только .bin и Intel HEX")
if not data:
raise FirmwareImageError("Образ пуст")
if len(data) > maximum_size:
raise FirmwareImageError(f"Размер образа превышает {maximum_size} байт")
return cls(file_path, data, base)
@classmethod # Отдельный маршрут C2000 не меняет байтовую адресацию Intel HEX других микроконтроллеров.
def load_c2000(cls, path, maximum_size=1024 * 1024): # Принимает прежний HEX C2Prog и бинарный/ASCII SCI8 без соседнего manifest.
from protocan.c2000_sci import decode, validate # Единственный C-парсер проверяет checksum, словные адреса и порядок октетов TI.
file_path = Path(path) # Сохраняет исходный путь для SHA-256 и повторного чтения перед аппаратным подтверждением.
with file_path.open('rb') as stream: raw = stream.read(maximum_size + 1) # Ограничивает чтение старых файлов до одного МиБ, как подготовка SCI-панели.
if not raw or len(raw) > maximum_size: raise FirmwareImageError('Пустой или слишком большой образ C2000') # Не выделяет дополнительные буферы для неподходящего размера.
try: validate(decode(raw), True) # Проверяет весь результат до изменения выбранного образа или контролов основной формы.
except ValueError as error: raise FirmwareImageError(str(error)) from error # Обычный диалог файла показывает конкретную ошибку HEX или защищённого адреса.
return cls(file_path, raw, 0) # SHA и CRC относятся к исходному файлу; словные адреса передаются внутри проверенной SCI8-таблицы.
def _parse_intel_hex(text: str, maximum_size=2 * 1024 * 1024) -> tuple[bytes, int]:
return contiguous_image(text, maximum_size)
@dataclass
class FirmwareTransfer:
image: FirmwareImage
block_size: int = 480
offset: int = 0
def next_block(self) -> tuple[int, bytes] | None:
if self.offset >= len(self.image.data):
return None
offset = self.offset
return offset, self.image.data[offset : offset + self.block_size]
def acknowledge(self, next_offset: int) -> None:
current = self.next_block()
if current is None or next_offset != current[0] + len(current[1]):
raise FirmwareImageError("МК подтвердил неожиданный offset")
self.offset = next_offset
@property
def percent(self) -> int:
return int(self.offset * 100 / len(self.image.data))