Note:  this help file is meant only for users of ulab, the Sun system
which supports the departmental microprocessor lab for courses
CS341, 440, and 644.

mtip allows you to access a "board", a singleboard (or similar) 
microprocessor system from timesharing on host ulab.  For example,
here is a session script made with "script" (another advantage of this 
hookup is the ability to make such scripts).  See also "help mtip".

Script started on Mon Sep  2 20:02:04 1996

ulab(1)% mtip -f $pcex/test.lnx
For command help, type ~?
For help on args, rerun without args
Code starts at 0x100100
Using board # 1 

Tutor> ~resetting board #1!
Please type CR to confirm console setting:           ---enter carriage-return
Setting console dev = 2
Console: colour EGA+ 80x25
COM1 at 0x03f8 (irq = 4) is a 16450
COM2 at 0x02f8 (irq = 3) is a 16450

                 Welcome to UMB Tutor for the PC
   UMB Tutor is a 32-bit protected-mode PC debugger/downloader,
       based on Linux, UMB Tutor for m68k, and remote gdb.
UMB Tutor is free software and you are welcome to distribute copies
of it under certain conditions.  There is no warranty for this program.
The copyright and warranty provisions follow the Gnu general public
license, available for view in gdb and elsewhere.  Full sources available.
--bugs, suggestions, questions to eoneil@cs.umb.edu

Exception 3 at EIP=0005ff7d: Breakpoint
Tutor> ~downloading /groups/ulab/pcdev/examples/test.lnx
Calling loadprog()
.......Done loading user program
Done.
Tutor> go 100100

Welcome to C on this machine, whatever it is

testing, testing, 1, 2, 3...
Single-char input test using getchar:
Now enter a char: j
If running without an OS, note how it was picked up and used
 before you typed CR.

If running with an OS, note how it waited until you typed .
Here it is, via putchar: j
Multiple-char input test using scanf:
Now enter a word: abcdef

scanf got abcdef

Now enter a number: 888

scanf got 888
Exception 3 at EIP=0010010b: Breakpoint           ---normal termination
							hits breakpoint at end
Tutor> ~h You are using board 1
 Commands are: 
  ~d  (or ~D) download file specified by -f or ~f
  ~f  (or ~F) set download filename
  ~h  (or ~H or ~?) this help text
  ~r  (or ~R) reset the board
  ~s  (or ~S) sleep for 1 (s) or 10 (S) seconds
  ~!  UNIX command to lower shell
  ~\c send char c literally (raw mode)
  ~q  (or ~Q) quit
  CTRL-C CTRL-C: send CTRL-C to board and quit
  CTRL-Z under C shell: suspend job
  quit-char: quit and drop core file
All other char sequences are sent to the board

Tutor> rd                                         ---reg display
EAX=00000001 EBX=00009e00   EBP=00057898
EDX=001002c8 ECX=00069004   ESP=003ffff0
ESI=00090800 EDI=00101adc   EIP=0010010b
EFLAGS=0202 (IF=1 SF=0 ZF=0 CF=0 OF=0)
Tutor> md 100100                                  ---memory display
00100100    bc f0 ff 3f 00 e8 02 00 00 00 cc 90 55 89 e5 e8 ...?........U...
Tutor> md 200000
00200000    00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
Tutor> ms 200000 44                               ---memory set
Tutor> md 200000
00200000    44 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 D...............
Tutor> ~? You are using board 1                   ---help inside mtip
 Commands are: 
  ~d  (or ~D) download file specified by -f or ~f
  ~f  (or ~F) set download filename
  ~h  (or ~H or ~?) this help text
  ~r  (or ~R) reset the board
  ~s  (or ~S) sleep for 1 (s) or 10 (S) seconds
  ~!  UNIX command to lower shell
  ~\c send char c literally (raw mode)
  ~q  (or ~Q) quit
   send  to board and quit
   under C shell: suspend job
  : quit and drop core file
All other char sequences are sent to the board

~!date                                           --- shell escape
Mon Sep  2 20:06:34 EDT 1996
!
~q                                               --- ~q to quit 
Quit handler: Leaving board #1
ulab(3)% exit
exit

script done on Mon Sep  2 20:07:03 1996

You can reset the board with the ~r command. This sends a command to
the reset server, which is directly wired to the reset logic of the
online board.  In fact, it is advisable to reset a board as soon as
you get it, because it could be left in a very strange state by the
last user.

If "~r" stops working, while mtip itself is OK, it means that the
reset server isn't working.  See topic "mtip reset" for help.



next up previous
Next: mtip reset Previous: The mtip Command: intro