Changes between Version 9 and Version 10 of GettingStartedGuide
- Timestamp:
- 10/18/17 14:12:51 (3 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
GettingStartedGuide
v9 v10 4 4 5 5 == Requirements == 6 Fawkes focuses on development for [http ://www.linux.org Linux-based systems] in general, and [http://www.fedoraproject.org Fedora Linux] and [http://www.centos.org CentOS]/[http://www.redhat.com Red Hat Enterprise Linux] in particular. Other distributions like [http://www.ubuntu.com Ubuntu] and [http://www.debian.org Debian] have been used successfully, but may require a little more work. The Fawkes Development team maintains many required packages within Fedora, and therefore coverage is best there. Fawkes can also be compiled and used on [http://www.freebsd.org FreeBSD], but some hardware plugins may not be available.6 Fawkes focuses on development for [https://www.linux.org Linux-based systems] in general, and [https://www.fedoraproject.org Fedora Linux] and [https://www.centos.org CentOS]/[https://www.redhat.com Red Hat Enterprise Linux] in particular. Other distributions like [https://www.ubuntu.com Ubuntu] and [https://www.debian.org Debian] have been used successfully, but may require a little more work. The Fawkes Development team maintains many required packages within Fedora, and therefore coverage is best there. Fawkes can also be compiled and used on [https://www.freebsd.org FreeBSD], but some hardware plugins may not be available. 7 7 8 8 Fawkes needs a few other software libraries that have to be installed on the development system. It is our declared goal to minimize this set of libraries, but libraries allow for extending Fawkes' functionality without reinventing the wheel and lowering the amount of code to write, verify, and maintain. We do not package any 3rd party libraries in the Fawkes source tree, but rely on the target system to provide those libraries. This way the source tree remains sleek and we exploit the working force of the fine people packaging software for their favorite operating system. … … 16 16 This method is currently supported on Fedora. Fawkes has been accepted as a Fedora package and can be installed either via the graphical package install utility or via yum on the command line. Install the {{{fawkes}}} package to get a useful base system. To do this on the command line execute ''as root'': 17 17 {{{ 18 yuminstall fawkes18 dnf install fawkes 19 19 }}} 20 20 ''Note'': If you plan to compile Fawkes from source, this method can be used to get the largest set of dependencies available on Fawkes by installing the {{{fawkes-devenv}}} package instead of {{{fawkes}}}. As its dependencies this package will pull in everything required and recommended to build Fawkes. … … 25 25 You can also go to the [http://www.fawkesrobotics.org/download/ download page] and get the latest release tarball. Afterwards unpack it with the following command, adapting the version number as necessary. 26 26 {{{ 27 tar xfj fawkes- 0.4.1.tar.gz27 tar xfj fawkes-1.0.1.tar.gz 28 28 }}} 29 29 Continue below at [#CompilingFawkes Compiling Fawkes]. … … 41 41 Make sure you have installed at least the minimum requirements, better even the recommended dependencies or as much as possible listed at FawkesDependencies. On Fedora read in the section [#System-widebinaryinstallation system-wide binary installation] about the fawkes-devenv package to achieve this easily, without having a full binary installation otherwise. We additionally recommend using [http://ccache.samba.org/ ccache], a tool that will create an object cache and which can tremendously speedup consecutive compilation runs during development. 42 42 43 Afterwards go to your Fawkes source directory, named either fawkes- 0.4.1 (for tarball installation, version may differ, of course) or fawkes (for git checkout). Then execute the following make command:43 Afterwards go to your Fawkes source directory, named either fawkes-1.0.1 (for tarball installation, version may differ, of course) or fawkes (for git checkout). Then execute the following make command: 44 44 {{{ 45 make -j 2clean all gui45 make -j`nproc` clean all gui 46 46 }}} 47 This will build everything that can be built. The {{{-j 2}}} parameter assumes that you have a dual core machine and will cause parallel compilation with two job clients. On a single-core machine omit this option. If you have more cores increase this accordingly.47 This will build everything that can be built. The {{{-j`nproc`}}} parameter runs a parallel compilation that uses all your available cores, {{{nproc}}} gives you the number of cores. If you're on a dual-core machine, this is equivalent to {{{-j2}}}. 48 48 49 49 The Fawkes build system distinguishes building the base system and console tools (the {{{all}}} target) and GUI applications (the {{{gui}}} target). This is done for efficiency, especially when working on the robot. The {{{clean}}} target will ensure that the source tree is clean. It is not strictly required on the first run, but if you repeat this step, e.g. after installing more dependencies, this comes handy.