ICC LINUX OPERATIONS
BE CAREFUL YOU HAVE ROOT ACCESS TO THE SYSTEM!
1 - Connect to the console port, run Hyperterm (9600 N81), and hit ENTER to get the prompt (and all entries or commands are terminated with the ENTER key):
Red Hat Linux release 9 (Shrike)
Kernel 220.127.116.11 on an i586
2 At the login: prompt, type root
3 At the Password: prompt, type the password
4 you should get a response something like this:
Last login: Fri Sep 5 on ttyS0
shutdown: cannot find pid of running shutdown.
or, if the ICC has just booted up and sent iridium messages:
The system is going down on Fri Sep 5 2008
Last login: Fri Sep 5 on ttyS0
5 ignore the system going down message, as logging in just aborted the shutdown anyway.
A QUICK COURSE IN LINUX COMMAND LINE OPS
1 at the prompt (bombadil:~#), you may issue various commands, like ls to get a directory, or cd iridium to change to the iridium directory (from the root directory). Most of the code for iridium ops resides in /root/iridium/uwu/ or /root/iridium/met/ -
the only files you might want to look at here are acm_messages, sim_messages, or met_messages these show the various messages issued by the programs that get the data, manipulate it as needed, and handle the iridium modem.
2 at any prompt, cd will return you to the /root directory.
3 at any prompt, pwd will tell you what directory you are in.
4 at login, you will be in the /root directory already. To go to the uwu directory, type cd iridium/uwu/ at the prompt.
5 the redundant copies of the iridium messages (converted to ASCII) are on the USB Flash drive at /mnt/usb/met/ or /mnt/usb/uwu/. To see a directory listing of the files, type ls /mnt/usb/met/, for example. For a long directory listing (owner, permissions, date, time info), ls -l /mnt/usb/uwu/, for example.
6 to copy files from the iridium directories to the USB drive, cp -p filename /mnt/usb/ will copy the file including time/date stamp.
7 to remove the USB drive, unmount it with the umount /mnt/usb/ command, then disconnect it. Or wait until you shutdown and power down the ICC.
8 to re-install the USB drive, connect it again, then mount it with:
mount -t vfat /dev/sdb1 /mnt/usb/. Or connect it while the ICC is powered down; it will be mounted by the system as usual on bootup.
SWITCHING FROM MET TO UWU OPS or UWU TO MET OPS
***** BE CAREFUL!! *****
1 ICC operations on bootup are controlled by symbolic links in the /etc/rc.d/rc3.d/ directory. If the ICC has not been configured for either MET or UWU use, there will be 2 disabled links in the directory, xx99iridium-met and xx99iridium-uwu.
2 to enable particular ops on bootup, move (rename) the xx99iridium-??? link to S99iridium-???, as follows:
-- to enable MET ops, mv xx99iridium-met S99iridium-met
-- to enable UWU ops, mv xx99iridium-uwu S99iridium-uwu
3 don't enable both at the same time; one should always be disabled by changing the leading S to xx.
SHUTTING DOWN THE SYSTEM (preferred method)
1 at the prompt, shutdown -h now will start a shutdown. You'll see a bunch of messages, ending with System halted - it's OK to powerdown now.
COMMUNICATING WITH MET OR UWU SUBSYSTEMS
You can use minicom to talk to the LOGGER in a MET system, or the SIMIF and ACMIF (interfaces) in an UWU system. Standard Linux com ports are labeled ttyS0 thru ttyS15; on the ICC system, ttyS0 is reserved for the console port (that's where you logged in). Port ttyS1 is not used currently. The 4-port serial expansion board is used for all comms to outside devices; ttyS4 thru ttyS7 are assigned to this board. These ports are used as follows:
ttyS4 -> LOGGER on the MET system, or SIMIF on the UWU system
ttyS5 -> Iridium Modem
ttyS6 -> ACMIF on the UWU system
ttyS7 -> not used
Example 1 talk to the LOGGER (or the SIMIF):
at the prompt, minicom ttyS4 will start the comms program on the ttyS4 port at 9600 baud N81.
Example 2 talk to the ACMIF:
at the prompt, minicom ttyS6 will start the comms program on the ttyS6 port at 9600 baud N81.
- CTRL-A Z will bring up a help screen, CTRL-A X will exit minicom.
- if you use CTRL-A L to capture to a file, use a full path to the file; for example:
/mnt/usb/uwu/capturefile.txt to put the capture file on the USB drive.
- note that the baud rate shown is 2400; the actual baud rate is 4 times the displayed baud rate (a feature of the 4-port serial board setup).