mirror/86Box-docs
1
0
Fork 0
mirror of https://github.com/86Box/docs.git synced 2026-02-22 01:25:34 -07:00
Code Issues Packages Projects Releases Wiki Activity

Initial modem documentation

Browse Source
This commit is contained in:
RichardG867
2024-07-26 15:46:45 -03:00
parent 496bd80b0a
commit d019f3515d
3 changed files with 57 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

56
hardware/network.rst
View File

@@ -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 <settings/network:Network Card #1-#4>` provides these settings for a modem:
* **Serial Port:** port to attach the modem. When using other serial devices such as a :ref:`mouse <settings/input:Mouse>` or :ref:`serial passthrough <settings/ports:Serial port passthrough 1-4>`, 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 <hardware/network:SLiRP>`. 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
----------------------------

2
settings/network.rst
View File

@@ -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 <https://en.wikipedia.org/wiki/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/ports:Parallel port 1-4>`.
* Settings for the **[COM] Standard Hayes-complaint Modem** are described on :ref:`Networking <hardware/network:Modem>`.
* Settings for the **[COM] Standard Hayes-compliant Modem** are described on :ref:`Networking <hardware/network:Modem>`.
VDE Socket
^^^^^^^^^^

2
settings/ports.rst
View File

@@ -34,7 +34,7 @@ Emulated device to connect to the given parallel (LPT) port.
* The :ref:`emulated network adapter <settings/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 <settings/network:Mode>` due to its point-to-point nature.
* PLIP only works with the **SLiRP** :ref:`network type <settings/network:Mode>` due to its point-to-point nature.
Serial port 1-4
---------------