# Read File

Lit un projet depuis la mémoire flash spécifiée du système de vision In-Sight.

## Read File – entrées

Syntaxe : RF[nom_du_fichier]

Paramètre | Description
--- | ---
Nom du fichier | Nom du projet. La commande s’exécute avec ou sans l’extension du fichier .JOBX.

## Read File – Sorties

Renvoie un code d’état, suivi d’une terminaison de ligne, puis de lignes de données du projet.

Les codes d’état sont :

Codes d’état | Description
--- | ---
1 | La commande a été exécutée avec succès.
0 | La commande est inconnue.
-1 | Le nom de fichier du projet manque.
-2 | Aucun projet n’a été enregistré sous ce nom ou les données du projet sont invalides, ainsi la commande n’a pas pu être exécutée.
-3 | Échec de la lecture.
-6 | L’utilisateur ne dispose pas de l’accès complet nécessaire à l’exécution de la commande.

Les lignes de données de projets sont :

Paramètre | Description
--- | ---
Nom | La première ligne contient le nom du projet.
Taille | La seconde ligne contient un nombre entier pour la taille du projet en octets.
Données | Le projet actuel est codé en valeurs ASCII hexadécimales formatées à 80 caractères par ligne. Chaque ligne se termine par un retour chariot et un saut de ligne.
CheckSum | La dernière ligne contient quatre octets hexadécimaux représentant un checksum des données du projet. Le système de vision calcule le checksum à partir des valeurs ASCII majuscules des données codées en hexadécimal, et non à partir des valeurs en octets du contenu du fichier. Pour plus d’informations, consultez la rubrique Checksum du mode natif.

## Read File – Exemple

Pour obtenir des informations sur le projet "text.jobx", enregistré sur le système de vision In-Sight, exécutez la commande suivante : RFtext.jobx

Après l’exécution de la commande Read File, la première ligne affichée dans la fenêtre Telnet représente le code d’état (1), suivi du nom du projet (text.jobx) et de sa taille (22) en octets, puis des données du projet au format ASCII hexadécimal. Enfin, la somme de contrôle ASCII hexadécimale de quatre octets est indiquée sur la dernière ligne (4206).

Remarque : La taille indiquée par la commande RF est le double du nombre d’octets de la taille réelle du fichier .JOB enregistré sur le système de vision In-Sight, en raison de l’encodage ASCII hexadécimal des données.