Andrey
f741741cf8
Добавить пояснения к исходникам, заголовкам TI, настройкам CCS и существующим проверкам. Зафиксировать правила кодировки, обзор модулей и аудит комментариев.
118 lines
10 KiB
Python
118 lines
10 KiB
Python
# Проверка ump_logger на модели пк. Комментарии и исходный текст в UTF-8.
|
||
# Продолжает текущий вызов, список или выражение: """Exercise the current board-specific SCI8 gate without TI tools or hardware."""; порядок аргументов сохраняется.
|
||
"""Exercise the current board-specific SCI8 gate without TI tools or hardware."""
|
||
# Импортирует необходимые имена: from pathlib import Path.
|
||
from pathlib import Path
|
||
# Подключает модуль struct для этой проверки или подготовки сборки.
|
||
import struct
|
||
# Подключает модуль subprocess для этой проверки или подготовки сборки.
|
||
import subprocess
|
||
# Подключает модуль sys для этой проверки или подготовки сборки.
|
||
import sys
|
||
# Подключает модуль tempfile для этой проверки или подготовки сборки.
|
||
import tempfile
|
||
# Подключает модуль unittest для этой проверки или подготовки сборки.
|
||
import unittest
|
||
|
||
# Задаёт ROOT по выражению справа; значение используется последующими операциями.
|
||
ROOT = Path(__file__).resolve().parents[2]
|
||
# Задаёт LIMIT по выражению справа; значение используется последующими операциями.
|
||
LIMIT = (0x3FFF - (128 + 1)) * 2
|
||
|
||
|
||
# Объявляет функцию image и её входные параметры.
|
||
def image(size):
|
||
# Задаёт header по выражению справа; значение используется последующими операциями.
|
||
header = struct.pack('<H', 0x08AA) + bytes(16) + struct.pack('<HH', 0, 0x8000)
|
||
# Задаёт blocks по выражению справа; значение используется последующими операциями.
|
||
blocks = max(1, (size-24+131075)//131076)
|
||
# Задаёт remaining по выражению справа; значение используется последующими операциями.
|
||
remaining = (size-24-blocks*6)//2
|
||
# Задаёт result по выражению справа; значение используется последующими операциями.
|
||
result = bytearray(header)
|
||
# Перебирает _ in range(blocks) в указанном порядке.
|
||
for _ in range(blocks):
|
||
# Задаёт words по выражению справа; значение используется последующими операциями.
|
||
words = min(65535, remaining)
|
||
# Задаёт result + по выражению справа; значение используется последующими операциями.
|
||
result += struct.pack('<HHH', words, 0, 0x8000) + bytes(words*2)
|
||
# Задаёт remaining - по выражению справа; значение используется последующими операциями.
|
||
remaining -= words
|
||
# Возвращает bytes(result)+bytes(2) вызывающему коду и завершает функцию.
|
||
return bytes(result)+bytes(2)
|
||
|
||
|
||
# Объявляет класс FirmwareGateTest для группировки проверок.
|
||
class FirmwareGateTest(unittest.TestCase):
|
||
# Объявляет функцию check_image и её входные параметры.
|
||
def check_image(self, data, success, profile="AT25256B"):
|
||
# Открывает управляемый ресурс tempfile.TemporaryDirectory() as directory с автоматическим освобождением.
|
||
with tempfile.TemporaryDirectory() as directory:
|
||
# Задаёт source по выражению справа; значение используется последующими операциями.
|
||
source = Path(directory) / 'candidate.bin'
|
||
# Сохраняет подготовленный файл в указанном формате для следующего шага.
|
||
source.write_bytes(data)
|
||
# Запускает внешний компилятор, генератор или тест; ненулевой результат проверяется параметрами вызова.
|
||
result = subprocess.run([
|
||
# Продолжает текущий вызов, список или выражение: sys.executable, str(ROOT / 'tests/gas167/check_image.py'),; порядок аргументов сохраняется.
|
||
sys.executable, str(ROOT / 'tests/gas167/check_image.py'),
|
||
# Продолжает текущий вызов, список или выражение: str(source), '--eeprom', profile,; порядок аргументов сохраняется.
|
||
str(source), '--eeprom', profile,
|
||
# Задаёт ], capture_output по выражению справа; значение используется последующими операциями.
|
||
], capture_output=True)
|
||
# Задаёт self.assertEqual(result.returncode по выражению справа; значение используется последующими операциями.
|
||
self.assertEqual(result.returncode == 0, success,
|
||
# Задаёт result.stderr.decode(errors по выражению справа; значение используется последующими операциями.
|
||
result.stderr.decode(errors='replace'))
|
||
# Читает исходный файл или образ для последующей проверки и разбора.
|
||
self.assertEqual(source.read_bytes(), data)
|
||
# Возвращает result.stdout + result.stderr вызывающему коду и завершает функцию.
|
||
return result.stdout + result.stderr
|
||
|
||
# Объявляет функцию test_exact_boundary_is_accepted и её входные параметры.
|
||
def test_exact_boundary_is_accepted(self):
|
||
# Продолжает текущий вызов, список или выражение: self.check_image(image(LIMIT), True); порядок аргументов сохраняется.
|
||
self.check_image(image(LIMIT), True)
|
||
|
||
# Объявляет функцию test_34a95bc5_size_is_rejected и её входные параметры.
|
||
def test_34a95bc5_size_is_rejected(self):
|
||
# Продолжает текущий вызов, список или выражение: self.check_image(image(32518), False); порядок аргументов сохраняется.
|
||
self.check_image(image(32518), False)
|
||
|
||
# Объявляет функцию test_missing_boot_terminator_is_rejected и её входные параметры.
|
||
def test_missing_boot_terminator_is_rejected(self):
|
||
# Продолжает текущий вызов, список или выражение: self.check_image(image(100)[:-2], False); порядок аргументов сохраняется.
|
||
self.check_image(image(100)[:-2], False)
|
||
|
||
# Объявляет функцию test_partial_block_is_rejected и её входные параметры.
|
||
def test_partial_block_is_rejected(self):
|
||
# Продолжает текущий вызов, список или выражение: self.check_image(image(100)[:-10], False); порядок аргументов сохраняется.
|
||
self.check_image(image(100)[:-10], False)
|
||
|
||
# Объявляет функцию test_m95_capacity_does_not_expand_code_ram и её входные параметры.
|
||
def test_m95_capacity_does_not_expand_code_ram(self):
|
||
# Задаёт diagnostic по выражению справа; значение используется последующими операциями.
|
||
diagnostic = self.check_image(image(261884), False, "M95M02")
|
||
# Продолжает текущий вызов, список или выражение: self.assertIn(b'outside code RAM', diagnostic); порядок аргументов сохраняется.
|
||
self.assertIn(b'outside code RAM', diagnostic)
|
||
# Продолжает текущий вызов, список или выражение: self.check_image(image(261886), False, "M95M02"); порядок аргументов сохраняется.
|
||
self.check_image(image(261886), False, "M95M02")
|
||
|
||
# Объявляет функцию test_m95_image_rejected_for_small_part и её входные параметры.
|
||
def test_m95_image_rejected_for_small_part(self):
|
||
# Продолжает текущий вызов, список или выражение: self.check_image(image(32734), True, "M95M02"); порядок аргументов сохраняется.
|
||
self.check_image(image(32734), True, "M95M02")
|
||
# Продолжает текущий вызов, список или выражение: self.check_image(image(32734), False, "AT25256B"); порядок аргументов сохраняется.
|
||
self.check_image(image(32734), False, "AT25256B")
|
||
|
||
# Объявляет функцию test_wrong_format_is_rejected и её входные параметры.
|
||
def test_wrong_format_is_rejected(self):
|
||
# Продолжает текущий вызов, список или выражение: self.check_image(bytes(100), False); порядок аргументов сохраняется.
|
||
self.check_image(bytes(100), False)
|
||
|
||
|
||
# Проверяет условие if __name__ == '__main__' перед выполнением следующего блока.
|
||
if __name__ == '__main__':
|
||
# Продолжает текущий вызов, список или выражение: unittest.main(); порядок аргументов сохраняется.
|
||
unittest.main()
|