Lien	Référence
	01) Introduction
	02) Préparation de l'imac
	03) Préparation de l'Apple IIe
	04) Relier l'imac à l'Apple IIe
	05) BootStrapping
	06) Récupérer le client ADTPro sur disquette
	07) Transfert d'un disque image .DSK de l'imac vers l'Apple IIe
	08) Méthode pour transférer un disque image .NIB vers l'Apple IIe
	09) Transfert d'une disquette de l'Apple IIe vers l'imac
	10) Transfert d'un disque dur de l'Apple IIe vers l'imac
	11) La gestion des erreurs

Dans les tutoriaux, vous trouverez à plusieurs reprises cette icône indiquant une note informative. Si vous ne vous intéressez qu'aux transferts imac/Apple IIe, vous pouvez sauter chaque note car cette lecture n'est en rien indispensable dans l'objectif qui nous intéresse. A noter que pour les chapitres sur les transferts, j'ai répété les pré-requis de configuration et la sélection du répertoire courant afin de pouvoir les lire indépendamment les uns des autres.

Sur le site officiel d'ADTPro, l'auteur signale avoir rencontré des problèmes avec des adaptateurs à base de chipset Prolific. D'après ses dires (et le témoignage d'autres personnes), il peut arriver que le transfert s'arrête en cours de route : le process se fige. De mon côté, je n'ai pas noté ce type de problème. Il faut peut-être en faire beaucoup pour avoir le soucis ou utiliser un adaptateur d'une autre marque, je ne sais pas... Aussi, il conseille un autre modèle avec une puce de marque FTDI (Future Technology Devices International Ltd).

Adaptateur USB 1.1/Série RS-232 DB9+DB25
ADAPTATEUR USB 1.1 SÉRIE UNIVERSELLE
Connexion USB 1.1 type A à tous types de périphérique série (RS 232) DB9M.
Vitesse de transmission théorique maximum en USB jusqu+à 12 Mbps.
Livré avec adaptateur DB9F/DB25M.
Adaptateur avec câble, auto-alimenté.
Compatible Windows 98/2000/XP/Vista (32/64bits).

On trouve la double appellation "java SE 1.6" et "java 6 Standard Edition": il s'agit de la même chose. Le "1." devant le "6" n'est pas systématiquement indiqué. On trouve plus communément l'appellation "java 6"; ce chiffre donnant l'impression d'une révision majeure. L'appellation "java 1.6" est surtout utilisée quand on désigne le numéro interne. Cette confusion a été introduite par les commerciaux de chez Sun Microsystems (à présent dans le giron d'Oracle) depuis la version 1.5 aussi appelée (vous vous en doutez): java 5.

Il ne faut néanmoins pas se laisser "abuser" par cette compatibilité "universelle" (Write once, run anywhere). Certes le programme proprement dit est en java, mais il s'appuie pour la bibliothèque RXTX qui implémente la communication série en langage C. Le lien entre java et C est assuré par la technologie JNI. L'auteur d'ADTPro doit donc livrer pour chaque version de son programme des compilations de RXTX spécifiques à chaque plateforme (Windows, Unix/Linux et Mac, en version 32 et 64 bits); processus assez lourd et dangereux si c'est l'utilisateur qui doit se charger de la configuration. Il faut s'assurer de la compatibilité à chaque changement de version (Java, architecture, RXTX). Heureusement, sur imac avec Snow Leopard, tout est transparent: il n'y a rien à configurer manuellement. Un double clic et c'est parti...

Si sur le programme que vous utilisez, il est indiqué ADTPro v.r.m., cela signifie que l'auteur ou la personne ayant compilé le projet a oublié de mettre à jour l'info de versioning. En effet, v.r.m. sont les initiales pour Version Release Milestone, donc les attributs qui permettent de différencier chaque nouvelle sortie d'ADTPro. Ces valeurs v.r.m. (propriété versionString) sont à indiquer au préalable dans le script Ant (build.xml) qui construit le projet. Pour les accros de la sécurité, si vous avez téléchargé ADTPro sur le site officiel, vous pouvez l'installer les yeux fermés. Son auteur est un contributeur de longue date aux forums Apple II. Le programme est sous licence GPL v2 et bien entendu les sources complets sont fournis avec. Par principe, je ne recommande pas de télécharger le programme sous forme exécutable prête à l'emploi ailleurs que sur le site officiel. La diffusion du programme (tout comme l'intérêt suscité par l'Apple II aujourd'hui) reste confidentielle aussi il est fort peu probable qu'une personne mal intentionnée se soit amusée à hacker le code. Mais bon, il ne faut jamais sous estimer la connerie humaine... Si vous êtes paranos et avez du temps à perdre, vous pouvez toujours essayer des décompiler les classes java. Si un saboteur de .DSK est passé par là, il est probable qu'il aura utilisé un obfuscator java (genre Zelix KlassMaster, Dash-O, Allatori, Proguard, RetroGuard ou yGuard) pour cacher ses bêtises et vous saurez tout de suite que ce téléchargement est à mettre à la poubelle au plus vite.

• Essayez d'en acheter une sur ebay.com, on en trouve plein: que ce soit des versions originales Apple ou des clones (comme la Super Serial Board SSB-1 à $24.95 chez kpsurplus ou chez MC Price Breaker).
  
• Il y a des associations comme WDA qui organisent des journées dédiées à une machine avec possibilité d'acquérir du matériel en double.
  
• J'ai vu aussi que l'auteur d'ADTPro en propose d'occasion à la vente.
  

Dip en position ON	Dip en position OFF

Il est possible d'utiliser ADTPro sans carte SSC. Mais les 2 autres solutions disponibles sont à mon sens beaucoup plus restrictives: Il est possible de faire tourner le programme avec une connexion ethernet mais cela nécessite d'acheter pour l'Apple IIe une carte d'interface supplémentaire. Or la seule qui est encore disponible (par intermittence) est l'Uthernet vendue 89 dollars US par a2RetroSystems (Glenn Jones). Ce prix est largement supérieur à celui d'une SSC. Je ne peux pas vous en dire plus, car je n'ai pas encore trouvé le temps de tester la mienne!! Il est aussi possible de faire fonctionner ADTPro en utilisant une connexion par cable audio (l'Apple II ayant un port cassette). Mais la lenteur des transferts est rédhibitoire même si le client Apple II a le mérite d'exister. C'est vraiment la roue de secours quand tout le reste a échoué.

Si vous n'arrivez vraiment pas à mettre la main sur des disquettes 5,25" compatibles avec l'Apple II, il vous reste encore une solution pour jouer sur votre vieille machine sans avoir à débourser un centime de plus. Il existe en effet une application multi-plateforme basée sur une approche similaire (serveur java/RXTX et client Apple II) mais qui permet de charger directement dans la mémoire de l'Apple II des jeux par le biais du port série. Son nom: Apple // Game Server, écrit par Brendan Robert (BLuRry) et Nick Westgate (Sicklittlemonkey). Le projet est téléchargeable ici sur Sourceforge. Une vidéo sur youtube.com est également disponible. L'ancien site encore hébergé par Berlios donne des informations intéressantes.

"Cordon null Modem SUBD9F/25M - 1.80M
Utilisation micro à imprimante en série ou switch/buffer à imprimante en série.
Câble blindé, moulé, vis longue.
Liaison modem null.
Câble DB25/DB9".

"Cables in male-to-female configurations are typically used as serial printer cables, while female-to-female versions are typically connecting two PC serial ports".

Cables differ from application to application, and even though the connectors on the cable ends are the same, and the cable has the exact same external appearance, the internal wiring can be completely different.
The connections between the wires and pins determine how the cable operates.

Troubleshooting & Cable Diagnosis

Cable type is determined by both physical appearance (the type of connectors used on both ends) and internal wiring (often referred to as the "pinouts").
While the connector types can be determined from visual inspection, internal wiring is another matter.
Unfortunately, a cable can have exactly the right "look" but not be able to work in the desired capacity.
Cables designed especially for printer use and cables designed for modem use can look exactly a like externally but a rewired differently.
One example of physical similarity is a cable used between the ImageWriter I and a serial card and a cable used to drive a modem with a serial card.
These two cables look identical externally but when you compare the two wiring diagrams shown in this Appendix, you can easily see that neither cable can replace the other because they're wired differently.
There are literally hundreds of cable designs and its much too easy to mix them up if they are judged by physical appearance alone.
Unless they are clearly marked, once they're separated from their original packaging, they can only be distinguished by electrical diagnosis).

More than ninety percent of the phone calls to the InTrec Tech Support department stating modem initialization failure, occur because the customer has a cable designed to be used with a printer.
In almost every case, the customer doesn’t believe they could have the wrong cable, because, "The dealer sold me the right one" or the package was marked "modem cable" meaning it has to be correct.
Apparently, unfortunately and seemingly, some dealers look at a cable's connectors, and if they match up with the computer and the modem - "That’s the right cable."
As often happens, after some checking, we often get a call or letter thanking us for pointing out the problem, verifying that the cable was wrong.

+------+------------+             +------------------+               +--------------+-------+
! imac ! Adaptateur !             !      printer     !               !     SSC      ! Apple !
!      !    USB     !             !       cable      !               ! Jumper block !   II  !
!      !   Série    ! DB9M   DB9F !==================! DB25M   DB25F !  (Terminal)  !       !
!      !            !             ! Straight-through !               !              !       !
+------+------------+             +------------------+               +--------------+-------+

+------+------------+             +------------+            +------------+               +--------------+-------+
! imac ! Adaptateur !             !   cable    !            ! Adaptateur !               !     SSC      ! Apple !
!      !    USB     !             ! null modem !            !    DB25    !               ! Jumper block !   II  !
!      !   Série    ! DB9M   DB9F !============! DB9F  DB9M !============! DB25M   DB25F !   (Modem)    !       !
!      !            !             ! crossover  !            !            !               !              !       !
+------+------------+             +------------+            +------------+               +--------------+-------+

+------+------------+             +------------+               +--------------+-------+
! imac ! Adaptateur !             !   cable    !               !     SSC      ! Apple !
!      !    USB     !             ! CrossWorks !               ! Jumper block !   II  !
!      !   Série    ! DB9M   DB9F !============! DB25M   DB25F !   (Modem)    !       !
!      !            !             !            !               !              !       !
+------+------------+             +------------+               +--------------+-------+

J'ai déja vu un message d'une personne sur un forum qui signalait ne pas trouver la touche #. Si vous avez le même problème, voici quelques infos pour vous. Les claviers français de l'Apple IIe sont à la fois AZERTY et QWERTY! Cliquez pour agrandir. Comme beaucoup de logiciels n'existaient qu'en version anglophone, il était possible de choisir le type de clavier à utiliser en manipulant un switch situé sur le devant de la machine (sous le clavier) pour passer de l'un à l'autre. C'était pratique car certaines touches ne sont pas au même endroit. Alors que leur emploi en QWERTY est pratique (et justifié), sur un clavier AZERTY ça pouvait devenir du n'importe quoi. Par exemple sur des jeux, certaines touches doivent être rapprochées pour être manipulées avec une seule main. Avec un clavier AZERTY, s'il faut faire de la gymnastique avec les 2 mains, on ne risque pas d'exploser les scores. Sur le clavier certaines touches ont donc à la fois le caractère d'un clavier AZERTY et celui d'un clavier QWERTY. Il y a une rom dans la machine qui contient les caractères pour les 2 configurations. Voici les équivalences de l'affichage des caractères après avoir actionné le switch: QWERTY AZERTY On voit que le caractère # en QWERTY correspond au caractère £ en AZERTY. ==> Il y a 2 solutions pour taper la commande IN#1. Soit vous passez en clavier QWERTY (si vous étiez en clavier AZERTY) et le caractère # s'affiche bien à l'écran quand vous appuyez sur la touche équivalente du clavier. Soit vous restez en clavier AZERTY et dans ce cas là, vous ne tapez pas IN#1 mais IN£1 (ce n'est pas la même touche, le £ étant près de la touche return) et cela fonctionne tout aussi bien de la même façon... Cliquez pour agrandir. En mode AZERTY, le caractère # n'est pas accessible via la touche: on obtient " ou 3 (avec shift).

La commande IN# slot permet d'accéder au sous programme d'entrée contenu dans la rom (firmware) de la carte SSC. Après avoir tapé cette instruction, il est possible : d'envoyer des commandes de settings à la carte depuis le clavier. (Il est aussi possible d'envoyer des commandes d'activation/désactivation de caractéristiques ou des commandes de gestion d'état comme par exemple break ou reset mais ces commandes ne sont pas utilisées ici). SURTOUT de donner la main au périphérique connecté à la SSC (ici le serveur ADTPro via la liaison série) pour faire en sorte que ce soit lui qui s'occupe de la liaison d'entrée. Pour simplifier, c'est comme si c'était  lui qui tapait sur le clavier à notre place. C'est donc le serveur ADTPro qui va "remplir" la mémoire de l'Apple IIe avec le système d'exploitation comme s'il tapait le programme depuis le clavier en quelque sorte (en déformant un peu la réalité).

• soit Control-A si la SSC est configurée en mode Modem (pour faire Control-A, il faut presser la touche control et, tout en la gardant enfoncée, appuyer sur la touche A).
• soit Control-I (la lettre I et pas le chiffre un) si la SSC est configurée en mode Terminal/Printer (pour faire Control-I, il faut presser la touche control et, tout en la gardant enfoncée, appuyez sur la touche I).
  

La commande <n>B (et return) permet de configurer manuellement la vitesse de transfert en bauds. L'auteur d'ADTPro a rajouté la saisie de cette commande car sur son site il n'a pas précisé comment régler la vitesse de transfert avec les dips. Il a mis un cliché de SW1 avec une vitesse lente de 300 bauds. Puis le réglage se fait pas voie logicielle. Il est probablement parti du principe que les utilisateurs n'avaient pas le manuel de la SSC et qu'il était plus simple de leur faire faire cette saisie plutôt que de leur demander d'effectuer le réglage approprié. Dans notre cas, cela n'apporte rien de plus puisque l'on a déjà effectué la configuration à l'aide des switchs sur la SSC. La liste possible des valeurs de <n> est la suivante: 6B = 300 bauds (à cette vitesse là, prévoir un oreiller pour faire la sieste pendant le transfert). 8B = 1200 bauds. 10B = 2400 bauds. 14B = 9600 bauds. 15B = 19200 bauds.

Sur un Apple II, il est possible avec ProDOS d'exécuter un fichier (appelé fichier EXEC) contenant une suite d'instructions. En tapant la commande EXEC (ou tiret: -) devant le nom d'un tel fichier, cela revient à automatiser la frappe d'une série de commandes. C'est une approche similaire qui est utilisée ici pour "charger" un programme en mémoire. Il faut savoir qu'il est possible de rentrer un programme en mémoire par ce qu'on appelle le "moniteur". En saisissanr la commande CALL -151, on accède à ce moniteur. En tapant: <adresse> : <octets>, cela revient à mettre en mémoire à l'adresse <adresse> la liste des octets mentionnés dans <octets>. Le bootstrapping consiste pour le serveur à envoyer à l'Apple II du texte (comme un fichier EXEC) contenant un dump du programme. Ce dump est chargé en mémoire à fur et à mesure par le moniteur. Les dumps ont été générés au moment de la construction du projet par un outil dédié: AppleDump.java (du package org.adtpro.utilities). On trouve dans le script Ant (build.xml) 5 appels à cette commande: pour les infilename PD.raw (ProDOS), ADTPROETH (client ethernet), ADTPROAUD (client audio), ADTPRO (client serial) et ADT (client serial ESDOS ][). Si vous voulez vous faire un dump du ProDOS 2.0.3 à la place du 1.9, rien de plus simple. Par exemple pour le dump de ProDOS, la 1ère ligne de l'écran ci-dessous: "2000:4C 06 20 EE F2 21 A5 43 8D 7D" va affecter à partir de l'adresse $2000 les 10 octets indiqués.

Si vous êtes curieux, vous avez probablement constaté que le menu " Amorçage " sur le serveur avait d'autres sous-menus que " ProDOS ". Je vais dire brièvement quelques mots sur le sous-menu " EsDOS ][ ". Il permet d'envoyer vers l'Apple IIe un autre DOS que ProDOS ainsi qu'un autre client que celui d'ADTPro. Tout d'abord il faut savoir qu'EsDOS ][ est une variante du DOS 3.3. (Le DOS 3.3 étant le système d'exploitation utilisé sur Apple II avant l'arrivée de ProDOS). EsDOS ][ est plus rapide que DOS 3.3 (héritage du ProntoDOS de Beagle Bros) et offre quelques fonctionnalités en plus: Option de formattage d'une disquette 5,25 pouces accessible depuis le menu du boot (touche I). Historiquement, avant ADTPro, il y avait ADT: il existait un client Apple II sous DOS 3.3 et un serveur en mode texte écrit en C qui pouvait tourner sur plateforme DOS ou Unix. (Il a existé plus tard une version graphique du serveur pour Windows). Pour info, voici à quoi ressemblait un écran du serveur (sous Linux) après un transfert: Il y a eu des forks d'ADT. L'intérêt aujourd'hui d'utiliser le couple EsDOS][ / ADT 2.3 est que ce dernier propose des fonctionnalités qui n'existent pas dans le client ADTPro. En effet, le programme a été adapté par Eric Neilson et Gérard Putter pour permettre la création d'images disques au format nibble (.nib) ainsi qu'au format propriétaire .v2d contenant des demi-pistes et donc supportant des logiciels protégés contre la copie exploitant ce type de verrouillage. A noter que ce format .v2d est spécifique à l'émulateur Virtual ][. Ceux qui s'intéressent à cette particularité pourront lire la documentation de l'outil A2V2. Le bootstrapping d'EsDOS][ et d'ADT 2.3 se fait de la même manière que celui de ProDOS et d'ADTPro. Le seule différence, c'est que le système d'exploitation s'envoie en 2 fois (1ère et 2nde partie) au lieu d'une pour ProDOS. Quelques clichés du client ADT 2.3 une fois chargé en mémoire: A noter par ailleurs qu'Eric Neilson travaille actuellement à la mise au point d'un client basé sur le programme E.D.D. Ce client sera lui aussi capable d'envoyer les nibbles lus vers un serveur via la carte SSC.

Nous avons vu tout à l'heure au moment de la configuration de la SSC que la vitesse la plus élevée était 19200 bauds. Aussi vous pourriez être étonné qu'à présent je parle de 115200 bauds. En fait, il s'agit d'une fonctionnalité non documentée car elle n'est pas disponible sur toutes les SSC. Si cela ne marche pas avec votre SSC, revenez à la vitesse de 19200 bauds sur le serveur et le client ADTPro. Extrait des FAQ Apple II: From: Michael Mahon, Ed Eastman, Steve Jensen An unmodified SSC can access the external oscillator circuit via software to get 115,200 bits per second. All you have to do is dump $10 into $C0AB instead of the $1F that's normally there. Although not supported in many applications, the new 115k setting has been added to ADT 1.23. Note: Some SSC boards may need to upgrade to a later version of the 6551 ACIA chip to function reliably at higher speeds. Dans cet extrait des FAQ, la carte SSC est supposée être en slot 2 et la valeur $1F "qui est normalement là" correspond à 19200 bauds.  Avec la SSC en slot 2: en POKANT la valeur $1F à l'adresse $C0AB, on a une vitesse de 19200 bauds. en POKANT la valeur $10 à l'adresse $C0AB, on a une vitesse de 115200 bauds. Même chose avec la SSC en slot 1: en POKANT la valeur $1F à l'adresse $C09B, on a une vitesse de 19200 bauds. en POKANT la valeur $10 à l'adresse $C09B, on a une vitesse de 115200 bauds. L'adresse du poke correspond à : (numéro du slot * 16) + $C08B. Dans le source, PSPEED représente l'index de la vitesse choisie dans la liste des valeurs acceptées. PSPEED = 0 => 300 bauds (on poke $16) PSPEED = 1 => 9600 bauds (on poke $1E) PSPEED = 2 => 19200 bauds (on poke $1F) PSPEED = 3 => 115200 bauds (on poke $10)

• les disques images contenant encore une protection.
• les disques images qui sont sous forme de .NIB uniquement pour préserver le numéro de volume. Ce numéro (stocké dans un champ adresse) sert aux programmes tenant sur plusieurs disquettes. Le volume est utilisé pour distinguer les faces les unes des autres, bref pour les identifier.
  

Formattage d'une disquette avec ADTPro.	Catalogue après avoir changé le répertoire courant sur le serveur.
Transfert d'ADT23.DSK vers la disquette.	Utilisation d'ESDOS ][ pour initialiser les 3 faces du jeu avec les numéros de volume 1, 2 et 3.
Transfert de la 1ère face de King's Quest 1 vers la face avec VOL001.	Prêt pour le transfert de la 2nde face.
Maintenant que les 3 faces sont faites, je boote le jeu. Page de crack.	Jeu avec son interface graphique en double haute résolution.

• Le serveur ne démarre pas car il n'y a pas de JRE (Java Runtime Environment) installé. Il faut installer une machine virtuelle java sur sa machine moderne.
  
  
• Le serveur ne se lance pas car la machine virtuelle trouvée n'est pas celle attendue: par exemple si un JRE 32 bits a été installé sur une machine 64 bits.
  Voici ce qu'on peut trouver dans les traces:
  SerialConfig Constructor about to attempt to instantiate rxtx library.
  Serial library not installed.
  SerialConfig Constructor could not instantiate the rxtx library.
  SerialConfig Constructor exit.
  
  
• Sur l'imac, il faut récupérer tout le contenu du .dmg et pas uniquement l'app car sinon il va manquer des dépendances et il y aura dans les traces un message du type:
  java.lang.UnsatisfiedLinkError: no rxtxSerial in java.library.path thrown while loading gnu.io.RXTXCommDriver.
  
  
• S'il y a un soucis avec le module prenant en charge RS232 (RXTX), il est possible que rien n'apparaisse dans la combo box "Port" de la configuration série. Exemple: si le chemin vers RXTX est incorrect, impossible alors de faire fonctionner le serveur.
  Il peut être nécessaire de recompiler RXTX pour un bon fonctionnement sur la machine moderne.
  Pour WIN, il y a 2 versions de RXTX.  Sur un PC 64 bit avec Windows 7, il faut pointer sur rxtx-2.2pre2.
  
  
• Personne n'est à l'abri d'un problème hardware ou des conséquence d'un mauvais driver.
  Je pense par exemple à l'adaptateur USB/Série côté imac. (Si vous constatez des arrêts de transferts en cours de route avec Mac OS/X en utilisant un adaptateur à base de chipset Prolific).
  Vous pouvez aussi avoir côté Apple IIe des problèmes liés au fait qu'une disquette soit esquintée ou un contrôleur instable (SSC ou contrôleur de lecteur de disquettes).
  
  
• La communication entre les 2 machines ne s'effectue pas (gel lors de l'attente d'une réponse) si le cable est HS ou inadapté ("printer cable" à la place de "null modem cable" par exemple).
  
  
• Une mauvaise configuration de la carte SSC (jumper+switchs) ou d'ADTPro côté Apple IIe affecte aussi la communication.
  Le piège facile est de déclarer la SSC dans un autre slot que celui où elle est réellement! Pensez à ouvrir le "capot" de votre Apple II pour vérifier le slot. Ce n'est pas parce que le cable sort derrière par le 1er trou que la carte SSC est nécessairement dans le slot 1!
  De même lors du bootstrapping (si vous devez en faire un), ne tapez pas bêtement sur votre Apple IIe ce qui est indiqué sur l'écran de l'imac. Adaptez la commande IN# au slot dans lequel se trouve la SSC.
  
  
• Risque aussi de disfonctionnement dans la communication si la vitesse de transfert indiquée dans la configuration sur l'Apple IIe est différente de celle sur l'imac. Il faut toujours synchroniser les deux.
  
  
• Si votre version d'ADTPro est boguée ou compilée pour une JRE supérieure à celle installée sur votre machine, vous allez partir en vrille.
  
  
• Ne vous étonnez pas d'erreurs lors de l'écriture sur une disquette si cette dernière est protégée contre l'écriture (encoche couverte ou pas d'encoche physique).
  
  
• Lors d'un bootstrapping, il y a un risque de problème si un système d'exploitation est déjà chargé côté Apple IIe. La solution:
  "2. Boot your Apple; hit Ctrl-Reset before it reads anything from the disk drive. It's important that it not load any OS, even DOS 3.3."