mirror of
https://gitee.com/mirrors_PX4/PX4-Autopilot.git
synced 2026-05-23 10:47:35 +08:00
README update
This commit is contained in:
@@ -1,28 +1,39 @@
|
||||
UAVCAN - CAN bus for aerospace and robotics
|
||||
===========================================
|
||||
UAVCAN stack in C++
|
||||
===================
|
||||
|
||||
[](https://scan.coverity.com/projects/1513)
|
||||
|
||||
Reference implementation of the [UAVCAN protocol stack](http://uavcan.org/).
|
||||
Portable reference implementation of the [UAVCAN protocol stack](http://uavcan.org) in C++ for embedded systems
|
||||
and Linux.
|
||||
|
||||
## Documentation
|
||||
|
||||
* [UAVCAN specification](http://uavcan.org/UAVCAN_specification)
|
||||
* [UAVCAN website](http://uavcan.org)
|
||||
* [UAVCAN discussion group](https://groups.google.com/forum/#!forum/uavcan)
|
||||
* [Libuavcan overview](http://uavcan.org/Libuavcan)
|
||||
* [List of platforms officially supported by libuavcan](http://uavcan.org/List_of_platforms_officially_supported_by_libuavcan)
|
||||
* [Libuavcan tutorials](http://uavcan.org/Libuavcan_tutorials)
|
||||
* [UAVCAN discussion group](https://groups.google.com/forum/#!forum/uavcan)
|
||||
|
||||
## Cloning the repository
|
||||
|
||||
```bash
|
||||
git clone https://github.com/UAVCAN/libuavcan
|
||||
git submodule update --init --recursive
|
||||
```
|
||||
|
||||
When using this repository as a git submodule in your project, make sure to use `--recursive` when updating it.
|
||||
|
||||
## Library development
|
||||
|
||||
Despite the fact that the library itself can be used on virtually any platform that has a standard-compliant C++03 or C++11 compiler, the library development process assumes that the host OS is Linux.
|
||||
Despite the fact that the library itself can be used on virtually any platform that has a standard-compliant
|
||||
C++03 or C++11 compiler, the library development process assumes that the host OS is Linux.
|
||||
|
||||
Prerequisites:
|
||||
|
||||
* Google test library for C++ - gtest (see [how to install on Debian/Ubuntu](http://stackoverflow.com/questions/13513905/how-to-properly-setup-googletest-on-linux))
|
||||
* C++03 *and* C++11 capable compiler with GCC-like interface (e.g. GCC, Clang)
|
||||
* CMake 2.8+
|
||||
* Optional: static analysis tool for C++ - cppcheck (use Debian/Ubuntu package `cppcheck`)
|
||||
* Optional: static analysis tool for C++ - cppcheck (on Debian/Ubuntu use package `cppcheck`)
|
||||
|
||||
Building the debug version and running the unit tests:
|
||||
```bash
|
||||
@@ -47,15 +58,17 @@ cmake ../../uavcan -G"Eclipse CDT4 - Unix Makefiles" \
|
||||
-DCMAKE_CXX_COMPILER_ARG1=-std=c++11
|
||||
```
|
||||
|
||||
Path `../../uavcan` in the command above points at the directory where the top-level `CMakeLists.txt` is located; you may need to adjust this per your environment. Note that the directory where Eclipse project is generated must not be a descendant of the source directory.
|
||||
Path `../../uavcan` in the command above points at the directory where the top-level `CMakeLists.txt` is located;
|
||||
you may need to adjust this per your environment.
|
||||
Note that the directory where Eclipse project is generated must not be a descendant of the source directory.
|
||||
|
||||
### Submitting a coverity build
|
||||
### Submitting a Coverity Scan build
|
||||
|
||||
First, [get the Coverity build tool](https://scan.coverity.com/download?tab=cxx). Then build the library with it:
|
||||
|
||||
```bash
|
||||
export PATH=$PATH:<coverity-build-tool-directory>/bin/
|
||||
mkdir debug && cd debug
|
||||
mkdir build && cd build
|
||||
cmake <uavcan-source-directory> -DCMAKE_BUILD_TYPE=Debug
|
||||
cov-build --dir cov-int make -j8
|
||||
tar czvf uavcan.tgz cov-int
|
||||
|
||||
Reference in New Issue
Block a user