Configuring VxWorks for Your Account

Procedure

1.     Remote login to "ratdog" (ratdog is the host machine):

               ----> rlogin ratdog
               ----> setenv DISPLAY localmachinename:0.0
               
               Example using machine "geeko":
                 --> setenv DISPLAY geeko:0.0
                              
2.     First-time setup: 
       If you are a first time user of Tornado, you need to do the
       following. Otherwise, skip step #2 and proceed to step #3.
       
       Copy of a file called "tornado.env" and place it in your
       home directory. 
       
               ----> cp /tornado.config/tornado.env .
               
       Add the following to .Xdefaults file in your home directory.
       
       
               ----> *customization: -color
               
       Execute the following command in a regular shell.
       
               ----> xrdb .Xdefaults
       
       
3.     Source "tornado.env":

               ----> source tornado.env

               
4.     Start Tornado:

               ----> launch &
               
5.     Redirect I/O to show up on the local machine. 
               
6.     Connect to a target agent:

                1.Click on the "Target" menu item and select the "Create" option, 
                a dialog box will come up. 
                2.In the "Target name or IP address" text field type in the IP 
                address of the particular VME bus you want to connect to. See
                Table 1.
                3.In the "Target server name" text field enter the target name.
                See Table 1.

                4. Click "Virtual console","All symbols",and "Verbose" toggle
                switches.
                5.Click on the "Launch" button at the bottom of the dialog box.
                This will intiate a connection with the target machine and save
                this configuration for later use. When you reconnect in the future 
                this particular configuration will be saved and can be reused. See
                the "Saved configurations" scroll area on the dialog box. 
               
7.     Compile:
       Compile your source code to an object file using the "rlogin ratdog" shell
       configured in steps 1-3 above.
       
               ---->  cc68k -fno-builtin -I ${WIND_BASE}/target/h -nostdinc \
               	      -O -c -g -m68040 -DCPU=MC68040 filename.c
               
8.     Download the object file to the target machine:
       Start "CrossWind" by clicking on the button labeled as such. Then load the
       object file by selecting "Download..." from File menu item. You should see
       a confirmation statement in the command area of CrossWind.
       
9.     Examine, debug, and run:
       Type "list" in the command area of CrossWing to view your source
       file. At this point you can start debugging, executing, etc.... 
       refer to on-line manuals for extensive help.
       
       
10.    Kill the target:
       When you finish, make sure you kill your target server you started
       in step #4 by executing the "Kill" option under the "Target" menu
       item. Otherwise, no one will be able to connect to the target
       machine(server) later.
               

Additional Information

Please see the VxWorks User's manual for further information.