컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 DOCUMENTATION DU PROGRAMME BBTPRO R굒ision du 28-Mars-1994, (C) Copyright 1994 Jean-Claude MICHOT 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 I) PROLOGUE II) BBTPRO TERMINAL a) Introduction b) Les commandes c) La gestion de la souris d) La carte KXTEL de chez Kortex(tm) e) Le mini-modem COMPOUCE de chez PNB(tm) f) Le light modem de chez COM1(tm) g) L'affichage VGA h) Des lenteurs sur un PC peu rapide 8086, 80286 i) La gestion de ports de communication j) Les probl둴es lors de transfert de fichiers (BBT ou Zmodem) III) BBTPRO RECEPTION a) Introduction b) Param굏rage IV) BBTPRO ENVOI a) Introduction b) Param굏rage VI) EPILOGUE APPENDIX A) Syntaxe d'utilisation du programme BBTPRO sous MS-DOS. APPENDIX B) Utilisation commerciale du protocole BBT. 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 I) PROLOGUE: Documentation sur le protocole BBT et sa version MS-DOS (BBTPRO) Le protocole BBT a 굏� � l'origine r괶lis� afin d'괹hanger des fichiers via le minitel. Ce protocole relativement simple dans sa conception permet de t굃괹harger tout fichier binaire � partir d'un moyen de communication 7 bits tel que le minitel. Le protocole BBT a 굏� cr굚 en Juin 89 par Jean-Claude MICHOT, la signification des lettres BBT est "Bulletin Board Transfer". Le terme BBS, "Bulletin Board System" d굎igne un certain type de serveur tr둺 r굋andu outre atlantique. La version MS-DOS de r괽굍ence du protocole BBT porte le nom de BBTPRO. Cette version int둮re diverses fonctions telles que: . Emulation de teminal VT100, ANSI-BBS, ISO-8859(Windows) . Emulation de Minitel(tm) 1B (40col et 80col) . Protocole de transfert BBT (Reception et Envoi) . Protocole de transfert Zmodem (Reception et Envoi) . Protocole de transfert Compatible (Reception) . Protocole de transfert Transity (Reception) . 2 choix de taille d'굆ulation minitel en mode texte et semi-graphique. . Annuaire t굃굋honique param굏rable. . Compatible Minitel(tm), Modem Hayes et KxTel. . Gestion de la souris et interpr굏ation des mots-cl굎 par simple clic. II) BBTPRO TErminal : a) Introduction La version MS-DOS de BBTPRO 2.2 int둮re un 굆ulateur vid굊tex qui permet la connexion � tous les serveurs vid굊tex. La particularit� de cette 굆ulation, c'est qu'elle d굏ecte d'elle- m늤e l'envoi de fichiers par le serveur avec les protocoles BBT, Zmodem, et protocole Compatible. De plus, elle sait faire du vid굊tex � des vitesses et formats tout autre que le 1200 bauds (7E1) du minitel. En effet il est possible de se connecter sur TEASER avec un modem en V22bis donc � 2400 bauds, 8 bits de data, pas de parit� ou bien en V32b � 14.400 bauds par exemple. Par d괽aut les param둻res sont : COM2 1200 7e1 (avec COM2, reli� � un minitel) b) Les commandes Les commandes de BBTPRO 2.2 en mode terminal sont les suivantes: ALT-P Param굏rage ALT-V Voir un 괹ran vid굊tex en local ALT-H Hangup modem (DTR-OFF/DTR-ON) ALT-D Annuaire t굃굋honique ALT-J Commande MS-DOS ALT-U Upload BBT ALT-Z Upload Zmodem ALT-W Upload Zmodem ALT-I Mode Iso ALT-G Flip/Flop Controle de flux Hardware (CTS/RTS) ALT-A Flip/Flop Terminal mode 80col TTY / Vid굊tex ALT-B Flip/Flop Emulation 40col en gros, 40col en petit ALT-K Composition d'un num굍o t굃굋honique ALT-L Capture du texte d'une connexion ALT-S Capture d'un 괹ran vid굊tex en fichier texte (VDXxxxx.TXT) ALT-CR Flip/Flop Convertir CR et DEL (minitel / ASCII) ALT-X Quitter le programme F1 Envoi la macro num굍o 1 F2 Envoi la macro num굍o 2 F3 Envoi la macro num굍o 3 F4 Envoi la macro num굍o 4 F5 Envoi la macro num굍o 5 F6 Envoi la macro num굍o 6 F7 Envoi la macro num굍o 7 F8 Envoi la macro num굍o 8 F9 Envoi la macro num굍o 9 F10 Envoi la macro num굍o 10 ALT-F1 D괽inition de la macro num굍o 1 ALT-F2 D괽inition de la macro num굍o 2 ALT-F3 D괽inition de la macro num굍o 3 ALT-F4 D괽inition de la macro num굍o 4 ALT-F5 D괽inition de la macro num굍o 5 ALT-F6 D괽inition de la macro num굍o 6 ALT-F7 D괽inition de la macro num굍o 7 ALT-F8 D괽inition de la macro num굍o 8 ALT-F9 D괽inition de la macro num굍o 9 ALT-F10 D괽inition de la macro num굍o 10 c) La gestion de la souris Le support de la souris est int괾r� � BBTPRO, il a 굏� test� avec une souris et un driver Microsoft(tm). Le bouton gauche de la souris s굃ectionne un texte � l'괹ran et valide ce dernier par la touche ENVOI. Le bouton droit de la souris s굃ectionne un texte � l'괹ran et ne valide pas l'envoi de ce texte. Il est alors possible de faire une s굃ection de texte puis de la valider par une autre touche de fonction que ENVOI. Ex: GUIDE, SUITE... Les textes: ENVOI, SUITE, RETOUR, ANNULATION, SOMMAIRE, RTOUR, CORRECTION, GUIDE, CONNEXION, *ENVOI, *SUITE, *RETOUR sont reconnus par BBTPRO et une traduction vers la touche MINITEL correspondante est r괶lis괻. Les versions 2.3.00 et sup굍ieures int둮rent le protocole Zmodem dont la d굏ection en r괹eption et en envoi est automatique. Les versions 2.3.04 et sup굍ieures int둮rent le protocole dit 'Compati- ble' dont la d굏ection en r괹eption est automatique. Les versions 2.3.05 et sup굍ieures int둮rent le protocole 'Transity' dont la d굏ection en r괹eption est automatique. d) La carte KXTEL de chez Kortex (tm) Il faut param굏rer la vitesse � 75 Bauds si vous utilisez une carte KORTEX pour r괶liser des connexions en V23 (1200/75). e) Le mini-modem COMPOUCE de chez PNB (tm) Si vous utilisez un modem de type COMPOUCE de chez PNB mettez un "set INT14=1" dans votre fichier autoexec.bat puis chargez le programme r굎ident COMPOUCE.EXE avant d'utiliser BBTPRO avec ce modem. (l'option en ligne de commande est -uint14) f) Le light modem de chez COM1 (tm) Si vous utilisez un modem de type LIGHT MODEM de chez COM1 mettez un "set LEGER=1" dans votre fichier autoexec.bat. g) L'affichage VGA Si vous constatez des probl둴es d'affichage en mode VGA, vous pouvez mettre un "set NOVGA=1" dans votre fichier autoexec.bat (l'option en ligne de commande est -windows) h) Des lenteurs sur un PC peu rapide 8086, 80286 Si vous constatez des probl둴es de lenteur d'envoi en mode serveur vous pouvez mettre un "set VITE=1" dans votre fichier autoexec.bat i) La gestion de ports de communication En standard BBTPRO utilise une librairie de communication qui porte le nom de "COMMPKG" r괶lis괻 par Jean-Pierre PARISY. Il est toutefois n괹essaire d'utiliser avec certain modem le gestionnaire INT14 de communication du PC. Une simple variable "INT14=1" ou l'option -uint14 en ligne de commande permet l'utilisation de ce gestionnaire. Pour ceux qui possedent des cartes de communication a des adresses et sur des IRQ non standard il est possible d'informer le programme de cette 굏at de fait, afin qu'il exploite correctement les ports de communication. La configuration standard de BBTPRO au niveau IRQ et Adresse est la suivante: Com IRQ Adresse KxTel ---------------------------------- Com1 4 0x3f8 - Com2 3 0x2f8 - Com3 4 0x3e8 370 Com4 3 0x2e8 270 Il est possible d'utiliser n'importe quelle Irq ou Adresse par la d괹laration d'une variable "COMxADRIRQ=AAAA IRQ" ou 'x' est le num굍o de communication, AAAA l'adresse en Hexad괹imale, et IRQ le num굍o de l'irq. Exemple: "COM3ADRIRQ=0x3e8 5" j) Les probl둴es lors de transfert de fichier (BBT ou Zmodem) Que ce soit en t굃괹hargement avec Zmodem ou BBT, il y a une detection automatique des probl둴es lies aux composants de communication (8250,16450,16550) de votre PC. Les messages d'erreurs suivants peuvent survenir: "ATTENTION: OVERFLOW( n )" "ATTENTION: OVERRUN( n )" "ATTENTION: BREAK( n )" "ATTENTION: FRAME( n )" "ATTENTION: PARITY( n )" ou 'n' repr굎ente le nombre d'erreurs qui sont survenues. En r둮le g굈굍ale une erreur de ce type implique une perte d'un ou plusieurs octets et provoque donc une re-굆ission du protocole � la suite d'un BAD-CRC. Ce genre de probl둴e est g굈굍alement li� � une vitesse d'aquisition de l'information qui est insuffisante. (La machine ne va pas assez vite) Exemple: vous dialoguez � 57600 baud entre le PC et le modem alors que vous n'avez qu'un simple 8250 pour g굍er la communication. Les causes des divers messages d'erreurs: PB: Vous avez regulierement des mesages d'erreurs tout les multiples de 4Ko avec Zmodem. Zmodem enregistre sur disque les donn괻s tous les 4Ko et MS-DOS ou vos divers caches-disque interdisent les interruptions pendant trop longtemps lors de l'괹riture. Pour r굎oudre ce probl둴e il y a plusieurs solutions possibles en fonction de la cause (voici quelques id괻s � essayer, mais il est possible d'avoir une machine qui fonctionne parfaitement avec tous les programmes que je vous conseille de retirer � titre d'essai): . T굃괹harger sur ramdisque . T굃괹harger sur un disque non compress� . Retirer EMM386 du votre fichier CONFIG.SYS . Retirer SMARTDRV de vos fichiers CONFIG.SYS et AUTOEXEC.BAT . Retirer QEMM de vos fichiers CONFIG.SYS et AUTOEXEC.BAT . Retirer (les divers caches disque plus ou moins 굏ranges...) . Retirer le/les gestionnaires r굎eaux Si vos probl둴es persistent avez Zmodem vous pouvez utiliser le program- me "GSZ.EXE" et lancer BBTPRO.EXE avec l'option -G en ligne de commande. Attention, ce programme est un Shareware, vous devez donc le payer si vous l'utilisez r괾uli둹ement. PB: Vous avez syst굆atiquement des messages d'erreurs lors de l'envoi de fichier avec Zmodem. La vitesse de configuration entre le PC et modem est plus importante que la vitesse d'envoi des informations sur la ligne t굃굋honique. Il faut donc mettre en place un "contr뱇e de flux" ; ceci s'effectue par la commande ALT-G en mode terminal ou l'options "-!" en ligne de commande. III) BBTPRO RECEPTION : a) Introduction : Pour recevoir un fichier envoy� par un serveur utilisant BBT comme protocole il suffit de lancer BBTPRO sur votre micro-ordinateur et de l'utiliser reli� � un modem ou un minitel pour vous connecter sur un serveur. Il faut bien s뻭 que votre micro-ordinateur et le minitel ou modem soient reli굎 par les c긞les n괹essaires. La d굏ection d'un envoi de fichier par le serveur se fera de mani둹e automatique. Si le programme BBTPRO est ex괹ut� sans y mettre d'argument il passe automatiquement dans un mode par d괽aut d괽ini lors de la configuration du programme. (Dans la distribution originale c'est le mode terminal � 1200 bauds sur COM1). b) Param굏rage : Certains param둻res peuvent 늯re modifi굎 par l'utilisateur. Ces param둻res peuvent 늯re tap굎 en ligne de commande lors du lancement du programme. Les modifications suivantes peuvent 늯re effectu괻s, - On peut utiliser un autre port s굍ie de communication que le num굍o 1. Il suffit pour cela de lancer BBTPRO en lui pr괹isant sur quel port de communication se trouve reli� le minitel. Exemple: "BBTPRO -s 2" BBTPRO utilisera dans ce cas, la s굍ie num굍o 2. Toutes les options utilisables en ligne de commande peuvent 늯re obtenues par la commande "BBTPRO ?" ou "BBTPRO /H". Les options d굎ir괻s doivent etre tap괻s en majuscule ou minuscule derri둹e un - ou / et les param둻res des options peuvent ou non 늯re pr괹괺괻s d'un espace. Les exemples suivants sont identiques: "BBTPRO -s 2", "BBTPRO /S 2", "BBTPRO -S2", etc etc... On peut utiliser les ports 1 et 2 reconnus automatiquement par le DOS ou utiliser les ports 3 et 4 que certains logiciels permettent de rendre disponibles sous DOS. - Le r굋ertoire o� sont re뇎s les fichiers qui seront t굃괹harg굎. En effet il est souvent pratique de recevoir tous les fichiers venant d'un serveur dans un r굋ertoire bien pr괹is. Pour cela, il suffit de pr괹iser au programme BBTPRO le nom du r굋ertoire o� l'on d굎ire recevoir lesdits fichiers. Exemples: "BBTPRO -s 1 -c C:\TELE\QBBS" ou "BBTPRO -s 2 -c C:\TELE\VDX\TEASER" ou "BBTPRO -s 4 -c C:\TELE\VDX\FOX" Le r굋ertoire o� sont re뇎s les fichiers t굃괹harg굎 porte le nom de pr괽ixe. IV) BBTPRO ENVOI : a) Introduction : La version MS-DOS de BBT donne la possibilit� aux utilisateurs de s'envoyer des fichiers entre eux sans passer par l'interm괺iaire d'un serveur. Lorsque deux utilisateurs d굎irent s'envoyer un fichier sans passer par l'interm괺iaire d'un serveur, l'un d'entre eux doit utiliser cette option de BBTPRO. BBTPRO permet aussi aux SYSOPs (Systeme Operator, personne g굍ant un micro-serveur) de proposer du t굃괹hargement sur leurs serveurs en utilisant le protocole BBT gr긟e au programme BBTPRO utilis� comme commande externe. Une temporisation de quelques secondes est d괹lench괻 sur le paquet d'ent늯e et dans le cas d'괹h괶nce de la temporisation ou de perte de porteuse durant le transfert le programme rendra la main au syst둴e. b) Param굏rage : Certains param둻res doivent 늯re modifi굎 par le SYSOP afin de placer BBTPRO dans le r뱇e d'un serveur de fichiers. Ces param둻res doivent 늯re tap굎 en ligne de commande lors du lancement du programme. Les modifications suivantes peuvent et doivent 늯re effectu괻s : - On peut utiliser un autre port s굍ie de communication que le num굍o 1. Il suffit pour cela de lancer BBTPRO en lui pr괹isant sur quel port de communication se trouve reli� le minitel ou le modem. Exemple: "BBTPRO -e -s2 -nFICHIER.TXT" BBTPRO utilisera dans ce cas, la s굍ie num굍o 2. On peut utiliser les ports 1 et 2 reconnus automatiquement par le DOS ou utiliser les ports 3 et 4 que certains logiciels permettent de rendre disponibles sous DOS. - Le nom du fichier qui doit 늯re envoy�. Ce param둻re est INDISPENSABLE ! Pour cela, il suffit de pr괹iser � BBTPRO le nom du fichier qui doit 늯re envoy� par le serveur. Un nom avec ou sans le chemin d'acc둺 complet peut 늯re sp괹ifi�. (Le chemin d'acc둺 sera de toutes fa뇇ns ignor� par le programme BBT qui recevra le fichier) De m늤e il est possible d'envoyer plusieurs fichiers avec une unique commande si le nom de fichier comporte des jokers ( * ou ? ) sous MS-DOS. Dans le m늤e principe il est possible de d괽inir une liste de fichiers � envoyer. Cette liste doit comporter une ligne par fichier cette derni둹e 굏ant constitu괻 du chemin d'acc둺 et du nom du fichier � envoyer. Pour informer BBTPRO d'envoyer les fichiers contenus dans une liste il suffit de lui donner le nom de cette liste avec un "@" en t늯e. Exemples: "BBTPRO -E -s 1 -n C:\ENVOI\TEXTE.TXT" ou "BBTPRO -E /S2 -n DEMO.EXE" ou "BBTPRO -E -S 3 -n DEMO.*" ou "BBTPRO -E -s 4 -n A:\TMP\MYPRINT.COM" "BBTPRO -E /s1 /n @C:\TMP\LISTE.TXT" - Le fichier "logfile". Ce fichier est une trace de tout ce qui a 굏� t굃괹harg� avec BBT sur votre serveur. Il est fortement conseill� d'utiliser un chemin d'acc둺 complet comme param둻re pour cette commande. Exemple: "BBTPRO -e -s 1 -f xxxxxxx -l C:\SERVEUR\BBTLOG.TXT" ou 'xxxxxxx' repr굎ente le nom du fichier que le serveur doit envoyer � l'utilisateur. - La taille des paquets utilis굎 par le protocole. En standard BBTPRO utilise des paquets de 3072 Octets en envoi serveur. Mais il peut 늯re fort utile de modifier ce param둻re; par exemple lorsque la personne qui appelle le serveur vient de loin et que la ligne t굃굋honique est de qualit� m괺iocre. Exemple: "BBTPRO -e -s 2 -n C:\DOWN\PC\C\CNUL.ARC -l C:\SERVEUR\BBTLOG.TXT -b 1024" Dans l'exemple pr괹괺ent BBTPRO envoie comme serveur sur le port s굍ie num굍o 2 le fichier "C:\DOWN\PC\C\CNUL.ARC", il archive, si le download s'est bien pass�, une trace dans le fichier "C:\SERVEUR\BBTLOG.TXT" et le protocole utilisera des paquets de 1024 caract둹es. VI) EPILOGUE: Je vais profiter de l'occasion qui m'est donn괻 pour remercier toute l'굌uipe de joyeux drilles qui a port� le protocole sur la plupart des machines et OS du march�. Donc Merci � : Top (MSDOS,COHERENT), rcougnenc (MSDOS), JNM (AMIGA), michel (MAC), LCI (MSDOS), cistel (MSDOS), Tomcat (ATARI,MAC), TITI61 (MSDOS), mikro (MSDOS), Ldfa (AMIGA), alain (MAC), DCA (APPLE II), ETOILE (ATARI), OMMADAWN (MSDOS/MULTIM), GOTO INFORMATIQUE (Soci굏�), OLITEC (Soci굏�) H� oui.... 놹 en fait du monde... Actuellement BBT est disponible entre autres, sur les syst둴es suivants : . PC MS-DOS WINDOWS . Atari (Gem) . Amiga (AmigaDos) . Mac (System6 ou 7) . Qnx2 & Posix Qnx4. . Unix Texas (mini) . SunOS (Sun) . Apple II (PRODOS) . Unix 386 (COFF386) SCO,INTERACTIVE,ESIX,DELL,... Je vous souhaite de faire de bons t굃괹hargements et de d괹ouvrir des choses int굍essantes dans ce que vous aurez t굃괹harg�. Jean-Claude MICHOT, APPENDIX A) Syntaxe d'utilisation du programme BBTPRO sous MS-DOS. BBTPRO 2.3.00 (Date: Jan 24 1994) (Compilateur: BC++ 3.1) Aide: BBTPRO /H -Terminal (Petit terminal vid굊tex) COM2,57600,8N1, -Reception (Reception de fichier/s) -Envoi (Envoi de fichier/s) -s serie (1,2,3,4) -v vitesse (75,1200,2400,9600,19200,38400,57600) -p parite (EVEN,NONE) -f format (7,8) -n nom_de_fichier ou pattern ou liste -c chemin_d'acces -b lng_d'un_paquet_BBT (256<=lng<=4096) -l nom_de_fichier_trace -abandon (Sortir du programme apr둺 un fichier t굃괹harg�) -uint14 (Utiliser l'int14 pour modem PNB(compouce) ou LAN(reseau)) -minitel (Retournement de minitel pour envoi de RTC a RTC) -imm괺iat (Utiliser BBTPRO comme protocole externe) -O SoundOff -kiosque (Envoi d'un fichier via un PAVI, teletel) -/ Clavier Minitel -windows (Ne recharge pas les polices VGA) -80col -Z Autorep V32bis -discret (N'affiche rien � l'괹ran) -J pas de ALT-J(msdos) -Gsz/dsz -XDebug (Debug protocoles) -!hardflow(CTS/RTS) -Y Test de la porteuse APPENDIX B) Utilisation commerciale de BBT A noter : L'utilisation du protocole sur des serveurs RTC non commerciaux, est TOTALEMENT LIBRE et n'est soumise � AUCUNE contrainte, de m늤e que l'utilisation et la r괶lisation des impl굆entations dans les logiciels d'굆ulation de minitel/terminaux.. Toute exploitation du protocole BBT sur un serveur Transpac est consid굍괻 comme une utilisation commerciale et ceci quel que soit le niveau de taxation du serveur. Une licence d'exploitation commerciale du protocole est disponible pour les serveurs commerciaux (Transpac). Pour en conna똳re les termes veuillez contacter la soci굏� France-Teaser par fax au +33 (1) 46 26 04 52 ou sur les serveurs suivants : Serveur: TEASER v23 (1.47500200) 7E1 TEASER v32-v32bis OLITEC (1.47500600) 8N1 TEASER v32-v32bis USR (1.47500710) 8N1 TEASER v23 (3614 TEASER) 7E1 TEASER v23 (3615 TEASER) 7E1 TEASER v23 (3617 EMAIL) 7E1 BAL: TEASER