ICC LINUX OPERATIONS

 

BE CAREFUL – YOU HAVE ROOT ACCESS TO THE SYSTEM!

 

LOGGING IN

 

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 2.6.16.55 on an i586

bombadil login:

 

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 18:49:57 on ttyS0

shutdown: cannot find pid of running shutdown.

bombadil:~#

 

    or, if the ICC has just booted up and sent iridium messages:

 

The system is going down on Fri Sep  5 19:03:17 2008

Last login: Fri Sep  5 18:57:29 on ttyS0

bombadil:~#

 

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.

 

Minicom notes:

- 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).