Skip to content

Latest commit

 

History

History
115 lines (77 loc) · 2.5 KB

README.md

File metadata and controls

115 lines (77 loc) · 2.5 KB
Raw

RS274 Interpreter cpp libraries

This is part of the linuxcnc project, I pick these codes out, and make a library which provides cmake configs for find_package. This might probably ease the way we use this interpreter.

Currently I have built this library and the SAI which is the stand alone interpreter, and export them to install.

Example

An example to use this library,

See https://github.com/windsgo/rs274-sai-compile-example

Build Steps

Makefile Way (also use cmake in makefile)

Use the Makefile provided.

  1. Modify the boost_root and install_dir in the Makefile

  2. Build it

make
  1. install
make install
  1. run sai test
./test.sh

CMake Step By Step

  1. configure

You need to set your own variable and prefix in the following command

cmake -B build -DCMAKE_BUILD_TYPE=Release \
	-DCMAKE_INSTALL_PREFIX=${install_dir} \
	-DCMAKE_EXPORT_COMPILE_COMMANDS=ON \
	-DBOOST_ROOT=__YOUR_PREFIX_1__/lib
  1. build
cmake --build build -j8
  1. install
cmake --install build
  1. run test
./test.sh

COMPILE NOTICE

  • When you use this library, define the EMC2_DEFAULT_TOOLTABLE while compiling if your src uses this defination. which should be the path of sim.tbl relative to the excutable file.
# like this in your CMakeLists.txt, for example the `sai`
target_compile_definitions(sai
    PRIVATE
    EMC2_DEFAULT_TOOLTABLE="${PROJECT_SOURCE_DIR}/sim.tbl"
)

About RUNTIME Path

I have the following code in CMakeLists.txt:

set_target_properties(rs274
    INSTALL_RPATH ${Boost_LIBRARY_DIRS}
)

  • What does it do?

    Set INSTALL_RPATH property to let the INSTALLED library have the search path of libboost_python27.so at runtime.

  • Why I add this?

    When an excutable or another library links to the INSTALLED TARGET rs274 dynamically, even though the excutable may link to libboost_python27, librs274.so need to know where to search for libboost_python27 itself !

  • To Mention:

    This should be done, since libboost_python27 is often not a system lib higher than Ubuntu20.04, it needs to be set according to different systems. So this lib is recommanded to compile each time on a new operating system.

    However, it can also be used if LD_LIBRARY_PATH is set proporly or the libboost_python27 path is included in /etc/ld.so.conf.

    I do this just to make runtime easier for compile test.