... and my README file

[Nicolas Boullis <nboullis@debian.org>]

Hi,

Could someone please check (for correct english) the attached README 
file?


Thanks in advance,

Nicolas,
non-native speaker

PS: please CC your replies to me, as I'm not subscribed.

		Special device files and major number

No major number has been officially allocated yet for em8300. The
major number 121 is currently used, but it's officially reserved for
"LOCAL/EXPERIMENTAL USE".

If you use a dynamic /dev system, like the old devfs or the new udev,
you do not care about the major number in use. Hence, you can (and
probably should) use automatic assignment of major number. This is
done by loading the em8300 module with the "major=0" option.

If you use a static /dev, you need to know the major number in use to
generate the required special device files. Although it is officially
reserved for "LOCAL/EXPERIMENTAL USE", the major number 121 is
currently used by default, but you can choose any other one with the
major option of the em8300 module.

Once you know the major number you will use, generate the proper
device files with the following few lines of POSIX sh (replace the 121
value as appropriate):
	#!/bin/sh
	MAJOR=121
	for i in `seq 0 3`; do
	  mknod -m 0660 /dev/em8300-${i}    c ${MAJOR} `expr 4 \* ${i}`
	  mknod -m 0660 /dev/em8300_mv-${i} c ${MAJOR} `expr 4 \* ${i} + 1`
	  mknod -m 0660 /dev/em8300_ma-${i} c ${MAJOR} `expr 4 \* ${i} + 2`
	  mknod -m 0660 /dev/em8300_sp-${i} c ${MAJOR} `expr 4 \* ${i} + 3`
	  chgrp video /dev/em8300-${i} /dev/em8300_mv-${i} /dev/em8300_ma-${i} /dev/em8300_sp-${i}
	done
	ln -s em8300-0    /dev/em8300
	ln -s em8300_mv-0 /dev/em8300_mv
	ln -s em8300_ma-0 /dev/em8300_ma
	ln -s em8300_sp-0 /dev/em8300_sp

 -- Nicolas Boullis <nboullis@debian.org>, Sun, 17 Dec 2006 00:37:24 +0100

		2.6 kernel systems without automatic firmware loading

Em8300 by default on 2.6 series kernels relies on automatic firmware loading
to load the firmware into the em8300 chip. The default debian kernels ship with
this enabled, so if that's what you're using you should be fine.

If you are not using a kernel with automatic firmware loading you will need to
modify the line in /etc/modprobe.d/em8300 which says "install em8300
/sbin/modprobe $chipset && /sbin/modprobe --ignore-install em8300" to read:

install em8300 /sbin/modprobe $chipset && /sbin/modprobe --ignore-install em8300 && for i in \`seq 5\`; do [ -e /dev/em8300-0 ] && break; sleep 1; done && /usr/bin/em8300setup -f /lib/firmware/em8300.bin

This will ensure that the firmware is loaded when the module is loaded.

 -- Brendon Higgins <blhiggins@gmail.com>, Wed Apr 12 17:48:58 2006

		Support for multiple firmwares

Previous versions of the em8300 package supported more than one microcode image
by keeping them in the /usr/share/em8300 folder. As microcode images should be
stored in the common /lib/firmware folder, the em8300 package no longer supports
handling of multiple firmware images.

If you wish, you can continue to use more than one microcode image as done
previously, however it then becomes your responsibility to remove these image
files should you wish to purge the em8300 package from your system.

 -- Brendon Higgins <blhiggins@gmail.com>, Sat Dec  2 17:01:23 EST 2006