Merge branch 'develop' of https://github.com/PaddlePaddle/Paddle into develop
zchen0211
7 years ago
commit
e80489a488
@ -0,0 +1,62 @@
|
||||
# Build PaddlePaddle for Raspberry Pi
|
||||
|
||||
You may use any of the following two approaches to build the inference library of PaddlePaddle for Raspberry Pi:
|
||||
|
||||
1. Build using SSH: Log in to a Raspberry Pi using SSH and build the library. The required development tools and third-party dependencies are listed in here: [`/Dockerfile`](https://github.com/PaddlePaddle/Paddle/blob/develop/Dockerfile).
|
||||
|
||||
1. Cross-compile: We talk about how to cross-compile PaddlePaddle for Raspberry Pi on a Linux/x64 machine, in more detail in this article.
|
||||
|
||||
## The Cross-Compiling Toolchain
|
||||
|
||||
Step 1. Clone the Github repo by running the following command.
|
||||
|
||||
```bash
|
||||
git clone https://github.com/raspberrypi/tools.git
|
||||
```
|
||||
|
||||
Step 2. Use the pre-built cross-compiler found in `./tools/tree/master/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64`. To run it on a Linux computer, glibc version >= 2.14 is needed.
|
||||
|
||||
## CMake Arguments
|
||||
|
||||
CMake supports [cross-compiling](https://cmake.org/cmake/help/v3.0/manual/cmake-toolchains.7.html#cross-compiling). All CMake configuration arguments required for the cross-compilation for Raspberry Pi can be found in [`cmake/cross_compiling/raspberry_pi.cmake`](https://github.com/PaddlePaddle/Paddle/blob/develop/cmake/cross_compiling/raspberry_pi.cmake).
|
||||
|
||||
Some important arguments that need to be set:
|
||||
|
||||
- `CMAKE_SYSTEM_NAME`: The target platform. Must be `RPi`.
|
||||
|
||||
- `RPI_TOOLCHAIN`: The absolute path of the cross-compiling toolchain.
|
||||
|
||||
- `RPI_ARM_NEON`: Use ARM NEON Intrinsics. This is a required argument and set default to `ON`.
|
||||
|
||||
- `HOST_C/CXX_COMPILER`: The C/C++ compiler for the host. It is used to build building tools running on the host, for example, protoc.
|
||||
|
||||
A commonly-used CMake configuration is as follows:
|
||||
|
||||
```
|
||||
cmake -DCMAKE_SYSTEM_NAME=RPi \
|
||||
-DRPI_TOOLCHAIN=your/path/to/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64 \
|
||||
-DRPI_ARM_NEON=ON \
|
||||
-DCMAKE_INSTALL_PREFIX=your/path/to/install \
|
||||
-DWITH_GPU=OFF \
|
||||
-DWITH_C_API=ON \
|
||||
-DWITH_PYTHON=OFF \
|
||||
-DWITH_SWIG_PY=OFF \
|
||||
..
|
||||
```
|
||||
|
||||
To build the inference library, please set the argument WITH_API to ON: `WITH_C_API=ON`.
|
||||
|
||||
You can add more arguments. For example, to minimize the size of the generated inference library, you may use `CMAKE_BUILD_TYPE=MinSizeRel`. For performance optimization, you may use `CMAKE_BUILD_TYPE=Release`.
|
||||
|
||||
## Build and Install
|
||||
|
||||
The following commands build the inference library of PaddlePaddle for Raspberry Pi and third-party dependencies.
|
||||
|
||||
```bash
|
||||
make
|
||||
make install
|
||||
```
|
||||
|
||||
The intermediate files will be stored in `build`. Third-party libraries will be located in `build/third_party`. If you have already built it for other platforms like Android or iOS, you may want to clear these directories by running the command: `rm -rf build`.
|
||||
|
||||
The infernece library will be in `your/path/to/install/lib`, with related header files in `your/path/to/install/include`.
|
||||
@ -1,2 +1,3 @@
|
||||
vendor/
|
||||
.glide/
|
||||
proto/*.go
|
||||
|
||||
@ -0,0 +1,4 @@
|
||||
# Ignore everything in this directory
|
||||
*
|
||||
# Except this file
|
||||
!.gitignore
|
||||
@ -1,60 +0,0 @@
|
||||
/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve.
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License. */
|
||||
|
||||
#pragma once
|
||||
|
||||
#include <stdlib.h>
|
||||
#include <unistd.h>
|
||||
#include <vector>
|
||||
|
||||
#include "paddle/platform/enforce.h"
|
||||
#include "paddle/string/piece.h"
|
||||
|
||||
extern char** environ; // for environment variables
|
||||
|
||||
namespace paddle {
|
||||
namespace platform {
|
||||
|
||||
inline void SetEnvVariable(const std::string& name, const std::string& value) {
|
||||
PADDLE_ENFORCE_NE(setenv(name.c_str(), value.c_str(), 1), -1,
|
||||
"Failed to set environment variable %s=%s", name, value);
|
||||
}
|
||||
|
||||
inline void UnsetEnvVariable(const std::string& name) {
|
||||
PADDLE_ENFORCE_NE(unsetenv(name.c_str()), -1,
|
||||
"Failed to unset environment variable %s", name);
|
||||
}
|
||||
|
||||
inline bool IsEnvVarDefined(const std::string& name) {
|
||||
return std::getenv(name.c_str()) != nullptr;
|
||||
}
|
||||
|
||||
inline std::string GetEnvValue(const std::string& name) {
|
||||
PADDLE_ENFORCE(IsEnvVarDefined(name),
|
||||
"Tried to access undefined environment variable %s", name);
|
||||
return std::getenv(name.c_str());
|
||||
}
|
||||
|
||||
inline std::vector<std::string> GetAllEnvVariables() {
|
||||
std::vector<std::string> vars;
|
||||
for (auto var = environ; *var != nullptr; ++var) {
|
||||
auto tail = string::Index(*var, "=");
|
||||
auto name = string::SubStr(*var, 0, tail).ToString();
|
||||
vars.push_back(name);
|
||||
}
|
||||
return vars;
|
||||
}
|
||||
|
||||
} // namespace platform
|
||||
} // namespace paddle
|
||||
@ -1,54 +0,0 @@
|
||||
/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve.
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License. */
|
||||
|
||||
#include "paddle/platform/environment.h"
|
||||
|
||||
#include "glog/logging.h"
|
||||
#include "gtest/gtest.h"
|
||||
|
||||
TEST(ENVIRONMENT, ACCESS) {
|
||||
namespace platform = paddle::platform;
|
||||
namespace string = paddle::string;
|
||||
|
||||
platform::SetEnvVariable("PADDLE_USE_ENV", "TRUE");
|
||||
|
||||
EXPECT_TRUE(platform::IsEnvVarDefined("PADDLE_USE_ENV"));
|
||||
EXPECT_EQ(platform::GetEnvValue("PADDLE_USE_ENV"), "TRUE");
|
||||
|
||||
platform::UnsetEnvVariable("PADDLE_USE_ENV");
|
||||
EXPECT_FALSE(platform::IsEnvVarDefined("PADDLE_USE_ENV"));
|
||||
|
||||
platform::SetEnvVariable("PADDLE_USE_ENV1", "Hello ");
|
||||
platform::SetEnvVariable("PADDLE_USE_ENV2", "World, ");
|
||||
platform::SetEnvVariable("PADDLE_USE_ENV3", "PaddlePaddle!");
|
||||
|
||||
std::string env_info;
|
||||
auto vars = platform::GetAllEnvVariables();
|
||||
for_each(vars.begin(), vars.end(), [&](const std::string& var) {
|
||||
env_info += platform::GetEnvValue(var);
|
||||
});
|
||||
|
||||
EXPECT_TRUE(string::Contains(env_info, "Hello World, PaddlePaddle!"));
|
||||
platform::UnsetEnvVariable("PADDLE_USE_ENV1");
|
||||
platform::UnsetEnvVariable("PADDLE_USE_ENV2");
|
||||
platform::UnsetEnvVariable("PADDLE_USE_ENV3");
|
||||
|
||||
env_info.clear();
|
||||
vars = platform::GetAllEnvVariables();
|
||||
for_each(vars.begin(), vars.end(), [&](const std::string& var) {
|
||||
env_info += platform::GetEnvValue(var);
|
||||
});
|
||||
|
||||
EXPECT_FALSE(string::Contains(env_info, "Hello World, PaddlePaddle!"));
|
||||
EXPECT_FALSE(platform::IsEnvVarDefined("PADDLE_USE_ENV1"));
|
||||
EXPECT_FALSE(platform::IsEnvVarDefined("PADDLE_USE_ENV2"));
|
||||
EXPECT_FALSE(platform::IsEnvVarDefined("PADDLE_USE_ENV3"));
|
||||
}
|
||||
Loading…
Reference in new issue