PV16SOG commands shell

Interpréteur de commandes du PV16SOG

Licence

Ce document fait partie du projet PV16SOG et est fourni sous licence CC-NC-SA-BY V3.0

auteur: Jacques Deschênes
révision 1.0
Copyright: 2015,2016, Jacques Deschênes

Présentation

Au démarrage l'ordinateur entre dans l'interpréteur de commande. Au début de la ligne apparaît un > suivit d'un curseur clignotant. Ceci indique que l'ordinateur est prêt à recevoir des commandes. Les commandes sont insensible à la casse. voici de quoi a l'air la console au démarrage:


PV16SOG shell
vesion 1.0

RAM libre: 20512
>|

L'ordinateur peut-être réinitialisé (redémarrage à froid) en tout temps, même pendant l'exécution d'un programme BASIC par la combinaison de touches <CTRL-ALT-SUP> comme à l'époque de MS-DOS. Pratique lorsqu'un progamme BASIC est bloqué dans une boucle infinie.

Il faut distinguer les commandes du shell et les commandes BASIC. L'interpréteur accepte les 2 types de commandes mais elles sont traitées différemment.

Les commandes du shell sont interprétées directement et ne peuvent pas être utlisées dans un progamme BASIC. Une telle tentative résulte en un messsage d'erreur du compilateur BASIC. Les commandes BASIC sont pré-compilées en bytecode et le dit bytecode est passé à la machine virtuelelle BASIC pour exécution. L'interpréteur de comamnde du shell est en mesure de distinguer les 2 types de commandes et de diriger les commandes BASIC au compilateur.

Ce document décris seulement les commandes du shell pour les commandes BASIC il faut consulter le manuel BASIC du PV16SOG.

Le shell possède un éditeur de ligne avec un historique de comamndes de 10 lignes. La navigation sur la ligne de commande se fait avec les touches suivantes:

FLÈCHE-GAUCHE déplacement du curseur vers la gauche d'un caractère.
FLÈCHE-DROITE déplacement du curseur vers la droite d'un caractère.
FLÈCHE-HAUT déplacement dans l'historique de commande vers les plus anciennes.
FLÈCHE-BAS déplacement dans l'historique de commande vers les plus récentes.
INSERT basculement entre mode insertion/écrasement.
SUP suppression du caractère à la position du curseur.
ARRIÈRE suppression du caractère avant la position du curseur.
RETOUR termine la saisie de cette ligne et passe la commande à l'interpréteur.

Référence des commandes du shell

La majoritée des commandes du shell servent à la gestions des fichiers enregistrés sur la carte SD. PV16SOG ne supporte pas les répertoires, tous les fichiers sont dans le répertoire racine. Certaines commandes de gestion de fichiers peuvent affecter plus d'un fichier par l'utilisation du caractère *. Ce caractère peut-être placé au début, à la fin ou au 2 extrémités d'un paramètre nom_de_fichier d'une commande. Placé au début la commande accepte tous les fichiers se terminant pas la chaîne qui le suit. Placé à la fin la commande accepte tous les fichiers commençant par la chaîne qui le précède. Lorsque placé au 2 extrémités la commande accepte tous les fichiers contenant la chaîne encadrée.

Dans ce qui suis ce qui est entre les caractères [ et ] est optionnel. Les commandes peuvent-être entrées en minuscules ou majuscules. L'interpréteur les converties automatiquement en majuscules.

CLEAR efface le contenu de l'espace RAM réservé au programmes BASIC.

COPY original nouveau copie du fichier original vers nouveau.

example:
		>COPY fichier1 fichier2
  	    Cré une copie de fichier1 avec le nom fichier2. Les noms de fichiers sont capitalisés.

DEL [*]fichier[*] supprime 1 ou plusieurs fichiers.

example:
		>DEL *.tmp
		Cette commande vas supprimer tous les fichiers dont le nom se termine par .TMP
		Lorsque la commande affecte plusieurs fichiers une demande de confirmation est faite pour chacun d'eux.

DIR [[*]test[*]] affiche à l'écran les fichiers contenus sur la carte SD. S'il y a plus de fichiers que le nombre pouvant apparaître dans un seul écran, un pause se fait à chaque écran. Cette commande peut utiliser le filtre *.
```
example:
		>DIR *BAS         
		SPRTEST.BAS          297
		SELECT.BAS           527
		TEST.BAS              87
		TONES.BAS            151
		RECT.BAS             156
		.
		.
		.
		
```

EDIT [nom_fichier] démarre l'éditeur de texte.

example:
		>EDIT carre.bas
		démarre l'éditeur. Si le fichier carre.bas existe il sera chargé dans l'éditeur, sinon le nouveau fichier sera
		sauvegardé sous ce nom.

FREE affiche la quantité de mémoire restante pour les programmes BASIC.
```
example:
		>free
		RAM free bytes: 20512
```

HDUMP nom_fichier affiche en hexadécimal le contenu d'un fichier. L'affichage fait une pause à chaque page.

example:
		>HDUMP tones.bas
		
		0000  69 6E 70 75 74 20 22 64 input "d
		0008  75 72 65 65 22 2C 20 64 uree", d
		.
		.
		.

HELP [commande] sans arguments affiche la liste des commandes. Suivit d'un nom de commande affiche un court texte d'aide relatif à cette commande.
```
example:
		>HELP dir
		DIR [filter]
		List file in root directory, may use '*'
		filter
		
```

MORE nom_fichier Affiche un fichier texte à l'écran. Fait une pause à chaque page.

example:
		>more tone.bas
		
		input "duree", d
		while 1
		 n=abs(rnd())%48
		 tone(n,d,1)
		 if key() then bye end if
		 wend

RASTER C'est un utilitaire pour centrer l'image sur l'écran du téléviseur. Affiche un rectangle qui représente le périmètre de l'affichage. En utilisant les flèches on centre le rectangle sur l'écran. La touche ESC permet de quitter l'utilitaire.
REBOOT Cette commande effectue un redémarrage à froid de l'ordinateur. Cette commande a le même effet que la combinaison de touches <CTRL-ALT-SUP>

REN nom_actuel nouveau_nom Renomme un fichier existant.

example:
		>REN tones.bas beep.bas
		Le fichier tones.bas sera renommé beep.bas

RUN [progam.bas] Compile et exécute un fichier BASIC existant sur la carte SD.

example:
		>RUN conway.bas
		Ouvre le fichier conway.bas, le compile et exécute le programme. Le programme compilé reste en mémoire et tant qu'il 
		n'est pas remplacé par un autre on peu le réexécuter simple en tapant: RUN sur la ligne de commande.