
                            
                        
                                      
                                 
                                       
                                               
                                
                                

                                                                      v1.3


                                  D O C U M E N T A T I O N


                               (c) Marco Vieth, avril 1995

                         Traduction franaise par 'Vive le Franais !'
                         ( contactes Marco pour tous renseignements )



-------------------------------------------------------------------------------




Sommaire:

       1.  Introduction
           1.1  Mieux lire cette documentation
           1.2  Droits, garanties
           1.3  Qu'est-ce qu'un CPC ?
           1.4  Que vous offre CPCEMU ?

       2.  Installation de CPCEMU
           2.1  Fichiers fournis avec CPCEMU
           2.2  Conditions requises ( matrielles & logicielles )
           2.3  A propos de la mmoire et des cartes sons
             2.3.1  Utilisation de la mmoire EMS
             2.3.2  Cration de la variable d'environnement BLASTER

       3.  Diffrences entre un vrai CPC et CPCEMU
           3.1  Le clavier
           3.2  Chargement des programmes
             3.2.1  Chargement  partir d'une disquette
                    - Le menu "Insrer une disquette"
                    - Le menu "Slection des fichiers"
             3.2.2  Chargement et sauvegarde sur cassette
             3.2.3  Chargement et sauvegarde d'un Snapshot

       4.  Changer la configuration
           4.1  Le menu "configuration"
           4.2  Le fichier de configuration
           4.3  Paramtres de la ligne de commande

       5.  Transfrer des donnes entre CPC <-> PC
           5.1  Utilisation des disquettes
             5.1.1  CPCTRANS: transfert le contenu des disquettes 
             5.1.2  22DISK: l'utilitaire de formatage et de copie de SYDEX
           5.2  Par l'interface parallle
             - l'adaptateur parallle
           5.3  Par l'interface srie
           5.4  Autres possibilites

       6.  Documentations, aides, remerciements
           6.1  O trouver des programmes pour CPC ?
           6.2  Nouveauts, changes d'expriences
           6.3  Si vous avez des questions ou des suggestions
           6.4  Les autres mulateurs d'Amstrad CPC
           6.5  Projets pour les prochaines versions de CPCEMU
           6.6  Remerciements
           6.7  Marques dposes

       7.  Informations internes sur CPCEMU:
           La "bote noire", et son contenu


       Appendices:

       A.1  Glossaire
       A.2  Bibliographie
       A.3  Index


---------------------------





1.  Introduction



Bienvenu dans le monde des mulateurs !

Quoi! Tu veux savoir ce qu'est CPCEMU, et ce que tu peut faire de cet trange
logiciel qui crit en jaune sur fond bleu et qui rle "Syntax Error" aprs
chaque frappe ?


Eh bien, pour t'viter de longues recherches, voici les rponses:
        CPCEMU emule un Amstrad CPC 464, 664 ou 6128 avec beaucoup
        d'extensions. En d'autres termes, le logiciel imite le
        comportement du vieil Amstrad sur PC.

Dans quel but ?
Eh bien, si t'en a toujous aucune ide, alors tu n'aura pas besoin de CPCEMU.

Quelques raisons:
        - nostalgie (ahhh, comme mon vieux CPC tait chouette ...)
        - meilleures performances que l'original ( avec l'EMS )
        - meilleur environnement pour dvelopper les applications
        - jouer
        - travailler (oui, un CPC est assez puissant pour du simple
           traitement de texte)
        - [                                  ] <- insre tes propres raisons.




1.1  Pour lire cette documentation
===================================

  J'ai essay d'crire une documentation claire et ordonne. Mais si tu
  as encore des questions (aprs plusieurs relectures!), tu peux me contacter.
  Pour les modalits, va voir au chapitre 6 (Documentations, ...).
  Tu peut aussi me contacter si tout est clair et que tu es content de CPCEMU.

  Dans le chapitre 1 (Introduction) est dcrit comment lire cette doc.
  Il contient aussi les infos sur les droits d'auteur, et quelques
  petites choses  propos du CPC en gnral.

  Dans le chapitre 2 (Installation) a commence. Tu apprendra comment
  installer et dmarrer CPCEMU.

  Le chapitre 3 (Diffrences entre CPC et CPCEMU) parle des caractristiques
   connatre si tu es un familier du vrai CPC et que tu veut utiliser
  l'mulateur maintenant. En gros, il dcrit le clavier, les disquettes,
  cassettes et les gniales 'Snapshot'.

  Dans le chapitre 4 (Changer la configuration) est dcrit comment personaliser
  CPCEMU pour tes besoins. Peut-tre que ton logiciel prfr marchera
  sans problmes !

  Dans le chapitre 5 (Liaison CPC <-> PC) tu trouveras comment rcuprer
  sur ton PC les vieux programmes CPC. Les utilitaires fournis avec CPCEMU
  y sont dcrits.

  Le chapitre 6 (Documentations, aide, remerciements) t'explique
  comment reevoir la dernire version de CPCEMU et qui contacter si tu
  as des questions.

  Le chapter 7 (Informations internes sur CPCEMU) est destin aux 
  professionnels seulement. La partie "officielle" de l'utilisateur
  est termine depuis le chapitre prcdent. Je dcrit ce que tu te dois 
  de savoir pour programmer un tel mulateur. Je dcrit aussi le menu
  de dbogage de CPCEMU, qui te permet d'analyser le processeur et
  la mmoire  tout moment. Les utilisateurs occasionnels devraient
  passer ce chapitre, au moins  la premire lecture.

  Dans l'appendice A.1 se trouve un glossaire avec les dfinitions des
  termes techniques les plus importants.
  L'appendice A.2 est une bibliographie, et l'appendice A.3 est l'index.



1.2  Droits, garantie
========================

  CPCEMU a t dvelopp par:

         Marco Vieth
         Auf dem Uekern 4
         33165 Lichtenau
         Germany


  CPCEMU est un Freeware, ce qui signifie que tu peut donner le programme 
  a tes amis et tes connaissances gratuitement. Les archiveurs sont autoriss
   inclure CPCEMU dans leurs collections de programmes pour le tlchargement.
  Les distributeurs de Shareware sont autoriss  distribuer CPCEMU seulement
  s'ils ne demande qu'une petite participation pour la copie  leurs clients.
  Contrairement au domaine publique, le Freeware ne veut pas dire "gratuit"
  et tu ne peut pas en faire ce que tu veut. Le copyright m'appartient
  toujours.

  Tout le logiciel et sa documentation est fournie "tel quel" sans garantie
  de quelque sorte.


  Bien que ce programme soit un freeware, j'accepte volontier les aides de
  toutes sortes, aussi bien techniques que financires.
  Va voir au chapitre 6 pour plus d'informations.



1.3  Qu'est ce qu'un CPC ?
===========================

  Si tu sais dj ce qu'est un CPC, passe cette section et va directement
  en 1.4.




  Toujours ici?

  Je ne veut pas "dissquer" le CPC maintenant, je veut seulement t'en donner
  une vue rtrospective pour que tu comprennes bien ce que c'est.

  CPC est l'abrviation pour Colour Personal Computer. Les ordinateurs de ce
  type furent les premiers construits en 1984 par la compagnie anglaise
  Amstrad et vendu sous diffrents noms dans les autres pays.
  C'tait le dbut de l're des ordinateurs familiaux: Commodore C64, 
  Sinclair Spectrum, Atari 800XL ..., lorsque le CPC 464 nat. Il a autant
  de RAM que le Commodore C64 (64 Ko), un lecteur/enregistreur de cassette 
  intgr et le 'Locomotive BASIC 1.0.'
  Le CPC 664 suivit avec un lecteur de disquettes 3" et le 'Locomotive BASIC 1.1.' 
  amlior lgrement depuis la version 1.0.
  Le CPC 6128 arrive en 1985, avece 128 Ko de RAM et  peut prs les mmes
  caractristiques que le CPC 664.
  Les disquettes 3" taient horriblement chres, mais plus stables que 
  les 5"1/4 (presque aussi stables que nos 3.5" d'aujourd'hui), mais surtout
  elles taient beacoup plus rapides compares aux cassettes.
  Les trois types de CPC taient vendus avec un moniteur couleur ou
  noir et blanc, et avec une alimentation intgre ( au moniteur ! ).
  Entre temps il y en a eu d'autres, comme le CPC+ par exemple.
  Le BASIC fourni possde prs de 178 instructions puissantes et rapides.
  On pouvait programmer des graphiques, des sons et mme les interruptions,
  le tout en BASIC en vitant les PEEKs et les POKEs.
  Le parque de logiciels grossit pendant des annes, et nombres de programmeurs
  CPC sont maintenant sur PC (comme le PDG de CRYO, eh oui !).
  


1.4  Que vous offre CPCEMU ?
============================

  Ce qui suit est un petit rsum de ce que t'offre CPCEMU. Dans les
  prochaines sections de la documentation, une signification claire
  et dtaille en sera donn.

  Trois modes graphiques diffrents (NbLignes x NbColonnes x NbCouleurs):

       Mode 0: 180x200x16
       Mode 1: 320x200x4
       Mode 2: 640x200x2

  Son: soit par le haut-parleur du PC,soit  travers la Soundblaster 
        (3 canaux streo).

  Mmoire:
    ROM: OS, BASIC, AMSDOS, et jusqu' 13 ROMs additionnelles (avec l'EMS)
    RAM: 64Ko, 128Ko, et jusqu' 576Ko de RAM compatible Dk'tronics (avec l'EMS)

  Disquettes: fichiers-images spciaux d'extension .DSK

  Cassettes: fichiers standards sous DOS, c.a.d BASIC CPC- et fichiers binaires
       avec les extensions .BAS et .BIN respectivement.

  Snapshots: Tu peux bloquer le droulement d'un programme pour le reprendre
       plus tard en sauvant la mmoire dans des fichiers DOS appels Snapshot
       (celui qui trouve un terme pour traduire a, il m'appelle), et
       ayant pour extension .SNA.

  Vitesse: Sur un 386  33MHz avec de l'EMS, CPCEMU est plus rapide que
       l'original.




2.  Installation de CPCEMU


Dans ce chapitre tu vas apprendre  installer et lancer CPCEMU.
Dans le paragraphe 2.2 tu pourras lire quelques trucs sur l'utilisation 
de la mmoire EMS et sur la variable d'environnement de la Soundblaster.
L'installation compltement personnalise avec le fichier de configuration
est dcrit plus tard dans le chapitre 4 (Changer la configuration).



2.1  Fichiers fournis avec CPCEMU
=================================

  Tu as reu CPCEMUxx.xxx avec les fichiers suivants:
  (J'ai mis entre parenthses les rpertoires o tu trouveras les
  fichiers aprs installation)
  
  COPYMATE.ROM   ROM avec un programme de copie (ROM)
  CPC464.BAT     Un CPC 464
  CPC464.ROM     ROM (systme+BASIC) d'un CPC 464 (ROM)
  CPC664.BAT     De mme, mais pour un CPC 664
  CPC664.ROM     (ROM)
  CPC6128.BAT    De mme, mais pour un CPC 6128
  CPC6128.ROM    (ROM)
  CPCADOS.ROM    AMSDOS pour tous CPCs (ROM)
  CPCEMU.CFG     Configuration pour tous CPCs (or CPCEMU0.CFG)
  CPCEMU.DBF     poke database
  CPCEMU.HLP     Aide, affiche en appuyant sur F1
  CPCEMU.EXE     L'mulateur
  CPCEMU_D.TXT   La documentation allemande
  CPCEMU_E.TXT   La documentation anglaise
  CPCEMU_F.TXT   La documentation franaise (ce fichier)
  CPCPARA.BAS    Programme en BASIC Amstrad pour transferts par le port parallle (UTILITY)
  CPCPD1.DSK     Disquette contenant des programmes d'exemples (DISC)
  CPCREC.BAS     Programme en BASIC Amstrad pour recevoir des programmes (UTILITY)
  CPCT0.BAT      Fichier batch pour CPCTRANS.EXE (exemple) (UTILITY)
  CPCTRANS.EXE   Programme pour crer des disquettes images (UTILITY)
  CPMDISKS.DEF   Dfinitions des formats pour 22DISK (UTILITY)
  FILE_ID.DIZ    Nom de l'archive
  INSTALL.BAT    Fichier batch pour l'installation
  PCPARA.EXE     programme de transfert parallle ct PC (UTILITY)
  README_D.TXT   Readme allemand
  README_E.TXT   Readme anglais
  ROMGET.BAS     Programme BASIC Amstrad pour enregistrer les ROMs (UTILITY)

  Les ROM originales l'Amstrad sont maintenant incluses.
  Le logiciel appartient  Locomotive Software, le BASIC appartient
   Amstrad.
  Amstrad et Locomotive m'ont autoriss  distribuer ces ROMs.



2.2  Conditions requises pour l'installation
============================================

  ...









A.2  Bibliographie



Le manuel du CPC est indispensable pour les dbutants:
- Spital Ivor und Perry, Roland und Poel, William und Lawson,Cliff:
    CPC 6128 Benutzerhandbuch, Schneider Computer Division 1985,
    Originalausgabe (c) 1985 (dans le mien est crit 1895)
    par AMSOFT, AMSTRAD Consumer Electronics plc et Locomotive
    Software Ltd.

Un listing trs bien comment de la ROM, les premiers chapitres
parlant plus spcialement du ct programmation du CPC.
- Janneck, Joern W. und Mossakowski,Till: ROM-Listing CPC 464/664/6128,
    Markt & Technik Verlag 1986

A l'inverse: un listing mal compos, rarement comment, parlant plus
du ct machine:
- Brueckmann, Englisch, Gertis: CPC 464 Intern mit kommentiertem
    ROM-Listing, Data Becker 1985

Bon pour apprendre le C, contient beaucoup d'exercices: 
- Kellay, Al and Pohl, Ira: A Book on C, Second Edition, 1990 by
    Benjamin/Cummings Publishing Company, Inc.

Comment crire un bon manuel bien comprhensible:
- Boedicker, Dagmar: Handbuch-Knigge, Software Handbuecher schreiben
    und beurteilen. Wissenschaftsverlag 1990





A.3  Index


Cette table contient une liste de mots cls et le numro du chapitre
o ces termes sont dcrits.

(incomplet)

...


------------------------------------------------------------------------------
logout
------
