	----=== HF PACTOR/AMTOR/GTOR/RTTY PACKAGE ===----

Version 0.6.3   October 2004 

TODO 

* * * * *     E N G L I S H    * * * * *
(German downstairs ... Deutsch weiter unten)
			      
By Guenther Montag DL4MGE 

GENERAL:
At the moment it seems to me most important to make the basic sound
driver interface functions, e.g. in l1/user/oss.c running well, also for
newer architectures and ALSA sound driver. This needs kernel-, driver-,
hardware- near  programming experience. Still crashes with some
soundcards. See also ChangeLog!!!
Next aims:
improve the no-mmap-code (IN l1/user/oss.c),
make one also for half duplex, 
make code also for stereo-only cards.

CONFIGURE AND COMPILATION: 
The makefiles of hf were made with automake
1.4 and autoconf.2.13. I did not yet change to newer automake / autoconf
because I still maintain the thing in my shack with good
old  Pentium 133 Mhz, Soundblaster 16, Kernel 2.2.13, SuSE Linux 6.3
with OSS driver,  here it is just running good. So please do not touch
Makefile.am's and config.in if you have new versions of autoconf and
automake if You do not know how they work. But if some of you wants to
upgrade, welcome, then I also would shift to another  system.! 
Compilation tested only with egcs 2.91.66 and gcc 3.2.2. 

SUGGESTIONS FOR FURTHER DEVELOPMENT:

MOST IMPORTANT: 
Try re-writing l1/user/oss.c either in OSS API without
mmap() or into new ALSA API with or without something like mmap. Some
soundcards (and / or drivers) don't like mmap. The ALSA peolpe say, in
ALSA there are better things than mmap. If you do this, take newest ALSA
lib, because since ALSA 1.0 the API has changed a bit.

DECODER:
A squelch function, to remove rubbish in RTTY and so make RTTY mailbox
possible!

TX:
Transmitting backspace does not really delete sign on partner's screen. 

PACTOR-MAILBOX:
it is there since 0.6, test it, improve it, also try it for amtor!
Help tweak F6FBB for: New user at first login should be able to send mail!

PROTOCOLS:
Pactor 2 and 3?
This would be new and make the program more precious, as a PTC-2 etc. 
is expensive. But: Is this possible for soundcard?  Also: The protocol
is not public. 300 baud packet? (does this exist for Linux?) PSK - why?
there are at least 5 good psk progs for linux!!
MT63, MFSK? They say it is better than pactor 1 !

LOG:
Contest counter increasing by 1 each QSO. 
Format in log file OK? (I made 2: binary file for re-reading by program 
and ascii file for printing / further processing)  (By sprintf... in
hfterm/src/log.c in Funktion log_store you can change  ascii log output
easily). 
Who knows more about log formats? Every contest wants its own cabrillo 
format! Other formats to store / as interface, e.g. ADIF? Better to link
hfterm whith an existing log prog! (e.g. 'hamlog', is  in SuSELinux 8.1)

WORLDMAP:
Axel is preparing a fine toy - to show the QTHs of qso partners  from
log dates. He prepared the map. I outcommented calculation  of the
pixmap hfterm/src/main (if MAP...endif), because the programm  otherwise
would need 10 mins to start on my old machine.  The pixmap is not there
any more in V.0.5, 3 MB when unpacked. Axel is working at this feature
within developing "Baken".

HELP:
Translations...
Doc in html...
More pactor info & experience reports!

73 & have a lot of fun


			    AUTHORS

Thomas M. Sailer	HB9JNX/AE4WA	Mail: sailer@ife.ee.ethz.ch
			
Ralf-Axel Krause	DF3JRK		http://www.df3jrk.de.vu
					Mail: df3jrk@gmx.de	
					Packet: df3jrk@df0hmb.hh.dl.eu.ww

Gnther Montag		DL4MGE  	http://www.hfterm.de.vu
 					Mail: dl4mge@darc.de
 					Packet: dl4mge@db0zka.bay.deu.eu

PLEASE DO subscribe mailing list:
	https://lists.sourceforge.net/lists/listinfo/hfterm-hackers

post to mailing list:
	hfterm-hackers@lists.sourceforge.net
	
download latest version at:
	http://sourceforge.net/projects/hfterm	


-----------------------------------------------------------------------

* * * * *     D E U T S C H    * * * * *

ALLGEMEINES: 
Im Moment erscheint vorrangig, die mit dem Soundtreiber
sprechenden Grundfunktionen, z.B. in l1/user/oss.c  gut zum Laufen zu
bringen, das heit auch fr neuere Architekturen und den ALSA-
Soundtreiber. Dazu sind Treiber-, Kernel-, hardwarenahe Programmier-
kenntnisse gefragt. Noch Abstrze bei manchen Soundkarten. (Das Herz des
Programms, hfkernel, stammt von 1996) Siehe ChangeLog !!!
Nchste Ziele:
no-mmap-Code (In l1/user/oss.c) verbessern
solchen auch fr halfduplex
Code auch fr Nur-Stereo-Karten.

COMPILER:
Die Makefiles von hf wurden mit automake 1.4 und autoconf.2.13 erstellt.
Ich mag gar nicht umteigen auf die aktuellen Versionen  (von SuSE Linux
8.1) automake 1.6.3 und autoconf 2.5.3 weil es auf meiner alten Kiste im
Shack mache. Bitte berhrt nicht die Makefile.am's und config.in wenn
ihr diese neuen Versionen von autoconf und automake habt und nichts
davon versteht. Aber wenn es jemand updaten will und kann, willkommen!
Kompilieren getestet bis gcc 3.2.2 gut.

ENTWICKLUNGSVORSCHLGE:

AM ALLERWICHTIGSTEN:
Versuche, l1/user/oss.c/fdx_driver und hdx_driver mit der alten OSS-API
ohne mmap() oder mit der neuen ALSA-API mit und ohne so etwas wie mmap()
zum Laufen zu bringen, da mmap() mit einigen Soundkarten und / oder
-treibern nicht luft. Wenn Du das mit ALSA tust, verwende die neueste ALSA-lib,
weil sich mit Version 1.0 die API etwas genderrt hat.

DECODER:
Eine Squelch-Funktion! Um Datenmll bei RTTY zu entfernen und so auch
die RTTY-Mailbox mglich zu machen!

TX:
Senden eines Backspace lscht am Schirm des QSO-Partners nicht.

PACTOR-MAILBOX:
luft seit 0.6, verbessern und auch fr Amtor, Gtor optimieren!
F6FBB zwicken, da es neuem Benutzer auch schon beim ersten Login Mails
senden erlaubt!

PROTOKOLLE:
Pactor 2 und 3?
Das wre m.W. neu und wrde das Programm noch wertvoller machen. Weil 
ein PTC-2 usw. sehr teuer ist. Aber schwierig, da urheberrechtlich
geschtzt! 300 Baud Packet? (gibt es das schon fr Linux?)  PSK 31 -
warum? Gibt mindestens 5 gute PSK-Programme fr Linux.
MT63? MFSK? Man sagt, die sind besser als Pactor 1 !

LOG:
Einfhrung eines Contest-Zhlers, der sich bei jedem QSO um 1 erhht.
Pat Dir das Format in der Log-Datei? (Ich machte 2, Binrdatei zum 
Wiedereinlesen durch das Programm, Ascii-Datei zum Drucken 
/Weiterverarbeiten.) (Mit sprintf... kannst Du in 
hfterm/src/log.c in Funktion log_store die Ausgabe leicht ndern!).
Wer kennt sich mit Logformaten besser aus? 
Jeder Contest mchte ein etwas anderes Cabrillo-Format!
Weitere Formate zum Speichern z.B. ADIF?
Vielleicht wre es aber die bessere Idee, hfterm mit einem bestehenden 
Logprogramm zu verbinden! 
(Z.B. "hamlog", in SuSELinux 8.1. enthalten - das einige
schne Features, z.B. Suchfunktionen hat, allerdings ein ganz 
eigenes Format 'Call|Name|QTH|RST|Band....' verwendet.!)
("X-Log" soll gut sein aber nicht bei SuSE laufen).

WORLDMAP:
Axel macht was tolles: Zeigen der QTHs mit Hilfe von Daten aus dem Log.
Die Karte bereits von Axel vorbereitet, in hfterm/src/main ist die 
Berechnung des pixmaps auskommentiert (if MAP...endif) weil der 
Programmstart bei (m)einem langsamen Computer sonst 10 Minuten dauert.
Axel arbeitet an diesem Feature im Moment im Rahmen seiner 
Weiterentwicklung des Programms "Baken".
Habe das Pixmap ausgebaut. (3 MB...)

HILFE:
bersetzungen...
Dokumentation in HTML....
Erfahrungsberichte mit Pactor...!
Liste der optimalen TxDelays fr verschiedene Funkgerte...


Viel Spa !!
			    AUTHORS

Thomas M. Sailer	HB9JNX/AE4WA	Mail: sailer@ife.ee.ethz.ch
			
Ralf-Axel Krause	DF3JRK		http://www.df3jrk.de.vu
					Mail: df3jrk@gmx.de	
					Packet: df3jrk@df0hmb.hh.dl.eu.ww

Gnther Montag		DL4MGE  	http://www.hfterm.de.vu
 					Mail: dl4mge@darc.de
 					Packet: dl4mge@db0zka.bay.deu.eu

Bitte bei mailing list eintragen!!!:	
	https://lists.sourceforge.net/lists/listinfo/hfterm-hackers

Meldungen an die mailing list:
	hfterm-hackers@lists.sourceforge.net
	
Download der neuesten Version:
	http://sourceforge.net/projects/hfterm	
