Installation of the Linux driver module for the NSM TrueSound Decoder. 
--

To compile the driver a simple 'make' in the directory should suffice.
After doing make, you should have a truesound.o

The module can be loaded into the kernel using 'insmod truesound.o' 
(see 'man insmod' if your not familiar with loadable modules).

To specify driver parameters, you can either edit truesound.c and change the 
default values in the config section, or you can pass parameters to insmod.
If you have more than one card you can pass the parameters as a 
comma-separated list, e.g. irq=5,7,12  == irq 5 for card 0, irq 7 card 2...

The parameters that can be changed are:
io  - which base I/O address(es) to use.
      The last 3 bits in the I/O address must be zero (i.e. (io & ~0x7)==io))
      (default: 0x280, 0x288, 0x290).
dma - which 16-bit dma channel(s) to use,
      Possible values are 5, 6 and 7
      (default: 5,6,7).
irq - which interrupt(s) to use.
      Possible values are 3, 5, 7, 10, 11, 12 and 15.
      (default: 10,11,12).
scan - Which hardware-addresses to scan at initialization, and in what
       order this should be done. (the 'hardware' address is the address 
       that can be changed on the switches on the card).
       This parameter does not usually have to be changed. 
       The card are assigned a major number in the order they
       are found.
       If you for instance have two cards at 0x1fc and 0x1fd, and
       you want the card at 0x1fd to be the first card (/dev/tsd0-*), then you
       can append 'scan=0x1fd,0x1fc' to insmod.
       Possible values are 0x1fc, 0x1fd, 0x1fe, 0x1ff.
       (default: 0x1fc, 0x1fd, 0x1fe, 0x1ff).

The device uses major number 60 by default.
The minor numbers used are:

(card 0)
0	- /dev/tsd0-ioctl, all the ioctl are allow but		
 	  you can't write to this device.
1	- /dev/tsd0-mp1, to play layer 1 files
2	- /dev/tsd0-mp2, to play layer 2 files
3	- /dev/tsd0-mp3, to play layer 3 files

(card 1)
64	- /dev/tsd1-ioctl
65	- /dev/tsd1-mp1,
66	- /dev/tsd1-mp2,
67	- /dev/tsd1-mp3,

(card 2)
128	- /dev/tsd2-ioctl
129	- /dev/tsd2-mp1,
130	- /dev/tsd2-mp2,
131	- /dev/tsd2-mp3,

(Note: users of older version of the driver has to recreate the /dev 
 entries since both major and minor numbers has been changed)

You can run the make-dev-entries.sh shell-script to create the /dev entries.
(as root: 'bash ./make-dev-entries.sh')

Now, you should be able to do a 'cat song.mp3 > /dev/tsd0-mp3'.
(also /dev/tsd1-mp3, /dev/tsd2-mp3 for second and third card)

If you have any problems, questions or bug reports please don't 
hesitate to contact me at magnus@ior.campus.luth.se

--
Magnus Berglund, magnus@ior.campus.luth.se, bert@ludd.luth.se

