****************************************************************************
*               CPMTCP FAQ v0.3 Created by WIZARDNJ. 6/19/06               *
* HW/SW Copyright Andrew J. Kroll http://dr.ea.ms/HW http://tcp.dr.ea.ms/  *
****************************************************************************

v.0.1 first release trying to get most of info here
      the first time so maybe update wont be needed.

v.0.2 url fixups, more info -- AJK

v.0.3 more generic information -- AJK

Table of contents:
------------------
1. Requirements
2. Configure Linux
3. Configure CP/M system
4. Connecting CP/M system
5. Running Programs



1. Requirements:
   --------------

Kermit for your system <http://www.columbia.edu/kermit/ck80.html>
AND
Any of the supported systems.

{
   	{
	C128 with:
	Swiftlink Cart with an installed ACIAFIX board <http://dr.ea.ms/HW/>
	            OR
	USER port RS-232C cart with all handshake lines.

	ATLEAST one 1571 or 1581

	AJK's patched-to-hell-and-back CP/M 3 <http://cpm.dr.ea.ms/>
   	}

	OR

	{
	Xerox 820-II or BIGBOARD
	}

	OR 

	{
	Generic Z80DART @ I/O 0x0000
	}

	OR

	{
	DOS system, COM1:
	}

	OR

	{
	Linux/elks system
	}
}
  
AND
{
	{
	PC running Linux 2.6.16 kernal or greater with serial driver patches,
	until the patches make it into the upstream kernel.
	<http://tcp.dr.ea.ms/>
	}

	OR

	{
	A modern modem supporting compression and full hardware handshake 
	and an ISP supporting SLIP. (Good luck finding one though!)
	}

	AND

	{
	RS-232 cable. (Can be purchased at a local computer store)

	Null modem adapter. (Can be purchased at a local computer store)

	Sliplogin for Linux <http://tcp.dr.ea.ms/>

	}
}

***NOTE: Prefered way to setup connection for C128, other setups are similar:
	c128->Swiftlink(aciafix:ON)->rs232 cable->null modem->PC serial port
***NOTE: ALTRENATE hookup for C128:
	c128->userport rs232->rs232 cable->null modem->PC serial
***NOTE: All other machines:
	CP/M machine->Serial port->rs232 cable->null modem->PC serial port

2. Files needed to be edited/created on the Linux box:

	[inittab]
	/etc/inittab can be edited to configure your serial port as follows 
	for a 38400 connection:

	T0:23:respawn:/sbin/agetty -Lh ttyS1 38400 vt100 (ttyS0=COM1,ttyS1=COM2)

	For userport RS-232, use 1200 in place of 38400.

	[rc.local] (chmod'ed to 750 for NAT AKA IPMASQ)

	#!/bin/bash

	/sbin/iptables -A FORWARD -i eth0 -o sl0 -j ACCEPT
	/sbin/iptables -A FORWARD -i sl0 -o eth0 -j ACCEPT
	/sbin/iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
	echo 1 > /proc/sys/net/ipv4/ip_forward


3. Configuring CP/M on C128:

	Boot c128 into cpm with boot floppy.
	set device to your port speed (ex. 9600,19200,38400,etc..)
	'DEVICE AUX:=6551[19200,noxon'  hit 'RETURN'
			  ^^^^^ Notice the baud is set at 19200,
				which is really twice that speed
				on a Swiftlink, so we are setting 
				port for 38400 baud.
	For the userport:
	'DEVICE AUX:=RS232[1200,noxon'  hit 'RETURN'



	Editing tcp.rc
	Next step we will have to change the DNS and IP entries in tcp.rc file.
	Each field MUST be seperated with a *SINGLE SPACE character.
	Using your favoite editor, such as VDE edit tcp.rc
	The file contains:

	'hostname hostip hostdnsip gatewayip'

	c128 192.168.80.2 192.168.80.1 0.0.0.0

	The gateway address is optional and currently unused. You may omit it.
	Make changes to the file and save it. (Escape X for VDE)


4. Connecting to the Internet

	Any terminal program using the serial device for serial I/O will work.
	Using your favorite terminal program (we use kermit in cp/m mode)
	Type 'KERMIT' at the prompt.

	You should see "Kermit-80 A:>"

	Type 'c' to get into terminal mode.
	You should see [Connected to remote host. Type %C to return...]

	We should have a Linux prompt here to login to the Linux system. 
	Please login to Linux now. If you do not se the linux login prompt 
	you may need to hit 'RETURN' a couple times to try get the login 
	to show up. If you can, instead send BREAK (not control C).

	linux login: 

	Login to your linux box 

	Type 'sliplogin' at the prompt and hit RETURN to enable the 
	slip connection between the computers.
	You should be presented with similar text below in your terminal:

	"Captain ! Something is lowering our shields!
	On screen, Mr. Worf !
	It's wizardnj at coordinates 192.168.80.2
	Mr. Data, try normal slip to 192.168.80.1
	We got him, captain."

	Next hit %c to get out of Terminal mode 
	you will see the Kermit-80 A:> prompt
	type 'EXIT' and then hit RETURN to leave Kermit.


5. Running programs on floppy disk.

	Program availble are IRC,FTP,UPDATE,TELNET,HTTPD... 

	[IRC]
	To setup an IRC session use commands below.
	A>irc irc.servername.com mynick 'RETURN'

	[FTP]
	To setup an FTP session use commands below.
	A>ftp ftp.zimmers.net

	You can download files to the other drives attached to your c128 ,
	A:8, B:9, C:10, D:11, M:REU if attached(up to 2mb is supported)

	List of commands at the FTP prompt:
	-----------------------------------
	ls or dir - shows the files on the server
	cd or cwd - changes directory on the server
	pwd - shows you what directory you are at on the server
	put - put a file onto the server
	get - get a file from the server
	mput - put many files onto the server
	mget - get many files from the server
	lcd - local disk/dir/user change
	lls - local file listing
	hash - toggle hash mark printing
	quit or bye or exit - exit to OS prompt.

*** NOTE: Not all commands are available on all systems.

	[UPDATE]
	Update will check via the internet if there is an update to the
	programs on your disk.

*** NOTE: It is recomended that you first make a backup
	of your current working disk before running this program.

	To run the update type at the prompt: 'UPDATE DR.EA.MS'

	Update will go out through the internet and check for any current 
	updates. (this may take a while, but it's pretty cool!)
	When finished, the update program has updated everything to the 
	newest versions available. 

Thats it for now hope you find this FAQ useful. WizardNJ OUT!!!!!