Dosbox-staging: Включение поддержки Telnet для последовательных портов softmodem

Спасибо за проблемы с кодом программного модема @rswindell.

Пожалуйста, задокументируйте эту команду ATNET0 / 1

Мы упоминаем команду NET1 в README (см. Ниже), однако, возможно, ее можно было бы улучшить.

В github вы можете «форкнуть этот проект», отредактировать README прямо в вашей вилке (используя веб-редактор Github), а затем отправить нам свои изменения. Мы будем признательны за вашу помощь в тщательном документировании этого!

BBS Gaming
----------
DOSBox's serial interface can emulate a telephone modem, which allows original
DOS terminal applications to either dial or host a BBS on the Internet 
via the Telnet protocol.

First, configure DOSBox with a serial port emulating a modem:

   [serial]
   serial1 = modem listenport:2323

Next, launch your favorite DOS terminal or BBS hosting software and configure
its corresponding serial port with default settings, as follows:

  COM1:
    - COM port 1
    - 8N1 data-bits, stop-bits, and parity
    - 57600 baud
    - 03F8 address
    - IRQ4 interrupt
    - 16550 fifo enabled
    - Software flow control (Xon/Xoff) enabled
    - Hardware flow control (CTS/RTS) enabled
    - Hardware flow control (DSR/DTR) disabled

To dial BBSes on the Internet:

  1) Set your dialing prefix to: ATNET1^MATDT to ensure file-transfers
     and command mode transitions and handled properly.

  2) Set the phone number of the BBS to its hostname or IP, optionally
     followed by the Telnet port number, for example:

      - Phone number on non-standard port: remote.bbs.com:2323
      - Phone number on standard port 23: remote.bbs.com

To host a DOS-based BBS:

 1) Configure your DOSBox serial port to listen on a Telnet port greater
    than 1024. This allows you to run DOSbox with normal user privileges
    as opposed to granting it root or administrator privileges, for example:

    [serial]
    serial1 = modem listenport:2323

 2) Configure your DOSBox machine to use a static IP address or be assigned
    a static IP via DHCP, which can typically be configured in your router.

 3) If your DOSBox machine is behind a router/firewall, add a port-
    fowarding entry to listen on TCP port 23 and pass it through to
    port 2323 to your DOSBox machine's IP address.  This allows Internet
    users to "dial" your BBS using the default Telnet port.

Пожалуйста, исправьте синтаксический анализатор AT-команд: strstr () почти никогда не является тем, что вы действительно хотите использовать.

Что вы предлагаете заменить strstr() на, чтобы аналогичным образом обнаружить эту подстроку внутри потока (char*) ?

Пожалуйста, поддержите опцию « telnet: 1 » в файле .conf, чтобы включить поддержку telnet для «модемных» устройств по умолчанию.

Похоже, хорошее предложение. Значит, это будет "по умолчанию" устройство, как если бы NET1 было установлено с самого начала?

Что вы предлагаете заменить strstr () на аналогичное обнаружение этой подстроки внутри потока (char *)?

Команда синтаксического анализа АТ следует слева направо, поддержка нескольких команд в одной и той же строке (multple команды могут существовать между «AT» и «\ г»). Как сегодня написан синтаксический анализатор AT-команд в DOSbox, вы не можете подключиться к какому-либо имени хоста с помощью «net0» или «net1» где-либо внутри него. например, «ATD net1.vert.synchro.net» обрабатывается так, как если бы это был просто «ATNET1», что явно неверно (попытка дозвона / подключения не выполняется). Исправление могло бы состоять не только из простой замены strstr () вызовом какой-либо другой функции.

Похоже, хорошее предложение. Значит, это будет "по умолчанию" устройство, как если бы NET1 была установлена ​​с самого начала?

Здесь возникает вопрос: если параметр « telnet: 1 » присутствует в файле .conf, программный модем DOSbox будет вести себя так же, как если бы AT-команда «NET1» была установлена ​​с самого начала.

В настоящее время опция « telnet: 1 » поддерживается только для типа устройств «nullmodem».

Когда модем, совместимый с Hayes, получает команду 'D', все, что находится после (и до '\ r'), рассматривается как шаблон набора (например, номер телефона, IP-адрес, имя хоста). Проблема с использованием strstr () в этом случае заключается в том, что он пропускает (игнорирует) все, что находится перед шаблоном, который вы ищете, поэтому вы не знаете, был ли шаблон аргументом команды или самой командой. Синтаксическому анализатору команд необходимо обрабатывать все команды, следующие за "AT", в порядке (слева направо), и для любых команд, которые завершат синтаксический анализ (например, команда 'D'), завершать работу после обработки команды.

Проблема с тем, как синтаксический анализ команд «NET0» или «NET1» реализован в DOSbox, не является уникальной для команды «D», я просто использовал это в качестве примера. Любые AT-команды, идущие до или после «NET0» или «NET1» в командной строке, также игнорируются.

Модем, совместимый с Hayes, может обрабатывать такие команды, как "AT & F & C1 & D2S95 = 3Ddial-pattern \ r". Командный процессор AT-команд программного модема DOSbox не поддерживает никакие другие команды, включенные в ту же командную строку, что и «NET0» или «NET1», и, что еще хуже, если эти строки появляются в аргументе команды (например, dial -pattern к команде 'D'), синтаксический анализатор обрабатывает строку как команду. например "AT Dnet1.vert.synchro.net" не работает должным образом.

Спасибо за подробное объяснение @rswindell!

@rswindell ,

Предлагаемые исправления находятся в PR https://github.com/dosbox-staging/dosbox-staging/pull/582.

CI GitHub генерирует здесь двоичные файлы (если вы не можете собрать из исходников):

• macOS: https://github.com/dosbox-staging/dosbox-staging/actions/runs/229555490.
• Windows: https://github.com/dosbox-staging/dosbox-staging/actions/runs/229555491.
• Linux: https://github.com/dosbox-staging/dosbox-staging/actions/runs/229555489.

@rswindell , когда у вас будет возможность, скомпилируйте и протестируйте ветку kc/modem-toggles-1 или протестируйте указанные выше двоичные файлы и дайте нам знать, что вы думаете.

Вы должны иметь возможность включить telnet-режим для данного последовательного программного модема в файле конфигурации, используя предложенный флаг telnet:1 .

Теперь режим Telnet можно переключать с помощью AT-команд: +NET1 и +NET0 .

Режим Telnet сохраняется при сбросах (ATZ) и остается в том режиме, который вы его установили. Вывод консоли Dosbox сообщит об изменении режима telnet.

Переключение режима telnet во время выполнения с использованием +NET1 (или 0) теперь может быть частью набора команд multi-AT, и это не повлияет на строку набора.
Например, следующее должно работать должным образом:

ATI3+NET1Dmyhost.NET0test.org

Файл README обновлен; дайте нам знать, если он выглядит нормально или как его следует изменить, чтобы улучшить описание.

Любопытно, работает ли это у вас так, как ожидалось!

@rswindell Большое спасибо за отчет об ошибке и подробные объяснения :) Проблема закрылась автоматически, как только я объединил # 582 в master.

Когда у вас будет минутка, пожалуйста, проверьте и сообщите нам, все ли сейчас в порядке :) Если вы обнаружите какую-то неисправность или что-то отсутствует - просто прокомментируйте здесь, и я снова открою проблему (или просто создам новую) .

Эта функция будет выпущена в следующей версии 0.76.0, но до тех пор ее можно будет протестировать в наших сборках для разработки: ссылка на новейшие разработки находится здесь: https://dosbox-staging.github.io/downloads/devel/

Спасибо, ребята, за быстрый и обстоятельный ответ.

Сегодня я протестировал версию dosbox-staging v0.76.0-alpha-690-g21a5, и действительно, опция « telnet: 1 » в файле .conf работает, и команды AT «+ NET1» и «+ NET0» работают.

Только одно наблюдение, и я не знаю, имеет ли это значение на самом деле, но команды «AT +» обычно имеют форму «AT + [слово] = [значение]» - поэтому, чтобы соответствовать этому синтаксису, команды telnet DOSbox будут быть «AT + NET = 0» или «AT + NET = 1». Это, вероятно, на самом деле не имеет значения, но я просто подумал, что упомяну об этом.

Отличная работа, ребята!

Спасибо за тесты @rswindell!

В самом деле ... Я также думал о = (видел другие примеры), но хотел минимизировать количество изменений синтаксиса (и кода), необходимых для реализации этого, в надежде, что это будет принято в восходящем направлении. Если все существующие DOSBox могут сделать этот переключатель, это обеспечит единообразие для пользователей.