ewsdr/test/serial

Стенд последовательного порта

Проверяет обёртку 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+.