Donated by Intel

Basic access information -- you will need:
    - CoC account from CNS
    - Systems machine group access (ask your advisor to submit a request)
    - Membership to the "xpower" group and mailing list
    - An alternate home path + directory set up on /net/hp31
Contact CNS for help with these issues.

Send email to "fryman@cc.gatech.edu" if you have questions or problems with the remainder of these instructions.

Accessing the ADI Boards

• There are only 6 ADI units.
  
• Five of these are available for general use (adi2-6).
  
• One is available for power measurements (adi1).
  
• In order to have exclusive access to any of these units, please use the "xpower" mailing list as a reservation system. Please make announcements requesting reservations at least one business week day in advance. This is to allow sufficient time for others to respond to your request. Also note that all announcements about downtime, server maintenance, kernel or toolchain upgrades, etc, will be made through this same "xpower" mailing list.
  

1. The ADI BRH boards are named "adi[1-6].cc.gatech.edu". The following procedures apply to adi[2-6]. adi1 is on a different network, and general access procedures are still being developed.
2. The ADI boards are now accessed via a Cyclades remote management for serial consoles unit. This is a 16-port device, where the first 10 ports are used for other equipment. You will not have permissions to access the first 10 ports, so don't bother trying. The Cyclades device is named "cc-ts3000-sys-2.cc.gatech.edu".
   • cc-ts3000-sys-2: port 11 = (reserved for adi1)
   • cc-ts3000-sys-2: port 12 = adi2
   • cc-ts3000-sys-2: port 13 = adi3
   • cc-ts3000-sys-2: port 14 = adi4
   • cc-ts3000-sys-2: port 15 = adi5
   • cc-ts3000-sys-2: port 16 = adi6
3. As per the instructions above, make sure the adiN board you want to access isn't already reserved for exclusive access. If you will need exclusive access, put out a request for it.
4. Accessing the board:
   1. You will be using the "C-Kermit" (v8.0+) to access the system and transfer files... some documentation is available in /usr/local/public/share/kermit. But not much :(
   2. First, start kermit. If you don't have /usr/local/public/bin in your path, then you'll need to manually prefix the "kermit" binary with the path: /usr/local/public/bin/kermit
   3. NOTE: kermit is only installed for Solaris and Linux boxen! (If you want me to install it for other machines, let me know.)
   4. Within kermit, type the command set protocol xmodem
   5. Now, still within kermit, type the command ssh -l (your-userid):ttyS(adi-port-number) cc-ts3000-sys-2.cc.gatech.edu
   6. NOTE: You can not access the Cyclades device from outside the direct GT network - no outlan, no resnet!
   7. Login to the cyclades with your password
   8. Hit "Enter" a couple of times -- if the prompt is RedBoot> then follow the steps below to bring up the board.
   9. Since you've got a linux prompt, the adi board is already booted and running. If you need to load a custom kernel, see the procedure for bringing up the board, below.
   10. Exit , you're done. Do this by typing Ctrl and \ at the same time; then type C (captial C). Now at the kermit prompt, type quit.
   11. telnet to your adiM target. (ssh will be added soon.)
   12. Login as user "root". The password you need can be read in the file /net/hp31/adibrh/etc/login.info. This file is only readable to memebrs of the group "xpower".
   13. Your files will be in /net/hp31/your-user-name.
   14. WARNING -- You are not logged in as yourself! You may need to explicitly set permissions for "other" to read/execute your files. (eg, "chmod -R go+rX /net/hp31/your-user-name")
5. If you have problems, email me.

• If you are NOT bringing up a custom board, then at the RedBoot> prompt, enter the following commands:
  1. clockrate [400-733] (pick the MHz you want to run at, between 400-733 inclusive.)
  2. load a kernel image, with one of these commands:
     • load -r -b 0xc0500000 zImage.TS31    (to load the TimeSys v3.1 Linux kernel (2.4.7+patches))
     • load -r -b 0xc0500000 zImage.x1    (to load Linux-2.4.19-rmk4-ds2)
  3. (wait for it to finish)
  4. go 0xc0500000
  
  
• If you ARE bringing up a custom kernel, then:
  1. You need to know how to remote power-cycle the boards (see below).
  2. From your kermit or your telnet session, be sure to power down the board cleanly and force the NFS file system to flush itself.
  3. Run as root the command "shutdown -h now" ON THE ADI BOX, NOT YOUR WORKSTATION!.
  4. When completed, power cycle the board.
  5. Be sure to have the custom kernel you want to boot someplace handy (like your home directory).
  6. At the RedBoot> prompt, enter the following commands:
     1. clockrate [400-733] (pick the MHz you want to run at, between 400-733 inclusive.)
     2. load -r -m x -b 0xc0500000 zImage.bin
     3. You now must download via Kermit & XModem the kernel to boot. In Kermit, use Ctrl-\ and then cap-C to get the command prompt of kermit. Type "send (filename)". If you take too long, the ADI board will timeout and you'll have to re-enter the load command.
     4. When the download is complete (3-5 minutes), run the command...
     5. go 0xc0500000