@DATABASE "TELEPORT" @NODE "main" "Welcome to Teleport Documentation" @TOC main Teleport v1.0 ~~~~~~~~~~~~~~~~~ The fastest nullmodem filetransfer program ever. Programmed by Dennis Gustafsson & Daniel Andersson in 1995 @{" Introduction " LINK "Intro"} @{" Free to use? " LINK "share"} @{" How to teleport " LINK "use"} @{" Technical information " LINK "tech"} @{" Bugs " LINK "bugs"} @{" Future " LINK "future"} @ENDNODE @NODE "intro" "What is Teleport" @TOC "main" Introduction ~~~~~~~~~~~~~~~~ Sending files over a nullmodem cable have always been a very slooow procedure. Between two terminal programs you can reach speeds like 115200 bps. It sounds quite a lot, but think about it! 115200 bits per second is not even 15 kbytes per second! It takes over one minute to send one megabyte of data! Is the Amiga and it's serial port really that slow? Of course not! The terrible facts you just have read is now history. With "Teleport" you are able to send files between two computers at an amazing speed. With hyperoptimized transfer routines in 100% assembler it is possible to reach speeds at almost 890.000 bits per second! It takes less than one second to transfer 100 kbytes. One megabyte takes approximately 9 seconds. A powerful interface or a cli-command is used to transfer the data. You can not use the routines with normal terminal programs. @ENDNODE @NODE "share" "Teleport is shareware" @TOC "main" What does it cost and what do I get ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ As you might now, most good things aren't for free and Teleport is not an exception.. The free version is a complete version but you can't send more than five files with it ;) If you register you will get the complete version plus two small cli-commands, that gives you the opportunity to send single files directly from shell. You will also be able to buy future version for half price. If you want to register you should send a stamped letter with a formatted disk and 100 SEK or 20 US Dollars. (No coins are accepted) to: Dennis Gustafsson Skedsbygd 1215 380 44 Alsterbro SWEDEN Don't forget to write your phone number and address. Note to Swedes: Om du vill kan du istället sätta in 110 SEK på PG 492 18 55-5. Då kommer en diskett med Teleport på posten. Glöm inte att skriva din adress. Märk med "Teleport" @ENDNODE @NODE "use" "How do I use Teleport" @TOC "main" The Teleport Interface ~~~~~~~~~~~~~~~~~~~~~~~~ It's not very hard to figure out how to use the interface, but i'll try to explain anyway. When you start the program it will wait until connect with the other computer is established or for a key press, if you press a key you will not be connected (not able to upload, download). · Uploading some files Press "U" or Enter. The filerequester is special made for this interface and has a very powerful multifile select. You can also select one / many device(s). Scroll through to the files with arrow keys or with the slider. The filerequester is very easy to use, so i don't explain it here. After the filerequester the program will search through the directories and transmit all the files you have selected (plus the sub-structure if Send Full Substructure is on) to the other computer. If you get bored, press on the source computer to abort the transmission. If an error occurs while transfering the file will be resended with a lower speed. If a file by some reason not could be transmitted, the filename will be stored and displayed after the complete transmission. · Download This part is handled automaticly by the program. The screen fades down to black when downloading. · Preferences If you click on the Preferences button you will be able to do some settings. If "Overwrite existing files" is turned off, the program will create a .dup-file instead of overwriting the old one. If "Send full substructure" is turned on, the whole structure, including the volume- name will be created on the other computer (Don't worry! The volume will be created as a drawer!). You can also change the download directory and the name of the logfile. If you don't want a logfile, simply don't write anything in the gadget. · Setting the external speed (speed used when transfering files) If you haven´t saved a config file, the standard speed is 3 (886723 bps). You can change the speed in the preferences editor. The speed is NOT the same as baud rate. To calculate the speed you can use the formula: Speed = (3546895/bps)-1 Example: To calculate 115200 bps Speed = (3546895/115200)-1 = 29 The highest possible speed between two A1200 and a normal cable is 3. If you have fast computers and a short cable of high quality, i think it is possible to set the speed to 2 without any loss of data. (We tested it with speed 2 between two A1200 and about 50% was transmitted without resending.) If you receive the data with a slower processor than 68EC020, like 68000, you can't use higher speed than 7 (443361 bps). If the speed is to high and the program missed some data, it will decrease the speed and resend the file automaticly. · Setting the internal speed (speed used when communicating) Just enter the speed as an argument, eg. 1> Teleport 38400 will set the internal speed to 38400. Default speed is 19200. (when transfering many small files it's good to have high internal speed) · The logfile This file will grow for every transfer. The date, time and some data will be added. The name of all skipped and resended files will be added to it. (If the logfile contains many resendings you should decrease the speed.) · Reconnect If no connect is established you can use this one to connect. · About Hmm.. what could this be? @ENDNODE @NODE "tech" "Technical information about Teleport" @TOC "main" Technical information ~~~~~~~~~~~~~~~~~~~~~~~ The program can't transmit files that is bigger than your memory. Therefore it's quite handy with a couple of megabytes RAM to transfer big files. (This is the first thing i will add in the next version.) If the filesize is zero the file will not be transmitted. All interrupts and multitasking are completely turned off during the transmission. This is necessary to reach the high speeds. It's up to you what you prefer.. 880.000 bps or 115200 bps plus multitasking. Anyway, who needs multitasking when you can transmit one megabyte in 9 seconds? The serial routines are written and assembled in Asm-One v1.5 The interface is written in Amos v1.34 with a couple of extra extensions. (Don´t worry AGA users! Teleport will patch your machine to ECS.) @ENDNODE @NODE "bugs" "Bugs in Teleport" @TOC "main" Bugs ~~~~~~~~ Sometimes the connection won't be established on both computers. Just reconnect on both computers. This little "bug" will be fixed soon. The program doesn't like to be executed from Directory Opus or programs like that. Start it from Shell or Workbench or there might appear a guru. Use Teleport on your own risk. I do not take any responsability for any loss of data. The routines are quite advanced and i'm not sure they like all multitasking programs. Don't have too important things in the background when running Teleport. If you find a bug in Teleport, please report it to me. @ENDNODE @NODE "future" "What will appear in Teleport" @TOC "main" The future of Teleport ~~~~~~~~~~~~~~~~~~~~~~~~ If I find somebody who knows how to program a PC and it's serial port, it may be possible to tranfer files between PC and Amiga at this speed. Do you know how to do it? You must know how to send and receive data through the serial port as fast as possible. You must also know how to program a powerful interface in Pascal, C or something like that. Don't hesitate to write to me if you think you can do it. (Is this speed possible on PC computers? I really don´t know! Do you?) In the future you will be able to choose files from the others computers directory in the filerequester, and download them. (like Directory Opus and Diskmaster) You will also be able to transfer files that is bigger than your memory. The files will be splitted up in smaller peaces. @ENDNODE