?_ u e \ l PQ Hilfe KC-Load Hilfe KC-Load h#s (11/03) ( @ wwwwwwwwwwwwwwwwp p w wp 7 p ww p 7 pp ww p pp ww p pp ww p p pp ww p p pp ww p ppww wp wppww wp wppww wp wppww 0 pwwp wp wwwwwwwwwwwwwwwwwwwwwwp0wwwwww p pww wppp0pwwp p pp ww 0pp ww ; pp wp w 0pp; wp wwp wp wwp 3wp wwp wwp w pwww w wwww ww wwwwp wwwwwwwwwww wwwwwwwwwwww wwwwwwwwwwwwwwwwwwwwwwwwww BrowseButtons() / & ;) z4 p |CONTEXT ^ |CTXOMAP AM |FONT HL |KWBTREE M |KWDATA TM |KWMAP M |SYSTEM |TOPIC |TTLBTREE U |bm0 Gf |bm1 yh |bm2 - # > FRn 9 0 D D M Y 1 4 M Y @ KC-Load - Kassetten-TransferE & > F Ȁ KC-Load Kassetten-Transfer a Y n o 0 > EP("start mailto:henrik.haftmann@e-technik.tu-chemnitz.de",0) KCLOAD.EXE ein Hilfsprogramm nicht nur fr KCEMU bertrgt Kassettendateien ber eine geeignete Soundkarte in den PC. Dabei knnen verschiedene Speicherformate ausgewhlt und bei Bedarf ber eine externe DLL selbst programmiert werden. Dieses Programm ist sicher nicht perfekt Bug-Berichte bitte an henrik.haftmann@e-technik.tu-chemnitz.de . 6 ' 6 Zum Programm G n 4 I b L} &4H ;! Vorwort Funktionsprinzip Erforderliche Hard- und Software 3 g ' 6 Bedienung N 4 I b 㠚H B - Hauptfenster Datei-Dialog Benutzerdefinierte Kodierung erstellen B g @ % : 0 Hilfe KC-Load h#s (5/13) 8 x 1 k x Vorwort3
@ ) " F Vorwort x e ' ' 0 Zu einem Emulator gehrt sich eigentlich die Mglichkeit, Kassettendateien irgendwie in den PC zu bekommen. Fr Disketten wird CDRIVE empfohlen. Bei Kassetten sieht das schon anders aus. Obwohl der Ur-PC auch ein Kassetten-Interface hatte, wurde das bei den Kompatiblen spter weggelassen. Erst seit sich Soundkarten in PCs allgemein durchgesetzt hatten, gibt es wieder eine Mglichkeit, Bandaufnahmen ohne Basteleien in den Computer zu lesen. Auerdem ermglicht KC-Load die umgekehrte Richtung: Daten auf Kassette speichern; das ist wohl eher fr Nostalgiker oder zur Erinnerung, wie sich das damals so anhrte. (Fr Programmierer auch zu Testzwecken.) F ' ? 0 Die ursprngliche Idee war, dass der emulierte Code im KCEMU die Kassettendateien einlesen knnte. Auf diese Weise knnte man jedes noch so exotische Format lesen. Das Problem ist jedoch, dass man dazu einen wirklich schnellen Computer braucht, und die Handhabung umstndlich bleibt. A e 1 M
H Funktionsprinzip< ( ) "& F Funktionsprinzip " 4 6 0 Die Kassettenaufzeichung erfolgt im FM-Verfahren, also Frequenzmodulation. Dabei ist die konstante Lnge einer Bitzelle nicht von Belang, d.h. ein Block mit vielen Nullen ist krzer als einer mit vielen Einsen. Die Mglichkeit der Amplitudenmodulation mit einer Soundkarte (z.B. Kantenglttung, Nulldurchgangsschtzung) wurde nicht vorgesehen; es wird einfach Rechtecksignal generiert bzw. erwartet. Grundlegende Unterprogramme sind ReadSwing, Messen der Zeit (Samples) zwischen zwei Nulldurchgngen, und WriteSwing, Ausgabe einer Halbschwingung mit vorgegebener Anzahl von Samples. Diese beiden Unterprogramme berwachen den Samplepufferberlauf und fordern ggf. von MMSystem den nchsten Puffer an. & ( H * " 0 Auf die beiden Unterprogramme kann jedes denkbare Kassettenformat aufgebaut werden, mit weiteren Unterprogrammen wie WriteByte, WriteBlock usw. Weiterhin arbeitet das Programm mit einer Multimedia-Task, eine Art Multithreading unter 16-bit-Windows. Als Folge knnen Sie whrend des Ladens/Speicherns unbekmmert das Fenster verschieben usw. Fr den kontinuierlichen Datenfluss ist es aber wichtig, dass keine groe Applikation gestartet wird; d.h. Rechenzeit muss dennoch laufend zur Verfgung stehen. Q " 1 SB Hard- und Software-ErfordernisseL # H ) "F F Hard- und Software-Erfordernisse A & % 8 0 Dieses Programm bentigt: b = J p:l " " Windows 3.1 (Standard-Modus) oder hher eine Soundkarte o.. mit einer Samplerate von 22kHz X & SB * " 0 Dieses Programm SB H bentigt mindestens Windows 3.1 im Standard-Modus demzufolge einen AT286 oder besser. Es ist 16bittrig und arbeitet daher auch unter WinOS2 und (vielleicht) WINE. Alle gngigen Soundkarten sind geeignet; sie muss 22kHz (Mono, 8bit) bei Wiedergabe und 11kHz oder 22kHz bei Aufnahme bewltigen. Ein einfacher PC-Lautsprecher-Treiber (speaker.drv) ist zur Wiedergabe nicht geeignet. Wie alle 16-Bit-Windows-Programme luft dieses Programm nicht unter 64-Bit-Windows-Versionen! Es sei denn, man installiert wine fr Windows, also den Windows-Emulator (ursprnglich) fr Linux. = B 1
= B D Hauptfenster8 SB B ) " F Hauptfenster X # B D 5 8] 0 "
Das Programm prsentiert sich als Dialogfenster, welches smtliche Einstellmglichkeiten auf einen Blick serviert. Beim Draufziehen von Dateien (Drag'n'Drop) werden diese ausgegeben. Klicke mit der Maus auf Dialogelemente, oder drcke TAB und ENTER, um detaillierte Hilfe zu erhalten. = B ]D 1 ]D F Datei-Dialog8 D D ) " F Datei-Dialog q ; ]D F 6 :y 0 " Das Laden und Speichern erfolgt generell netto, kein Hinzufgen oder Weglassen von Headern (Vorblcken). Werden Extra-Header gewnscht, muss der Schalter Mit Vorblock eingeschaltet werden. Die Wirkung dieses Schalters ist abhngig von der gewhlten Kodierung. (Hier fehlt dem Schreiberling noch Information!) C D IF 1 R = IF XL Laden von Kassette< F F ' * 6 Laden von Kassette l = IF H / ,{ 0 Dieser voreingestellte Schalter (ENTER lst Knopfdruck aus) startet den Einlesevorgang. Es wird das ausgewhlte Wave-In-Gert verwendet und die Daten ber die ausgewhlte Kodierung dekodiert. Das Speichern der erfolgreich eingelesenen Datei erfolgt generell am Ende. Dabei errt KC-Load einen geeigneten DOS-Dateinamen aus der vorhandenen Header-Information. Hinweis: Das Speichern im Z80-Format ist nicht explizit implementiert. Mit dem Laden werden die eingelesenen Blcke wie am KC in der blauen Statuszeile gelistet. (Betrifft nur KC85/1..4 und Turbolader MPM). ` : F QI & t 0 Folgende Zeichen mssen beim Einlesen beachtet werden: H K E X p:l > Block wurde fehlerfrei gelesen; Band weiterlaufen lassen ? Block wurde falsch gelesen; bitte Band etwas zurckspulen * Nicht erwartete Blocknummer gelesen; bitte Band vor- oder zurckspulen (je nachdem, welcher Block erwartet wird), ggf. Band weiterlaufen lassen und abwarten. ! Fehlerhafter Block wurde nach angebbarer Anzahl von Versuchen schlielich fehlerhaft eingelesen QI L ( 0 Bei den anderen Formaten erfolgen die Meldungen anders; bei BASICODE erscheint der Text; bei Turbolader h#s ist die Fehlerprfung systembedingt erst am Ende des gesamten Einlesevorgangs mglich. Q " K XL / .D 8 Diese Seite ins Hauptfenster G L L 1 4 " L Speichern auf Kassette@ XL L ' 2 6 Speichern auf Kassette L N / , 0 Mit diesem Schalter ffnet sofort der Dateiauswahl-Dialog, in dem Sie die zu speichernde Datei auswhlen. Mit dem OK beginnt der Speichervorgang ber das ausgewhlte Wave-Out-Gert und die Kodierung. Generell geht der Dateiname beim Speichervorgang verloren. Hinweis: Das Laden im Z80-Format ist nicht explizit implementiert. Mit dem Speichern werden die geschriebenen Blcke wie am KC in der blauen Statuszeile gelistet. (Betrifft nur KC85/1..4 und Turbolader MPM). F ! L ,O % B 0 Dabei gibt es nur ein Zeichen: q E N O , ( p:l < Block wurde fehlerfrei(?) geschrieben; Band weiterlaufen lassen w ,O G ' 0 Die anderen Kodierungen machen sich anders bemerkbar; BASIO G XL CODE schreibt den gespeicherten Text in die Statuszeile. Q " O / .D < Diese Seite ins Hauptfenster >
G ր 1 ~ ր Lese-Versuche7
' 6 Lese-Versuche d > ր q & } 0 Um den Benutzer nicht mit nervenden Messageboxen o.. bei fehlerhaften Blcken zu qulen, wurde bereits am KC eine Mglichkeit geschaffen, nach einer gewissen Anzahl von Leseversuchen automatisch den Block fehlerhaft zu lesen. So konnte und kann sich der Bediener ausschlielich dem Kassettenrecorder widmen und muss nicht zweiarmig arbeiten. Die Anzahl der Versuche ist hiermit einstellbar von 0 (fehlerhaften Block sofort lesen) bis 7; auch mit Maus unter Verwendung des Mini-Rollbalkens rechts. Die Zahl der Versuche wird sofort wirksam, also auch whrend des Lesens. 6
( 0 Vorgabe: 4 ;
q 1 L " > Lautstrke4
' 6 Lautstrke * "g 0 Bei der Wave-Ausgabe kann die Lautstrke graduell von 0 (Stille, UNSINN!) bis 7 (maximaler Hub, 98..98) eingestellt werden. Der Hub errechnet sich zu 2*Lautstrke. Vorgabe: 4 : - 1 ~ P
- ˍ Kodierung3 ` ' 6 Kodierung ~ - % 0 Entsprechend der Vielzahl emulierter Computer mit verschiedenen Kassettenformaten untersttzt KC-Load folgende Kodierungen: : ` [ { p:l " " " KC85/1..4, das Standardformat fr die KC-Reihe. Jeder Block umfasst 1 Byte Blocknummer, 128 Byte Nutzdaten und 1 Byte Prfsumme. Turbolader MPM, ein von Mhlhausen(?) stammendes Format mit gleichem Blockaufbau, aber doppelt so schnell. Turbolader h#s, ein von haftmann#software 1990/91 entwickelter Lader. Das Besondere: Der Code zum Turbo-Laden befindet sich im ersten Daten-Block (im gewohnten KC85/1..4-Format), so dass man keinen extra Lader braucht(e). Ist etwa dreimal so schnell; gravierender Nachteil ist, dass die Prfsumme erst am Schluss kommt. J b p:l " " Z1013, dieser Computer verwendet als einziger Blcke mit 32 Byte Nutzdaten. Dabei gibt es Dateien ohne und mit Header vom Extra-Programm HEADERSAVE. Meist kursieren Dateien mit Header, weil man sich ansonsten unbedingt Anfangs-, End- und Startadresse aufschreiben musste und die Dateien keinen Namen trugen. Etwa so schnell wie KC85/1..4 BASICODE, nicht nur ein BASIC-Dialekt, sondern auch ein gemeinsames Dateiformat, erschaffen von Radio Hilversum zur Vereinheitlichung der BASIC-Programme (besonders zwischen West-Computern). Sehr langsam. FSK-moduliertes RS-232 mit 1200 Baud, 8 Datenbits, 2 Stoppbits. Bit 7 invertiert. Trgerfrequenzen 2400 Hz (1-Bit), 1200 Hz (0-Bit). Keine Prfsummen, nur fr Text gedacht. 9 < K du p:l " - benutzerdefinierte Kodierungen; die Programme dazu befinden sich in DLLs mit der Endung .KCL, die sich im Startverzeichnis von KCLOAD.EXE befinden mssen. Wenn keine .KCL-Dateien gefunden wurden, erscheinen auch keine. Hinweise zum Schreiben solcher DLLs siehe Benutzerdefinierte Kodierung erstellen . > z ' . 0 Vorgabe: KC85/1..4 Q " < ˍ / .D \
@ Diese Seite ins Hauptfenster = z 1 > Ende/Abbruch6 ˍ > ' 6 Ende/Abbruch Q + & W 0 Dieser Schalter beendet das Programm KC-Load. Er wechselt whrend der Wave- Ein/Ausgabe zu einem Abbruch-Schalter; damit wird der Wave-Vorgang beendet. Die Taste ESC funktioniert nur bei Beschriftung Abbruch; das Programmende kann mit Alt+E, Alt+F4, System-Men oder Task-Manager erreicht werden. 6 > ŏ 1 P
* ŏ a Hilfe/ ' 6 Hilfe ŏ U * ŏ a + &T 0
Naja, muss ich den Schalter erklren? = 1 0
Installieren6 a ' 6 Installieren : B 0 Was macht denn SO ein Schalter? Zunchst wird KC-Load keinerlei Registry-Eintragungen vornehmen. Im Gegenzug vergisst es alle Einstellungen beim Beenden. Wollen Sie jedoch, dass KC-Load die Einstellungen (Lese-Versuche, Lautstrke, Kodierung und Wave-Gerte) sich merkt, drcken Sie diesen Knopf. Es wird sofort und ab jetzt auch bei jedem (normalen) Programmende gespeichert. < 1 ~ * x Wave-Gerte5 ' 6 Wave-Gerte 8 : 9 @ 0 Nur fr den Fall, dass Sie mehrere Soundkarten verwenden, knnen Sie hiermit die gewnschte auswhlen. Bei Wave-Mapper whlt Windows eine freie Soundkarte selbstndig aus (siehe auch Win95-Systemsteuerung / Multimedia / Audio / Bevorzugtes Gert). Falls keine Soundkarte auftaucht, ist entweder keine installiert, oder das Format 22kHz, Mono, 8bit (11kHz bei Aufnahme) wird nicht untersttzt. Falls Sie in diesem Falle Wave-Mapper auswhlen, kann das Programm sehr hart abstrzen (Ursache noch ungeklrt). & _ 0 Auerdem haben Sie die Mglichkeit, mit WAVE-Dateien zu arbeiten; KC-Load benutzt in diesem Fall immer eine Datei KCLOAD.WAV im aktuellen Verzeichnis (Name nicht nderbar). G : V 1 V Block (Status-Anzeige)@ ' 2 6 Block (Status-Anzeige) ? V ? L 0 8 < Hier knnen Sie KC-like den Lade- und Speicher-Vorgang verfolgen. Zur Erluterung der angezeigten Symbole sehen Sie unter Laden von Kassette und Speichern auf Kassette nach. Vielleicht erinnert Sie die weie Schrift auf blauem Grund an den KC85 W & , 1
x ,
Benutzerdefinierte Kodierung erstellenR ) ~ ) "R FO Benutzerdefinierte Kodierung erstellen , . ' 0 Die zu erstellende DLL muss (oder sollte mindestens einen der beiden) Eintrittspunkte mit folgenden Namen und Definitionen aufweisen: ~ @ N 0GO
procedure LOAD; export; {Laden von Kassette} ... procedure SAVE; export; {Schreiben auf Kassette} ... exports LOAD, SAVE; m . 1 0 0 Die Ordinalzahlen fr den Export sind beliebig. Der Kontext ist quasi ein Thread von MMTASK.TSK. (Ja, KCLOAD arbeitet multi-threaded!) Das regulre Ende dieser Unterprogramme entspricht einem Aufruf von EndProcess(true), was den Thread beendet. Diese beiden Routinen knnen sich zur Bewltigung ihrer Arbeit folgender Unterprogramme aus KCLOAD.EXE bedienen: ( x a 0O
function ReadSwing:Integer; far; external 'KCLOAD' index 2; {Flusswechsel erkennen, LOAD} procedure WriteSwing(Len:Integer); far; external 'KCLOAD' index 3; {Flusswechsel schreiben, SAVE} procedure EndProcess(OK:Boolean); far; external 'KCLOAD' index 4; {Vorzeitig abbrechen, LOAD und SAVE} procedure SetStatus(S:PChar); far; external 'KCLOAD' index 5; {Statuszeile setzen, LOAD und SAVE} function GetSizeData:Longint; far; external 'KCLOAD' index 6; {Restliche Datei-Bytes ermitteln, SAVE} function GetDataBlock(P:PChar; Size:Integer):Integer; far; external 'KCLOAD' index 7; {Datei-Bytes holen, SAVE} procedure AddDataBlock(P:PChar; Size:Integer); far; external 'KCLOAD' index 8; {Datei-Bytes schreiben, LOAD} procedure GetName(P:PChar; Size:Integer); far; external 'KCLOAD' index 9; {Dateiname beschaffen, SAVE} procedure SetNameHint(P:PChar); far; external 'KCLOAD' index 10; {Dateiname vorgeben, LOAD} G \ 0 Diese Programme sind weitestgehend selbsterklrend, hoffe ich. Das Len bei WriteSwing bzw. das Ergebnis bei ReadSwing versteht sich als Sample-Zahl bei 22kHz. Wie der Name EndProcess andeutet, kehrt diese Routine niemals zurck. Das Ergebnis von GetDataBlock ist die Anzahl der in den Puffer kopierten Bytes. Falls dagegen AddDataBlock keine Bytes mehr schreiben kann, kehrt diese Prozedur nicht zurck; es erscheint eine Fehlermeldung. :
I ` 0 Alternativ kann diese DLL in C oder Assembler(!) geschrieben werden; entsprechende Anweisungen mssen in die .DEF-Datei geschrieben werden. (Integer=int, PChar=LPSTR, Boolean=char.) Ist diese DLL fertig, muss sie in *.KCL umbenannt werden, damit sie von KCLOAD.EXE erkannt wird. Zum Testen der DLL ist es ntzlich, einen Breakpoint (asm int 3 end) zu Beginn der Unterprogramme LOAD und SAVE zu setzen. Hinweis: Eine solche DLL wurde noch nie geschrieben, wer's macht, ist der erste! 1 > 1 ] > j ,
j '
0 1 > 1 l Helv Times New Roman Symbol Arial Courier
= U L P
x = P
* > ~ "
M / & ;) i24 8
FA3C17E Abbruch Benutzerdefinierte Kodierung erstellen Block (Status-Anzeige) Datei-Dialog Ende Funktionsprinzip Hardware Hauptfenster Hilfe Inhalr $ Installieren ( Kodierung , Laden von Kassette 0 Lautstrke 4 Lese-Versuche 8 Software < Speichern auf Kassette @ Vorwort D Wave-Gerte H *?w ' .' } ) + \ \ |SYSTEM C:\WINNT\TEMP\~hc24 C:\WINNT\TEMP\~hc24
C:\WINNT\TEMP\~hc24 K
F:\PROGWIN\KCLOAD\KCLHELP.ICO K ' F:\PROGWIN\KCLOAD\KCLHELP.ICO
F:\PROGWIN\KCLOAD\KCLHELP.ICO K ( @ wwwwwwwwwwwwwwwwp p w wp / & ;) Lz KC-Load - Kassetten-Transfer M Vorwort Funktionsprinzip
Hard- und Software-Erfordernisse Hauptfenster = Datei-Dialog Laden von Kassette Speichern auf Kassette " Lese-Versuche ~ Lautstrke > Kodierung P
Ende/Abbruch Hilfe * Installieren Wave-Gerte x Block (Status-Anzeige) Benutzerdefinierte Kodierung erstellen / & ;) L4 p Ľ* jI }~ < .V P
- S L}M " 8 on" ;!
:x \
@> B= &4H H 2 ) lp
Z & MrEd Microsoft Draw Z & MrEd X X System ) _
& MrEd O 7 7
& MrEd G - - G - - ' ' lus
UD [ 5d lp tf <\ ! ̃ ̃ ̃ ̃ ̃ ̃ ̃ ̃ ̃ ̃ ̃ ̃ ̃ ̃ ̃ ̃ ̃ ̃ c ' [w' [w' [w' [w# [w#wp ( w#wp )w!p )w!p ) w p ) w!p ( w p
) w p
) w p
/ w p [w p [w p [w p [ p c p c !p [w!p [w!p [w!p [w"p [w#p [ w# [w' [w' [ w' [ w#
[ w#wp
[ w#wp
[ w!p [ w!p [w p [w!p [w p [ p c
p u p u p u p k p u p K p L!p N!p L!p L!p K"p
P#p
P#
x u# u#wp u#wp $N !p $Fw!p $Fw p Fw!p Fw
p Fw
p ( w p (w
p (w
p ( w
p ( w
p ( w
p ( w
p ( w!p $ ( w!p $Fw!p $Fw!p $Fw"p $F#p $N # O I OwpI NwpI Mp1 Mp1 p Ep1 p Ep p p1 p p p p p p p p p
p
p
p
p Mp
p Mp1p Mp1 p Mp1 p Np1 p Op1 p O 1 O I P I Nw I Nw 1 :x
w 1 p ?w 1 p Bx w p w 1 p x w p
w p x w p w x w w x w w p Bx w p Dw 1p :x
w 1 p Mw 1 p M 1 p P 1 p O 1 $ D
Dwp D
Dwp D
Dp D
Dp 6DODODDODODDDO7Dp 6DODDOODDODDDDDOD7Dp 6DOODDDDDODDODOOODO6Dp wx6DODDDODDODOOOODO6Dp x6DODDDODDODOOOODO6D p x6DODDODDODODODODO6D p 6DODDDODDODODDODO6D p 6DODDDDDDODDODODDODO6Dp 6DOODOODDODDDDODOD7Dp 6DODDDDODODDODO7Dp D
Dp D
Dp D
Dp D
Dp $
8 1 < , on 1 , } K K \
@ K K .V e J " K Ľ q * S / :Hotspot 10 Laden Hotspot 9 Speichern Hotspot 8 Versuche Hotspot 7 Lautst Hotspot 6 Kodierung Hotspot 5 Ende Hotspot 4 Hilfe Hotspot 3 Install Hotspot 2 WaveDev Hotspot 1 Status d [ lp ^ $ ? _ o wp z } z wp o _ ?
| Vorgefundene Kodierung: UTF-8 | 0
|