INSTALACIÓN DE LA LIBRERIA EN EL ENTORNO C.

COMPILACIÓN DE LA LIBRERIA

En este tutorial se describe paso a paso la configuración y compilación de LMSAPI en el IDE Code::Blocks, el cual se encuentra disponible en la siguiente dirección:

• http://sourceforge.net/projects/lmsapi/.
  

También se requiere el compilador libre Gcc para windows, MingW, el cual se puede encontrar en la siguiente dirección:

• http://sourceforge.net/projects/lmsapi/.
  

Para instalar el IDE y el compilador basta con descomprimir el contenido de cada paquete descargado en la unidad C.

• El compilador MingW se debe encontrar en la dirección "C:\MinGW".
• El IDE Code::Blocks se debe encontrar en la dirección "C:\CodeBlocks".
  

Ejecute el IDE Code::Blocks (el archivo ejecutable "C:\CodeBlocks\codeblocks.exe") y habilite la configuración por defecto de Code::Blocks.
Luego en el menu File->Open busque el archivo del proyecto LMSAPI, titulado lms200.workspace:

Abriendo el proyecto lms200.workspace

.

Luego seleccione la configuración adecuada a su proyecto; por conveniencia, se elegirá ReleaseDLL para crear una librería dinámica.

Seleccionando la configuración del proyecto.

.

Una vez seleccionada la configuración, se procederá a la compilación de la librería con el comando Build->Rebuild (Ctrl-F11). El resultado será una DLL presente en la carpeta "/lmsapi/libDLL".

VINCULACIÓN DE LA LIBRERIA A UN PROYECTO

En el directorio "tests/data_test" del proyecto LMSAPI encontrará una plantilla de proyecto para el modulo de prueba de la librería.
Cualquier proyecto que use LMSAPI debe vincular la librería dinámica "lmsapi.dll" o la librería estática "lmsapi.a" presentes en los directorios "/lmsapi/libDLL" y "/lmsapi/lib".

Esto se logra accediendo a las propiedades del proyecto en el menu Project->Properties. Luego se accede a las propiedades de construcción del proyecto (Project's Build Options)..

Añadiendo librería dinámica.

.

También se requiere configurar el directorio de archivos cabecera (Donde se encuentran los prototipos de las funciones) en la categoria "Search Directories". A continuación se incluirá la carpeta 'include' del proyecto LMSAPI donde se encuentran los archivos con extensión *.h..

Añadiendo directorio de fuentes.

.

Estos pasos son suficientes para desarrollar proyectos en C que hagan uso de LMSAPI como librería dinámica (DLL).
Sin embargo, si se requiere que la aplicación final no tenga dependencias a otras librerías en tiempo de ejecución (es decir, que no requiera que la DLL de LMSAPI se incluya en la distribución), se puede configurar que la aplicación utilice LMSAPI como librería estática, la cual será incorporada al ejecutable. Para esto, hay que incluir en el proyecto la versión estática de la librería LMSAPI en vez de la versión DLL. El archivo binario de esta es "lmsapi.a" el cual se encuentra en la carpeta "/lmsapi/lib" del proyecto.
Adicionalmente, debe declararse una constante que indicará que la librería se vinculará estáticamente. Esto se logra compiando la constante LMSAPI_STATIC_LIB en las opciones de compilación, especificamente en las propiedades del proyecto de la aplicación:

Declarando la constante LMSAPI_STATIC_LIB en las opciones de compilación

.

Por último, para utilizar las funciones de LMSAPI basta con declarar "#include <lmsapi_sensor.h>" en el archivo fuente de la aplicación.

---