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/
|
vendor/
|
||||||
.glide/
|
.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