aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPatrick Roth <roth@stettbacher.ch>2019-10-18 15:37:50 +0200
committerPatrick Roth <roth@stettbacher.ch>2019-10-18 15:37:50 +0200
commit2e0a0a8c9701719a2ba203ea90113fcb7954dd3e (patch)
tree2fa5da7fcdb9319953cc8a7c3c2325ec24b598da
parentwrong include paths for o-3000 header files (diff)
downloado3000-driver-2e0a0a8c9701719a2ba203ea90113fcb7954dd3e.tar.gz
o3000-driver-2e0a0a8c9701719a2ba203ea90113fcb7954dd3e.zip
Building instructions for Windows added
Diffstat (limited to '')
-rw-r--r--README.md74
1 files changed, 70 insertions, 4 deletions
diff --git a/README.md b/README.md
index 8e852b4..f3235fc 100644
--- a/README.md
+++ b/README.md
@@ -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 ..