feat(serial): своя обёртка последовательного порта — macOS собирается

RTL-модуль Serial собирается только для [android, linux, netbsd, openbsd,
win32, win64] — Darwin в списке нет (rtl-extra/fpmake.pp). Из-за этого под
macOS CAT по последовательному порту стоял заглушкой, а CWKeyer не собирался
вовсе.

★Скопировать чужой исходник было нельзя. Serial.SerSetParams кладёт B-константу
скорости прямо в c_cflag — идиома Linux, где это битовая маска. На BSD и macOS
B115200 это просто ЧИСЛО 115200, и в c_cflag прилетает $1C200: CLOCAL | HUPCL |
CCTS_OFLOW плюс мусор в поле CSIZE. Молча включается аппаратный CTS-flow, и
передача встаёт, если железка не держит CTS, — а ошибки никакой, порт
«открылся».

Новый SerialPort.pas:
* Unix — termios напрямую, Linux и macOS ОДНИМ путём (разница спрятана в
  константах RTL; Darwin даёт и termio, и все TIOCM_*). Скорость только через
  CFSetISpeed/CFSetOSpeed, c_cflag собирается с нуля чистой SerCFlags;
  CRTSCTS — исключительно по явной просьбе; сырой режим и VMIN/VTIME явные;
  open с O_NONBLOCK и снятием флага сразу после (часть USB-драйверов, как и
  tty-устройство на маке, висит в open до DCD).
* Windows — тонкая переадресация в RTL Serial: там он есть и в termios не лезет.
* Неуспех SerOpen на ВСЕХ платформах даёт SER_INVALID_HANDLE (RTL возвращал 0
  под Windows и −1 под Unix, из-за чего вызывающие держали свои развилки).
  Проверка — SerValid.

Точки вызова: CATSerial и CWKeyer переведены на обёртку, заглушка
CAT_SERIAL_STUB и платформенные {$IFDEF} вокруг хендлов убраны. Имена портов по
умолчанию и подсказка в настройках теперь платформенные (SerDefaultPortName /
SerPortNameHint): на маке порт зовётся /dev/cu.usbserial-XXXX, и '/dev/ttyS0'
там — заведомо неверная подсказка; осмысленного умолчания не существует,
поэтому пусто.

Новый стенд test/serial (36 проверок) — на псевдотерминале: открытие, termios
обратным чтением, ★«CRTSCTS сам не включился», ★«в c_cflag нет ничего, кроме
наших флагов», формат через чистую SerCFlags (обратным чтением его не
проверить: pty восьмибитно-чистый и молча меняет CS7 на CS8), обмен, срок
таймаута, CR не превращается в CR+LF, эха нет, и сквозной прогон CAT через
обёртку. Негативный контроль: с `or Cardinal(BitsPerSec)` в SerSetParams (та
самая идиома, что ломает RTL на BSD) проверка c_cflag падает — «1CAB0 против
8B0».

test/platform расширен: теперь сим-компилирует и SerialPort, для его
Windows-ветки добавлена заглушка модуля Serial с теми же сигнатурами.

Модемные линии (DTR/RTS/CTS/DSR/CD/RI) на pty не проверяются — ioctl TIOCM*
там не работает; это остаётся на живой порт.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Bkwwyj7xVRrqnSVEseTRfV
This commit is contained in:
2026-08-24 22:09:44 +03:00
co-authored by Claude Opus 5
parent f2ecd63fe1
commit 05ba39fdad
11 changed files with 943 additions and 122 deletions
+8 -8
View File
@@ -39,7 +39,7 @@ unit CWKeyer;
interface
uses
Classes, SysUtils, SyncObjs, Math, Serial, CWMorse;
Classes, SysUtils, SyncObjs, Math, SerialPort, CWMorse;
const
CW_SIDETONE_RATE = 48000; // rate огибающей сайдтона (аудиотракт PC)
@@ -912,7 +912,7 @@ end;
constructor TCWKeyPort.Create;
begin
FLock := TCriticalSection.Create;
FHandle := 0;
FHandle := SER_INVALID_HANDLE;
FreeOnTerminate := False;
inherited Create(False);
end;
@@ -972,13 +972,13 @@ end;
procedure TCWKeyPort.ClosePort;
begin
if FHandle > 0 then
if SerValid(FHandle) then
begin
SerSetDTR(FHandle, False);
SerSetRTS(FHandle, False);
SerClose(FHandle);
end;
FHandle := 0;
FHandle := SER_INVALID_HANDLE;
end;
function TCWKeyPort.OpenPort(const C: TCWKeyPortConfig): Boolean;
@@ -986,9 +986,9 @@ begin
Result := False;
if C.Port = '' then Exit;
FHandle := SerOpen(C.Port);
if FHandle <= 0 then
if not SerValid(FHandle) then
begin
FHandle := 0;
FHandle := SER_INVALID_HANDLE;
SetErr('cannot open ' + C.Port);
Exit;
end;
@@ -1039,12 +1039,12 @@ begin
if not C.Enabled then
begin
if FHandle > 0 then begin Release; ClosePort; end;
if SerValid(FHandle) then begin Release; ClosePort; end;
Sleep(100);
Continue;
end;
if FHandle <= 0 then
if not SerValid(FHandle) then
begin
// Переоткрытие раз в 2 с: адаптер могли воткнуть уже после старта.
if GetTickCount64 < Retry then begin Sleep(100); Continue; end;