Andrey
f741741cf8
Добавить пояснения к исходникам, заголовкам TI, настройкам CCS и существующим проверкам. Зафиксировать правила кодировки, обзор модулей и аудит комментариев.
77 lines
8.0 KiB
Python
77 lines
8.0 KiB
Python
# Проверка ump_logger на модели пк. Комментарии и исходный текст в UTF-8.
|
||
# Продолжает текущий вызов, список или выражение: """Сборка и запуск исходного регистратора с подменой GPIO/IRQ на Windows.; порядок аргументов сохраняется.
|
||
"""Сборка и запуск исходного регистратора с подменой GPIO/IRQ на Windows.
|
||
|
||
Нужны GCC либо Clang и lld-link в PATH. TEMPLATES_ROOT задаёт библиотеку. Проверяется алгоритм, но не ABI и тайминги TI.
|
||
DLL создаётся во временной папке; исходные .out/.hex прошивки не затрагиваются.
|
||
"""
|
||
# Подключает модуль ctypes для этой проверки или подготовки сборки.
|
||
import ctypes
|
||
# Подключает модуль os для этой проверки или подготовки сборки.
|
||
import os
|
||
# Импортирует необходимые имена: from pathlib import Path.
|
||
from pathlib import Path
|
||
# Подключает модуль subprocess для этой проверки или подготовки сборки.
|
||
import subprocess
|
||
# Подключает модуль shutil для этой проверки или подготовки сборки.
|
||
import shutil
|
||
# Подключает модуль tempfile для этой проверки или подготовки сборки.
|
||
import tempfile
|
||
|
||
# Задаёт root по выражению справа; значение используется последующими операциями.
|
||
root = Path(__file__).resolve().parents[2]
|
||
# Задаёт templates по выражению справа; значение используется последующими операциями.
|
||
templates = Path(os.environ.get('TEMPLATES_ROOT', root.parent / 'newProject/SETGUI/third_party/templates'))
|
||
# Задаёт protocol по выражению справа; значение используется последующими операциями.
|
||
protocol = templates / 'c/set-protocol'
|
||
# Задаёт compiler по выражению справа; значение используется последующими операциями.
|
||
compiler = os.environ.get('CC') or shutil.which('clang') or shutil.which('gcc')
|
||
# Проверяет условие if not compiler перед выполнением следующего блока.
|
||
if not compiler:
|
||
# Останавливает текущую операцию с исключением SystemExit('Clang or GCC is required in PATH').
|
||
raise SystemExit('Clang or GCC is required in PATH')
|
||
# Задаёт link_flags по выражению справа; значение используется последующими операциями.
|
||
link_flags = [] if 'gcc' in Path(compiler).name else ['-nostdlib', '-fuse-ld=lld', '-Wl,/noentry,/nodefaultlib']
|
||
# Открывает управляемый ресурс tempfile.TemporaryDirectory(prefix='ump-recorder-') as directory с автоматическим освобождением.
|
||
with tempfile.TemporaryDirectory(prefix='ump-recorder-') as directory:
|
||
# Exercise the production identity binding too, using a build-local header.
|
||
# Запускает внешний компилятор, генератор или тест; ненулевой результат проверяется параметрами вызова.
|
||
subprocess.run([
|
||
# Продолжает текущий вызов, список или выражение: os.sys.executable, str(root / 'UKSSTMS320F28335/prepare_identity.py'),; порядок аргументов сохраняется.
|
||
os.sys.executable, str(root / 'UKSSTMS320F28335/prepare_identity.py'),
|
||
# Продолжает текущий вызов, список или выражение: '--project', str(root / 'UKSSTMS320F28335'), '--templates', str(templates),; порядок аргументов сохраняется.
|
||
'--project', str(root / 'UKSSTMS320F28335'), '--templates', str(templates),
|
||
# Продолжает текущий вызов, список или выражение: '--output', directory,; порядок аргументов сохраняется.
|
||
'--output', directory,
|
||
# Задаёт ], check по выражению справа; значение используется последующими операциями.
|
||
], check=True)
|
||
# Задаёт library по выражению справа; значение используется последующими операциями.
|
||
library = Path(directory) / 'recorder_test.dll'
|
||
# Запускает внешний компилятор, генератор или тест; ненулевой результат проверяется параметрами вызова.
|
||
subprocess.run([
|
||
# Продолжает текущий вызов, список или выражение: compiler, '-shared', *link_flags, '-Wno-unknown-pragmas', '-Wno-int-to-pointer-cast',; порядок аргументов сохраняется.
|
||
compiler, '-shared', *link_flags, '-Wno-unknown-pragmas', '-Wno-int-to-pointer-cast',
|
||
# Продолжает текущий вызов, список или выражение: '-Itests/ump_logger/stubs', '-ISource/Internal/Include',; порядок аргументов сохраняется.
|
||
'-Itests/ump_logger/stubs', '-ISource/Internal/Include',
|
||
# Продолжает текущий вызов, список или выражение: '-I' + str(protocol), '-I' + str(protocol / 'ports/tms320f28335'),; порядок аргументов сохраняется.
|
||
'-I' + str(protocol), '-I' + str(protocol / 'ports/tms320f28335'),
|
||
# Продолжает текущий вызов, список или выражение: '-I' + str(templates / 'c/firmware-info/include'), '-I' + directory,; порядок аргументов сохраняется.
|
||
'-I' + str(templates / 'c/firmware-info/include'), '-I' + directory,
|
||
# Продолжает текущий вызов, список или выражение: 'tests/ump_logger/recorder_test.c', 'Source/Internal/shared_ump.c', '-o', str(library),; порядок аргументов сохраняется.
|
||
'tests/ump_logger/recorder_test.c', 'Source/Internal/shared_ump.c', '-o', str(library),
|
||
# Задаёт ], cwd по выражению справа; значение используется последующими операциями.
|
||
], cwd=root, check=True)
|
||
# Отдельный процесс освобождает DLL до удаления временной папки Windows.
|
||
# Запускает внешний компилятор, генератор или тест; ненулевой результат проверяется параметрами вызова.
|
||
subprocess.run([
|
||
# Продолжает текущий вызов, список или выражение: os.sys.executable, '-c',; порядок аргументов сохраняется.
|
||
os.sys.executable, '-c',
|
||
# Задаёт 'import ctypes,sys; r по выражению справа; значение используется последующими операциями.
|
||
'import ctypes,sys; r=ctypes.CDLL(sys.argv[1]).run_tests(); '
|
||
# Задаёт 'print("PASS" if r по выражению справа; значение используется последующими операциями.
|
||
'print("PASS" if r==0 else f"FAIL: C line {r}"); sys.exit(bool(r))',
|
||
# Продолжает текущий вызов, список или выражение: str(library),; порядок аргументов сохраняется.
|
||
str(library),
|
||
# Задаёт ], check по выражению справа; значение используется последующими операциями.
|
||
], check=True)
|