MYNT-EYE-S-SDK/docs/src/sdk/source_install_ubuntu.rst

150 lines
3.9 KiB
ReStructuredText
Raw Normal View History

2019-03-14 05:48:41 +02:00
.. _sdk_source_install_ubuntu:
Ubuntu SDK Source Installation
==============================
.. only:: html
=============== =============== ===============
2019-03-18 09:36:40 +02:00
Ubuntu 14.04 Ubuntu 16.04 Ubuntu 18.04
2019-03-14 05:48:41 +02:00
=============== =============== ===============
|build_passing| |build_passing| |build_passing|
=============== =============== ===============
.. |build_passing| image:: https://img.shields.io/badge/build-passing-brightgreen.svg?style=flat
.. only:: latex
=============== =============== ===============
2019-03-18 09:36:40 +02:00
Ubuntu 14.04 Ubuntu 16.04 Ubuntu 18.04
2019-03-14 05:48:41 +02:00
=============== =============== ===============
✓ ✓ ✓
=============== =============== ===============
.. tip::
If you used any other Linux distributions without apt-get package manager, you need to install required packages manaully instead of using ``make init``.
============= =====================================================================
Linux How to install required packages
============= =====================================================================
Debian based sudo apt-get install build-essential cmake git libv4l-dev
Red Hat based sudo yum install make gcc gcc-c++ kernel-devel cmake git libv4l-devel
Arch Linux sudo pacman -S base-devel cmake git v4l-utils
============= =====================================================================
.. ::
`Installation of System Dependencies <https://github.com/LuaDist/Repository/wiki/Installation-of-System-Dependencies>`_
Getting Source Code
--------------------
.. code-block:: bash
sudo apt-get install git
git clone https://github.com/slightech/MYNT-EYE-S-SDK.git
Required Packages
------------------
.. code-block:: bash
cd <sdk>
make init
* `OpenCV <https://opencv.org/>`_
.. tip::
To build and install Opencv, Please refer to `Installation in Linux <https://docs.opencv.org/master/d7/d9f/tutorial_linux_install.html>`_ . Alternatively, refer to the command below:
.. code-block:: bash
[compiler] sudo apt-get install build-essential
[required] sudo apt-get install cmake git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
[optional] sudo apt-get install python-dev python-numpy libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libjasper-dev libdc1394-22-dev
$ git clone https://github.com/opencv/opencv.git
$ cd opencv/
$ git checkout tags/3.4.1
$ mkdir _build
$ cd _build/
$ cmake \
-DCMAKE_BUILD_TYPE=RELEASE \
-DCMAKE_INSTALL_PREFIX=/usr/local \
\
-DWITH_CUDA=OFF \
\
-DBUILD_DOCS=OFF \
-DBUILD_EXAMPLES=OFF \
-DBUILD_TESTS=OFF \
-DBUILD_PERF_TESTS=OFF \
..
$ make -j4
$ sudo make install
Building code
--------------
.. tip::
If opencv is installed in custom directory or if you want to specify a version, you should set the path before building:
.. code-block:: bash
# OpenCV_DIR is the directory where your OpenCVConfig.cmake exists
export OpenCV_DIR=~/opencv
Otherwise, CMake will prompt cannot find OpenCV. If you need sdk without OpenCV, please read :ref:`sdk_without_opencv` .
Build and install:
.. code-block:: bash
cd <sdk>
make install
Finally, sdk will install in ``/usr/local`` by default.
Building samples
----------------
.. code-block:: bash
cd <sdk>
make samples
Run samples:
.. code-block:: bash
./samples/_output/bin/api/camera_a
Tutorial samples, please read :ref:`data` and :ref:`ctrl` .
Building tools
---------------
.. code-block:: bash
cd <sdk>
make tools
Installation requirement:
.. code-block:: bash
cd <sdk>/tools/
sudo pip install -r requirements.txt
The usage of tools and scripts will be introduced later.
Conclusion
-----------
If your project will use SDK, you can refer to the settings in ``samples/CMakeLists.txt`` for CMake. Alternatively, import the head file and dynamic library in the installation directory.