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

HTTP commands

There are 5 commands that can be accessed through HTTP

/<command>
/HardOff	Hard power off command
/SoftOff	Soft power off command
/Reset	Resets the node
/PowerOn	Turns node on
/LantronixReset	resets lantronix device (CM)

These commands are entered after the cm address, i.e.

http://10.1.x.x/Reset

If the cm has not been accessed through http prior since the last reset, then it will ask for the administrative username and password.

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> <long | short>       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