Installation instructions for the Windows platform

---------------------------------------------------

(Note: this could go in the main INSTALL file)

The instructions are rather long; they detail what I had to go through

install libdc1394. It's not very difficult though. If you have

problems or comments about these instructions, please contact the

mailing list libdc1394-devel@lists.sf.net. The mailing list is

private, but you can send messages even if you are not a member; you

will just have to wait for moderation on your first message.

0. Unplug all 1394 cameras on your system.

Windows tries to be smart but more often than not it isn't. Don't give

it something to chew on ;)

1. Install MinGW and Msys

Use the project's installer to install both MinGW and Msys

http://sourceforge.net/projects/mingw/files/Installer/mingw-get/

2. CMU driver installation

This windows version of libdc1394 uses the CMU 1394 driver at its

core. For this reason you should first download and install this

driver.

** Attention: if you have a Point Grey driver installed on your

   computer (FlyCapture,...), you should first remove it

   thouroughly. Verify after its removal that the camera is not

   recognized as a Point Grey camera anymore, but as an "Imaging

   Device" (in the device manager). Any attempt to use the CMU driver

   and/or libdc1394 will fail if Windows is still complaining about

   the missing "pgrcam.sys" file, among others. Verify that no file in

   windows/inf/ refers to pgrcam.sys and check the following

   directories for PGR files: /Windows/System32/drivers,

   /Windows/System32/DRVSTORE and /Windows/System32/ReinstallBackups.

   Editing the registry may be necessary too (augh!).

Get the CMU driver at http://www.cs.cmu.edu/~iwan/1394/

We recommend you use the installer "1394camera646-unsigned.exe", as

this is the version on which this library is based.

After the installer has run, you may need to tell Windows to use the

CMU driver. Plug a camera, verify that the CMU demo app sees it and

that you can get a live feed. If not, go to the hardware manager and

check the driver status of your camera. If drivers are not attached to

it, you must use the "have disk" option and point Windows to the

location of the INF file, normally c:\Program Files\CMU\1394Camera

\Driver. Don't let Windows look for drivers on its own. After you have

confirmed that the drivers used by the camera are the CMU drivers,

re-test using the CMU demo app.

Note 1: in the CMU demo app, you need to reset the camera before you

can control it.

Note 2: the CMU app sometimes fails to start a Format_7 stream. I

recommend that you start by selecting a standard video mode

(e.g. 640x480 MONO)

Note 3: on 64bit systems, the CMU driver is installed in c:\Program

Files (x86)\CMU\1394Camera\Driver (note the extra "(x86)")

Once the CMU stuff is working fine, run the Msys shell and copy the

library files and headers to your mingw system:

cp /Program\ Files/CMU/1394Camera/lib/1394camera.lib /mingw/lib/lib1394camera.a

cp /Program\ Files/CMU/1394Camera/include/1394camapi.h /mingw/include/

cp /Program\ Files/CMU/1394Camera/include/1394common.h /mingw/include/

Tip 1: Use slashes ("/") when working in Msys, not backslashes ("\")

Tip 2: Installation should be done in the /mingw directory, NOT the

msys directory.

3. SDL installation (optional)

A new example program is being used to test the windows platform:

dc1394_iso. This program requires SDL, so if you want to compile it

you should install SDL first.

Get SDL at http://www.libsdl.org/release/SDL-1.2.14.tar.gz

Don't use 1.2.15, the files are buggy (this may have been fixed

recently). Put the tarball in your Msys home, usually something like

c:/mingw/msys/1.0/home/<username>/

tar -xvzf SDL-1.2.14.tar.gz

cd SDL-1.2.14

./configure --prefix=/mingw/

make

make install

4. libdc1394 (at last!)

If you reed this, you already have the tarball or GIT snapshot. Put it

alongside the SDL library in your Msys home directory (see above), and

again:

tar -xvzf libdc1394.tar.gz

cd libdc1394

./configure --prefix=/mingw/

make

make install

To test the library, run dc1394_iso.exe. If your camera does not

support the modes hardcoded in that example, you may need to adjust

some #define statements in dc1394_iso.c

Note: when using Msys, stderr is not dumped on the terminal but in a

file. If you run the example from the directory of its location, the

output file should be ./.libs/stderr.txt

If you get a nice live video, congratulations! If not, please contact

the mailing list (libdc1394-devel@lists.sf.net).

Damien & Satofumi