Differences

This shows you the differences between two versions of the page.

--- util:svdm [2022/05/29 21:27] – [Features] digital man
+++ util:svdm [2024/03/25 16:34] (current) – [Configure] Add new options MainLoopDelay and SocketSelectTimeout digital man
@@ Line 1: / Line 1: @@
 ====== Synchronet Virtual DOS Modem ======
-SVDM is a modem emulator for Windows which utilizes the Synchronet Virtual UART/FOSSIL Driver (''DOSXTRN.EXE/SBBSEXEC.DLL'') to enable support for DOS communications programs on Windows NT-based operating systems. 64-bit Windows support is enabled by also installing [[http://www.columbia.edu/~em36/ntvdmx64.html|NTVDMx64]].
+SVDM is a MODEM emulator for Windows which utilizes the Synchronet Virtual UART/FOSSIL Driver (''DOSXTRN.EXE/SBBSEXEC.DLL'') to enable support for DOS communications programs on Windows NT-based operating systems. 64-bit Windows support is enabled by also installing [[https://mendelson.org/ntvdmx64.html|NTVDMx64]].
 SVDM should run on 32-bit and 64-bit editions of Windows XP and later.
@@ Line 6: / Line 6: @@
 Although SVDM reuses components of the Synchronet BBS Software and shares some of its source code and libraries, it is is not technically "part of" Synchronet BBS nor is it required for the normal use or operation of a Synchronet BBS.
+You can find the latest "release" of SVDM available for download (as ''svdm??.zip'') at [[http://synchro.net/Synchronet/]].
 ===== Uses =====
   * Use 16-bit DOS terminal programs (e.g. Telix, ProComm, Qmodem, Telemate, etc.) to connect to Internet-connected BBSes
@@ Line 16: / Line 17: @@
   * Emulates an NS16550 UART
   * Provides a FOSSIL/PC-BIOS (int14h) software interface
-  * IPv4 and IPv6 support
+  * IPv4 and IPv6 support (for inbound and outbound connections)
+  * Inbound connection filtering based on IP address/range
   * Telnet client and server support
   * Raw TCP client and server support
+  * Play optional sound (wave) files upon "ring", connection, and disconnection
   * Accurate Hayes Smartmodem / USRobotics Sportster Modem "AT Command Set" emulation
      * Complete with virtual NVRAM settings/number storage (i.e. AT&W, AT&Zn=S)
      * Optional auto-answer (ATS0=1)
-     * RING result upon incoming connection attempts
+     * RING result upon incoming connections
      * Verbal and numeric result modes
+     * Caller ID support (enabled with AT+VCID=1 or AT#CID=1)
      * "Dial" IP addresses or hostnames with optionally-specified TCP port and/or protocol
@@ Line 48: / Line 52: @@
                   [on optionally-specified network interface]
         -p<port>  Specify default TCP port number (decimal)
+        -n<node>  Specify node number
         -d        Enable debug output
         -h<sock>  Specify socket descriptor/handle to use (decimal)
@@ Line 54: / Line 59: @@
         -V        Display detailed version information and exit
 </file>
+==== Flow Control ====
+When utilizing UART (COM Port) virtualization (e.g. with most DOS terminal programs and some DOS door programs), be sure to enable RTS/CTS hardware flow control in the DOS program and do **not** enable DTR/DSR or XON/XOFF (software) flow control.
+==== Ports ====
+For DOS programs using UART/COM Port I/O, the COM port number (or I/O port and IRQ) must match what SVDM is virtualizing. By default, SVDM virtualizes COM 1 (I/O Port 3F8, IRQ 4), but this can be changed globally or per program via the ''svdm.ini'' file.
+For DOS programs using the PC-BIOS/FOSSIL int14h interface, all COM ports are supported and treated identically (i.e. the ''DX'' register value is ignored).
+==== Baud Rates ====
+The DTE baud rate set by the DOS program is not used by SVDM (i.e. the transmit and receive data rates are only limited by the TCP/IP network). If you wish to artificially limit the receive data rate for some reason (not normally necessary), you can use the ''-r'' command-line option or the "Rate" key in the root section of ''svdm.ini'' to set the maximum receive rate, in characters per second.
+A DTE rate of 38400 bps is reflected by virtual device driver and if the DOS program attempts to change this value, there is no effect.
+==== Connect Rates ====
+For incoming TCP connections, SVDM will report either "CONNECT 9600" or just "CONNECT" (assumed 300 bps) depending on the modem's extended response (''ATX'') setting.
+==== Bits o' Parity ====
+The communication data (word) bit width, stop bits, and parity settings used by the DOS program are not used by SVDM. The equivalent of 8 data bits, no parity, and one stop bit, is assumed.
+==== Disconnect ====
+If the DOS program de-asserts ("drops") DTR, the TCP connection will be terminated (by default). Alternatively, the DOS program can send the escape sequence (by default, "+++", surrounded by a one second guard time of inactivity) to enter command mode and then send "ATH" or "ATH0" to disconnect.
 ===== Examples =====
-Run Telix:
+Run Telix (popular comm program for MS-DOS from the 1980s):
   svdm telix
-Run Renegade BBS Software (in WFC mode), listening on all IPv4 network interfaces for incoming TCP connections:
+Run Renegade BBS Software (in WFC mode), listening on all network interfaces for incoming TCP connections:
-  svdm -l -4 renegade
+  svdm -l renegade
 ===== Dialing =====
@@ Line 97: / Line 128: @@
   AT&ZL?
-Save dial strings (numbers) can be dialed by using the ''ATDSn'' command:
+Saved dial strings (numbers) can be dialed by using the ''ATDSn'' command:
   ATDS0
 If your DOS terminal program of choice has trouble dialing long dial strings (e.g. accommodating long DNS hostnames or IPv6 addresses), try using the saved number storage feature to resolve that limitation. After enter the following command, dialing "S0" as a "phone number" would actually connect to "telnet:vert.synchro.net:23".
   AT&Z0=telnet:vert.synchro.net:23
+Another option for dialing longer dial strings is to specify "aliases" in the ''[alias]'' section of your ''svdm.ini'' file. Any combination of printable ASCII characters may be used for a dial string alias, except for the colon ('':'') and equals (''='') characters.
+<code ini>
+[alias]
+vertrauen=telnet:vert.synchro.net:23
+</code>
+  ATDvertrauen
 ===== Configure =====
@@ Line 110: / Line 148: @@
 ^ Section      ^ Key       ^ Default       ^ Description ^
-| //Root//     | ''Mode''  | ''Raw''       | Specify the TCP protocol: ''Telnet'' or ''Raw'' |
+| //Root//     | ''Mode''  | ''Telnet''    | Specify the TCP protocol: ''Telnet'' or ''Raw'' |
 | //Root//     | ''Port''  | ''23''        | Specify the TCP port number |
 | //Root//     | ''Node''  | ''0''         | Specify the BBS node number |
@@ Line 120: / Line 158: @@
 | //Root//     | ''ServerEcho'' | ''true'' | The server (e.g. BBS) is expected to echo input back to the client (for Telnet option negotiation) |
 | //Root//     | ''Rate''  | ''0''         | Limit receive rate to a specific number of //characters-per-second// |
-| //Root//     | ''AddressFamily'' | ''IPv4'' | Default IP address family: "unspec", "ipv4", or "ipv6" |
+| //Root//     | ''AddressFamily'' | ''unspec'' | Default IP address family: "unspec", "ipv4", or "ipv6" |
 | //Root//     | ''BusyNotice''    | hard-coded | Message to send before disconnecting remote connections when already-servicing a remote client/user connection |
+| //Root//     | ''AnswerBanner''  | hard-coded | Message to display upon incoming connections, blank to disable |
+| //Root//     | ''RingSound''     | //blank//  | Wave file to play upon incoming "ring" |
+| //Root//     | ''ConnectSound''  | //blank//  | Wave file to play upon connection |
+| //Root//     | ''DisconnectSound'' | //blank//  | Wave file to play upon disconnection |
+| //Root//     | ''IpFilterFile''  | //blank//  | Path/filename of file containing lists of IP addresses/patterns/ranges to reject incoming connections from |
+| //Root//     | ''clientFile''    | ''client.ini'' | File to write incoming connected client information (e.g. IP address), blank to disable |
+| //Root//     | ''MainLoopDelay''       | ''0'' | Milliseconds to yield CPU in application main loop |
+| //Root//     | ''SocketSelectTimeout'' | ''0'' | Milliseconds to wait for receive data on TCP socket |
 | ''Modem''    | ''AutoAnswer''    | ''false''  | Automatically answer/accept incoming TCP-connection attempts (''ATS0'') |
+| ''Modem''    | ''CallerID''      | ''false''  | Incoming/client IP address reporting between RING results (''AT+VCID'' or ''AT#CID'') |
 | ''Modem''    | ''Echo''          | ''true''   | Send AT command characters back to terminal (''ATE'') |
 | ''Modem''    | ''Quiet''         | ''false''  | Respond to AT commands (''ATQ'') |
@@ Line 137: / Line 184: @@
 | ''UART''     | ''IRQ''           | //depends// | Hardware interrupt request (IRQ) line to virtualize, e.g. 4 |
 | ''UART''     | ''Address''       | //depends// | Hardware I/O port base address (use ''0x'' prefix for hexadecimal notation, e.g. ''0x3f8'') |
+| ''alias''    | various           |            | Each key is a unique dial string alias (e.g. ''mybbs = protocol:address:port'') |
 | ''sockopts'' | various           |            | See ''[[config:sockopts.ini]]'' |
-Settings changed via modem AT command take precedence over command-line options which take precedence over .ini file settings.
+Settings changed via modem AT command take precedence over command-line options which take precedence over ''.ini'' file settings.
 Settings in the //Root// section may also be specified in a program-specific section (named after the program itself), to create program-specific settings.
@@ Line 174: / Line 222: @@
 | ''Hn''  | Control ON/OFF hook (e.g. ''ATH0'' to hang-up) |
 | ''In''  | Display modem information |
+| ''Ln''  | Control speaker volume (ignored) |
+| ''Mn''  | Enable speaker (e.g. ''ATM1'' enables wave file playback) |
 | ''O''   | Return online (from command mode) |
 | ''Qn''  | Display/suppress result codes (e.g. ''ATQ1'' enables //quiet mode//) |
+| ''P''   | Pulse mode dialing (ignored) |
 | ''Sr=n''| Set register //r// to //n//. |
 | ''Sr?'' | Display value of S-Register //r//. |
+| ''T''   | Tone mode dialing (ignored) |
 | ''Vn''  | Control verbal result codes (e.g. ''ATV0'' enables //numeric// result mode) |
 | ''Xn''  | Control extended result codes (e.g. ''ATX0'' disables extended result codes) |
-| ''Z''   | Initialize/re-initialize modem |
+| ''Z''   | Initialize/re-initialize modem (e.g. re-read ''.ini'' file) |
 | ''&W''  | Write modem settings to ''.ini'' file |
 | ''&Zn=s'' | Store a dial string //s// into slot //n// (0-19) |
 | ''&Zn=L'' | Store last-dialed string into slot //n// (0-19) |
 | ''&Zn?''  | Display saved dial string from slot //n// |
-| ''&ZL?''  | Display last dialed string |
+| ''&ZL?''  | Display last dialed string |
+| ''+VCID=n'' | Control Caller ID reporting (alias: ''#CID='') |
+| ''+VCID?'' | Query Caller ID enabled status (alias: ''#CID?'') |
 S-Registers store additional/advanced modem settings as decimal-numeric values:

Trace:

Differences

Navigation

Search

Toolbox