![]() |
FlexNet application documentation
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Description:TheFirmware emulator for PC/FlexNet. This TF-Emulator allows existing terminal-programs, written for the WA8DED/ TheFirmware command set to be used with PC/FlexNet. These programs include GP, SP, TheBox, DX-Cluster and others. TFEMU may be loaded 4 times maximum. Since PC/FlexNet only accepts one program with a given name, TFEMU must first be duplicated, for example with "COPY TFEMU.EXE TFEMU2.EXE". The different TFEMU recognize their mutual existence and automatically dispatch incoming connects among them, so the different TFEMU may run under the same mycall&SSID. The streams of the first loaded TFEMU are filled with incoming connects first, up to the maximum specified with ESC Y, then those of the second TFEMU and so on. If all streams with a given mycall in all TFEMU's are filled, then a CONNECT REQUEST message is generated. It is however unpredictable on which TFEMU this message is output. Command line parameters:tfemu [-i=<int>]
The driver may be unloaded either with FLEX /U (which unloads also the other PC/FlexNet components) or with KILLAPPL. The FlexNet channel parameters may either be set with ESC T and ESC @MODE or with the FlexNet utility FSET.EXE. Implemented TNC commands
*: This parameter may be set individually on each stream Now incoming connections are taken also if TFEMU is in background (i.e. no Terminal program is running). This works if there is enough free memory and the foreground application behaves cooperatively enough. (not exhaustively tested) Differences to the Original-Firmware(as far as they are known...)
Interrupt formatsTFPC(N5NX) interruptThe TFPC interrupt may be recognized at the string "N5NX" three bytes after the address where the vector points to. The string is not terminated with a zero byte! Following functions are available:
DRSI interruptThe DRSI interrupt may be recognized with the following bytes: 0x53 0x1e 0xbb 0x?? 0x?? 0x8e 0xdb 0x84 0xe4 0x74 0x20 Following functions are available:
Special routinesThese routines are specific to TFPCX, but nevertheless they are needed by some application programmes (see TERM below) These routines are available at both interrupts
The following should be checked (Incomplete) success listTFPCT.COM v2.10 written by OE1HHC and OE3GMWThis is a simple terminal program, written by the TFKISS authors, which uses the TFPC(N5NX) Interrupt. No anomalies known. Reports by HB9JNX@HB9W GP.EXE (Graphic Packet) v1.61 written by DH1DAEThis is a host mode terminal program with graphical user interface (DOS) with many features. It works with an without the -d options. Needs a lot of DOS memory so EMM386 is most likely necessary. Uses the extended host mode. No anomalies known. Reports by HB9JNX@HB9W, DK7WJ@DB0GV, DG9FDL@DB0SRS, DL3FDU@DB0AIS THS.EXE v2.50 written by HB9CVVThis is a menu driven DOS DRSI hostmode program. It exists quite a long time. It works with the -dr option. No anomalies known. Reports by HB9JNX@HB9W TERM.EXE v10.36 written by DL5FBD, Gerd-Michael RitterSimple DOS terminal program, which is written in Turbo Pascal and whose source code is available (including a serial interface library that supports "standard" serial interfaces and the TFPC(N5NX) interrupt). Works now since TFEMU supports the special function 0xfd (transmitter handshake). TERM uses this function which is otherwise only supported by TFPCX without testing if this function really exists. (TERM would have to ask for the TFPCX version and if the returned value makes sense (it is neither 0, 0xffff, nor 0xfdxx), it may use these functions) Reports by HB9JNX@HB9W, thanks to DG9FDL@DB0SRS, Michael for his hint SP.EXE Demoversion 9.00 written by Sigi Kluger DL1MEN (commercial)Works as far as I may judge it. SP uses the ESC @B command for the transmitter flow control, therefore TFEMU must(!!) have enough buffer memory, at least 16kByte, -b0x4000! This should solve the problem with sending files Reports by HB9JNX@HB9W, thanks to DG9FDL@DB0SRS, Michael for his hint TOP.EXE v1.47 written by DF8MTA superficial test did not show any problems... Reports by HB9JNX@HB9W, thanks to DG9FDL@DB0SRS, Michael for his hint THEBOX v1.9a written by DF3AV et alTheBox may be started. Warning: TheBox does not test if a firmware emulator is loaded or not - and crashes if not... TFEMU must be started with -i0xfe! Furthermore, TheBox uses the ESC @B command for the transmitter flow control. Therefore, TFEMU must have enough buffer memory, at least 16kByte (-b0x4000)! Otherwise, it seems to work (as far as I can judge it...) Reports by HB9JNX@HB9W AA4RE BBS v2.9 written by AA4REThis mailbox also doesn't test if a WA8DED emulator is loaded! (This seems to be a mailbox "feature"). Otherwise it works, just configure it as described for DRSI's PC*PA adapter, start TFEMU with -dr -i0xff (the com number then also has to be 255!) Reports by HB9JNX@HB9W PacketCluster v5.4-4 written by Pavillion Software (commercial)Install as described for DRSI's PC*PA-Adapter. First tests were immediately successful, more thorough tests will follow. cf /L option. Example: the DX-Cluster HB9W-8 is connected to the RMNC HB9W 9-10. TFEMU should be started with: TFEMU -DR -I=0xff -L=HB9W-9 Reports by HB9JNX@HB9W FBB 5.15c written by F6FBBload-high FLEXNET.EXE, KISS.EXE, and TFEMU.EXE in your autoexec.bat. TFEMU doesn't need any parameters, except a larger buffer size if you have an overloaded BBS. Concerning FBB, simply validate interface 5 on PORT.SYS (interface previously) used with TFPCX/TFPCR. All INITTNCx.SYS, MAINTx.SYS, and BEACONx.SYS should then use TFEMU commands (explained in this DOC file) : don't mention TxDelay, Persist, etc... :-) All tests have been done with FBB 5.15c linked to a FlexNet digipeater on a 9k6 full duplex kiss wire link. To know more, contact F5PJE @ F6BIG or F1UNA @ F5KPO. Report courtesy by Eric F5PJE Unsuccessful programsTNCTERM.EXE (supplied with the DRSI driver)This is a very simple terminal program. It does not work. It does not recognize the TFEMU interrupt. Does not work also with other WA8DED emulators, such as G8BPQ DED Emulator Reports by HB9JNX@HB9W
page created by Thomas Sailer <sailer@ife.ee.ethz.ch> last updated: 05.04.97 |