diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 74 |
1 files changed, 70 insertions, 4 deletions
@@ -8,7 +8,10 @@ freely available. These cameras are developed and produced in Switzerland. ## USB Host Driver This USB driver is needed to communicate with the camera. -### Build and install +### Build and install for Linux +Make sure you've all tools for compiling and linking application. Futher the tool *cmake* +is required. Run follow instructions in a shell: + ``` git clone https://stettbacher.ch/gitlab/o-3000/driver.git cd driver @@ -18,11 +21,74 @@ cmake .. sudo make install ``` +### Build and install for Windows +Following instructions will install the free and open source software development +environment MinGW on your Windows system. MSYS2 contains a command line shell for development +usage and the MinGW compiler. Further informations are found here: + +* [1] https://wiki.qt.io/MSYS2 +* [2] http://www.msys2.org/ + +Download and execute newest MSYS2 installer version from [2]. Use the default +installation path *C:\msys64*. Otherwise MSYS might have a problem. + +Run MSYS2-shell and update core components: + +``` +pacman -Sy +pacman --needed -S bash pacman pacman-mirrors msys2-runtime +``` + +You must exit out from MSYS2-shell, restart MSYS2-shell, then run below +command to complete rest of other component's update: + +``` +pacman -Su +``` + +Exit out of MSYS2-shell, restart MSYS2-shell, then you are ready to use MSYS2-shell. Double-check +whether MSYS is up-to-date: + +``` +pacman -Su +``` + +Install several tools for software development and building O-3000 libraries and applications. +This will install 32 and 64 bit toolchains: + +``` +pacman -S base-devel git +pacman -S mingw-w64-i686-toolchain mingw-w64-x86_64-toolchain mingw-w64-i686-cmake mingw-w64-x86_64-cmake +pacman -S mingw64/mingw-w64-x86_64-libusb mingw32/mingw-w64-i686-libusb +``` + +Exit MSYS2-shell and run MSYS2-MinGW-shell located here: + +``` +C:\Users\<USER>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\MSYS2 64bit +``` + +You can choose between a 32 and 64 bit platform. Choose whichever you prefer. + +Build O-3000 Driver: + +``` +mkdir o-3000-git +cd o-3000-git +git clone https://stettbacher.ch/gitlab/o-3000/driver.git +cd driver +mkdir build +cd build +cmake .. -G "MSYS Makefiles" +make +``` + +You'll find the DLL in the building directory. ### Cross-Compile -First a toolchain file is needed to specify the cross-compiler environment. As astarting point, -use the template 'cmake/toolchain_file_template.cmake'. Specify the cross-compiler and path. -Run cmake within build directory as follow: +A toolchain file is needed to specify the cross-compiler environment. As a starting point, +use the template 'cmake/toolchain_file_template.cmake'. Do specify the cross-compiler and path. +Run the cmake command as follow: ``` cmake -DCMAKE_TOOLCHAIN_FILE=../cmake/toolchain_file_template.cmake .. |