Project

General

Profile

Installation » History » Version 3

Rafael Bailon-Ruiz, 2020-08-28 17:40

1 1 Rafael Bailon-Ruiz
h1. Installation
2
3 3 Rafael Bailon-Ruiz
This is a quick tutorial on how to install CAMS on your computer. Instructions are different depending on your needs: If a you are a regular user %{background:yellow}Who is a regular user?%, follow the [[Installation#Regular user installation process|Regular user installation process]]; and if you are a developer, follow the [[Installation#Developer installation process|Developer installation process]].
4 1 Rafael Bailon-Ruiz
5 2 Rafael Bailon-Ruiz
In any case, CAMS server requires a PC running a recent GNU/Linux operating system, preferably Ubuntu 18.04 or 20.04. Windows and MacOS are not supported. 
6 1 Rafael Bailon-Ruiz
7 2 Rafael Bailon-Ruiz
On the contrary, access to the graphical user interface is possible from any device running a modern web browser.
8 1 Rafael Bailon-Ruiz
9
h2. Regular user installation process
10
11 2 Rafael Bailon-Ruiz
This guide assumes you are using Ubuntu 18.04. If you are using another operating system make sure that Python 3.5 or later is installed.
12 1 Rafael Bailon-Ruiz
13
h3. Paparazzi framework
14
15 2 Rafael Bailon-Ruiz
First, install the Paparazzi framework using the "one-liner installation process":https://wiki.paparazziuav.org/wiki/Installation#Quickstart_for_Ubuntu_users. If you are not an Ubuntu user follow the "OS specific instructions":https://wiki.paparazziuav.org/wiki/Installation#OS_Specific_Instructions.
16 1 Rafael Bailon-Ruiz
17 2 Rafael Bailon-Ruiz
Add the environment variables PAPARAZZI_HOME and PAPARAZZI_SRC to your command line interpreter. The code below should work for most users **if you used the one-liner installation**:
18 1 Rafael Bailon-Ruiz
19
<pre><code class="shell">
20
echo "export PAPARAZZI_HOME=~/paparazzi" >> ~/.bashrc
21
echo "export PAPARAZZI_SRC=~/paparazzi" >> ~/.bashrc
22
</code></pre>
23
24 2 Rafael Bailon-Ruiz
Otherwise, you can find more information "here":https://wiki.paparazziuav.org/wiki/Installation#Environment_Variables.
25 1 Rafael Bailon-Ruiz
26 2 Rafael Bailon-Ruiz
h3. CAMS
27 1 Rafael Bailon-Ruiz
28 2 Rafael Bailon-Ruiz
Make sure that curl is installed:
29
<pre><code class="shell">
30
apt-get install curl
31
</code></pre>
32
33 1 Rafael Bailon-Ruiz
Make sure that redis is installed:
34
<pre><code class="shell">
35
apt-get install redis-server
36
</code></pre>
37
38
Make sure that curl is installed:
39
<pre><code class="shell">
40
apt-get install curl
41
</code></pre>
42
43
Install pip3 and update it:
44
<pre><code class="shell">
45
apt-get install python3-pip
46
pip3 install --user --upgrade pip
47
</code></pre>
48
49
If you want to update it for all users:
50
<pre><code class="shell">
51
pip3 install --upgrade pip
52
</code></pre>
53
54 2 Rafael Bailon-Ruiz
For now the easiest way to install CAMS is to clone the "git repository of the graphical user interface":https://redmine.laas.fr/projects/nephelae-devel/repository/nephelae_gui and run its installation script.
55 1 Rafael Bailon-Ruiz
56
<pre><code class="shell">
57
git clone ssh://git@redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_gui.git nephelae_gui
58
cd nephelae_gui
59
make install pip_options=--user
60
</code></pre>
61
62
To check the installation, launch the server:
63
64
<pre><code class="shell">
65
make demo
66
</code></pre>
67
68
This will (hopefully) start the replay of a UAV flight.
69
70 2 Rafael Bailon-Ruiz
You should now be able connect to the graphical user interface with your web browser on "http://0.0.0.0:8000/":http://0.0.0.0:8000/.
71 1 Rafael Bailon-Ruiz
72 2 Rafael Bailon-Ruiz
h2. Developer installation process
73 1 Rafael Bailon-Ruiz
74 2 Rafael Bailon-Ruiz
h3. System requirements
75
76
The main programming language is **Python 3.5**. "Official support for Python 2.7 ending by the beginning of 2020":https://pythonclock.org/, no development efforts were made to support Python 2.7.
77
78
Most of development and testing where made on "Ubuntu 16.04 LTS Xenial Xerus":http://releases.ubuntu.com/16.04/ on which Python 3.5 is the default Python version.
79
80
All server side applications should work on a Unix-based system provided it supports Python 3.5 or later. Compatibility with Microsoft Windows has not been tested.
81
82
The client side application is web-based and should work on a modern web browser. (Only tested with Mozilla Firefox and Safari).
83
84 1 Rafael Bailon-Ruiz
h3. Paparazzi framework
85
86
Make sure that curl is installed:
87
<pre><code class="shell">
88
apt-get install curl
89
</code></pre>
90
91
h4. System dependencies (for Ubuntu 16.04)
92
93
<pre><code class="shell">
94
add-apt-repository ppa:team-gcc-arm-embedded/ppa
95
apt-get update
96
apt-get install gcc-arm-linux-gnueabi gcc-arm-none-eabi
97
</code></pre>
98
99
<pre><code class="shell">
100
add-apt-repository ppa:paparazzi-uav/ppa
101
apt-get update
102
apt-get install paparazzi-dev paparazzi-jsbsim
103
</code></pre>
104
105
h4. System dependencies (for Ubuntu 18.04)
106
107
<pre><code class="shell">
108
apt-get install gcc-arm-none-eabi
109
</code></pre>
110
111
<pre><code class="shell">
112
add-apt-repository ppa:paparazzi-uav/ppa
113
apt-get update
114
apt-get install paparazzi-dev paparazzi-jsbsim
115
</code></pre>
116
117
h4. Repository
118
<pre><code class="shell">
119
git clone -b laas_master https://github.com/pnarvor/paparazzi.git paparazzi
120
cd paparazzi
121
make
122
</code></pre>
123
124 2 Rafael Bailon-Ruiz
LAAS-Nephelae software needs the environment variables PAPARAZZI_HOME and PAPARAZZI_SRC to be set to the root paparazzi folder (where you cloned it). Add these lines to your .bashrc, replacing "paparazzi_path" to where you cloned paparazzi repository.
125 1 Rafael Bailon-Ruiz
126
<pre><code class="shell">
127
export PAPARAZZI_HOME="paparazzi_path"
128
export PAPARAZZI_SRC="paparazzi_path"
129
</code></pre>
130
131 2 Rafael Bailon-Ruiz
Once Paparazzi installed, launch ./paparazzi. In the paparazzi center, build every aircraft you need to use by selecting an item in the _A/C_ menu and then clicking on the _build_ button.
132 1 Rafael Bailon-Ruiz
133 2 Rafael Bailon-Ruiz
h3. CAMS
134 1 Rafael Bailon-Ruiz
135
Install pip3 and update it:
136
<pre><code class="shell">
137
apt-get install python3-pip
138
pip3 install --user --upgrade pip
139
</code></pre>
140
141
If you want to update it for all users:
142
<pre><code class="shell">
143
pip3 install --upgrade pip
144
</code></pre>
145
146
Clone and install the 3 core packages (in developer mode with the -e pip3 option):
147
148
"nephelae_base":https://redmine.laas.fr/projects/nephelae-devel/repository/nephelae_base.
149
<pre><code class="shell">
150
git clone git://redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_base.git nephelae_base
151
cd nephelae_base
152
pip3 install --user -e .
153
</code></pre>
154
155
"nephelae_mesonh":https://redmine.laas.fr/projects/nephelae-devel/repository/nephelae_mesonh.
156
<pre><code class="shell">
157
git clone git://redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_mesonh.git nephelae_mesonh
158
cd nephelae_mesonh
159
pip3 install --user -e .
160
</code></pre>
161
162
"nephelae_paparazzi":https://redmine.laas.fr/projects/nephelae-devel/repository/nephelae_paparazzi.
163
<pre><code class="shell">
164
git clone git://redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_paparazzi.git nephelae_paparazzi
165
cd nephelae_paparazzi
166
pip3 install --user -e .
167
</code></pre>
168
169
Make sure that redis is installed:
170
<pre><code class="shell">
171
apt-get install redis-server
172
</code></pre>
173
174
Clone and install the "nephelae_gui":https://redmine.laas.fr/projects/nephelae-devel/repository/nephelae_gui package in developer mode:
175
<pre><code class="shell">
176
git clone git://redmine.laas.fr/laas/users/simon/nephelae/nephelae-devel/nephelae_gui.git nephelae_gui
177
cd nephelae_gui
178
make install pip_options=--user install_mode=dev
179
</code></pre>
180
181
To check the installation, launch the server:
182
183
<pre><code class="shell">
184
make demo
185
</code></pre>
186
187
This will (hopefully) start the replay of a UAV flight.
188
189 2 Rafael Bailon-Ruiz
You should now be able connect to the graphical user interface with your web browser on "http://0.0.0.0:8000/":http://0.0.0.0:8000/.