This repository has been archived by the owner on Nov 17, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 6.8k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Moving Raspberry Pi and TX2 setup to common install page (#6393)
- Loading branch information
1 parent
e1b7556
commit 2b638ff
Showing
4 changed files
with
168 additions
and
158 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,77 +1,8 @@ | ||
| # Installing MXNet on Raspbian | ||
| MXNet supports the Debian based Raspbian ARM based operating system so you can run MXNet on Raspberry Pi Devices. | ||
|
|
||
| These instructions will walk through how to build MXNet for the Raspberry Pi and install the Python bindings for the library. | ||
|
|
||
| The complete MXNet library and its requirements can take almost 200MB of RAM, and loading large models with the library can take over 1GB of RAM. Because of this, we recommend running MXNet on the Raspberry Pi 3 or an equivalent device that has more than 1 GB of RAM and a Secure Digital (SD) card that has at least 4 GB of free memory. | ||
|
|
||
| ## Installing MXNet | ||
|
|
||
| Installing MXNet is a two-step process: | ||
|
|
||
| 1. Build the shared library from the MXNet C++ source code. | ||
| 2. Install the supported language-specific packages for MXNet. | ||
|
|
||
| ### Build the Shared Library | ||
|
|
||
| On Raspbian versions Wheezy and later, you need the following dependencies: | ||
|
|
||
| - Git (to pull code from GitHub) | ||
|
|
||
| - libblas (for linear algebraic operations) | ||
|
|
||
| - libopencv (for computer vision operations. This is optional if you want to save RAM and Disk Space) | ||
|
|
||
| - A C++ compiler that supports C++ 11. The C++ compiler compiles and builds MXNet source code. Supported compilers include the following: | ||
|
|
||
| - [G++ (4.8 or later)](https://gcc.gnu.org/gcc-4.8/) | ||
|
|
||
| Install these dependencies using the following commands in any directory: | ||
|
|
||
| ```bash | ||
| sudo apt-get update | ||
| sudo apt-get -y install git cmake build-essential g++-4.8 c++-4.8 liblapack* libblas* libopencv* | ||
| ``` | ||
|
|
||
| Clone the MXNet source code repository using the following ```git``` command in your home directory: | ||
| ```bash | ||
| git clone https://github.com/dmlc/mxnet.git --recursive | ||
| cd mxnet | ||
| ``` | ||
|
|
||
| If you aren't processing images with MXNet on the Raspberry Pi, you can minimize the size of the compiled library by building MXNet without the Open Source Computer Vision (OpenCV) library with the following commands: | ||
| ```bash | ||
| export USE_OPENCV = 0 | ||
| make | ||
| ``` | ||
|
|
||
| Otherwise, you can build the complete MXNet library with the following command: | ||
| ```bash | ||
| make | ||
| ``` | ||
|
|
||
| Executing either of these commands start the build process, which can take up to a couple hours, and creates a file called ```libmxnet.so``` in the mxnet/lib directory. | ||
|
|
||
| If you are getting build errors in which the compiler is being killed, it is likely that the compiler is running out of memory (espeically if you are on Raspberry Pi 1, 2 or Zero, which have less than 1GB of RAM), this can often be rectified by increasing the swapfile size on the Pi by editing the file /etc/dphys-swapfile and changing the line CONF_SWAPSIZE=100 to CONF_SWAPSIZE=1024, then running: | ||
| ```bash | ||
| sudo /etc/init.d/dphys-swapfile stop | ||
| sudo /etc/init.d/dphys-swapfile start | ||
| free -m # to verify the swapfile size has been increased | ||
| ``` | ||
|
|
||
| ## Install MXNet Python Bindings | ||
|
|
||
| To install python bindings run the following commands in the MXNet directory: | ||
|
|
||
| ```bash | ||
| cd python | ||
| sudo python setup.py install | ||
| ``` | ||
|
|
||
| You are now ready to run MXNet on your Raspberry Pi device. | ||
|
|
||
| *Note - Because the complete MXNet library takes up a significant amount of the Raspberry Pi's limited RAM, when loading training data or large models into memory, you might have to turn off the GUI and terminate running processes to free RAM.* | ||
|
|
||
| ## Next Steps | ||
|
|
||
| * [Tutorials](http://mxnet.io/tutorials/index.html#embedded) | ||
| <!-- This page should be deleted after sometime (Allowing search engines | ||
| to update links) --> | ||
| <meta http-equiv="refresh" content="3; url=http://mxnet.io/get_started/install.html" /> | ||
| <!-- Just in case redirection does not work --> | ||
| <p> | ||
| <a href="http://mxnet.io/get_started/install.html"> | ||
| This content is moved to a new MXNet install page. Redirecting... </a> | ||
| </p> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,76 +1,8 @@ | ||
| # Installing MXNet on The NVIDIA Jetson TX2 | ||
| MXNet supports the Ubuntu Arch64 based operating system so you can run MXNet on NVIDIA Jetson Devices. | ||
|
|
||
| These instructions will walk through how to build MXNet for the Pascal based [NVIDIA Jetson TX2](http://www.nvidia.com/object/embedded-systems-dev-kits-modules.html) and install the corresponding python language bindings. | ||
|
|
||
| For the purposes of this install guide we will assume that CUDA is already installed on your Jetson device. | ||
|
|
||
| ## Installing MXNet | ||
|
|
||
| Installing MXNet is a two-step process: | ||
|
|
||
| 1. Build the shared library from the MXNet C++ source code. | ||
| 2. Install the supported language-specific packages for MXNet. | ||
|
|
||
| ### Build the Shared Library | ||
|
|
||
| You need the following additional dependencies: | ||
|
|
||
| - Git (to pull code from GitHub) | ||
|
|
||
| - libatlas (for linear algebraic operations) | ||
|
|
||
| - libopencv (for computer vision operations) | ||
|
|
||
| - python pip (to load relevant python packages for our language bindings) | ||
|
|
||
| Install these dependencies using the following commands in any directory: | ||
|
|
||
| ```bash | ||
| sudo apt-get update | ||
| sudo apt-get -y install git build-essential libatlas-base-dev libopencv-dev graphviz python-pip | ||
| sudo pip install pip --upgrade | ||
| sudo pip install setuptools numpy --upgrade | ||
| sudo pip install graphviz jupyter | ||
| ``` | ||
|
|
||
| Clone the MXNet source code repository using the following ```git``` command in your home directory: | ||
| ```bash | ||
| git clone https://github.com/dmlc/mxnet.git --recursive | ||
| cd mxnet | ||
| ``` | ||
|
|
||
| Edit the Makefile to install the MXNet with CUDA bindings to leverage the GPU on the Jetson: | ||
| ```bash | ||
| cp make/config.mk . | ||
| echo "USE_CUDA=1" >> config.mk | ||
| echo "USE_CUDA_PATH=/usr/local/cuda" >> config.mk | ||
| echo "USE_CUDNN=1" >> config.mk | ||
| ``` | ||
|
|
||
| Edit the Mshadow Makefile to ensure MXNet builds with Pascal's hardware level low precision acceleration by editing mshadow/make/mshadow.mk and adding the following after line 122: | ||
| ```bash | ||
| MSHADOW_CFLAGS += -DMSHADOW_USE_PASCAL=1 | ||
| ``` | ||
|
|
||
| Now you can build the complete MXNet library with the following command: | ||
| ```bash | ||
| make -j $(nproc) | ||
| ``` | ||
|
|
||
| Executing this command creates a file called ```libmxnet.so``` in the mxnet/lib directory. | ||
|
|
||
| ## Install MXNet Python Bindings | ||
|
|
||
| To install python bindings run the following commands in the MXNet directory: | ||
|
|
||
| ```bash | ||
| cd python | ||
| sudo python setup.py install | ||
| cd .. | ||
| export MXNET_HOME=$(pwd) | ||
| echo "export PYTHONPATH=$MXNET_HOME/python:$PYTHONPATH" >> ~/.bashrc | ||
| source ~/.bashrc | ||
| ``` | ||
|
|
||
| You are now ready to run MXNet on your NVIDIA Jetson TX2 device. | ||
| <!-- This page should be deleted after sometime (Allowing search engines | ||
| to update links) --> | ||
| <meta http-equiv="refresh" content="3; url=http://mxnet.io/get_started/install.html" /> | ||
| <!-- Just in case redirection does not work --> | ||
| <p> | ||
| <a href="http://mxnet.io/get_started/install.html"> | ||
| This content is moved to a new MXNet install page. Redirecting... </a> | ||
| </p> |