[[TOC(Hardware/CM/*, depth=2)]]

== Installing the CM3 ==
=== Connections to the CM3 ===
The CM3 card has a few external connections. The power connector (on board revision 4) uses a Tyco Electronics 2 pin surface mount header, the mating side to this header is [http://search.digikey.com/scripts/DkSearch/dksus.dll?Detail&name=A98602-ND here]. Using vampire clips connect the positive power cable to the standby voltage from the node power supply (PS), which is typically the purple cable, or pin 9 on the 20(+4) pin power power connector. The ground wire can be connected to any of the PS ground cables. 

There are two cables that should come out of the J6 header. The first cable is the 'power switch' cable (two wires) and should be plugged between the mother board (MB) power button pins (usually found on the 'front panel' header) and pins 1 & 2 on the J6 header. This cable replaces the need for a physical power switch. Similarly the 'reset switch' cable runs between pins 3 & 4 on the J6 header and the reset switch pins on the same 'front panel' header on the MB. 

The serial header is used to connect to the serial port on the mother board, the J4 header is another way of accessing the serial lines and uses a standard 2x5 100mil pin spacing. In the present configuration the serial cable should be a straight cable, and not a crossover (or null modem). If you wish to use a null model cable the resistors R17 and R18 must be populated, and R15 and R16 removed. The last connection that needs to be made is the power monitoring cable, which is the floppy power cable from the PS. This feeds the voltage that the CM will monitor to determine the state of the node. 

=== Turning the CM3 on ===

The Lantronix Xport AR does not refresh its IP address when an ethernet cable is plugged in to is it important the that MAC address of the device already be in DHCP with the appropriate address, and that the ethernet cable be already plugged in when the device is powered on. If it is not in DHCP and plugged in to the network it will default to some unknown IP address, and will not change until reset or power cycled. 

When the CM3 turns on the software will start sending UDP packets to the CMC and waiting for responses as well as monitoring the hardware status of the node. This will only happen after the Xport AR has gone through it's own boot sequence, which includes getting its IP address from the DHCP sever and booting into the custom code loaded with the CM3 image.

== Using the CM3 ==
The CM3 board, once properly plugged in and powered up will find an IP address and then load the custom software written automatically. Once the node has and IP and is powered up it should start communicating with the CMC right away. For details on the way the software works please refer to the [http://www.orbit-lab.org/wiki/Hardware/CM/cCM3/02-SoftwareDescription Software Description] or look at the code repository in the SVN. The UDP commands are described in more detail in the software description. 

=== UDP ===
UDP is the primary way to control the node, and is always running in the software. UDP is used to communicate between the CMC and the CM, each command from the CMC has a ACK (in software) to signify that the command was received and processed. UDP allows for the powering on, off, and reset of the node, as well as a reset command to the CM and enabling and disabling the update feature.

=== Command line interface (CLI) access ===

Base on telnet to port 8023 (also used for Lantronix access). You can find more about implemented commands with "?" e.g.:
{{{
telnet 10.1.224.1 8023
Trying 10.1.224.1...
Connected to cons1-1.outdoor.orbit-lab.org.
Escape character is '^]'.
>ena
(enable)#cm
(cm)#?
clrscrn                                 exit 
power off <hard | soft>                 power on 
reset cm                                reset node 
show cm                                 show history 
show node                               write 
}}}

==== Command line commands ====

 || '''''Node related commands''''' ||
 || power on || Power the node on ||
 || power off hard || Power the node off ||
 || power off soft || Issue shutdown through the console interface || 
 || reset node || Reset the node || 
 || show node || Show operating condition of node ||
 || '''''CM related commands''''' ||
 || reset cm || Reset CM software||
 || show cm || Show MAC, IP, and software version of CM||
 || '''''CLI related commands''''' ||
 || show history || Display previous commands entered|| 
 || write || || 
 || clrscrn  || Clears the screen ||
 || exit || Exit the CM command line mode ||

{{{
(cm)#show cm
Code Version: 3.1.0
MAC address:  00:20:4a:94:e3:64
IP address:   10.1.224.1
}}}

{{{
(cm)#show node
Node state:         On
Registered:       TRUE
System Temperature: 22
12V Reading:        12.000
5V Reading:         4.992
3V Reading:         3.302
Node Type:          Outdoor node
Coordinates:        [0,1]
(cm)#
}}}

=== Serial to Telnet tunnel ===
 
Telnet to IP address of CM and you will get access to serial console of the node. The default serial settings for the serial-to-telnet tunnel are:
|| Baud || 115200 ||
|| Parity || None ||
|| Data Bits || 8 ||
|| Stop Bits|| 2 ||
|| Flow Control || None ||