mirror of
https://git.vladimir.cc/vladimir/ewsdr.git
synced 2026-08-25 17:27:32 +00:00
ew8bakandClaude Opus 5
f88b1615e7
Ноль на Unix и на Windows означает не одно и то же, и одной проверкой тут не обойтись. На Unix это законный дескриптор (при закрытом стандартном вводе fpOpen отдаёт именно его), а ядро Windows нулевой хендл не выдаёт никогда — там ноль это либо отказ RTL, либо неинициализированное поле. Внутренний путь был безопасен и раньше (SerOpen переводит ноль RTL в SER_INVALID_HANDLE, свои поля инициализируются им же), но публичный контракт для значения, пришедшего извне, оказывался неверным. Теперь проверка разведена по платформам. ★Стенд научился ПРОГОНЯТЬ windows-ветку, а не только компилировать её. Заглушка модуля Serial — чистый Паскаль, поэтому ветку можно собрать и запустить прямо на Linux: test/platform/win_probe проверяет перевод нулевого хендла в SER_INVALID_HANDLE, ответ SerValid и правило имени COM10+. До сих пор у windows-пути обёртки не было никакого поведенческого покрытия вовсе. Негативный контроль: если убрать windows-ветку из SerValid, прогон падает на «★нулевой хендл под Windows негоден». Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Bkwwyj7xVRrqnSVEseTRfV
Стенд последовательного порта
Проверяет обёртку SerialPort.pas на псевдотерминале: настоящего COM-порта
на сборочной машине нет, а проверить надо ровно то, на чём обжигается перенос —
как обёртка настраивает порт.
test/serial/run.sh
Что проверяется
- Открытие: несуществующий порт даёт
SER_INVALID_HANDLE(а не ноль и не случайное число), живой — годный хендл. - ★Дескриптор 0 — законный порт: стенд закрывает стандартный ввод, после
чего порт открывается именно как
0, и проверяет, что он считается годным и через него идут данные. Признак неудачи ровно один —SER_INVALID_HANDLE. Проверка вида «ноль = ошибка» теряла бы рабочий порт у демона и вдобавок не закрывала дескриптор (SerCloseсмотрит на ту же проверку). - ★Имя устройства для Windows:
COM10и вышеCreateFileоткрывает только в форме\\.\COM10— короткое имя система резолвит лишь дляCOM1..COM9, а у USB-переходников номер за десяток заезжает легко. Правило чистое (SerWinDeviceName), поэтому проверяется и на Linux: короткие имена не трогаются, длинные получают префикс, уже полная форма не удваивается, пути Unix не задеваются. - termios обратным чтением: скорость, стоп-биты,
CREAD/CLOCAL, сырой режим (нетICANON,ECHO,OPOST). - ★Аппаратный поток
CRTSCTSне включается сам — только по явной просьбе. Это главная проверка стенда: на кабеле без CTS случайно включённый CRTSCTS вешает передачу намертво, и никакой ошибки при этом нет. Ровно так ломается RTL-модульSerialна BSD и macOS — там B-константы это числа, а он кладёт их вc_cflag(подробнее — в шапкеSerialPort.pas). - ★В
c_cflagнет ничего, кроме наших флагов (маскаCBAUDснимается) — прямая ловушка на ту же ошибку. Негативный контроль: если вSerSetParamsдописатьor Cardinal(BitsPerSec), проверка падает с «1CAB0 против 8B0». - Формат (размер символа, чётность, стоп-биты, флаг потока) — через чистую
SerCFlags. Обратным чтением его не проверить: pty восьмибитно-чистый, ядро молча заменяетCS7наCS8и снимаетPARENB. - Обмен: запись и чтение в обе стороны, срок у
SerReadTimeout,CRне превращается вCR+LF, эха нет. - Сквозной прогон: байты на мастере → поток
CATSerial→TCATEngine→ ответ обратно (командойID, она отвечает константой и радио не трогает).
Чего стенд НЕ проверяет
Модемные линии DTR/RTS/CTS/DSR/CD/RI: ioctl TIOCM* на
псевдотерминале не работает. Это остаётся на живой порт с железкой — там же
проверяется и телеграфный ключ на CWKeyer.
Платформенные ветви (Windows, macOS) проверяет соседний стенд test/platform:
компиляцию обеих, а windows-ветку ещё и прогоном на заглушке модуля Serial —
перевод нулевого хендла RTL в SER_INVALID_HANDLE, ответ SerValid (там ноль
негоден, в отличие от Unix) и правило имени COM10+.