summaryrefslogtreecommitdiffstats
path: root/source/k/README_SPEAKUP_PATCH.TXT
blob: 8fd1559613cb6dbe7259ebe070ab724f41d666d3 (plain) (blame)
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80

This is an archive of the speakup project's GIT HEAD snapped on the given
day, and was used to build the speakup.s kernel.  Grabbing Speakup's GIT
repo (if you want the very latest) is done like this, by the way:

git-clone http://www.linux-speakup.org/speakup.git

To build the same kernel as Slackware included as speakup.s, you'll
need to do this:

Untar the speakup archive, and cd into the speakup directory:

tar xf speakup-2009-12-30.tar.xz
cd speakup-2009-12-30

Patch whatever kernel you happen to want to compile:
./install /usr/src/linux-2.6.33.4

Change to the kernel directory:
cd /usr/src/linux-2.6.33.4

If you want to start with the defaults one of Slackware's kernels, you can do
that like this:

cat /boot/vmlinuz-huge-2.6.33.4 > .config

Or, better yet, if you have access to the Slackware tree use the
Speakup .config that was used:

cat (slacktree)/kernels/speakup.s/config > .config

Then do any additional configuation to the kernel that you may require:

make menuconfig

You might want to check in Device Drivers -> Accessibility -> Speakup
to make sure that Speakup support is configured to your liking.

After that, it's build and install:
make
make modules_install
make bzImage
cat arch/x86/boot/bzImage > /boot/vmlinuz-huge-2.6.33.4-speakup

I put the -speakup on the end of the kernel name so that I can remember
which kernel I've patched, but that part is entirely optional.

The next step will be to edit add the new kernel's modules to an initrd if
you use one (if you didn't build in the root filesystem or something like
that you will need an initrd).  See "man mkinitrd" for more details on the
subject of making an initrd.

Now just add the new kernel (and possibly the /boot/initrd.gz) to
/etc/lilo.conf, run lilo as root, and you are ready to reboot.  Make sure
to use an append="speakup parameters" type line in /etc/lilo.conf to
configure speakup to use the proper synth driver.  You many also need to
specify the serial port or other parameters, like this:

append="speakup.synth=dectlk speakup.ser=2"

This line would attempt to use Speakup with a DecTalk Express on /dev/ttyS1.

Note that with Speakup 3.x, the kernel parameter names have changed to
contain dots rather than underscores.  Other options have changed as
well.  Although perhaps not a complete list, I found these changes noted
on the linuxfromscratch web site:

speakup_synth became speakup.synth, and the "sftsyn" synthesizer became "soft";

speakup_ser became speakup.ser, and serial ports are now numbered starting from 1,
not from 0 (i.e., speakup_ser=1 became speakup.ser=2);

speakup_quiet became speakup.quiet, valid values are 0 and 1;

speakup_port became speakup.port.

Good luck!  :-)

Pat