Manuel d'utilisation pour Kit 68000 ou kit 68010

Sommaire

Edition d'un programme en assembleur 68000/68010.
Generation de code.
- Pour une application ne comportant qu'un module en assembleur 68000.
- Pour une application ne comportant qu'un module en C 68000.
- Pour une application comportant des modules en C 68000 et en assembleur 68000 (cas du gerant de tƒaches).
- Utilisation des fichiers de commandes pour maitriser l'edition des liens.
Telechargement vers un kit.
Liste des commandes du moniteur.
- .reg (consulter/modifier un registre).
- DF (pour 68000 Display formated).
- RD (pour 68010 register display).
- MD (memory display).
- MM (memory modify).
- MS (memory set).
- DU (dump memory).
- BM (block move).
- BS (block search).
- BF (block fill).
- BT (block test).
- BR (breakpoints).
- NOBR(no breakpoints).
- GD (go direct).
- GO (execution de programme).
- GT (Temporary breakpoint).
- T (trace).
- TT (trace to temporary breakpoint).
Presentation et commande des maquettes FischerTechink avec un kit68000.
Analyseur logique:
Introduction avec l'"analyseur logique" sur station hp710/712.
L'Analyseur Logique Tektronix 1241.

Edition d'un programme en assembleur
 
	edition du programme se fait sous un editeur du reseau (ved, ed, vuepad, emacs, vi, ...). ATTENTION
	votre nom de fichier doit avoir une extension en .s , exemple : Source.s

	Il est obligatoire de respecter un certain nombre de regles au moment de l'edition :

	Respecter les champs separes par des espaces ou des tabulations :

Etiquette..........Mnemonique..........Operande..........Commentaires

	Les commentaires en debut de ligne sont precedes d'une etoile, les commentaires situes pars une
	operande sont precedes d'un point-virgule.

	
Toute valeur hexadecimale est suivie du suffixe H et est precede d'un 0 si le
 premier chiffre est	une lettre; exemple :

			MOVE.L  0FFB000H,D0

		Suffixe hexadecimal     : H
		Suffixe octal           : Q
		Suffixe binaire         : B

	Un nombre sans suffixe est considere comme decimal.

	Donc le nombre decimal 14 peut s'ecrire 0EH ou 16Q ou 1110B.


	
L'adressage immediat est indique par une diese :

			MOVE.B  #0C3H,D1

	
L'adressage indirect est symbolise par des parentheses; exemple :

			SUB             (A5),D4


Generation de code


(UNIQUEMENT sur les stations info13 a info36.)

Pour une application ne comportant qu'un module en assembleur 68000
 
	Il suffit simplement d'utiliser la commande d'assemblage :

			assemblage Fichier (sans extension .s)
    
	Cette commande genere 3 fichiers :

		Fichier.lst Il contient le code machine + le source + la table des symboles + les
		eventuelles erreurs.

		Fichier.o   est le fichier objet.
		Fichier.s29 est le fichier "executable" a telecharger dans le kit.


Pour une application ne comportant qu'un module en C 68000

	Il faut utiliser la commande de compilation cckit + en option le nom du kit(68000,
68010 ou 68030) + le nom du fichier (sans extension .c). Cette commande genere alors 4 fichiers :

		Fichier.lst  contient le mnemonique assembleur ( en correspondance avec le source C )
		+ le code machine + la table des symboles ).

		Fichier.map  est le rapport de l'edition des liens.

		Fichier.o   est le fichier objet.
		Fichier.s29 est le fichier a telecharger dans le kit.

Pour une application comportant des modules C 68000 et assembleur 68000

	Soit l'application nomee appli comportant:

		1 module main.c (programme principal en langage C)
		1 module ext.s  (sous-programme en langage assembleur 68000)

	TRADUCTIONS SEPAREES :

	a) Compilation des sources C avec la commande c68 nomfichier :

		info18 4: ls
			  main.c

		info18 5: c68 main

		info18 6: ls
			  main.c    main.lst    main.o
			
	main.c  source C du programme.

	main.o  contient le code objet de main.c ( creer si main.c est sans erreur).

	main.lst contient la traduction du fichier source C main.c en mnemonique assembleur +
	le code machine 68000.

	b) Assemblage des sources assembleur avec la commande a68 nomfic :

		info18 6: ls
			  ext.s

		info18 7: a68 ext

		info18 8: ls
			  ext.s   ext.lst   ext.o

	ext.s   source 68000, extension en .s obligatoire !

	ext.o   contient le code objet de ext.s

	ext.lst contient le code machine 68000 + la table des symboles + les    eventuelles erreurs...


	EDITION DES LIENS
 
		La commande l68 NomFichier permet une edition des liens avec tous les fichiers
		objets (extension .o) presents dans le repertoire courant avec les librairies standards.
		Le parametre  Nomfichier est le fichier a telecharger sur le kit. Exemple :

		info18 8: ls
			  ext.s   ext.lst   ext.o   main.c   main.lst   main.o

		info18 9: l68 appli

		info18 10: ls
			    ext.s    ext.lst    ext.o    main.c    main.lst    main.o
			    appli.map    appli.s29

	appli.s29 executable au format S2-S9 a telecharger sur le kit
	
	appli.map rapport de edition des liens et eventuellement les erreurs.

	Note :  La commande l68 [options] NomFichier accepte 2 options (  kit68000 et kit68010 ).
	L'option par defaut est kit68000. Elle a pour effet de generer un fichier executable a
	partir de l'adresse hexadecimale 800 ( compatible avec le kit 68000 ), pour l'option kit68010
	l'adresse est FF9000 ( compatible avec le kit 68010 ).
 

Telechargement vers le kit :

Dans une fenˆetre Xterm, placez vous (cd + chemin) dans votre repertoire de travail. Lancez la
commande kit + le nom du kit 68000, 68010 ou 68030. Attendez l'apparition du prompt
retourne par le kit. Alors vous pouvez entrer la commande :

		send Fichier (sans extension .s29)
    
	 Vous executez votre programme avec la commande :

	go + l'adresse de debut du programme ( 800 sur kit68000 et ff9000 sur kit68010 )

	Pour revenir sous UNIX tapez la commande quit ou Ctrl-c.

	Les autre commandes du moniteur du kit sont les suivantes:

Liste des commandes du moniteur

.reg :

	.reg <CR>
	.reg EXPRESSION <CR>

	Son ro“le est de permettre les operations sur les registres. La commande non suivie d'une expression
	numerique retourne le contenu du registre; sinon elle met le registre a la valeur specifiee.


La commande DF (pour 68000 registre display) :

	DF <CR>

	Elle edite tout simplement -en hexadecimal- le contenu de tous les registres.


la commande RD (pour 68010 register display)
 
	voir la commande DF (cf 6.2)


La commande MD (memory display) :

	MD <=Symbole1><,=Symbole2><;option><CR>
	MD <,longueur><;option><CR>

	Les options possibles sont :

		DI      : avec desassemblage.
		DIS     : avec desassemblage et edition des symboles.
		P       : edition d'une page ecran.

	Cette commande permet de visualiser une zone memoire, sous deux formats possibles :

		Au nombres d'octets desire pour edition en hexadecimal.
		Au nombre de lignes desassemblees pour edition en source 68000/68010

	La longueur par defaut est 16. Les lignes ne sont pas tronques : on prend le multiple
   de 16 le plus proche par exces.

	Si aucune des 2 options DI ou DIS n'est precisee, on est en edition hexadecimale;
   l'equivalent ASCII de chaque octet est affiche en fin de ligne.
	Si un octet ne correspond pas a un code ASCII affichable, on ecrit un point.
	Si une des option DI ou DIS est utilisee, et si on ne rencontre aucun code operatoire
   indefini, ce code sera desassemble sous forme de constante sur un mot (DC.W).
	La frappe de <CR> apres l'execution de la commande permet de visualiser les adresses
   suivantes avec les mˆmes options.


La commande MM (memory modify) :

	MM <=Symbole1><CR>
	MM <Adresse><CR>

	Cette commande permet de visualiser un ou plusieurs emplacement memoire, avec ou sans
   desassemblage, et eventuellement de les modifier. Attention : Si la modification de
   donnees hexadecimales ne pose pas de problemes, il n'en va pas de mˆme pour la modification
   de programme desassemble; Si on remplace un code operatoire par un autre ne comportent pas
   le mˆme nombre d'octets, la suite du programme sera perdu. Ce genre de modification doit ˆetre
   fait de preference par editeur sur le programme source.
	L'adresse et son contenu sont edites de la facon suivantes :

	<=Donnee><CR>   modification de la memoire et passage a l'adresse suivante.

	<=Donnee> ^ <CR>        modification de la memoire et passage a l'adresse precedente.

	<=Donnee>  = <CR>       modification de la memoire et visualisation de la mˆme adresse.

	<=Donnee> . <CR>        modification de la memoire et arrˆt.

	Si l'option DI a ete choisie, il est necessaire d'inserer un espace avant la nouvelle instruction.
   Dans le cas ou une mauvaise instruction est rentre, le caractere X est affiche, et la mˆme adresse
   est visualisee  vue d'une nouvelle modification.


La commande MS (memory set) :

	MS <=Symbole1><=Donnee><CR>
	MS <=Adresse><=Donnee><CR>
	MS <=Symbole1><='Texte ASCII'><CR>
	MS <=Adresse><='Texte ASCII'><CR>

	Cette commande permet de modifier directement la memoire. la donnee peut ˆtre alphanumerique (Texte
   ASCII entre cotes) ou numerique.


La commande DU (dump memory) :

	DU [T]<=Symbole1><=Symbole2><CR>
	DU [T]<=Adresse debut><=Adressefin><CR>

	Cette commande permet de visualiser a ecran le contenu d'une zone memoire.


La commande BM (block move) :

	BM  <=Symbole1><=Symbole2><=Symbole3><CR>
	BM  <CR>

	Cette commande permet de dupliquer une zone de memoire. Le bloc origine est defini par ses deux
   adresses de debut et de fin; il est copie a partir de l'adresse destination.

	La commande retourne le message suivant :

		Adresse memoire = 
		Adresse memoire = 


La commande BS (block search) :

	BS  <=Symbole1><=Symbole2><'Texte ASCII'><CR>
	BS  <'Texte ASCII'><CR>
	BS  <=Symbole1><=Symbole2><;taille><CR>
	BS  <;taille><CR>

	Cette commande permet de localiser dans la memoire (RAM ou ROM) une chaŒne de caracteres
   ASCII ou une valeur numerique. La recherche se fait entre les bornes precisee par les deux
   premiers parametres.
	Si on cherche une chaŒne, celle-ci doit-etre placee entre cotes.

	Lorsqu'on cherche une valeur numerique, on peux utiliser un masque : dans ce cas, la recherche
   se fera en appliquant un ET logique entre les donnees testees et le masque. Dans ce mode de
   recherche, on peut aussi precisee la taille du mot a chercher, et le type de la recherche
   (egalite ou inegalite) :

		;B      Donnee de type octet, recherche d'une egalite.
		;-B     Donnee de type octet, recherche d'une inegalite.
		;W      Donnee de type mot, recherche d'une egalite.
		;-W     Donnee de type mot, recherche d'une inegalite.
		;L      Donnee de type mot long, recherche d'une egalite.
		;-L     Donnee de type mot long, recherche d'une inegalite.

	L'option par defaut est ;B (recherche d'une inegalite sur un octet).

	La commande retourne les messages suivants : Adresse memoire = 
suivi des adresses memoire ou la recherche est positive.


La commande BF (block fill) :

	BF <=Symbole1><=Symbole2><=Donnee><CR>
	BF <=Adresse debut><=Adressefin><=Donnee><CR>

	Cette commande, comme toutes les autres, accepte des symboles comme parametres. Il suffit de faire
   preceder leur nom du signe =. Block fill permet d'initialiser une zone de RAM a une valeur donnee.
   La donnee doit ˆtre du type MOT et les adresses doivent en consequence ˆtre paires.

	La commande retourne le message suivant :

		adresse memoire = <=Adresse debut><=Adressefin>


La commande BT (block test) :

	BT <=Symbole1><=Symbole2><CR>
	BT <CR>
	BT <,longueur><CR>

	Cette commande teste la memoire (de facon destructive) entre les bornes precisees. Si le test se
   deroule sans erreur, toute la zone est positionnees a zero. Sinon, un message est edite sur ecran,
   donnant :

		l'adresse de l'erreur,
		la valeur ecrite,
		la valeur lue.


La commande BR (breakpoints) :

	BR <CR>
	BR <=Symbole><CR>
	BR <Adresse><CR>
	BR <=Symbole><;compteur><CR>
	BR <Adresse><;compteur><CR>

	BR sans parametre affiche les points d'arrˆts deja positionnes en memoire.

	BR suivie d'une adresse memoire positionne un point arrˆt a cette adresse; A l'execution, le programme
   s'arrˆtera a cette adresse en affichant le contenu des registres. Si on ajoute a BR un compteur (sur 32 bits),
   le programme ne s'arrˆtera  qu'apres un nombre de passages determine par la valeur du compteur.

	Le nombre de points d'arrˆts est limite a 8. Apres le passage par un brekpoint, le programme peut
   etre relance par la commande GO. Les points arrˆt ne sont pas modifiees par un RESET.


 La commande NOBR (no breakpoints)

	NOBR <CR>
	NOBR <=Symbole><CR>
	NOBR <Adresse><CR>

	Sans parametres, cette commande efface tous les points arrˆt precedemment positionnes. Suivi d'une adresse
   (ou d'un symbole), elle supprime le breakpoint (s'il existe)qui etait associe a cette adresse.


La commande GD (go direct) :

	GD <CR>
	GD <=Symbole><CR>
	GD <Adresse><CR>

	Cette commande lance le programme objet en memoire, soit a l'adresse specifiee dans la commande,
   soit a l'adresse contenue dans le registre PC par defaut. Cette commande ne positionne pas les
   points d'arrˆets.


La commande GO (execution du programme) :

	GO <CR>
	GO <=Symbole><CR>
	GO <Adresse><CR>

	Cette commande est identique a la precedente, a ceci pres qu'elle positionne les points d'arrˆts en memoire.


La commande GT

	GT <CR>
	GT <=Symbole><CR>
	GT <Adresse><CR>

	Cette commande est identique a la precedente, a ceci pres qu'elle positionne un point arrˆt temporaire,
   de plus, celui precise dans le texte de la commande. Des qu'un point arrˆt est rencontre, le programme
   s'arrˆte en supprimant le point arrˆt temporaire.


La commande T

	T <CR>

	Elle execute l'instruction pointee par le compteur ordinal PC, edite le contenu des registres
   (cf commande RD , affiche la prochaine instruction a executer, et s'arrˆete...
   Un appui sur <CR> "trace" l'instruction suivante. T suivi d'un compteur execute le nombre
   d'instructions precise par la valeur du compteur. Les points d'arrˆets et les compteurs d'arrˆets 
   sont operants en mode TRACE. Il est a noter cependant que le mode TRACE ne peut pas ˆtre utilise 
   dans un programme de traitement d'interruption ou de traitement d'exeption ( TRAP ).


La commande TT (trace to temporary breakpoint) :

	TT <CR>
	TT <=Symbole><CR>
	TT <Adresse><CR>

	Elle positionne les points d'arrˆts, et lance le programme en mode TRACE (en affichant le
   contenu des registres a chaque instruction) et s'arrˆte sur un point arrˆet (en tenant compte
   des compteurs).