Blame INSTALL-windows

Packit 713213
Installation instructions for the Windows platform
Packit 713213
---------------------------------------------------
Packit 713213
(Note: this could go in the main INSTALL file)
Packit 713213
Packit 713213
The instructions are rather long; they detail what I had to go through
Packit 713213
install libdc1394. It's not very difficult though. If you have
Packit 713213
problems or comments about these instructions, please contact the
Packit 713213
mailing list libdc1394-devel@lists.sf.net. The mailing list is
Packit 713213
private, but you can send messages even if you are not a member; you
Packit 713213
will just have to wait for moderation on your first message.
Packit 713213
Packit 713213
Packit 713213
0. Unplug all 1394 cameras on your system.
Packit 713213
Packit 713213
Windows tries to be smart but more often than not it isn't. Don't give
Packit 713213
it something to chew on ;)
Packit 713213
Packit 713213
Packit 713213
Packit 713213
1. Install MinGW and Msys
Packit 713213
Packit 713213
Use the project's installer to install both MinGW and Msys
Packit 713213
http://sourceforge.net/projects/mingw/files/Installer/mingw-get/
Packit 713213
Packit 713213
Packit 713213
Packit 713213
2. CMU driver installation
Packit 713213
Packit 713213
This windows version of libdc1394 uses the CMU 1394 driver at its
Packit 713213
core. For this reason you should first download and install this
Packit 713213
driver.
Packit 713213
Packit 713213
** Attention: if you have a Point Grey driver installed on your
Packit 713213
   computer (FlyCapture,...), you should first remove it
Packit 713213
   thouroughly. Verify after its removal that the camera is not
Packit 713213
   recognized as a Point Grey camera anymore, but as an "Imaging
Packit 713213
   Device" (in the device manager). Any attempt to use the CMU driver
Packit 713213
   and/or libdc1394 will fail if Windows is still complaining about
Packit 713213
   the missing "pgrcam.sys" file, among others. Verify that no file in
Packit 713213
   windows/inf/ refers to pgrcam.sys and check the following
Packit 713213
   directories for PGR files: /Windows/System32/drivers,
Packit 713213
   /Windows/System32/DRVSTORE and /Windows/System32/ReinstallBackups.
Packit 713213
   Editing the registry may be necessary too (augh!).
Packit 713213
Packit 713213
Get the CMU driver at http://www.cs.cmu.edu/~iwan/1394/
Packit 713213
We recommend you use the installer "1394camera646-unsigned.exe", as
Packit 713213
this is the version on which this library is based.
Packit 713213
Packit 713213
After the installer has run, you may need to tell Windows to use the
Packit 713213
CMU driver. Plug a camera, verify that the CMU demo app sees it and
Packit 713213
that you can get a live feed. If not, go to the hardware manager and
Packit 713213
check the driver status of your camera. If drivers are not attached to
Packit 713213
it, you must use the "have disk" option and point Windows to the
Packit 713213
location of the INF file, normally c:\Program Files\CMU\1394Camera
Packit 713213
\Driver. Don't let Windows look for drivers on its own. After you have
Packit 713213
confirmed that the drivers used by the camera are the CMU drivers,
Packit 713213
re-test using the CMU demo app.
Packit 713213
Packit 713213
Note 1: in the CMU demo app, you need to reset the camera before you
Packit 713213
can control it.
Packit 713213
Note 2: the CMU app sometimes fails to start a Format_7 stream. I
Packit 713213
recommend that you start by selecting a standard video mode
Packit 713213
(e.g. 640x480 MONO)
Packit 713213
Note 3: on 64bit systems, the CMU driver is installed in c:\Program
Packit 713213
Files (x86)\CMU\1394Camera\Driver (note the extra "(x86)")
Packit 713213
Packit 713213
Once the CMU stuff is working fine, run the Msys shell and copy the
Packit 713213
library files and headers to your mingw system:
Packit 713213
Packit 713213
cp /Program\ Files/CMU/1394Camera/lib/1394camera.lib /mingw/lib/lib1394camera.a
Packit 713213
cp /Program\ Files/CMU/1394Camera/include/1394camapi.h /mingw/include/
Packit 713213
cp /Program\ Files/CMU/1394Camera/include/1394common.h /mingw/include/
Packit 713213
Packit 713213
Tip 1: Use slashes ("/") when working in Msys, not backslashes ("\")
Packit 713213
Tip 2: Installation should be done in the /mingw directory, NOT the
Packit 713213
msys directory.
Packit 713213
Packit 713213
Packit 713213
Packit 713213
3. SDL installation (optional)
Packit 713213
Packit 713213
A new example program is being used to test the windows platform:
Packit 713213
dc1394_iso. This program requires SDL, so if you want to compile it
Packit 713213
you should install SDL first.
Packit 713213
Packit 713213
Get SDL at http://www.libsdl.org/release/SDL-1.2.14.tar.gz
Packit 713213
Don't use 1.2.15, the files are buggy (this may have been fixed
Packit 713213
recently). Put the tarball in your Msys home, usually something like
Packit 713213
c:/mingw/msys/1.0/home/<username>/
Packit 713213
Packit 713213
tar -xvzf SDL-1.2.14.tar.gz
Packit 713213
cd SDL-1.2.14
Packit 713213
./configure --prefix=/mingw/
Packit 713213
make
Packit 713213
make install
Packit 713213
Packit 713213
Packit 713213
Packit 713213
4. libdc1394 (at last!)
Packit 713213
Packit 713213
If you reed this, you already have the tarball or GIT snapshot. Put it
Packit 713213
alongside the SDL library in your Msys home directory (see above), and
Packit 713213
again:
Packit 713213
Packit 713213
tar -xvzf libdc1394.tar.gz
Packit 713213
cd libdc1394
Packit 713213
./configure --prefix=/mingw/
Packit 713213
make
Packit 713213
make install
Packit 713213
Packit 713213
To test the library, run dc1394_iso.exe. If your camera does not
Packit 713213
support the modes hardcoded in that example, you may need to adjust
Packit 713213
some #define statements in dc1394_iso.c
Packit 713213
Packit 713213
Note: when using Msys, stderr is not dumped on the terminal but in a
Packit 713213
file. If you run the example from the directory of its location, the
Packit 713213
output file should be ./.libs/stderr.txt
Packit 713213
Packit 713213
If you get a nice live video, congratulations! If not, please contact
Packit 713213
the mailing list (libdc1394-devel@lists.sf.net).
Packit 713213
Packit 713213
Packit 713213
Packit 713213
Damien & Satofumi
Packit 713213