Titre Fastdsk


FASTDSK: Documentation française. Dernière révision: mardi 05/05/2009

 
NOUVEAU: La version 20090504 est à présent compatible GS.


I) PRESENTATION


FASTDSK est un programme FREEWARE pour ordinateur Apple II.
Il fonctionne sous le système d'exploitation ProDOS et permet de créer rapidement des disk images à partir de disquettes physiques 5 pouces 1 / 4.
Ces disquettes physiques doivent avoir le format standard de cette machine, à savoir 35 pistes avec 16 secteurs par piste.

Il permet de stocker le contenu de vos disquettes Apple II sous forme de fichiers de 143360 octets (=140k) par face.
Ces fichiers ont l'extension classique .DSK.
Une fois ces disk images récupérés sur une machine moderne, vous pourrez continuer à utiliser les données présentes dessus grâce à des émulateurs d'Apple II.


Il existe actuellement plusieurs solutions possibles pour créer des disk images .DSK.
Certaines nécessitent de relier l'Apple II à un PC ou à un MAC et d'utiliser un logiciel pour assurer le transfert entre les 2 (comme ADT, ADT Pro, ...)

FASTDSK ne fonctionne pas ainsi : il ne communique pas directement avec une autre machine.
Pour son mode opératoire, il se rapproche plutôt du logiciel DSK2FILE.
En effet il créé directement les .DSK sur une unité ProDOS amovible reliée à l'Apple II. Cette unité amovible peut ensuite être lue et exploitée sur un ordinateur récent avec des programmes comme le fameux CiderPress de FaddenSoft. Cette méthode accélère considérablement le temps de création d'un fichier image car elle n'est pas tributaire d'une communication lente au travers d'une carte d'extension SSC et d'un cable série.

FASTDSK est très spécialisé. Il ne permet que le transfert dans le sens : disquette Apple II vers fichier disk image .DSK.
MAIS... il dispose des atouts suivants (par rapport à DSK2FILE) :


Configuration nécessaire:

APPLE:

PC:

Notes: FASTDSK ne fonctionne pas sur certains modèles anciens de Franklin Ace 500 et sur Mac avec carte d'émulation IIe.

II) UTILISATION


II.1) Démarrage

Le disk image contenant FASTDSK est bootable.
Si ce n'est pas le cas avec la version en votre possession, voici la procédure à suivre.

FASTDSK est constitué de 3 objets :

FASTDSK.SYSTEM (SYS)
FASTDSK.CONF (BIN)
FASTDSK (BIN)

Pour démarrer, vous devez lancer le programme système FASTDSK.SYSTEM.
Ce launcher se lance à partir d'un sélecteur de programmes comme celui inclus dans ProDOS en tapant BYE.

Vous pouvez aussi l'exécuter à partir de BASIC.SYSTEM en tapant :
-FASTDSK.SYSTEM

Vous pouvez aussi mentionner un nom de volume et un ou plusieurs répertoires si le répertoire courant ou vous êtes positionné n'est pas celui contenant FASTDSK. Pour cela, tapez au choix :
-/volume/directories/FASTDSK.SYSTEM ou -directories/FASTDSK.SYSTEM


II.2) Version

Lorsque FASTDSK est démarré, apparaît en haut à gauche de l'écran la taille de la mémoire que le programme peut utiliser.
Si c'est 128k, alors la lecture se fera en 2 fois mais si c'est 256k alors FASTDSK ira à sa vitesse optimale et lira une disquette en une seule passe.
Ici un écran de démarrage des versions 256k et 128k:

Running FASTDSK
Running FASTDSK

Pour identifier chaque nouvelle version, je n'ai pas utilisé un numéro mais la date de release du programme. Cette date se trouve dans le titre, à droite de FASTDSK. Sur l'exemple précédant, c'est la version 20061130.
Utilisez toujours la dernière version sortie qui corrige les éventuels bogues découverts.

Vous aurez remarqué que FASTDSK a un look « old-style » en 40 colonnes ressemblant au logiciel bien connu : LOCKSMITH FAST COPY.
C'est bien normal puisque ce programme est la référence en la matière de copie rapide. FASTDSK revendique aussi une grande rapidité par rapport à son concurrent DSK2FILE.


II.3) Configuration

Vous êtes à présent au niveau du menu principal.
FASTDSK vous informe toujours des touches que vous pouvez utiliser en les indiquant en bas de l'écran.

La première chose à faire est de configurer FASTDSK en tapant la lettre C sur votre clavier.

Il y a plusieurs informations à modifier. Déplacez vous avec les touches UP et DOWN pour aller d'une option de configuration à l'autre et faites RETURN pour modifier.

Running FASTDSK



Pour quittez le menu de configuration, tapez ESC.
Le programme vous demandera alors si vous souhaitez sauvegarder dans le fichier FASTDSK.CONF la configuration. Ceci est utile si vous voulez retrouver cette configuration la prochaine fois que vous lancerez FASTDSK.
Si vous répondez "N", alors vous devrez repasser par le menu de configuration la prochaine fois.


II.4) Création de disk images

Utilisez l'option G du menu principal pour lancer la création.
Si aucun répertoire n'est défini dans la configuration alors vous obtiendrez un message d'erreur :

Running FASTDSK

FASTDSK vous demandera d'insérer la disquette dans le lecteur et d'appuyer sur une touche pour le lancement.
Si vous avez activé la numérotation automatique (USE STD NAME = "Y") alors pour pouvez quand même modifier le nom par le biais des touches + et -. Ceci peut être nécessaire si par exemple vous traitez une disquette n'ayant qu'une seule face car le programme vous positionne d'office sur la face Back après avoir créé un .DSK pour la face Front.
Ici, pour passer à la disquette suivante et modifier le nom en adéquation (GR00002F.DSK), je dois juste appuyer sur la touche +:

Running FASTDSK

La touche SPACE vous permet de lancer le processus.
A noter qu'il faut 283 blocks ProDOS free pour sauver un .DSK. Un contrôle est systématiquement effectué avant de commencer le traitement de chaque disquette. La disquette n'est pas lue s'il n'y a pas la place disponible.
Exemple de message d'erreur indiquant que la place "REQ"uise n'est pas disponible:

Running FASTDSK

Le nom du fichier ne doit pas avoir été déja utilisé. Si c'est le cas, que vous soyez en mode automatique ou en mode manuel, il vous sera demandé si vous voulez ou non supprimer le fichier existant portant ce nom. Si vous répondez Yes, le fichier existant sera détruit, dans le cas contraire, le programme repasse soit sur la saisie du nom si le mode manuel est activé (en pré-affichant celui précédemment écrit) soit vous donne la main pour utiliser + et - pour changer le nom standard.

Running FASTDSK
Running FASTDSK

Si c'est ok, FASTDSK indique le statut de progression dans la carte des secteurs et au niveau de la ligne des statuts de pistes. Le caractère '.' signale que c'est OK.
Si pour un secteur apparaît un chiffre de 1 à 9, ceci signifie que le programme a dû s'y reprendre à plusieurs fois pour le lire correctement. Ceci n'est en rien génant au final (à part le ralentissement du traitement de la piste); ce nombre étant affiché pour information (uniquement). Au delà de 10 tentatives, le secteur est déclaré HS.
Tout autre signe en vidéo-inverse indique une anomalie.

Running FASTDSK

Si vous stockez les .DSK au niveau root d'une unité ProDOS, il ne faut pas dépasser 51 noms en tout. Au delà, vous vous exposez au message "CAN'T CREATE TARGET FILE".

Note du 08/01/2007: j'ai traité avec mon programme environ 500 disquettes pour le moment.
J'ai constaté que pour certaines d'entres elles qui n'avaient pas été utilisées depuis très longtemps, il arrive qu'à la première lecture il y ait beaucoup d'erreurs (frottement du disque de mylar, ...?). En les repassant une seconde fois (ou plus), le nombre d'erreurs peut diminuer. ->Il ne faut donc pas hésiter à insister.
J'ai par ailleurs réussi à créer des .dsk pour des disquettes que je pensais être mortes: en bootant un jeu par exemple, il y avait plantage sur l'apple II mais le disk image lui fonctionne. En effet il arrive que la routine drive d'un soft soit beaucoup plus exigeante que mon programme quant au nombre max d'erreurs tolérées. FASTDSK fait 10 lectures avant d'abandonner alors que des jeux se crashent si un secteur n'est pas lu en moins d'essais que cela.


II.5) Touches particulières

Au niveau du menu principal, la touche Q permet de quitter FASTDSK.
Si vous utilisez la numérotation automatique des disk images (USE STD NAME = "Y") et si vous voulez quitter le programme, alors FASTDSK vous demandera si vous voulez sauvegarder la configuration si vous avez créer au moins un .DSK.
Ceci est destiné à prendre en compte les valeurs actuelles de NNNNN et S pour le prochain lancement de FASTDSK.

Running FASTDSK

Dans le menu principal, il y a 2 options spéciales qui ne sont pas mentionnées :


III) INFORMATIONS TECHNIQUES


III.1) Présentation des sources et des objets

FASTDSK a été écrit avec l'assembleur Merlin 8 2.58 sous ProDOS.


FASTDSK.SYSTEM utilise les sources suivant :

INCLUDE.FD.S     includes de FASTDSK
FASTDSK.SYS.S    programme de lancement
QSREADP.S        routine de chargement d'un objet ProDOS en mémoire principale
QSPRINT.S        routine d'affichage d'un message en 80 colonnes
MLIQUIT.S        routine d'appel à MLI Quit
WAITKEY.S        routine d'attente d'une touche dans une liste autorisée


Pour construire l'objet FASTDSK.SYSTEM, il faut taper sur une ligne de commande de l'éditeur Merlin : LINK $2000  "LNK.FD.SYS"
L'objet LNK.FD.SYS mentionné dans cette commande doit au préalable être construit en assemblant le source LNK.FD.SYS.S.


FASTDSK.CONF contient les données de la configuration de FASTDSK.
Pour construire cet objet, il suffit d'assembler le source FASTDSK.CONF.S.


FASTDSK est le programme principal. Il utilise les sources suivants :

INCLUDE.FD.S     includes de FASTDSK
FASTDSK.S        programme principal
MLIQUIT.S        routine d'appel à MLI Quit
WRITE40C.S       routine d'affichage en 40 colonnes
WAITKEY.S        routine d'attente d'une touche dans une liste autorisée
CONFIG.S         routine de gestion de la configuration
DIR.SEL.S        routine de sélection d'un volume et d'un répertoire
SUPER.INPUT.S    routine effectuant un input contrôlé
FASTLOAD.S       routine de chargement d'une disquette en mémoire
RDSECDTA.S       routine disk II de plus bas niveau


Pour construire l'objet FASTDSK, il faut taper sur une ligne de commande de l'éditeur Merlin : LINK $8E00 "LNK.FASTDSK".
L'objet LNK.FASTDSK mentionné dans cette commande doit au préalable être construit en assemblant le source LNK.FASTDSK.S.


III.2) Organisation de la mémoire

Mémoire principale au démarrage :

$2000-$25FF        FASTDSK.SYSTEM   


FASTDSK.SYSTEM charge la configuration et lance FASTDSK. Une fois qu'il a fait cela, la place qu'il occupait est libre.

Lors du chargement d'une disquette, l'utilisation de la mémoire dépend de la capacité de la ram.

********** Si 128k :

1er passage

Mémoire principale :                Mémoire auxiliaire :

$0800-$17FF        Piste $00        $0800-$17FF        Piste $08
$1800-$27FF        Piste $01        $1800-$27FF        Piste $09
$2800-$37FF        Piste $02        $2800-$37FF        Piste $0A
$3800-$47FF        Piste $03        $3800-$47FF        Piste $0B
$4800-$57FF        Piste $04        $4800-$57FF        Piste $0C
$5800-$67FF        Piste $05        $5800-$67FF        Piste $0D
$6800-$77FF        Piste $06        $6800-$77FF        Piste $0E
$7800-$87FF        Piste $07        $7800-$87FF        Piste $0F
$8800-$8BFF        Buffer open
$8C00-$8DFF        FASTDSK.CONF
$8E00-$BEFF        FASTDSK

2nd passage

Mémoire principale :                Mémoire auxiliaire :

$0800-$17FF        Piste $10        $0800-$17FF        Piste $18
$1800-$27FF        Piste $11        $1800-$27FF        Piste $19
$2800-$37FF        Piste $12        $2800-$37FF        Piste $1A
$3800-$47FF        Piste $13        $3800-$47FF        Piste $1B
$4800-$57FF        Piste $14        $4800-$57FF        Piste $1C
$5800-$67FF        Piste $15        $5800-$67FF        Piste $1D
$6800-$77FF        Piste $16        $6800-$77FF        Piste $1E
$7800-$87FF        Piste $17        $7800-$87FF        Piste $1F
$8800-$8BFF        Buffer open      $8800-$97FF        Piste $20
$8C00-$8DFF        FASTDSK.CONF     $9800-$A7FF        Piste $21
$8E00-$BEFF        FASTDSK          $A800-$B7FF        Piste $22



********** Si 256k :

Mémoire principale :                Mémoire auxiliaire (bank 0 aux):

$0800-$17FF        Piste $00        $0800-$17FF        Piste $08
$1800-$27FF        Piste $01        $1800-$27FF        Piste $09
$2800-$37FF        Piste $02        $2800-$37FF        Piste $0A
$3800-$47FF        Piste $03        $3800-$47FF        Piste $0B
$4800-$57FF        Piste $04        $4800-$57FF        Piste $0C
$5800-$67FF        Piste $05        $5800-$67FF        Piste $0D
$6800-$77FF        Piste $06        $6800-$77FF        Piste $0E
$7800-$87FF        Piste $07        $7800-$87FF        Piste $0F
$8800-$8BFF        Buffer open
$8C00-$8DFF        FASTDSK.CONF
$8E00-$BEFF        FASTDSK

1er bank aux. (après bank 0) :      2nd bank aux. (après bank 0) :

$0800-$17FF        Piste $10        $0800-$17FF        Piste $18
$1800-$27FF        Piste $11        $1800-$27FF        Piste $19
$2800-$37FF        Piste $12        $2800-$37FF        Piste $1A
$3800-$47FF        Piste $13        $3800-$47FF        Piste $1B
$4800-$57FF        Piste $14        $4800-$57FF        Piste $1C
$5800-$67FF        Piste $15        $5800-$67FF        Piste $1D
$6800-$77FF        Piste $16        $6800-$77FF        Piste $1E
$7800-$87FF        Piste $17        $7800-$87FF        Piste $1F
                                    $8800-$97FF        Piste $20
                                    $9800-$A7FF        Piste $21
                                    $A800-$B7FF        Piste $22


III.3) Informations diverses


IV) REMERCIEMENTS ET LIENS


Mes chaleureux remerciements aux personnes ou sociétés suivantes :


Liens internet :


V) TELECHARGEMENT

Dernière version compatible Apple IIe et Apple IIgs (merci à David Empson et Thierry Bauvoi):

Floppy
ProDOS
Download FastDSK 20090504
HDD
ProDOS
Download FastDSK 20090504 source code


Première version (IIe uniquement):

Floppy
ProDOS
Download FastDSK 20061215 (gzipped)
HDD
ProDOS
Download FastDSK 20061215 source code (gzipped)