From 2e0a0a8c9701719a2ba203ea90113fcb7954dd3e Mon Sep 17 00:00:00 2001
From: Patrick Roth <roth@stettbacher.ch>
Date: Fri, 18 Oct 2019 15:37:50 +0200
Subject: Building instructions for Windows added

---
 README.md | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file 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 ..
-- 
cgit v1.2.1