vendors/Insight/XC2VP7_Microblaze/README

   1 Warning:  You have entered the domain of the reconfigurable penguin.
   2
   3 Things you should know:
   4
   5 (1) The kernel and OS image are in /dev/mtd5, also known as /dev/flash/image.
   6     Don't do "eraseall /dev/mtd5" unless you want to reprogram the flash from
   7     within xmd.   You probably don't want to do this.  There is currently no
   8     way to update the kernel from within uClinux itself.  I'm working on it.
   9
  10 (2) Don't "cat /proc/kmsg"!  This is the only guaranteed way I know to crash the
  11     kernel.  I don't know why this happens, but there are much bigger problems to
  12     solve than that one!  Everything else in /proc seems to work pretty well.
  13
  14 (3) There's a test program called gpio_test.  Run it and see what it does.
  15
  16 (4) /var and /usr are both writable file systems (ext2 on ramdisk).  However, I've
  17     had to hack the kernel to get around some mb-gcc bugs to get them working.  It
  18     won't take much to break them at the moment, but simple file copies should be OK.
  19
  20 (5) The shell you are running is "sash".  It's pretty simple, no output
  21     redirection, no scripting commands (for, case etc), and so on.  You can use
  22     the ampersand '&' to launch processes in the background.  Try it, it works!
  23
  24 (6) 'ps' and 'uptime' both work.  See if you can stress the processor then run
  25     uptime to view the sweat on its brow!  Have a look in /bin to see what other
  26     familiar *n*x tools are present in the demo.
  27
  28 (7) /dev/ttyS0 is the main console, /dev/ttyS1 is the debug uart.  Try putting
  29     some terminal software on that line at 115200kbps and see if you can talk to it.
  30
  31 (8) If you manage to crash this demo (other than (2) above), please send an email
  32     to the microblaze uclinux mailing list and tell us how you did it.  Mailing
  33     list details found at www.itee.uq/edu.au/~jwilliams/mblaze-uclinux
  34
  35 (9) There is no number 9.
  36
  37 There's still plenty of work to be done, but if you (or your boss) are umm-ing and
  38 ahh-ing about the viability of uclinux on microblaze, hopefully this demo will
  39 inspire some confidence.
  40
  41 Have fun - I certainly am! :)
  42
  43 John Williams <jwilliams@itee.uq.edu.au>
  44