gsport/doc/web/src/site/apt/ethernet.apt
2012-03-05 21:02:19 +00:00

71 lines
3.2 KiB
Plaintext

-----
GSport Ethernet
-----
David Schmidt (david__schmidt at users dot souceforge dot net)
-----
GSport Emulated Ethernet
The Uthernet (TFE) support in GSport was made possible by implementing the GPL source written by Spiro Trikaliotis for the {{{http://www.viceteam.org/}Vice emulator}}.
This version of GSport contains the latest code from VICE 2.2.
* Details
Right now Uthernet emulation only works under Windows.
Support for emulation under OS X and Linux is planned.
In order to use Uthernet emulation, you must install {{{http://www.WinPcap.org/install/default.html}WinPCap}} and
have a wired (not wireless) Ethernet connection on the host computer.
* GSport Setup
After GSport starts, press F4 to enter the text based menu and select the "Ethernet Card Configuration" option.
By default, Uthernet emulation is turned off. Enable it by setting "Uthernet Card in Slot 3" to "On".
Next, select the host interface you wish to use to communicate with the outside world. A list of available
interfaces is provided on screen. For most the default of interface "0" is correct.
Return back to the main menu and save your configuration for good measure. Due to limitations, you must exit
and restart GSport for the changes you made to take effect.
* GS/OS Setup
In order to use TCP/IP connectivity under GS/OS, you have to install the latest version of Marinetti and the
Uthernet Link Layer.
First download and install the latest version of Marinetti 3.0 available at:
{{{http://www.apple2.org/marinetti/Marinetti3.0b1.SHK}http://www.apple2.org/marinetti/Marinetti3.0b1.SHK}}
Then install the latest TCPIP INIT available at:
{{{http://www.apple2.org/marinetti/TCPIP30b3.SHK}http://www.apple2.org/marinetti/TCPIP30b3.SHK}}
Just extract and copy the file to the "System.Setup" folder in your GS/OS system folder, overwriting the existing file
Last, install the latest Uthernet Link Layer (1.0.1b5) available at:
{{{http://www.wannop.info/speccie/uthernetll.bxy}http://www.wannop.info/speccie/uthernetll.bxy}}
Just extract and copy the file to the "TCPIP" folder in your GS/OS system folder.
After copying over all the files, reboot the emulated IIgs. Once at the desktop, bring up the graphical control
panel available in the Apple menu and double click the "TCP/IP" icon.
Click on "Setup Connection..." Select the "Uthernet" link layer from the drop down and then click "Configure..."
Set "Lan Slot:" to "3", check off the DHCP option and then click "Save". Click "OK" to leave the setup dialog.
You should be able to click "Connect to network" and successfully connect to your TCP/IP netowork.
From this point on, you are free to run any TCP/IP aware GS/OS applications.
The following applications have been tested and seem to work fine:
Spectrum Automated File Exchange 2.1.9 (FTP client, use passive mode)
Telnet application included with Marinetti
The following applications have been tested and DO NOT work:
Casper web server: It will not serve web pages. This is likely a limitation of WinPCap.
* 8-bit Applications
Uthernet enabled versions of Contiki and ADTPro work fine with GSport. Other 8-bit software should work fine but
are untested.