diff --git a/hardware/network.rst b/hardware/network.rst index fa2e711..9a6ff2e 100644 --- a/hardware/network.rst +++ b/hardware/network.rst @@ -153,7 +153,61 @@ This guide only covers the basics of VDE. It provides many more useful features Modem ----- -.. note:: Documentation coming soon. +The emulated modem can **dial-out** to Telnet servers as a client, receive **dial-in** calls as a server, or connect to a network through SLIP **dial-up**. + +.. important:: The :ref:`hardware/network:Telnet client` and :ref:`hardware/network:SLIP` modes cannot understand **country and area codes**, which are enabled by default on Windows. Check your dialing settings if you always get *no answer* or *no carrier*. + +The *Configure* button next to the :ref:`network card selector ` provides these settings for a modem: + +* **Serial Port:** port to attach the modem. When using other serial devices such as a :ref:`mouse ` or :ref:`serial passthrough `, make sure to select a port that is not used. +* **Baud Rate:** bit rate for communicating with the modem. This has an impact on the reported and actual transfer speeds. +* **TCP/IP listening port:** TCP port number used for the :ref:`hardware/network:Telnet server` to receive dial-in connections, or ``0`` to disable dial-in. +* **Phonebook File:** text file containing a list of phone numbers and the addresses they should connect to. Format is one entry per line (up to 200 entries), with the phone number, followed by a space or tab, followed by the address to connect to. +* **Telnet emulation:** handle Telnet protocol sequences instead of passing them through the modem. If this option is off, then a raw connection is established. + +.. note:: Telnet emulation must be **on** for connecting to some Telnet servers which require option negotiation, and **off** for connecting two 86Box machines or other binary applications. + +Telnet client +^^^^^^^^^^^^^ + +Dial the ``address`` (defaults to port 23) or ``address:port`` of a Telnet server as a phone number to connect to it through the modem. Both IP addresses and DNS names are accepted. + +For dialer software which does not support entering ``.`` or ``:`` as part of a phone number, an alternative option is specifying a zero-padded IP optionally followed by a port number, such as ``010176001086`` for ``10.176.1.86`` on the default port 23, or ``0101760010864321`` for ``10.176.1.86:4321``. + +Telnet server +^^^^^^^^^^^^^ + +By setting the modem's **TCP/IP listening port** option, a **dial-in server** is started on that port, allowing a Telnet client or another application to dial into the emulated machine by connecting to the host on the specified port number. The modem rings as soon as a TCP connection is received by the listening server; the server will refuse connections if an incoming or outgoing call is already active, as call waiting is not emulated. + +For games and other applications that support dial-in, a connection **between 86Box machines** can be established with this mode, by configuring the first machine to listen as a server, and having the second machine dial into the first one's IP and port. + +SLIP +^^^^ + +Dial number ``0.0.0.0`` or ``000000000000`` (twelve zeros) to establish a **Serial Line Internet Protocol (SLIP)** dial-up network connection. SLiRP is the only supported network mode when using a modem; other modes are ignored. + +.. important:: This is not the standard PPP connection mode typically used by dial-up providers around the world; therefore, dialer software that is compatible with and configured for SLIP must be used. + +Example configuration for Windows 98 +"""""""""""""""""""""""""""""""""""" + +1. Open the *Connect to the Internet* desktop shortcut. Depending on your Windows region, this opens either the MSN setup wizard or the Internet Connection Wizard, which will in turn open the modem setup wizard to add a modem. +2. Check *Don't detect my modem; I will select it from a list* and click *Next*. +3. Select any of the standard modem types and click *Next*. The speed does not matter, as the configured baud rate is automatically used. +4. Select the serial port to which the modem is connected (COM1 by default) and click *Next*. +5. Wait for the modem to install and click *Finish*. +6. If you're on the MSN setup wizard, click *Lan/Manual* to switch to the proper Internet Connection Wizard. +7. Select *Connect using my phone line* and click *Next*. +8. Enter ``0.0.0.0`` as the phone number and **uncheck** *Dial using the area code and country code*. +9. Click *Advanced...* and perform these changes: + * On the *Connection* tab, set the **connection type** to *SLIP (Serial Line Internet Protocol)*. + * On the *Addresses* tab, set the IP and DNS addresses **manually** according to :ref:`the SLiRP rules above `. For the first SLiRP instance, these are 10.0.2.15 for IP and 10.0.2.3 for DNS. + * Click *OK* then *Next*. +10. Leave the username and password **blank** and click *Next* then *Yes* on both warnings. +11. Set the connection name (or leave the default alone) and click *Next*. +12. Skip setting up an e-mail account and click *Next* then *Finish*. + +To connect through dial-up, open Internet Explorer and click *Connect* when prompted. When the *Terminal Screen* shows up, click *Continue* and the connection will be established. Advanced networking features ---------------------------- diff --git a/settings/network.rst b/settings/network.rst index c23ac0b..afbc85a 100644 --- a/settings/network.rst +++ b/settings/network.rst @@ -39,7 +39,7 @@ The *Configure* button opens a new window with settings specific to the selected .. note:: * The MAC address is partially configurable and always prefixed by an `Organizationally Unique Identifier `_ belonging to the card's manufacturer, such as ``00:E0:4C`` for Realtek. * The **[LPT] Parallel Port Internet Protocol** network adapter requires a **PLIP Network** device to be attached to a :ref:`parallel port `. - * Settings for the **[COM] Standard Hayes-complaint Modem** are described on :ref:`Networking `. + * Settings for the **[COM] Standard Hayes-compliant Modem** are described on :ref:`Networking `. VDE Socket ^^^^^^^^^^ diff --git a/settings/ports.rst b/settings/ports.rst index 1b033b4..23ed1af 100644 --- a/settings/ports.rst +++ b/settings/ports.rst @@ -34,7 +34,7 @@ Emulated device to connect to the given parallel (LPT) port. * The :ref:`emulated network adapter ` must also be set to **[LPT] PLIP**. * PLIP is compatible with the DOS ``plip.com`` packet driver and the Linux ``plip`` driver (only with interrupts enabled). It is not compatible with the Windows *Direct Cable Connection* feature or any other parallel port networking implementations. - * PLIP works best with the **SLiRP** :ref:`network type ` due to its point-to-point nature. + * PLIP only works with the **SLiRP** :ref:`network type ` due to its point-to-point nature. Serial port 1-4 ---------------