Programm zur Ansteuerung eines Yaesu FRG9600 mit dem Computer-Interface
Version 2.7

Copyright 1995-96-97-98-99 Bernardo Rossi
Email brossi@geocities.com

==========================================================================
ACHTUNG: Wichtige Anmerkung, fuer den Fall, dass beim Start des Programms
eine Fehlermeldung erscheint 'Input past end of file', muss eure FRG.INI Datei
dem neuen Beispiel angepasst werden, da neue Eintraege hinzugekommen sind. 
In diesem Fall ist es auch empfehlenswert, die alte Datei FRG.SAV zu
loeschen.
===========================================================================

Es werden keine Garantien hinsichtlich der Funktion des Programms gegeben.

Bei Defekten, Beschaedigungen, Funktionsstoerungen oder anderes, bei dem
Computer, Interface, FRG9600 oder andere verwendete Apparate liegt die
Verantwortung allein bei euch.

Das Abhoeren oder Veroeffentlichen bestimmter Sendungen koennen illegal
sein, und koennen je nach Gesetz bestraft werden. Ihr allein seid dafuer
verantwortlich, dass die entsprechenden Gesetze befolgt werden.

Dieses Programm kann frei verteilt werden. Falls es euch gefaellt, waere
ein Dankschreiben an obige Email-Adresse ganz nett.

Dieses Programm muss mit allen unten aufgelisteten Dateien verteilt werden.
Sie duerfen nicht veraendert werden (Ausgenommen die .INI und .SET).
Es darf nicht gegen Bezahlung verteilt werden, ausgenommen die Selbstkosten
der Datentraeger, die es enthalten.

Falls die Datei FRG.EXE geaendert wird, wird das Programm nicht mehr
funktionieren. 
Diese Aenderungen koennen durch Beschaedigung, Virus, Checksummen von
Antivirus-Programmen, Kompressoren usw. verursacht werden.

Es werden auch Ratschlaege oder Kommentare ueber das Programm angenommen,
ich kann zwar keine Hilfestellung oder Fehlerbeseitigung garantieren, aber
mann kann ja nie wissen...


Das Programm besteht aus folgenden Dateien
------------------------------------------
FRG.EXE      Die ausfuehbare Datei
FRG.INI      Konfiguration des Programms
FRG-ITA.TXT  Anleitung auf italienisch
FRG-ENG.TXT  Anleitung auf englisch
FRG-DEU.TXT  Anleitung auf deutsch
FRG.SET      Alternative Setups fuer die Scan-Grenzen
STATION.VHF  Beispiel einer Datei mit gespeicherten Frequenzen
BRUN45.EXE   Runtime von QuickBasic 4.5, (c) Microsoft
FILE-ID.DIZ  Beschreibung des Programms
WHATSNEW.FRG Was gibt es neues?
FRG.SAV      Wird vom Programm angelegt, enthaelt verschiedene Einstellungen

Erforderliche Ausruestung:
--------------------------
Computer IBM kompatibel, funktioniert gut auf einem 386-25.
Grafikkarte VGA farbig, Aufloesung 640 x 480
Scanner Yaesu FRG-9600
Interface um diese zu verbinden. Ich habe es aus Bequemlichkeit in den FRG9600
eingebaut
Geeignete Kenntnisse um dass alles zum Funktionieren zu bringen :-)


FRG.INI
-------

Diese Datei kann den eigenen Erfordernissen angepasst werden. Die enthaltenen
Daten bedeuten:

1) COM-Port an welches das Interface angeschlossen ist. Com-Port kann 1 oder 
   2 sein.
2) Die Adresse in Hex des obigen COM-Ports. Falls dieser Wert=0 ist, werden
   die Standardadressen, COM1=&H3F8 und COM 2=&H2F8 angenommen. Sollte der
   eigene COM-Port eine abweichende Adresse besitzen, muss sie hier
   eingetragen werden. Falls dies nicht korrekt ist, wird nicht die Erkennung
   der besetzten Frequenzen funktionieren.
3) Der Name der Datei in welche die Stationen gespeichert werden sollen.
4) Die Frequenz die bei Programmstart am FRG eingestellt wird
5) Der Mode  der bei Programmstart eingestellt wird
6) Der untere Limit des Frequenzabschnittes
7) Der obere Limit des Frequenzabschnittes
8) Der Step des Frequenz-Scans
9) Programm-Piepser ein: soundon. Falls Ihr keine Piepser wollt, soundoff
10) Ein Befehl der ausgefuehrt werden soll, wenn der Dos-Shell aufgerufen
    wird, nuetzlich z.B. wenn ein Notizbuch zwischendurch benoetigt wird
11) Pause busy
12) Pause scan
13) Die Prioritaets-Frequenz
14) Der Zeit-Intervall in welchem die Prioritaets-Frequenz gescannt wird
15) Die Art des S-Meter Interface: joy (bei Joystick-Port), minix
    (falls ein Minix-Interface verwendet wird), none (Kein S-Meter Interface)

Die Punkte 4 5 6 7 8 11 12 13 beinhalten die Anfaenglichen Einstellungen, wenn
das Programm gestartet wird. Sie koennen dann im Laufe des Programms beliebig
geaendert werden.

Beispiel einer Konfigurations-Datei:

2                COM-Port 2
&H2F8            Adresse des Ports 2f8 Hex
station.vhf      Datei in welcher die Stationen gespeichert werden
1630000          Start-Frequenz des frg: 163.000.000 hz
FM-N             Start-Mode      "   " 
600000           Unterer Limit   "   "  :  60.000.000 hz
9050000          Oberer Limit    "   "  : 905.000.000 hz
250              Start-Step      "   "  :      25.000 hz
soundon          Piepser eingeschaltet
edit notes.frg   Befehl der bei Dos-Shell ausgefuehrt wird
200              Pause, wenn eine besetzte Station gescannt wird
0                Pause zwischen den einzelnen Scan-Schritten
1436250          Prioritaets-Frequenz 143.625.000 Hz
300              Zeitintervall, in dem die Prioritaets-Frequenz gescannt wird
joy              Der S-Meter wird ueber den Joystick-Port gelesen

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

Speicher-Datei
--------------
Die gefundenen Stationen werden in einer Datei gespeichert, deren Name in
FRG.INI stehen muss

Ein typischer Eintrag kann sein:

1002000,"PRIVATRADIO","FM-W"," radio vr 2000"

Die Daten bedeuten:
Frequenz - Gruppe - Mode - Name
Falls Ihr von Hand die Datei editieren wollt, muss darauf geachtet werden
dass die Anfuehrungszeichen an den richtigen Stellen stehen und die Frequenzen
in aufsteigender Reihenfolge gelistet werden,
Der Name muss von einem Leerzeichen oder einem * vorangegangen werden. In 
diesem Fall wird die Station uebersprungen.

Als letzter Eintrag zwingend vorgeschrieben:
9050000,"END","FM-N"," "

als Frequenz wird die hoechste Frequenz des FRG eingegeben.

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

FRG.SET

Hier koennen Scan-Bereiche gespeichert werden, die oft benoetigt werden.
Mittel Alt-F4 und des entsprechenden Buchstabens sind diese abrufbar.
Kann beliebig geaendert werden.

Ein typischer Eintrag kann sein:

1180000,1360000,500,AM-W,Air Traffic

Die Daten bedeuten:
Unterer Limit - Oberer Limit - step - mode - Bezeichnung des Bereichs


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

Alle wichtigen Daten erscheinen in einem Bildschirm. Dieser aehnelt etwas
dem Bedienfeld eines FRG9600. Die Einzelnen Funktionen werden durch Druck
auf die Funktions-Tasten (Z.B. F1), Alt-Funktionstaste (Z.B. AF1), Control-
Funktionstaste (Z.B. CF1) oder durch Mausklick aufgerufen

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

Signalstaerke-Anzeige (S-Meter): Bei Verwendung des vorgesehenen Interface
wird hier die Signalstaerke angezeigt.
Falls die vorgesehene Eintragung im FRG.INI 'joy' lautet, wird diese ueber
den Joystick-Port abgelesen, mit dem entsprechenden Interface.
Falls die vorgesehene Eintragung im FRG.INI 'minix' lautet, wird diese ueber 
das vorhandene Minix-Interface abgelesen. 
Falls die vorgesehene Eintragung im FRG.INI 'none' lautet, wird keine
Signalstaerke angezeigt, sondern nur der Squelch-Status. 
Um den S-Meter zu kalibrieren, muss gleich nach dem Programm-Start der FRG
auf eine Frequenz ohne Signal, und dann eine Frequenz mit maximaler Signal-
staerke eingestellt werden. Dies kann einfach geschehen, indem man einen
starken FM Rundfunksender eingibt, und dann auf LSB oder USB umschaltet.

Die S-Meter Anzeige ist noch ein Experiment. Ich haette gerne Mitteilungen
darueber, wie es fuer euch funktioniert.

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

Im unteren Bildschirmteil befindet sich der Spektrum-Analysator. 
Das Frequenz-Band, welches durch die oberen und unteren Limits begrenzt ist, 
wird in 4 Zeilen aufgeteilt, dessen Anfangsfrequenzen an der linken Seite
stehen.
Gescannte Frequenzen werden durch einen weissen Punkt angezeigt.
Gefundene besetzte Frequenzen werden durch einen zusatzlichen gelben Punkt 
angezeigt.
Die aktuelle Frequenz hat einen groesseren weissen Punkt.
Durch Mausclick auf eine beliebige Stelle des Analysators wird die entsprechen-
de Frequenz aufgerufen.

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

Pfeil auf - Pfeil ab: um die Frequenz manuell zu aendern. Aufwaerts ist
normalerweise etwas schneller als abwaerts. Eine kleine Pause kann auch
auftreten, wenn man am Ende des Bereichs angekommen ist, und man wieder zum
Anfang zurueckspringt. Klick auf einfachen Pfeil: es geht in einzelnen 
Schritten weiter, doppelter Pfeil: es geht dauernd weiter

F1: FREQUENCY: Durch Druck auf F1 kann eine beliebige Frequenz eingegeben
werden. Diese muss sich innerhalb der Limits befinden. Die letzten 2 Ziffern
werden nicht eingegeben, sie sind immer 00.

F2: STEP: Kann beliebig eingegeben werden. Letzten 2 Ziffern siehe oben.

F3: MODE: abwechselnd zwischen LSB, USB, AM-N, AM-W, FM-N, FM-W

F4-F5: LIMIT HI e LO: Es wird innerhalb dieser beiden Limits gescannt. Die
eigenen Limits des FRG koennen nicht ueberschritten werden. Die letzten 2
Ziffern werden nicht eingegeben, sie sind immer 00.

F6: NAME Station: Hier kann der abgebildeten Frequenz ein Name zugeordnet
werden. Dieser wird dann immer im Display angezeigt. Der Name wird automatisch
in der Stations-Datei gespeichert.

F7: GROUP: Die Frequenz kann einer bestimmten Gruppe zugeordnet werden.
Diese wird automatisch in der Stations-Datei gespeichert.

F8 SAVE - CF8 LOAD: Alle momentanen Einstellungen koennen in einer Datei
FRG.SAV gespeichert werden. Sie koennen dann zu einem spaeteren Zeitpunkt
wieder abgerufen werden. Bitte nicht mit der Datei FRG.SAV rumspielen, da
sonst unvorhersehbare Resultate erscheinen koennen.

F9: LIST File: Die Stations-Datei wird aufgelistet. Mit Pfeil-Ab oder Mausklick
auf die unterste Zeile wird die naechste Seite gelistet, mit Pfeil-Auf oder
Mausklick auf die oberste Zeile wird die vorherige Seite gelistet. Durch Druck
auf einen Buchstaben oder Mausklick auf einen Eintrag wird die entsprechende
Station aufgerufen, wenn deren Frequenz innerhalb der Limits liegt. Mit ESC
geht's wieder zur Hauptanzeige.

F10 oder ESC: QUIT: Ende des Programms.

Alt-F1: M CLEAR: Die Frequenz wird von der Stations-Datei entfernt.
Dies muss bestaetigt werden.

Alt-F2: SCAN on/off: Der automatische Scan wird ein-ausgeschaltet. Je nach 
Scan-Mode wird nach Frequenzen, Speicher oder Gruppe gescannt.

Alt-F3: ADD AUT: Wenn automatisch gescannt wird, werden alle gefundenen Sender
automatisch der Speicher-Datei zugefuegt. Nuetzlich, wenn die der FRG eine
Zeitlang von alleine laufen soll. Die Frequenz wird mit Datum und Uhrzeit
versehen, als Gruppe wird "SCANNED" vermerkt.

Alt-F4: SETUP: Die Datei FRG.SET wird aufgelistet. Durch Druck auf einen
Buchstaben oder Mausklick auf einen Eintrag wird die entsprechende Einstellung
aufgerufen, um schnell einen bestimmten Frequenzabschnitt abzurufen.

Alt-F5: SKIP: Durch Druck auf * bei einer gespeicherten Station, wird deren
Name ein * vorgelegt. In diesem Fall wird diese Station in zukunft ueber-
sprungen. Dies passiert nur wenn die Anzeige auf ON steht. Durch Druck auf
Alt-F5 wird die Anzeige auf OFF gestellt. Es werden dann auch die Stationen
mit dem * angezeigt. Nuetzlich, wenn man Stoersender usw. ueberspringen will.
Falls die Station noch nicht gespeichert war, muss man * zweimal druecken. 
Diese wird dann mit dem Namen *SKIP gespeichert. Wenn dann das * geloescht 
wird, wird auch die Station von der Liste entfernt.

Alt-F6: PAUSE SCAN: Pause zwischen den einzelnen Schritten, wenn von Hand oder
automatisch gescannt wird. Es sind keine Sekunden, sondern nur eine relative
Anzeige.

Alt-F7: PAUSE BUSY: Laenge der Pause, wenn eine Station gefunden wurde.
Es sind keine Sekunden, sondern nur eine relative Anzeige.
Wenn = 0 dann wird der Scan gestoppt.
Wenn = 1 dann wird der Scan solange angehalten, bis die Station auf Sendung
         ist, oder irgendeine Taste gedrueckt wird.

Alt-F8: SHIFT: Es kann der Shift-Wert geaendert werden.
Durch Druecken von '-' oder'+' wird der Shift-Wert der Frequenz ab- oder
zugezogen. Nuetzlich um Repeater-Eingaenge zu kontrollieren.

Alt-F9: MODE SCAN: Der automatische oder manuelle Scan kann ueber Frequenzen,
Datei oder Gruppe laufen.

   Frequency: Alle Frequenzen innerhalb des Limits werden gescannt, nach dem
              gewuenschten Step. Bei der Aufforderung F1 druecken.
   File: Alle gespeicherte Stationen werden gescannt, innerhalb des Limits.
         Bei der Aufforderung F2 druecken
   Group: Es werden alle Frequenzen gescannt, die unter einer bestimmten Gruppe
          gespeichert wurden. Erst muss die Datei gescannt werden, bis die
          gewuenschte Gruppe erscheint. Bei der Aufforderung F3 druecken.

   File-Gruppe: Falls innerhalb der Limits keine Stationen gespeichert wurden,
   erscheint ein Alarmton und die Mitteilung: No stations found

Alt-F10: SHELL: Es wird das Dos aufgerufen und das im FRG.INI angegebene 
Programm aufgerufen.

Ctrl-F1: Die Prioritaets-Frequenz kann geaendert werden.

Ctrl-F2: Das Scannen der Prioritaets-Frequenz wird ein- und ausgeschaltet.
         Die Pri-Frequenz wird in bestimmten Zeitintervallen gescannt, die 
         vom Wert in der FRG-INI abhaengen. Wenn sie dabei besetzt ist, wird 
         auf diese Frequenz umgeschaltet.

Ctrl-F10: Die Spektrum-Analysator wird geloescht

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

Fehlermeldungen:

FREQUENCY OUT OF LIMITS: Die eingegebene Frequenz ist nicht korrekt, ausserhalb
 der Limits

STEP oder FREQUENCY NOT CORRECT: Die Eingabe ist nicht korrekt

NOTHING SAVED: Station kann nicht geloescht werden, da nichts gespeichert war

ONLY F1 F2 F3: Nur die entsprechenden Tasten sind erlaubt

WRONG KEY PRESSED: Eine nicht erlaubte Taste wurde gedrueckt

NO STATIONS FOUND: Keine Stationen innerhalb der aktiven Limits gespeichert

NO SETTINGS SAVED: Es wurde keine Einstellung vorher gespeichert

NOT WHEN SCANNING GROUP: SKIP kann nicht eingeschaltet werden, when GROUP
gescannt wird und eine Station mit '*' angezeigt ist.

NO GROUP DISPLAYED: GROUP kann erst gescannt werden, wenn eine Station aus
der Datei angezeigt wird
