Commit d06ab64d authored by Marc Ariberti's avatar Marc Ariberti
Browse files

* first draft of the draft

parent 4579f7b3
<!doctype linuxdoc system>
<linuxdoc><article>
<titlepag>
<title>Cross compiling VLC for ARM based platforms</title>
<title>Cross compiling VLC for ARM-Linux based platforms</title>
<author>Marc Ariberti <tt><htmlurl url="mailto:marcari@videolan.org" name="<marcari@videolan.org>"></tt></author>
<date>v0.0.1, 13 march 2003</date>
<abstract>
......@@ -16,46 +16,264 @@
<sect>
<heading>Introduction</heading>
<sect1>
<heading>Which platforms ar targeted ?</heading>
<heading>Which platforms are targeted ?</heading>
<p>
I will describe here how to compile vlc for an ARM based
PDA running linux. It includes for example :
<itemize>
<item>Compaq - iPaq (H36xx, H38xx,...), using
<itemize>
<item>Familiar linux
<item>Opie
</itemize>
</item>
<item>YOPY/Linupy</item>
<item>Zaurus</item>
</itemize>
</p>
</sect1>
<sect1>
<heading>Requirements for cross-compilation</heading>
</sect1>
<sect1>
<heading>Why not compiling directly on the target platform ?</heading>
<heading>Why cross-compiling ?</heading>
<p>
It is of course possible to compile directly on the targeted platform.
But there are a lot of great advantages to cross-compile :
<itemize>
<item>The most important one is probably the speed, because a
desktop computer is most of the time faster than a PDA for
compilation.</item>
<item>Another big problem is that a complete compilation toolchain
does take a great amount of disk space. And this space is usually
very limited on embedded systems.</item>
<item>And there also may not be enough memory to compile big files.</item>
</itemize>
</p>
</sect1>
</sect>
<sect>
<heading>Building the toolchain</heading>
<sect1>
<heading>The cross compiler (gcc)</heading>
<heading>Prerequisite</heading>
<sect2>
<heading></heading>
<p>
During this section, we will use the following variables :
<itemize>
<item><bf>${PREFIX}</bf> will designate where you want to install
your toolchain (eg: <tt>/usr/local/arm/2.95.3</tt>).</item>
<item><bf>${SRCDIR}</bf> will designate the directory where
sources will be uncompressed
(eg: <tt>/usr/src</tt> or <tt>/home/foobar/cross-arm</tt>).</item>
</itemize>
</p>
</sect2>
<sect2>
<heading>Files needed</heading>
<p>Download the following files and put them in the <bf>${SRCDIR}</bf> :
<itemize>
<item><tt>binutils-2.11.2.tar.gz</tt></item>
<item><tt>linux-2.4.19.tar.bz2</tt></item>
<item><tt>patch-2.4.19-rmk4.bz2</tt></item>
</itemize>
</p>
</sect2>
</sect1>
<sect1>
<heading>Binutils</heading>
<p>Compiling binutils is pretty simple :
<tscreen><verb>
% tar xzf binutils-2.11.2.tar.gz
% cd binutils-2.11.2
% ./configure --target=arm-linux --prefix=/usr/local/arm/2.95.3
% make
% su
# make install
</verb></tscreen>
</p>
</sect1>
<sect1>
<heading>Preparing linux kernel</heading>
<p>
<tscreen><verb>
% tar xzf linux-2.4.19.tar.bz2
% bunzip2 patch-2.4.19-rmk4.bz2
% cd linux-2.4.19
% patch -p1 &lt; ../patch-2.4.19-rmk4.bz2
% make clean ARCH=arm CROSS_COMPILE=arm-linux-
% make ARCH=arm h3600_config
!!! don't forget to save the configuration even if no changes are made
% make ARCH=arm menuconfig
% make symlinks ARCH=arm CROSS_COMPILE=arm-linux-
% mkdir -p /usr/local/arm/2.95.3/arm-linux/include
% cp -Rf include/asm include/asm-arm include/linux /usr/local/arm/2.95.3/arm-linux/include
% cd /usr/local/arm/2.95.3/arm-linux
% ln -s include sys-linux
</verb></tscreen>
</p>
</sect1>
<sect1>
<heading>Basic cross compiler (gcc)</heading>
<p>
tar xvzf gcc-2.95.3.tar.gz
bunzip2 gcc-2.95.3.diff.bz2
bunzip2 gcc-2.95.3.diffbis.bz2
patch -p1 -d gcc-2.95.3 &lt; gcc-2.95.3.diff
patch -p1 -d gcc-2.95.3 &lt; gcc-2.95.3.diffbis
cd gcc-2.95.3
./configure --target=arm-linux --disable-threads --enable-languages=c --prefix=/usr/local/arm/2.95.3 --with-headers=linux-2.4.19/include
make
make install
</p>
</sect1>
<sect1>
<heading>Compiling glibc</heading>
<p>
Depending on your target, you may choose another glibc version (eg: 2.1.3 for linupy 1.4)
tar xvzf glibc-2.2.5.tar.gz
cd glibc-2.2.5
tar xvzf ../glibc-linuxthreads-2.2.5.tar.gz
CC=arm-linux-gcc ./configure arm-linux --target=arm-linux --prefix=/usr/local/arm/2.95.3/arm-linux --enable-add-ons
The following step is quite long !
CC=arm-linux-gcc make
If you have problems compiling glibc due to pread/pwrite, edit sysdeps/unix/sysv/linux/kernel-features.h
and turn __ASSUME_PREAD_SYSCALL and __ASSUME_PWRITE_SYSCALL from 1 to 0.
CC=arm-linux-gcc make install
</p>
</sect1>
<sect1>
<heading>Full cross compiler (gcc)</heading>
rm -Rf gcc-2.95.3
tar xvzf gcc-2.95.3.tar.gz
patch -p1 -d gcc-2.95.3 &lt; gcc-2.95.3.diff
patch -p1 -d gcc-2.95.3 &lt; gcc-2.95.3.diff2
cd gcc-2.95.3
./configure --target=arm-linux --prefix=/usr/local/arm/2.95.3
make
make install
</sect1>
<sect1>
<heading>Misc</heading>
Add /usr/local/arm/2.95.3/bin to your PATH. Add the following line (depends on your shell)
to your shell's configuration file :
export PATH=/usr/local/arm/2.95.3/bin:$PATH
cp libgcc_s.so.1 /usr/local/arm/2.95.3-new/arm-linux/lib
Install theses packages on your compiler box in /usr/local/arm/2.95.3/arm-linux
xlibs_4.1-5_arm.ipk
xlibs-dev_4.1.0-16_arm.ipk
zlib1g_1.1.4-3_arm.ipk
zlib1g-dev_1.1.3-fam1_arm.ipk
</sect1>
</sect>
<sect>
<heading>Cross compiling libraries needed by vlc</heading>
Download <tt>ipaq-config.site</tt> to ${SOURCES}.
When downloading source tarballs copy them to your ${SOURCES} directory.
Each section is supposed to begin with <tt>cd ${SOURCES}</tt>.
<sect1>
<heading>SDL</heading>
!!!! beurk but did not found a better working method
tar xvzf SDL-1.2.5.tar.gz
cd SDL-1.2.5
./configure --enable-release --target=arm-linux --host=arm-linux \
--disable-esd \
--prefix=/usr/local/arm/2.95.3/arm-linux/usr \
--x-includes=/usr/local/arm/2.95.3/arm-linux/usr/X11R6/include \
--x-libraries=/usr/local/arm/2.95.3/arm-linux/usr/X11R6/lib \
--disable-video-opengl
export PATH=/usr/local/arm/2.95.3/arm-linux/bin:$PATH
make && make install
</sect1>
<sect1>
<heading>Glib/GTK+</heading>
tar xvzf glib-1.2.10.tar.gz
cd glib-1.2.10
CONFIG_SITE=../ipaq-config.site ./configure --prefix=/usr/local/arm/2.95.3/arm-linux/usr
make
make install
cd ..
tar xvzf gtk+-1.2.10.tar.gz
cd gtk+-1.2.10
CONFIG_SITE=../ipaq-config.site ./configure --prefix=/usr/local/arm/2.95.3/arm-linux/usr --with-glib=../glib-1.2.10
make
make install
</sect1>
<sect1>
<heading>ffmpeg</heading>
tar xvzf ffmpeg.tar.gz
cd ffmpeg
./configure --cpu=armv4l --cc=arm-linux-gcc --disable-mmx --prefix=/usr/local/arm/2.95.3/arm-linux/usr --enable-shared
cd libavcodec
make
Vlc does not require that you install ffmpeg.
</sect1>
<sect1>
<heading>mad</heading>
tar xvzf mad-0.14.2b.tar.gz
cd mad-0.14.2b
./configure --enable-release --target=arm-linux --host=arm-linux \
--disable-esd \
--prefix=/usr/local/arm/2.95.3/arm-linux/usr \
--x-includes=/usr/local/arm/2.95.3/arm-linux/usr/X11R6/include \
--x-libraries=/usr/local/arm/2.95.3/arm-linux/usr/X11R6/lib \
--disable-video-opengl
export PATH=/usr/local/arm/2.95.3/arm-linux/bin:$PATH
make
</sect1>
<sect1>
<heading>gpe</heading>
</sect1>
%%%%%%%%%%%%%%%%%%%%%%%
First get Tremor and ogg sources from xiph.org (through CVS for example).
Then for each them, do :
% ./configure --enable-release --prefix=/usr/local/arm/2.95.3/arm-linux
% export PATH=/usr/local/arm/2.95.3/arm-linux/bin:$PATH
% make
% su
# make install
I know it is not clean, but --host or --target switches does not work.
The PATH I include, contains all the gcc utils for cross compilation
without the arm-linux- prefix.
If you want to link them statically : edit the libvorbisidec.a and remove
from the archive bitwise.o and framing.o (conflict with libogg.a)
For flac, get the source tarball (from the videolan website for example)
% ./configure --enable-release --host=arm-linux --target=arm-linux
--prefix=/usr/local/arm/2.95.3/arm-linux
% make
-> will fail (xmms plugin), but not a problem, continue installation by hand
% su
# cp -Rf include/FLAC /usr/local/arm/2.95.3/arm-linux/include
# cd src/libFLAC
# make install
When compiling vlc, add to the ./configure :
--enable-ogg
--enable-tremor
--enable-flac
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
<sect1>
<heading>tremor</heading>
</sect1>
......@@ -67,14 +285,26 @@
</sect1>
<sect1>
<heading>libdvbpsi</heading>
tar xvzf libdvbpsi-0.1.2.tar.gz
cd libdvbpsi-0.1.2
./bootstrap
./configure --target=arm-linux --host=arm-linux
make
</sect1>
<sect1>
<heading>a52</heading>
tar xvzf a52dec-0.7.4.tar.gz
cd a52dec-0.7.4
./configure --enable-release --host=arm-linux --target=arm-linux --prefix=/usr/local/arm/2.95.3/arm-linux
make && make install
</sect1>
</sect>
<sect>
<heading>Cross compiling vlc itself</heading>
have a look rules.* in the ipkg directory.
</sect>
</article></linuxdoc>
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment