GettingTheGCSRunningonAGumstixBoard

= Introduction =
Would it not be great to have your small UAS in your backpack, throw it in the air and monitor and even adjust the flight via a small device in your pocket? If you think this would be awesome, read on, since that is what this page is all about. It is the first attempt and will not be about iPad, Android Phones, Amazon Kindles or the likes as a ground station. For this we have other wiki pages. No, we will use a trusted solution; A Gumstix board with Linux on it connected to a small screen.
= Outcome =
The outcome of our efforts will be to:
#Have the Paparazzi GCS running on a small Gumstix computer board so we can monitoring and adjust the flight of our unmanned aircraft with just a small simple device.
#Have fully correct instructions on how to get it to work on this wiki page.
{TODO add screenshot of working setup}
= Hardware =
What do you need to get your groundstation up and running:
# A gumstix board with a power supply
# 8 GB or higher capacity micro SD card, the faster the better
# USB to mini-USB cable
# Regular UTP network cable
# A small, or big screen, preferably with touch such as the 4.3" LCD panel that comes with the Chestnut board kit or this fully integrated Gumstix board
# Micro-SD to USB adapter or card reader
# A computer that runs Linux OS
= Software =
We will install the following on the micro SD card
#Ubuntu OS for Gumstix
#Support libraries
#Paparazzi main software
==Conventions==
Note: You can just copy the line(s) in the box and paste them in your terminal.
But do not copy the $ or # sign at the beginning of a line. This symbol is just added on this page to show that the command is to be pasted at a terminal prompt as regular user($) or root user(#).
 $ this is an example of how a regular user command for your terminal looks
= Get the Operating System =
Pre-requisites
Have the micro SD card at hand and download this custom OS with everything already installed for a gumstix board and Chestnut43 with touchscreen.
{TODO: provide an image with everything already fully installed}
==Installation Steps==
===I'm in ahurry===
If you are eager to start and do not want to install everything thant download [this file] and follow the steps of how to copy it ont an microSD card
Unzip the downloaded OS via
 $ gunzip gcsStix.img.gz
Insert micro SD card in an SD reader and plug it in a USB port of your PC, then on the terminal type: 
 $ dmesg 
 
[170074.104194] sd 7:0:0:0: [sdb] Write Protect is off
[170074.104199] sd 7:0:0:0: [sdb] Mode Sense: 0b 00 00 08
[170074.104999] sd 7:0:0:0: [sdb] No Caching mode page present
[170074.105005] sd 7:0:0:0: [sdb] Assuming drive cache: write through
[170074.107904] sd 7:0:0:0: [sdb] No Caching mode page present
[170074.107911] sd 7:0:0:0: [sdb] Assuming drive cache: write through
[170074.109282] sdb: sdb1 sdb2
[170074.112159] sd 7:0:0:0: [sdb] No Caching mode page present
[170074.112165] sd 7:0:0:0: [sdb] Assuming drive cache: write through
[170074.112169] sd 7:0:0:0: [sdb] Attached SCSI removable disk
[170074.904553] kjournald starting. Commit interval 5 seconds
[170074.916813] EXT3-fs (sdb2): using internal journal
[170074.916823] EXT3-fs (sdb2): recovery complete
[170074.916826] EXT3-fs (sdb2): mounted filesystem with ordered data mode
Note: for my local machine the micro SD card was mounted on /dev/sdb as shown in the code above. Be aware of what you are doing at the next steps, as dd can completely overwrite your hard drive or other devices.
Where sdX is the SD reader device found with the command above, replace sdX with your specific device in the following commands and /path/to/file with the path to your previously downloaded Gumstix image file.
 $ SDCARD=/dev/sdX
 $ sudo dd if=/path/to/file/gcsStix.img of=$SDCARD bs=64k
This will take several minutes depending on your configuration and when this is done, safely remove the micro SD card from your computer by right clicking on it and select eject. Then, insert the micro SD card into the Gumstix micro SD slot.
== Connecting peripherals==
When you have a Linux version running on your Gumstix, you can add a LCD, or a mouse, or a keyboard. First, install CuteCom on your local machine running on a terminal:
To set up your LCD you must follow these steps:
#Connect LCD flex cable to Gumstix connector
#Attach USB-to-mini-USB cable to both your local machine and Gumstix board.
#Power up Gumstix board
#Install and start cutecom
 $ sudo apt-get install cutecom
 $ cutecom
A window will pop up and you must adjust the pull-down menu settings as follows:
Device will usually be either /dev/ttyUSB0 or /dev/ttyUSB1 . You can figure this out by typing on your command prompt:
 dmesg|tail
Note: This command lists the last connected devices.
Baud rate must be set to 115200, data bits to 8, stop bits to 1, parity to none, handshake none checked, open for both reading and writing checked, apply settings when opening checked, choose "CR,LF end line" and Char delay 1ms.
Click on Open device and your connection should start. If you encounter any problems, but you are sure you did everything right, check if your Gumstix board overheated or restart it.
Connect through CuteCom to the Gumstix, restart the board and hit a key within 5 seconds:
 Hit any key to stop autoboot: 5
Then type the following in the CuteCom command prompt:
 setenv defaultdisplay lcd43
Or, if you are using a 3.5" screen (such as the LCD panel with the Palo35):
 setenv defaultdisplay lcd35
You can save this setting for future boots by saving it:
 saveenv
Finally, continue with the boot process by typing in CuteCom command prompt:
 boot
==Connect to the Gumstix through the network==
If you want to send files to the Gumstix, you can do it via a ssh connection. In order to do this, both devices, your computer and the Gumstix must be connected to the same network. Once you've done this, you can start setting up the connection.
In order to do so you need to know the IP address of the Gumstix. 
The first thing you need in order to get rid of the USB to mini-USB cable and its physical limitations is to create a user and set a password for it and install openssh. 
Please feel free to replace "sergiu" with whatever username you choose, but keep in mind that you must replace it everywhere you encounter "sergiu".
 useradd -c "Sergiu S" -m -s "/bin/bash" -G sudo sergiu
Note: -G option will add the user to the specified group.
 $ passwd sergiu
You will be asked to enter a password and confirm it. Type your password, then hit CTRL + Enter key combination and then retype your password. If successful, you will get this message:
 passwd: password updated successfully
 $ sudo apt-get install openssh-server
Once you have accomplished this, you must discover the Gumstix ip address, typing on CuteCom:
 $ ifconfig -a 
Note: if you can't use this command for any reason you can get a list with all the IP addresses on the network using 'arp -a' on your machine.
Among the data returned, you will see something like this:
 
eth0 Link encap:Ethernet HWaddr 00:15:c9:28:c9:ff 
 inet addr:192.168.0.100 Bcast:192.168.0.255 Mask:255.255.255.0
 inet6 addr: fe80::215:c9ff:fe28:c9ff/64 Scope:Link
 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
 RX packets:3960 errors:0 dropped:0 overruns:0 frame:0
 TX packets:727 errors:0 dropped:0 overruns:0 carrier:0
 collisions:0 txqueuelen:1000 
 RX bytes:3734905 (3.7 MB) TX bytes:63765 (63.7 KB)
 Interrupt:80 
Now you should be able to connect using:
 $ ssh sergiu@192.168.0.100 {TODO USERNAME change}
You will be asked to type the password you previously set for the user.
==Working With Gumstix==
Note: You may get some errors during this installation. This depends on how well you are cooling down your system, how much RAM you have on your platform and so on. If you get errors when trying install a large number of packages/libraries at once, try to divide them into smaller groups.
1. Add a swap file
Due to lack of RAM memory it is possible to see errors like this:
 ==== ERROR [while installing ocamlfind.1.3.3] ====
 Internal error:
 # opam-version 1.0.1 (1.0.0-84-g9b3ff34)
 # os linux
 opam: "fork" failed: Cannot allocate memory
 'opam install ocamlfind' failed.
The solution to this problem is to create a swap file. For this case I created a 512 MB swap file, but you should adapt its size to the size of your SD card and the needed memory size.
Execute these commands to create and mount a swap file:
 sudo dd if=/dev/zero of=/swapfile1 bs=1024 count=524288 (will create 512 MB swap file)
 sudo mkswap /swapfile1
 sudo chown root:root /swapfile1
 sudo chmod 0600 /swapfile1
 sudo swapon /swapfile1
Note: this will remove the swap file each time you shutdown. If you need the file, you have to repeat the swapon command after each boot. An alternative would be to have it mounted every time you boot the system.
For more explanations you can go to this website
2. Autologin
Remove the login prompt
You may want to set your OS to auto-login. Why? Because there may be times you don't have a keyboard for the Gumstix around. You can find a good explanation of this here .
 $ sudo locale-gen en_US.UTF-8
 $ sudo apt-get install vim nano # (or use your favorite editor)
Note: if you get an error at this step, use the --fix-missing option as recommended.
 $ sudo vim /etc/lightdm/lightdm.conf
Edit the autologin-user line by replacing the username with your own
 autologin-user=sergiu
and add this line:
 autologin-user-timeout=0
or the right locale for your keyboard. If this didn't solve your problem, you may want to read here more about it.
3. More Memory
Remove the Lightdm GUI manager in order to free memory
 $ sudo apt-get remove lightdm
After this step you must reboot.
4. More speed
Remove processes not needed 
 $ sudo killall -9 NetworkManager #(for faster system), {TODO in start the config? still needed?}
Because the size of the original image was 4.3 GB, you have to execute the following set of instructions to resize the partition to 8 GB:
5. Add more space 
#Insert the micro SD card in your local machine´s card reader
#Use gparted to increase the size of the partition
 $ sudo apt-get install gparted
 $ sudo gparted
==Install the prerequsites==
Installing one package at a time is the best path to succes since it is likely during installation that you will be asked to re-run some of the commands with the "--fix-missing" option. 
 $ sudo apt-get install gtk2-engines-pixbuf
 $ sudo apt-get install make #already latest
 $ sudo apt-get install gcc #already latest
 $ sudo apt-get install g++ #already latest
 $ sudo apt-get install libgsl0-dev
 $ sudo apt-get install gnuplot
 $ sudo apt-get install libgnomecanvas2-dev
 $ sudo apt-get install bzip2
 $ sudo apt-get install git
 $ sudo apt-get install libusb-dev
 $ sudo apt-get install speech-dispatcher
 $ sudo apt-get install glade
 $ sudo apt-get install imagemagick 
 $ sudo apt-get install libpcre3-dev
 $ sudo apt-get install git-core
 $ sudo apt-get install python-usb
 $ sudo apt-get install python-lxml
 $ sudo apt-get install python-wxgtk2.8
 $ sudo apt-get install m4
 $ sudo apt-get install python-yaml 
 $ sudo apt-get install subversion
 $ sudo apt-get install libglade2-dev libgnomeui-dev libgnomecanvas2-dev librsvg2-dev libgtkspell-dev libcanberra-gtk-dev --fix-missing
 $ sudo apt-get install libsdl1.2-dev
Create a subdirectory where you will download and install all the libraries and other software tools needed. To keep your home dir tidy use a develop directory to store all the relevant downloads.
 $ mkdir ~/develop
 $ cd ~/develop/
==OCAML==
 $ wget http://caml.inria.fr/pub/distrib/ocaml-4.00/ocaml-4.00.1.tar.gz
 $ tar -xvzf ocaml-4.00.1.tar.gz 
 $ cd ocaml-4.00.1
 $ ./configure
 $ make world
 $ make opt
 $ make ocamldoc
 $ make ocamlbuild.native
 $ make ocamlbuild.byte
 $ sudo make install
 $ sudo make installopt
 $ ocaml -version #(make sure you have the right version, meaning 4.00.1)
 $ cd ~/develop
==Opam tool==
#Install the OCAML Opam tool
 $ git clone https://github.com/OCamlPro/opam.git
 $ cd opam
 $ ./configure 
 $ make (because of overheating you may get some errors, but keep doing 'make')
 $ sudo make install
 $ cd ~/develop
 $ mkdir ~/.opam
 $ opam init
 $ eval `opam config env`
Please select yes.
 $ sudo opam install ocamlfind
 $ sudo opam install lablgtk 
 $ sudo opam install pcre-ocaml
 $ sudo opam install ocamlnet
 $ sudo opam install xml-light
=portability-support=
#Get paparazzi-portability-support related files
 $ sudo apt-get install debhelper devscripts fakeroot build-essential autoconf automake autotools-dev dh-make xutils lintian pbuilder dh-ocaml tcl-dev libxt-dev libXt-devel
 $ cd ~/develop
 $ git clone https://github.com/paparazzi/paparazzi-portability-support.git
 $ cd paparazzi-portability-support/linux/
 $ sudo ./develenv.sh
 $ cd ivy/
 $ svn checkout http://svn.tls.cena.fr/svn/ivy/ivy-c/trunk ivy-c
 $ cd ivy-c/src/
Patchthe Makefile with :
Patch content:
 --- Makefile.orig	2013-05-23 16:36:45.000000000 +0000
 +++ Makefile	2013-05-23 16:32:22.000000000 +0000
 @@ -28,6 +28,11 @@
 	FPIC=
 endif
 
 +MACHINE = $(shell uname -m)
 +ifeq ("$(MACHINE)", "armv7l")
 +	FPIC = -fPIC
 +endif
 +
 
 ifndef PREFIX
 	export PREFIX=/usr/local
 $ make all
 $ sudo make install
== IVY ==
IVY is a simple protocol and a set of open-source libraries and programs that allows applications to broadcast information through text messages, with a subscription mechanism based on regular expressions. The project can be found at: http://www2.tls.cena.fr/products/ivy/ 
In the paparazzi project, Ivy is used to send telemetry data to where ever you want.
NOTE: Do not confuse this IVY with the Apache Ivy project. 
== Ivy-OCAML ==
The Ivy-ocaml is a Library that make it possible to use Ivy via the Ocaml language.
 $ cd ~/develop/paparazzi-portability-support/linux/ivy/
 $ svn checkout http://svn.tls.cena.fr/svn/ivy/ivy-ocaml/trunk ivy-ocaml
 $ cd ivy-ocaml/
 $ make
 $ sudo PATH=$PATH make install
=== Ivy-python ===
The ivy-python package makes it possible to use the IVY libraries from within the Python programming language. The ivy-python package is architecture independent, so it can be downloaded from the Ubuntu or Debian paparazzi repository. However since this is the from scratch page we will download it from the official source repository via 
 $ cd ~/develop/paparazzi-portability-support/linux/ivy/
 $ svn co http://svn.tls.cena.fr/svn/ivy/ivy-python/trunk ivy-python
 $ cd ivy-python/
 $ sudo python setup.py install
== Main sourcecode ==
Now all the prequisites are installed, finally we can grab a copy of the full Paparazzi project
 $ cd ~
 $ git clone https://github.com/paparazzi/paparazzi.git
 $ cd paparazzi
 $ export PPRZ_HOME=~/paparazzi/
 $ export PAPARAZZI_HOME=~/paparazzi/
 $ export PAPARAZZI_SRC=~/paparazzi/
 $ make ground_segment
Calibrate your touchsreen
 $ sudo apt-get install xinput_calibrate
 $ X &
 $ export DISPLAY=:0
 $ xinput_calibrate
You will have to touch the center of the four circles. When you will have touched all four points, you will get a similar message on your command prompt.
 --> Making the calibration permanent <--
 copy the snippet below into '/etc/X11/xorg.conf.d/99-calibration.conf'
 Section "InputClass"
 	Identifier	"calibration" 
	MatchProduct	"ADS7846 Touchscreen" 
	Option	"Calibration"	"147 3917 3783 251" 
 EndSection
Note: each time you reboot you will need to start X server. Now, because we already started it to calibrate the screen, you can skip the next two commands. Only this time!
Fine, now lets start the X server.
 $ X &
And make a display setting
 $ export DISPLAY=:0
Finally, it's time to party, let's run the Paparazzi center 
 $ cd ~/paparazzi
 $ ./paparazzi
Add this to the session
 $ sw/ground_segment/cockpit/gcs -b 192.168.1:2010
= Testing =
= Telemetry =
Hardware list:
#Laptop with paparazzi softaware
#Gumstix board
#XBee module
#USB power hub
#UAV with RC transceiver and xbee module
#internet connection 
Note: from the tests made, the xbee module won't be seen by the Gumstix board if it is not connected before you power up the system.
For this tests, it was used this drone:
{TODO provide pictures}
You can find here all the configuration files. Download them and copy them as it follows:
 $ cd ~/paparazzi/conf/system/udev/rules/
 $ sudo cp -av *rules /etc/udev/rules.d/
 $ mkdir conf/radios/sergiu
 $ cp conf/radios/sergiu ~Downloads/sergiu_mx22_pprz-ap.xml {TODO change the names with something more appropriate}
 $ git remote -v
 $ mkdir conf/airframes/sergiu
 $ cp conf/airframes/sergiu ~/Downloads/orange.xml {TODO change file name}
 $ cp conf/ ~/Downloads/conf.xml
 $ cp conf/airframes/sergiu/ ~/Downloads/orange.xml
 $ ./paparazzi
Download this tarball {TODO provide tarball} and extract it in /home/user/paparazzi/var/ . Inside you will find all the files needed to run paparazzi GCS with datalink.
{TODO provide files orange.xml,radio...xml, udev rules, config.xml; set datalink properly and
explain how to build, upload, execute + print screens}
= Add a joystick =
{TODO add calibration steps}
 $ cd ~/paparazzi/sw/ground_segment/joystick
 $ make clean
 $ make
In Paparazzi Center select Tool>>Joystick and make sure that the line looks like this:
 /home/sergiu/paparazzi/sw/ground_segment/joystick/input2ivy -ac orange2 extreme_3d_pro.xml 
where '/sergiu' must be replaced with your user, 'orange2' with the name of your A/C and 'extreme_3d_pro.xml' with the name of your joystick.
Edited ~/paparazzi/conf/conf.xml .
opened tools:
	server /home/sergiu/paparazzi/sw/ground_segment/tmtc/server 
	gcs /home/sergiu/paparazzi/sw/ground_segment/cockpit/gcs 
	data link /home/sergiu/paparazzi/sw/ground_segment/tmtc/link -udp 
	joystick /home/sergiu/paparazzi/sw/ground_segment/joystick/input2ivy -ac ardrone2_sdk extreme_3d_pro.xml 
	messages /home/sergiu/paparazzi/sw/ground_segment/tmtc/messages 
	real-time plotter /home/sergiu/paparazzi/sw/logalizer/plotter 
Notes: wireless connection in between the drone and laptop is required for data link.
= Testing =
{TODO: Describe here a first run with Paparazzi Sim}
=onboard video=
System identification
 $ cat /proc/bus/input/devices
output
 I: Bus=0019 Vendor=0000 Product=0006 Version=0000
 N: Name="Video Bus"
 P: Phys=LNXVIDEO/video/input0
 S: Sysfs=/devices/LNXSYSTM:00/LNXSYBUS:00/PNP0A08:00/LNXVIDEO:00/input/input4
 U: Uniq=
 H: Handlers=kbd event4 
 B: PROP=0
 B: EV=3
 B: KEY=3e000b 0 0 0 0 0 0 0
Install mplayer
 $ sudo apt-get install mplayer2
to make sure that the program is working properly type
 $ mplayer
and you are supposed to get a list of the options available.
Get image using mplayer, Terratec Grabby digitizer, 2.4GHz receiver, and a camera with 2.4 GHz transmitter:
 $ dmesg
and look if your digitizer is registered as /dev/video0 which is the default or otherwise and replace bellow
 $ mplayer tv:// -tv driver=v4l2:width=320:height=240:norm=NTSC:input=0:device=/dev/video0:noaudio
where
 inputs: 0 = Composite1; 1 = S-Video;
If 0 doesn't work for you, try with value 1.
{TODO: video receiver connect description }
{TODO: video digitizer a description }
= Links =
Links to related information
* OMAP
* https://www.gumstix.com/
* Dev/Caspa
* https://github.com/paparazzi/paparazzi-portability-support