= Info =
 Beschreibung:: Benutzerhandbuch zum SD2IEC

<<TableOfContents()>>

= SD2IEC Benutzen =

Das SD2IEC bietet eine Kommandoschnittstelle um Diskettenimages, die auf der
SD-Karte gespeichert sind, auszuwählen und in das Laufwerk einzulegen (zu
mounten). Die Kommandoschnittstelle ist über den Fehlerkanal (Kanal 16) des
Diskettenlaufwerks implementiert und Kommandos werden mit den Befehlen OPEN
and CLOSE abgesetzt. Im folgenden wird das Interface anhand von
Beispielen beschrieben. Das SD2IEC hat hier die default Gerätenummer 8.

== Kommando Interface ==

Nach dem Einschalten des C64 verhält sich das SD2IEC so, als würde der Inhalt
der SD-Karte der Inhalt einer Diskette sein. Er lässt sich mit LOAD und LIST
anzeigen.

''Inhalt der SD-Karte anzeigen'':
{{{
  LOAD "$",8
  LIST
}}}

Erst nach dem Auswählen/Mounten eines Diskettenimages kann auch dessen Inhalt
angezeigt werden.

''Diskette auswählen'':
{{{
  OPEN 1,8,15,"CD:<name>.D64":CLOSE 1
}}}
Erklärung:
  * OPEN: einen Kanal zu einem Gerät öffnen
  * 1: logische Dateinummer
  * 8: Geräte Nummer
  * 15: Fehlerkanal des Diskettenlaufwerks zum Senden von Kommandos
  * "CD:<name>.D64": CD Kommando: wähle Datei von SD Karte
  * CLOSE 1: Kanal 1 wieder schließen
Referenz:
  * OPEN: https://www.c64-wiki.de/index.php/OPEN

Nachdem die Diskette eingelegt wurde, kann auch deren Inhalt angezeigt werden.

''Disketteninhalt anzeigen'':
{{{
  LOAD "$",8
  LIST
}}}

Die Liste zeigt die Dateien und Programme, die auf dem Diskettenimage
vorhanden sind.

''Programm laden'':
{{{
  LOAD "<name>",8,1
}}}
Alternativ zum Tippen des LOAD Kommandos mit dem vollen Dateinamen kann auch
die Ausgabe des LIST Kommandos modifiziert werden. Einfach LOAD vor dem
angezeigten Namen schreiben und ,8,1 anfügen.

Referenz:
  * Programm laden: http://selmiak.bplaced.net/games/c64/index.php?lang=eng&game=Tutorials&page=Loading-a-program
  * LOAD: https://www.c64-wiki.de/index.php/LOAD

Nach dem Laden der Programmes in den Speicher des C64 kann es endlich
gestartet werden

''Programm starten'':
{{{
  RUN
}}}

Ein Einlegen eines anderen Diskettenimages erfolgen, indem es (wie zuvor auch)
über den Fehlerkanal des Diskettenlaufwerks ausgewählt wird. Soll der Inhalt
der SD-Karte nochmal angezeigt werden, muss die eingelegte Diskette wieder
freigegeben werden (unmounten).

''Diskettenimage freigeben'':
{{{
  OPEN1,8,15,"CD:←":CLOSE1
}}}
("←" ist ein C64-Symbol. Taste: links oben) und den *Inhalt der SD-Karte*
anzeigen:
{{{
  LOAD "$",8
  LIST
}}}


Wieder ''zum Root-Verzeichnis der SD-Karte wechseln'':
{{{
  OPEN1,8,15,"CD://":CLOSE1
}}}


''FileBrowser'':<BR>
Der CMB !FileBrowser bietet die Möglichkeit Diskettenimages über Tastatur
oder Joystick in einer Fileliste auszuwählen, zu mounten und Programme zu laden.
Außerdem kann durch die Verzeichnisse der SD-Karte gebrowst werden.

Referenz:
  * CMB !FileBrowser: http://www.vic20.it/cbmfilebrowser

Das auf der CMB !FileBrowser Seite (unten) angebotene Archiv
(`CBM-FileBrowser_v1.6.zip`) enthält das !FileBrowser Image unter `disk images/`.
Im Verzeichnis `programs/` liegt ein allgemeiner Loader, der einen
systemabhängige Teil lädt, welcher wiederum den CMB-!FileBrowser lädt und
startet. Für den C64 müssen im Root-Verzeichnis der SD-Karte folgende Dateien
kopiert werden:
{{{
  ./fb
  ./fb64
  ./cbm-filebrowser.d64
}}}

Der CBM-!FileBrowser Loader kann dann direkt nach dem C64 Start geladen und
gestartet werden (":" referenziert das Root-Verzeichnis der SD-Karte):
{{{
  LOAD":fb",8
  RUN
}}}

''AUTOSWAP.LST'':<BR>
gibt es auch noch ...
FIXME:
lokale, globale Referenzen moglich
  * !MultiDisk Listen testen: AUTOSWAP.LST
{{{
  turrican_2/
    t2_s1.d64
    t2_s2.d64
    autoswap.lst
}}}

Referenz zum SD2IEC firmware SW Interface:
  * SD2IEC Kommandoübersicht: http://www.c64-wiki.com/index.php/sd2iec_(firmware)

----
KategorieProjekt