Installation » History » Version 5
Rafael Bailon-Ruiz, 2020-10-06 14:51
1 | 1 | Rafael Bailon-Ruiz | h1. Installation |
---|---|---|---|
2 | |||
3 | 4 | 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 proceed with 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 | 5 | 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. On the contrary, access to the graphical user interface is possible from any device running a modern web browser. |
6 | 1 | Rafael Bailon-Ruiz | |
7 | 5 | Rafael Bailon-Ruiz | {{toc}} |
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/. |