summaryrefslogtreecommitdiff
path: root/eCos.mdwn
blob: 5e816f24f14bfef0e3265a0c27641a0d0a5ea13d (plain)
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
# Installing eCos

eCos is an open-source RTOS designed to run on embedded systems. [Instructions for downloading and installing eCos](http://gps.psas.pdx.edu/RedBootOnTheMG5001) can be found on the [GPL-GPS wiki](http://gps.psas.pdx.edu). You may also want to set up a cross-compiler.

Linux distribution specific instructions for setting up a cross-compiler:

- [[Debian|DebianCrossCompilerHowto]]
- [[Gentoo|GentooCrossCompilerHowto]]

Once you've installed eCos, you'll need to add the configtool path to your $PATH environment variable. In the default installation, configtool is found in ecos/ecos-2.0/tools/bin/

# Building the eCos docs

According to Andrew, the eCos folks are bad about updating the html documentation for eCos. However, the sgml documentation is usually current. To build the sgml into pdfs, you'll need the following debian packages:

- docbook
- jade
- jadetex

You may also need one or more of the following packages:

- docbook-dsssl
- docbook-html-forms
- docbook-mathml
- docbook-simple
- docbook-slides
- docbook-utils
- docbook-xml
- docbook-xsl

(The ambiguity about the above list comes from needing a RedHat package called docbook-stylesheets. There is no Debian package by that name, so I installed all the packages named docbook-\* that looked relevant. If someone wants to figure out which ones are really necessary, go for it.)

Next, go to the directory ecos/docs/sgml and type the following commands:

    $ ./makemakefile
    $ make pdfletter

If you get a message like "TeX capacity exceeded, sorry [number of strings=55000]", you'll need to edit two lines in /etc/texmf/texmf.d/96JadeTeX.cnf. Make sure the lines that start with "max\_strings" look like this:

    max_strings.jadetex = 155000
    max_strings.pdfjadetex = 155000

Then run update-texmf and try to make the sgml again.