[[TOC(Hardware/cCM/cCM3/*, depth=3)]] ==== 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 commands are no longer being used as over firmware version 4.0 ===== HTTP commands ===== These are the commands that can be accessed through HTTP. They all return XML pages with the success or failure of the command || / || || || /HardOff || Hard power off command || || /SoftOff || Soft power off command || || /Reset || Resets the node || || /PowerOn || Turns node on || || /LantronixReset || Resets lantronix device (CM) || || /Status || Returns the power state of the node|| These commands are entered after the cm address, i.e. {{{ http://10.1.x.x/Reset }}} Format for the XML return pages is as follows. ====== Success ====== <> OK > e.g. {{{ OK }}} ====== Failure ====== e.g. {{{ Reset }}} ====== Status ====== on/off ===== 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 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 || ===== Custom Phone control firmware ===== There is a slightly altered version of the standard firmware designed for controlling a phone though the 3 most common buttons: power, up, and down. All the existing commands from the standard firmware still exist, so depending on the physical connections enacting the 'reset node' command may activate the 'down button' command because they access the same control pins. For this reason, for this firmware it is encuraged to only use the button 1/2/3 commands and nothing else. ====== HTTP commands ====== || Http address || function description || || /1l || 5 second 'button press on button 1 || || /2l || same as above for button 2 || || /3l || same as above for button 3 || || /1s || half second button press for button 1 || || /2s || same as above for button 2 || || /3s || same as above for button 3 || ====== UDP ====== no UDP support for this ====== CLI ====== {{{ Trying 10.1.224.61... Connected to 10.1.224.61. Escape character is '^]'. >enable (enable)#phone (phone)#? button <1 | 2 | 3> clrscrn exit show history write }}} you must enter the command as such {{{ button 1 short }}} ====== Connections ====== Right now the connections are as such || button || connection || || 1 || Power || || 2 || up || || 3 || down || ==== Manually Entering an IP ==== The current CM3 firmware is configured to use DHCP to find it's appropriate IP address. In instances where DHCP is not available a manual IP address can be entered using the following steps 1: Find the current device IP and enter that address into a web browser. The CM3 will default to some IP if not DHCP offers are given, check log files for this address 2: Go to the "Network" page using the link on the side bar 3: Go into the "Configuration" 4: Disable the DHCP client 5: Enter desired IP address [[Image(manualIP.png)]]