File: README.TXT

package info (click to toggle)
libnjb 2.2.5-4.1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 2,528 kB
  • ctags: 1,071
  • sloc: ansic: 11,860; sh: 8,611; makefile: 135
file content (66 lines) | stat: -rw-r--r-- 2,995 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
Using libnjb and sample programs under Windows/Win32
----------------------------------------------------

Nominally, if you have already installed Creatives drivers on your 
machine, you should install the libusb-win32 filter driver for use
with libnjb on Windows. The filter driver is a simple installer that
can be found at http://libusb-win32.sourceforge.net/

The current version (as of writing) is version 0.1.10, but any later
version will probably work just as fine.

Plug in your device, exit any Creative applications and run some 
sample programs to test that the library works. Start with the program
program "handshake.exe", then test "tracks.exe" and whatever you want
to try out.

If you only want to run the sample programs, this is all you need to
do.

You can then try to compile your own programs against libnjb if you 
like. You will need the GNU MinGW toolchain. The details are explained
below.


Compilation of programs under Windows/Win32
-------------------------------------------

1. libnjb must be compiled with the MinGW Windows compiler, see
   http://www.mingw.org/ install both MinGW and MSYS.

2. libnjb needs libusb-win32, see http://libusb-win32.sourceforge.net
   Depending on what you have on your machine, you have to do
   different things:

   A: If you already have Creative/Notmad software on this machine,
      Install the libusb-win32 filter binary from libusb-win32. An
      installer is available on the file download page for 
      libusb-win32

   B: If you have no Creative/Notmad or otherwise official drivers
      on your machine, you need to install the full driver. Do this
      by downloading the libusb-win32 device binary from libusb-win32.
      Then combine this with the .inf file found in the libnjb source
      tree "windows" directory to create a driver package. Then 
      choose this .inf file, right-click and install, or select it
      when you plug in your device and you're asked for a driver.

3. To compile libnjb you need the libusb-win32 device binary, because
   this binary includes the library itself and the usb.h file. Unzip
   the libusb-win32 driver binary and copy the libusb.a file to 
   something like C:\mingw\lib and usb.h to something like
   C:\mingw\include.

4. Unzip the libnjb sources and run MSYS. Enter the libnjb source dir
   and type "./configure" followed by "make". libnjb should build.
   You can immediately run the samples and verify that it works.

5. Then install libnjb and compile your own programs... By default
   libnjb installs into the local tree (mostly c:\mingw\usr\local)
   which confuse parts of MinGW so perhaps you're better off by
   installing to /usr with "./configure --prefix=/usr".

6. If you make an installer for your Windows program you might want
   to do something that checks for Creatives driver, and if they're
   present will install the filter driver, else installs the device
   driver.