移植Eigen库到SylixOS下及使用方法

1. 开发环境

宿主机：Windows 7 
集成开发环境：Real-Evo IDE 3.5.3 
虚拟机：Ubuntu 
目标机：x86

2. Eigen简介

Eigen是一个提供了线性代数、矩阵、向量操做等运算的C++库，其中包含了不少算法。Eigen的License是MPL2，支持多平台。 
Eigen使用提供源码的方式给用户使用，在使用时只须要包含Eigen的头文件便可进行使用。之因此采用这种方式，是由于Eigen采用模板方式实现，因为模板函数不支持分离编译，因此只能提供源码而不是动态库的方式供用户使用，不过这也更方便用户使用和研究。 
Eigen包含一个核心模块和多个附加模块，每个模块都有相对应的头文件，若是须要用到其中的模块，只须要包含相对应的头文件便可。为了方便用户使用，源码中提供了Dense以及Eigen两个头文件，用户代码包含这两个头文件便可访问多个模块。 
须要的头文件和功能以下表所示。 

3. 资源获取

通常的，能够经过官方网站获取要移植的第三方件的资源。Eigen的下载地址为Eigen官网。 
本篇中使用的Eigen版本为eigen-3.3.4，下载后解压文件以下图所示。 

4. Linux平台编译及安装

Eigen在编译的过程当中并不生成库文件，只会生成头文件，所以在编译的过程当中不会产生目标文件。具体的操做步骤参考Eigen源文件中的INSTALL文件。Eigen工程使用的编译工具是cmake，使用cmake编译以后会生成Makefile文件，编译步骤以下图所示。 

在执行cmake编译以后，会在源码目录下生成Makefile，执行make install命令则会生成相应的头文件并安装到执行cmake命令时指定的路径下，操做步骤以下图所示。 
 
安装路径下的内容以下图所示。 
 
在使用Eigen时，只须要包含Eigen目录下相应的文件便可。

5. SylixOS平台编译

因为Eigen库在编译时并不生成库文件，只是生成对应的头文件。且RealEvo-IDE不支持cmake操做，所以SylixOS无需编译，可直接将Linux平台安装生成的文件拷贝使用。在实际使用时，只要包含相对应的头文件便可。

6. Eigen库使用

6.1 建立APP工程 
建立SylixOS APP工程，操做以下图所示。 
 
新建include目录，而后将在Linux下安装生成的eigen3文件夹拷贝到SylixOS APP工程的include目录下，工程结构以下图所示。 
 
在Eigen源码目录中的doc/examples/目录下提供了测试代码，本例中的代码便是其中的测试代码。 
6.2 修改eigenTest.mk 
修改eigenTest.mk文件，包含Eigen头文件路径，操做以下图所示。 
 
在测试过程当中，在编译Eigen源码目录中的doc/examples/目录下的Cwise_erf.cpp、Cwise_erfc.cpp、Cwise_lgamma.cpp这三个测试文件会报错。可经过修改eigenTest.mk解决，解决方法以下图所示。 

关于在运行Eigen源码目录中的doc/examples/目录下的matrixfree_cg.cpp会致使系统死机的缘由是因为线程栈溢出致使的，具体解决方法可经过增长线程栈大小解决，关于如何修改线程栈大小可参考《SylixOS应用开发手册》的线程管理章节。 
经过修改eigenTest.mk查看出错缘由，操做以下图所示。 
 
6.3 部署运行 
编译部署到SylixOS后，运行结果以下图所示。