# These instructions are specific to the installatin of tinyos on the
# group laptop in 330 Cory
#
# Date: Thu Oct 21 19:28:00 PDT 2004

Definitions for use below:
<username> refers to you EECS account name


--- INSTRUCTIONS ---
- Set up a cygwin account
  * start up cygwin (3 options below)
    ~ should be a shortcut on the desktop that uses the terminal
      emulator rxvt (recommended)
    ~ can run cygwin-rxvt.bat directly at
      c:/tinyos/cygwin/cyginw-rxvt.bat
    ~ can run the default cygwin prompt at
      c:/tinyos/cygwin/cyginw.bat
  *   mkpasswd -d -u <username> >> /<username>.txt
  * logout of cygwin and then logout of windows
  * Contact Phoebus (phoebusc) to finish creating a cygwin account for
    you (he will modify /etc/passwd and add you to the 'tos' group)
    and wait.

- OPTIONAL: Make your home directory not world writeable
  * chmod go-w /home/<username>

- Setting up your environment
  *   cd /cygdrive/c/Installation\ Files/tinyos/tinyos-1.x_extra_files
  *   cp .bashrc .inputrc .Xdefaults env_tinyos-1.x.sh ~/
  *   cp dot_emacs ~/.emacs
  * You are free to modify these if you know what you're doing, or
    just copy what is necessary.

- Set up Matlab
  *   cd /cygdrive/c/Installation\ Files/tinyos/tinyos-1.x_extra_files
      # same as above
  * mkdir ~/matlab
  * cp classpath.txt ~/matlab
  * cp windows_startup.m ~/matlab/startup.m
  * Since matlab is a remote installation you will have to mount the
    server hosting matlab:
    Example assuming you are using the EECS license install of Matlab 6.5:
    1) Go to "My Computer" and access the "Add or Remove Programs" option
       and select the Matlab6.5 install (this should be very quick, as
       very little software physically needs to be installed on your
       computer)
    2) In the "My Computer" Window, select "Tools->Map Network Drive" from
       the Menu Bar.  Select a drive, say Z:, and select the folder
       \\Winsww\sww\public (or you can browse for it under
       Microsoft Windows Network->Eecs->Winsww->sww->public).  Click
       "Finish" to map the drive.
    3) Check in cygwin that /cygdrive/z exists
          ls /cgdrive/z/matlab

- Set up for ucbRobo
  *   cd; mkdir ~/ucbRoboData;



--- Usage Instructions ---
General Tips for new Cygwin Users:
- When you log in to cygwin, your home directory is at
  /home/<username> which corresponds to 
  /cygdrive/c/tinyos/cygwin/home/<username>
- Use /cygdrive/c/ in replacement of c:/ to look at any files outside
  the c:/tinyos/cygwin directory
  ex. cd /cygdrive/c/tinyos/config
- Use the environment variables to help you quickly navigate around
  the directories.
  ex. cd $TOSROOT
      cd $UCBROBO
- It is recommended that you use cygwin-rxvt.bat to start up your
  cygwin because the RXVT terminal allows you to page up using
  <shift>-PgUp, among other features like better control over terminal
  look and feel.  Configuring RXVT requires editing the .Xdefaults
  file in your home directory (ex. if you want different screen dimensions).

Specific Tips to this Installation:
- Your default group is 'tos', a local group created for all tinyos
  users on this laptop.  This is to allow group permissions to work
  correctly.
- You must start matlab from ~/matlab by typing 'matlab &' at the cygwin prompt
  to get matlab to recognize your classpath.txt and startup.m files.
- Remember that since this is a shared environment, you will want to
  backup your files periodically.  Others may accidentally erase your
  files.