MegaSwitch Development Toolset SW50070 Release 1.1 931027 DANOSI Contents 2 Diskettes 2 Manuals 1 Set of slides (paper copy) 1 Package Description (this docu - ment) Purpose of package This package contain the develop- ment toolset to be used for develop- ment of Real Time Pascal programs that can be executed on MAC241 and MAC242 controllers. Reason for Release Correction of errors. Requirements SW50070 requires: Unix workstation Vpix SW2114 Real Time Pascal Compi- ler rel 2.19 SW51020 RcPAX ISO Presenta- tion Layer Occam 2 Toolset from INMOS and appropriate development board SW50050 MegaSwitch Basic Software, rel 4.1 SW51100 MegaSwitch Interwor- king, rel 4.1 If SW50070 is used in a DOS en- virronment, the shell scripts and the makejob cannot be used. Documentation RC5000 MegaSwitch, System and Router Software, Reference Ma- nual, june 1991. PN: 99001338. This manual gives a functional description of the software modu- les included. Futhermore a detail- ed description of the RTP pro- gramming-interfaces are given. Slides from "BNK-Temadag om MegaSwitch Udviklingsomgivelser hos KTAS, 911128". These slides gives an overview of the use of this package. EM Programmers Guide,12/12 1988, RCA.PAXNET.OER/NRH.195. Corrections and Enhancements Changes since release 1.0: LineConnector and LinkBus is up- dated as described in the package description af SW51100 rel. 4.1. DES-descriptions of relevant mo- dules are included. All are updated since sw50512 rel. 3.0. The requestset zmacc.r8z is inclu- ded. All basic RTP envirronments are updated. sys5000.env is not inclu- ded any more. Filename extension of precompiled RTP programs are changed to .tah for execution on transputer part and .t22 for execution on RC5000 CPU respectively. Thus also the file x25/makefile have changed and the file mxtrtp.lah are used instead of mxtrtp.l4h. 931015.1: NCP poll of RTP LCPs did not function because of an error in Mopsys. Limitations and Recommenda- tions The file mxt.btl can be generated by calling "make" in the /usr/mega/x25 directory. The compiled files from X.25/X.75 access software are assumed to be present. The makejob is functioning with SW2114 rel 2.19, the toolset D705B from INMOS and SW95707I VP/ix Multi-user Release 1.2 from ICL DATA with the following con- figuration. The vpix setup files are included for information only. Four different con- figurations are used in this setup: vpix.cnf use no special devices. vpix1.cnf use A: as floppy drive. vpix2.cnf use TDS device. TDS is defined as a nonstandard device. vpix3.cnf use TDS3 device. TDS3 is defined as a nonstandard devi- ce. By means of shell scripts using this configuration, a user is able to use different devices dependent of the purpose. Especially it is possible to use 2 inmos development boards at the same time. A number of shell scripts etc. are used by the makefiles: submake: activates a makefile in a subdirectory. crm: conditional remove. If the files does not exits no error mes- sage is generated. evenlen.com: DOS program that if necessary extends a .btl file to have even length to overcome problems in the RC8000 plib pro- grams. dos: executes the following com- mand (normally "do") and remo- ves the file $1.ok (normally "do.ok") if no errors have oc- cured. do: DOS batchjob, executes the following command (DOS pro- gram), writes "OK" in the file do.ok if the command is executed succesfully, and finally vpix is terminated. tdsreserve: reserves the tds sy- stem given in parameter $1. tdsrelease: releases the tds sy- stem given in parameter $1. tdsb: executes the following com- mand with reservation of the tds system and use vpix3.cnf con- figuration. After use the tds sy- stem is released. This scheme assures that a makejob is never stopped, because the tds system is used by someone else. tdsc: corresponds to tdsb, but uses vpix2.cnf configuration. floppy: corresponds to tdsb, but uses vpix1.cnf configuration. mak: executes makejob and prints output on both screen and the file named by parameter $1. rtppar: used for generation of .rci files (RTP parameter files). rtplink.vii: command to vi editor, changes extention from .c4h to .t4h on a list of files. awkp: command to awk, used for generation of the file mxtmem.inc to find the right addresss from the file mxt.map. The PI-5 utilities comprise: rtplink: "links" all lbdr chains of RTP programs so they can be used as input for ilink. rtptrace: takes a dump as input and prints a stacktrace for an ex- ception if a such have occured. rtpvers: prints version and date for for compiled RTP programs. Installation The directory /usr/mega must be the home directory of users using the development toolset. All software must be installed in the directory /usr/mega and in the sub- directory defined in the Identification of files section. The files tdsreser.ve and tdsrelea.se must be renamed to tdsreserve and tdsrelease respectively. All shell scripts in the util directory must be set to have execute permis- sions. The Occam 2 toolset must be instal- led in the directory /usr/mega/itools. The RTP compiler must be installed in the directory /usr/mega/rtp. Identification of Files readme file: readme50.070 vpix setup files: vpix/autoexec.bat vpix/vpix.cnf vpix/vpix1.cnf vpix/vpix2.cnf vpix/vpix3.cnf Shell scripts etc used by makefiles: util/submake util/crm util/evenlen.com util/dos util/do.bat util/tdsreserve util/tdsrelease util/tdsb util/tdsc util/floppy util/mak util/rtppar x25/rtplink.vii x25/awkp Unix makefiles: x25/makefile Mxt-stub: x25/mxtocc.l4h x25/mxtrtp.lah x25/mxt.t4h x25/mxt.pgm PI-5 runtime system: rtp/system/rtp.lib rtp/system/rtp2.lib Basic software modules: locon/localcon.t4h linecon/lineconn.t4h linecon/modemhan.t4h linecon/measureh.t4h library/linkbus.lib library/megarout.lib dce/mopsys.tah dce/lcpfunc.tah dce/ml.tah dce/mbxlink.tah dce/em02.tah dce/double.tah dce/paxzone.tah mega3502/mbxlink.t22 Basic RTP envirronments: paxenv/double.env paxenv/io.env paxenv/net.env paxenv/em02.env paxenv/xrou.env paxenv/xcs.env paxenv/cs.env paxenv/xscc.env paxenv/dis.env paxenv/ats.env paxenv/hdlc.env PI-5 Utilities: rtp/rtplink.com rtp/rtptrace.com rtp/rtpvers.com DES-files: des/mtlocalc.d8d des/mbxlink.d8d des/megalink.d8d des/mopsys.d8d Requestsets: reqset/zmacc.r8z The version numbers of the occam modules included in sw50070 is: LocalConnector 2.5 LineConnector 4.11 See also next page. The version numbers of the RTP modules for the transputer part is: name source date object date version mopsys 1993.10.07:11.06 1993.10.07:11.09 1.15 megalink 1991.05.02:13.52 1993.09.29:10.19 0.0 mbxlinkinit 1991.05.02:13.52 1993.09.29:10.20 0.0 mbxlinkcreat 1991.05.02:13.52 1993.09.29:10.20 0.0 mbxlinksend 1991.05.02:13.52 1993.09.29:10.20 0.0 mbxlinkrecei 1991.05.02:13.52 1993.09.29:10.20 0.0 emanswermess 1992.02.04:13.40 1993.09.29:10.22 2.40 emfreeevents 1992.02.04:13.40 1993.09.29:10.22 2.40 emsender 1992.02.04:13.40 1993.09.29:10.22 2.40 emprepareeve 1992.02.04:13.40 1993.09.29:10.22 2.40 emsendspoolp 1992.02.04:13.40 1993.09.29:10.22 2.40 emsendevents 1992.02.04:13.40 1993.09.29:10.22 2.40 emreceivemes 1992.02.04:13.40 1993.09.29:10.22 2.40 eminitrc 1992.02.04:13.40 1993.09.29:10.22 2.40 emspoolevent 1992.02.04:13.40 1993.09.29:10.22 2.40 emwaithardev 1992.02.04:13.40 1993.09.29:10.22 2.40 emterminate 1992.02.04:13.40 1993.09.29:10.22 2.40 emabort 1992.02.04:13.40 1993.09.29:10.22 2.40 emsnooping 1992.02.04:13.40 1993.09.29:10.22 2.40 emsnoopevent 1992.02.04:13.40 1993.09.29:10.22 2.40 emoldtonewma 1992.02.04:13.40 1993.09.29:10.22 2.40 doubleadd 1991.05.02:13.52 1993.08.17:09.11 0.0 doublediv 1991.05.02:13.52 1993.08.17:09.11 0.0 doublelt 1991.05.02:13.52 1993.08.17:09.11 0.0 doubleint 1991.05.02:13.52 1993.08.17:09.11 0.0 doubleuint 1991.05.02:13.52 1993.08.17:09.11 0.0 intdouble 1991.05.02:13.52 1993.08.17:09.11 0.0 uintdouble 1991.05.02:13.52 1993.08.17:09.11 0.0 doublemadd 1991.05.02:13.52 1993.08.17:09.11 0.0 doublemod 1991.05.02:13.52 1993.08.17:09.11 0.0 doublemsub 1991.05.02:13.52 1993.08.17:09.11 0.0 doublemul 1991.05.02:13.52 1993.08.17:09.11 0.0 doublesub 1991.05.02:13.52 1993.08.17:09.11 0.0 doubledec 1991.05.02:13.52 1993.08.17:09.11 0.0 doubleinc 1991.05.02:13.52 1993.08.17:09.11 0.0 lcpinc 1991.05.02:13.52 1993.09.29:10.19 2.0 lcptyp 1991.05.02:13.52 1993.09.29:10.19 2.0 lcpidtoint 1991.05.02:13.52 1993.09.29:10.19 2.0 inttolcpid 1991.05.02:13.52 1993.09.29:10.19 2.0 typinctolcpi 1991.05.02:13.52 1993.09.29:10.19 2.0 initpaxzone 1991.05.28:17.02 1993.09.29:10.20 0.0 getpaxsem 1991.05.28:17.02 1993.09.29:10.20 0.0 freepaxsem 1991.05.28:17.02 1993.09.29:10.20 0.0 syncpaxopsys 1991.05.28:17.02 1993.09.29:10.20 0.0 gethdlcline 1991.05.28:17.02 1993.09.29:10.20 0.0 initpaxname 1991.05.28:17.02 1993.09.29:10.20 0.0 getnetaddr 1991.05.28:17.02 1993.09.29:10.20 0.0 pliblook mbxlink.t22 nr kind name source date object date version bytes 1 PROGRAM mbxlink 1991.11.14:12.09 1993.09.29:13.48 1.5 9924