Bien Debuter Sur Impdos

Bien débuter sur iMPdos

• (update : 18/11/2022)

Comme indiqué au boot, quand on ne sait pas ce que l'on peut faire et comment cela fonctionne, une simple commande :

• |hlp (Affiche l'aide)

Le fichier help.bin doit être installé la première fois sur xMass. Une fois le premier ùhlp, vous pourrez l'effacer.

Comment Sélectionner un Drive ?

La sélection des drives se fait naturellement. Ainsi :

• ùp1 permet de sélectionner la partition 1 de 128mb de la xMass
• ùp2 permet de sélectionner la partition 2 de 128mb de la xMass
• ùp3 permet de sélectionner la partition 3 de 128mb de la xMass
• ùp4 permet de sélectionner la partition 4 de 128mb de la xMass
• ùx permet de sélectionner le lecteur courant de la xMass

Mais, quelles différences entre les RSXs ùP1/P4 et ùx ?

Les premières permettent de sélectionner la bonne partition mais réinitialisent obligatoirement le chemin alors que la dernière sélectionne la partition courante ainsi que le dernier chemin.

NB : en cas de reset ou d'extinction du cpc, la partition ainsi que le chemin sont conservés.

Comment Sélectionner un chemin ?

Une fois, la partition sélectionnée via ùpx (x allant de 1 à 4), un simple CAT affichera le catalogue du lecteur. Concernant les partitions, sachez qu'il n'y a qu'une seule partition utilisable sur une DOM 128mo.

Ensuite, la commande ùcdx,"repertoire" vous permettra d'entrer dans le bon répertoire.
Notez que load"repertoire/" fonctionne également.

Par exemple :

ùcdx,"games"

ou

load"games/"

vous entrez dans le répertoire games

On peut également accéder à plusieurs répertoires par exemple :

ùcdx,"games/gryzor"

ou

load"games/gryzor/"

Le "/" est important pour l'instruction load car elle signifie répertoire.

Par exemple :

load"games/gryzor/gryzor.bin

va dans le répertoire games, puis dans le répertoire gryzor et charge le fichier gryzor.bin.

iMPdos est en surcouche avec l'Amsdos située en rom 7, ce qui signifie que la plupart des instructions i/O sont supportées.

Ainsi, cat, load, save, et run" , fonctionnent sans aucun soucis.

il existe cependant leurs alter-égos à savoir, ùcat pour "cat", ùl pour "load", et ùr pour run"

Il y a également quelques petites différences entre certaines d'entres elles. Ainsi, ùr,"nomdufichier" sera une excellente alternative à run"nomdufichier".En effet la 1ère forcera le lecteur xMass même si celui-ci est remis à zéro lors de la réinitialisation de la rom7.

Voyons maintenant unes à unes toutes les Rsx disponibles :

Afficher le header d'un fichier

ùinf,"myfile"

Qu'est-ce que le header d'un fichier ?

C'est ce que l'on appelle l'en-tête. Celui-ci contient une mine d'informations puisque vous trouverez ainsi, le type de fichier (bas, binaire, ascii), le point d'entrée (l'adresse de début du fichier), la longeur du fichier, ainsi que l'adresse d'execution.
J'aurais pu m'arrêter là,mais j'ai décidé d'afficher également sur quel secteur de la xMass était sauvegardé le fichier ainsi que le nombre de secteurs utilisés par celui-ci.

Quelques explications ?

• Le type désigne le type de fichier, à savoir basic (0,1), binaire (2) et ascii (&16)
• StartAdr est l'adresse de départ du fichier
• Lenght est la longueur du fichier
• Exec est l'adresse d'execution
• NbSect est le nombre de secteurs utilisés dans le fichier
• StSect est le 1er secteur sur lequel se trouve le fichier.

Accès aux répertoires

ùcdx,"monrep"

ou

load"monrep/"

La commande initiale sur iMPdos était ùcd mais pour ne pas "bloquer" la rsx de la rom de la M4 qui s'appelle également ùcd, j'ai décidé d'ajouter un x afin de préciser que nous voulons sélectionner le répertoire sur la xMass.
Un truc important à noter, le répertoire peut contenir jusqu'à 11 caractères.

il est important de savoir que chaque répertoire ne peut contenir que 64 fichiers ou repertoires au maximum. Le root ou la racine, contiendra quand à elle au maximum, 512 fichiers, enfin 511, car un repertoire trash est crée au formatage.

Ainsi, lorsqu'un répertoire est crée, il reste 62 62 entrées disponibles car 2 autres sont déjà utilisées par les répertoires crées [..], et [trash].

Qu'est-ce que ces répertoires crées ?

[..] permet de revenir sur le répertoire précédent ùcdx,".." ou load"../"
[trash] c'est le répertoire poubelle. C'est ici que sont envoyés les fichiers doublons. Ainsi, lorsque vous enregistrez 2 fois le même fichier, l'ancien est copié dans le trash et le nouveau sera enregistré dans le répertoire courant.

ùcdx,"/" permet de revenir à la racine
ùload"/" permet de revenir à la racine

Créer un nouveau répertoire

ùmd,"monrep"

ou

save"monrep/"

Le répertoire monrep est créé dans le répertoire courant dans la limite des 64 fichiers expliqués plus haut.
Le nom du répertoire peut contenir jusqu'à 11 caractères.

Effacer un répertoire

ùrd,"monrep"

Une confirmation vous sera demandée avant d'effacer le repertoire "monrep", en cas de mauvaise manipulation.

Effacer un fichier

ùdel,"myfile.aaa"

ou

ùera,"myfile.aaa"

Le fichier "myfile.aaa" sera effacé. Aucune confirmation n'est demandée.

Renommer un fichier

ùrfile,"newfile","oldfile"

Le fichier oldfile sera renommé en newfile

Renommer un répertoire

ùrdir,"newdir","olddir"

Le répertoire olddir sera renommé newdir.

Formater votre xMass.

Avant de formater votre xMass, il faudra, au préalable sélectionner la bonne partition, via les , commandes ùp1, ùp2, ùp3 ou ùp4, surtout si vous voulez éviter de formater la mauvaise partition. En effet, imaginez que vous soyez sur la partition numéro 4, si vous lancez le formatage, celle-ci sera formatée. Ce serait un peu bête si vous pensiez formater la partition 2.

Concernant, le formatage de la xMass :

|format,numèro de partition (1-4)

Le formatage ne dure que quelques secondes.
Une confirmation vous sera demandée avant chaque formatage. Pensez bien à vérifier si vous formattez la bonne partition!

Installer un boot xMass

ùinstall

Cette instruction est à utiliser seulement si la track0 si celle-ci à été corrompue.

Créer un boot différent au lancement du cpc.

ùautoexec,mode,border,ink0,ink1

Un système de boot a été intégré permettant dans le cas présent de choisir :

1. le mode graphique
2. La couleur du border
3. La couleur du ink 0
4. La couleur du ink 1

par exemple, avec ùautoboot,2,6,0,26, le cpc bootera en mode 2, border 6, ink 0 en noir et ink1 en 26

ùraz

Cette commande permet de réinitialiser l'autoboot aux valeurs d'origine du boot cpc, à savoir, mode 1, border 1, ink 0 à 1, et ink 1 à 24.

L'éditeur de secteur

Il m'est apparu comme essentiel dès le début du code d'iMPdos, de créer un éditeur de secteur * à la Discologie * afin de pouvoir naviguer rapidement dans les secteurs de la xMass.

ùed,&0201,00

on édite le secteur 000201 de la xMass. Ce secteur est en fait le secteur du root de votre xMass.

J'ai ensuite ajouté 2 autres commandes à l'éditeur :

ùed

qui permet d'afficher le secteur courant dans l'éditeur de secteur

ainsi que

ùed,"malfunct.bin"

qui affiche le 1er secteur du fichier "malfunct.bin"

Editeur Mémoire Ram

Lors de l'Alchimie 13, Sid m'avait demandé s'il était possible d'éditer la ram à la façon d'un éditeur de secteur.

ùmed,&A700

L'éditeur affiche maintenant les codes hexa/ascii à partir de l'adresse #A700.

Copie un fichier xMass d'un répertoire à un autre

ùmove,"/001/toto.scr","/gfx/17k : copie le fichier toto.scr du répertoire 001 dans les répertoires gfx 17k. Le fichier source toto.scr est toujours présent dans le répertoire 001. Un ùdel ou un ùera effacera l'ancien fichier.
la présence du 1er / permet à la commande de partir du boot et non du répertoire courant.

Backup & Restauration

Un backup des partitions 1, 2 ou 3 peut être maintenant réalisé. Pour cela, la partition 4 est utilisée comme backup. Il reste toujours possible d'utiliser la partition 4 comme les 3 premières, à savoir, sauvegarder, charger, copier,… des fichiers.

ùbackup,1 : sauvegarde la partition P1 vers la partition 3 (p3)
ùbackup,2 : sauvegarde la partition P2 vers la partiton 4 (p4)

Dans le cas d'un backup sur iMPdos 128, la partition 1 est copiée sur la deuxième moitié de la DOM ) partir du secteur #020000.

ùrestore,numéro_de_partition : numéro de partition est compris entre 1 et 2.
ùrestore,2 -> recopie la partition P4 vers P2
ùrestore,1 -> recopie la partition P3 vers P1

** Dans le cas d'un backup sur iMPdos 128, seul ùrestore,1 reste fonctionnel.**

Dans le cas d'un backup ou d'une restauration, une confirmation vous sera toujours demandée.

Clear xMass Cache

ùclear

Efface les 2 mémoires caches de la xMass. A n'utiliser que lorsque la mémoire cache pose problème dans iMPdraw.

Affichage de la version d'iMPdos

ùv : affiche la version d'iMPdos.