| | 2 | The Barrett-supplied WAM PC can be used for controlling the WAM and writing software. This computer contains a PCI CANbus card for communicating directly with the motor controllers of the WAM. The WAM PC runs Ubuntu 12.04 modified with the Xenomai realtime kernel patches. You will need to connect a monitor, keyboard, and mouse if you want to log into the WAM PC directly. Otherwise, you can use the WAM PC "headless" (without a monitor) by logging into it over an Ethernet network. |
| | 3 | |
| | 4 | == Ethernet / DHCP == |
| | 5 | Setting up an Ethernet connection on the WAM PC is only necessary if you want to: |
| | 6 | * Access the Internet from the WAM PC (recommended) |
| | 7 | * Log into the WAM PC remotely using ssh (optional) |
| | 8 | * Use your own workstation for development and run the WAM PC "headless" |
| | 9 | |
| | 10 | The WAM PC is configured to obtain its IP address from a DHCP server on your wired Ethernet network. Please make sure your DHCP server is configured to assign an IP address to the WAM PC. You should use a Cat5e Ethernet cable to connect the Ethernet port on the back of the WAM PC to an Ethernet switch on your network. Please note that unless you have a DHCP server running on your workstation (this is rare), you can not connect the WAM PC directly to your workstation. |
| | 11 | |
| | 12 | When using the external WAM PC, you will not be using the supplied WiFi Access Point. Since you will be bypassing the WAM's internal PC, there is no need to connect an Ethernet cable to the ETHERNET port on the backplate of the WAM. |
| | 13 | |
| | 14 | == Discovering the WAM's IP address == |
| | 15 | When the WAM PC is turned on, it begins to boot up. After about 30 seconds, the WAM PC will request an IP address from a DHCP server. Once the WAM PC obtains an IP address, it launches a small UDP discovery application. If your workstation is connected to the same network as the WAM, then you can use the [http://web.barrett.com/support/WAM_Installer/wamdiscover.exe wamdiscover.exe] Windows application or the [http://web.barrett.com/support/WAM_Installer/wamdiscover.py wamdiscover.py] Python script to determine the IP address of the WAM PC. |
| | 16 | |
| | 17 | == Logging into the WAM PC == |
| | 18 | Once you know the WAM PC's address, you can connect to it using ssh. If you have a Windows workstation, we recommend using [http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe PuTTY SSH]. |
| | 19 | |
| | 20 | The default username is "robot". The default password is "WAM". |
| | 21 | |
| | 22 | == Navigating the WAM PC's directories (via ssh) == |
| | 23 | After logging into the WAM PC, you will find yourself in the /home/robot directory. If you type "ls" then hit <Enter>, you will see a listing of the files and folders in that directory. One of the directories should be called "libbarrett_examples". If you type "cd libbarrett_examples" then hit <Enter>, you will change to that directory. |
| | 24 | |
| | 25 | == Editing source code on the WAM PC == |
| | 26 | There are several options for editing source code on the WAM PC: |
| | 27 | * The easiest way is to use [http://www.eclipse.org Eclipse] directly on the WAM PC. |
| | 28 | * If you prefer to use your own workstation, you can install/use [http://www.eclipse.org Eclipse] or [http://www.jedit.org jEdit] (with its FTP plugin) or some other editor on your workstation that supports file access over sftp (ssh). |
| | 29 | * An alternative is to enable X11 forwarding in your ssh connection to the WAM PC. At the command line, include "-Y" in your ssh connection command: ssh -Y robot@<your-WAM-IP>. In PuTTY, this setting is called Connection:SSH:X11:Enable X11 Forwarding. Then you can ssh into the WAM PC and edit files on your workstation using commands like "gedit ex01_initialize_wam.cpp &", or any other graphical editor you want to install on the WAM PC. You can also launch the file browser by typing "nautilus &". For this method to work, you will need an X11 server running on your workstation. For Windows workstations, we recommend using [http://sourceforge.net/projects/xming/ Xming]. |
| | 30 | * If you prefer text-based code editor like vi or emacs, you can use those directly on the WAM PC from a terminal window or over ssh. |
