slitaz-forge view arm/index.html @ rev 511
arm: add setup guid for cross compiling
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Sat Apr 12 21:07:10 2014 +0200 (2014-04-12) |
| parents | 8603b3a44014 |
| children | b6820b2f1e49 |
line source
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <title>SliTaz ARM</title>
5 <meta charset="utf-8" />
6 <link rel="stylesheet" type="text/css" href="style.css" />
7 <link rel="shortcut icon" href="favicon.ico" />
8 </head>
9 <body>
11 <div id="header">
12 <div id="logo"></div>
13 <div id="network">
14 <!-- <a href="http://scn.slitaz.org/">SCN</a>-->
15 <a href="http://forum.slitaz.org/forum/arm">Forum</a>
16 <a href="http://bugs.slitaz.org/?arch=arm">Bugs</a>
17 <a href="http://hg.slitaz.org/slitaz-arm/summary">Hg</a>
18 <a href="http://cook.slitaz.org/cross/arm/">Cooker</a>
19 <a href="http://mirror.slitaz.org/arm/">Mirror</a>
20 </div>
21 <h1><a href="./">SliTaz ARM</a></h1>
22 </div>
24 <div id="block">
25 <!-- arm.slitaz.org navigation -->
26 <div id="block_nav">
28 <nav id="nav">
29 <a href="http://twitter.com/slitaz" title="Follow us on Twitter">
30 <img src="images/twitter.png" alt="Twitter" /></a>
31 <a href="codex/">Codex</a>
32 <a href="tools.cgi?pkgs">Packages</a>
33 <a href="rpi/">Raspberry Pi</a>
34 </nav>
36 </div>
37 <!-- Information/image -->
38 <div id="block_info">
39 <p>
40 <img src="images/generic.png" alt="generic.png" />
41 Official SliTaz GNU/Linux port to ARM
42 </p>
43 </div>
44 </div>
46 <!-- Content -->
47 <div id="content">
49 <h2>Welcome to SliTaz ARM</h2>
51 <img src="images/arm.png" alt="arm.png"
52 style="float: right; margin: 0 0 10px 20px;" />
53 <p>
54 This website provides information, notes and links about the
55 <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a> port to
56 the ARM architecture. SliTaz currently supports the ARM v6 (armel)
57 architecture and work is on the stove for armv6hf (hard float) and
58 armv7.
59 </p>
60 <p>
61 SliTaz ARM is supported by the official SliTaz project but with its
62 own boot scripts for faster start-up. A base system will use around
63 20mb of RAM. SliTaz can turn an ARM device into a music or web server,
64 a NAT, an IRC bot, a small desktop and much more.
65 </p>
67 <div style="text-align: center;">
68 <a href="images/shots/slitaz-rpi-jwm.png"><img
69 src="images/shots/slitaz-rpi-jwm_thumb.png"
70 alt="slitaz-rpi-jwm PNG" /></a>
71 <a href="images/shots/slitaz-rpi-e17.jpg"><img
72 src="images/shots/slitaz-rpi-e17_thumb.png"
73 alt="slitaz-rpi-e17 PNG" /></a>
74 <a href="images/shots/slitaz-rpi-e17-links.png"><img
75 src="images/shots/slitaz-rpi-e17-links_thumb.png"
76 alt="slitaz-rpi-links PNG" /></a>
77 </div>
79 <h2>Raspberry Pi</h2>
81 <p>
82 Currently the SliTaz official ARM port works on the Raspberry Pi and can
83 be used to setup a small server. DirectFB, Xorg, JWM, E17, Openbox and
84 the FOX toolkit is ported and provides a nice and light GUI support.
85 Sat-rpi lets advanced users create custom Rpi flavors with an official
86 Kernel, custom boot options and more.
87 </p>
89 <div class="box-rpi">
90 <a href="rpi/">SliTaz Raspberry Pi Home</a>
91 </div>
93 <h2>Build distros</h2>
95 <p>
96 To create some custom ARM SliTaz flavors we use a tool called 'sat'
97 which stands for SliTaz ARM Tool. Sat is a cmdline tool written
98 in SHell script and in the spirit of SliTaz, light, fast and easy to
99 use! Get the code via the Mercurial Hg repository or download the latest tarball:
100 <a href="http://hg.slitaz.org/slitaz-arm/archive/tip.tar.bz2">tip.tar.bz2</a>
101 </p>
103 <pre>
104 $ hg clone http://hg.slitaz.org/slitaz-arm
105 </pre>
107 <p>
108 You may want to browse the
109 <a href="http://hg.slitaz.org/slitaz-arm">slitaz-arm</a>
110 Hg repo and have a look at the
111 <a href="tools.cgi?doc&tool=sat">README</a> to get started. Once
112 sat is cloned and installed you can generate a distro with a single
113 command from your local slitaz-arm repo:
114 </p>
116 <pre>
117 # sat mirror && sat gen --flavor=arm-base
118 </pre>
120 <h2>Packages</h2>
122 <p>
123 All SliTaz ARM packages are automatically built by the
124 <a href="http://cook.slitaz.org/cross/arm/">ARM Cooker</a>. To properly
125 handle the SLITAZ_ARCH variable, the recommended Package Manager is
126 <a href="http://hg.slitaz.org/spk">spk</a>. One way to start
127 with the Spk Toolset is to generate a distro and include spk.
128 On a SliTaz ARM system you simply run 'spk-up --list' to get the
129 latest <a href="tools.cgi?pkgs">packages list</a>. The current ARM
130 packages mirror URL:
131 </p>
133 <div class="box-dl">
134 <a href="http://cook.slitaz.org/cross/arm/packages/"
135 >http://cook.slitaz.org/cross/arm/packages/</a>
136 </div>
138 <h2>SliTaz Tiny/Touch Screen</h2>
140 <img src="images/shots/sts-pitft.png" alt="sts-pitft.png"
141 style="float: right; margin: 4px 0 10px 20px;" />
143 <p>
144 The SliTaz Tiny/Touch Screen aka sts provide a suitable desktop for
145 small screens such as 320x240 TFT display. The screenshot shown sts
146 running on the Raspberry PiTFT touchscreen. The desktop is powered
147 by Openbox and LXpanel. All applications are started maximited and
148 without decoration.
149 </p>
150 <p>
151 To close windows and switch desktop you must use the hidden bottom
152 panel. Sts provide a small cmdline tool to handle custom tasks and
153 the sts-session script can be used to start an X session via startx
154 and ~/.xsession or the Slim login manager.
155 </p>
157 <pre>
158 $ sts help
159 </pre>
161 <h2>Prebuilt ARM Toolchain</h2>
163 <p>
164 To compile SliTaz packages to ARM you need a working cross compilation
165 toolchain. You can build your own with 'cross' or use our prebuilt
166 toolchains available from the SliTaz Mirror:
167 </p>
169 <div class="box-dl">
170 <a href="http://mirror.slitaz.org/arm/cross/"
171 >http://mirror.slitaz.org/arm/cross/</a>
172 </div>
174 <h2>Cross compiling</h2>
176 <p>
177 SliTaz provides all the necessary tools for cross compiling Open Source
178 software. The <a href="http://hg.slitaz.org/cookutils">cookutils</a>
179 package provides 'cross' which is used to create cross compilation
180 toolchains and 'cook' is used to cross compile SliTaz packages.
181 </p>
183 <p>
184 README, howto and docs: <a href="tools.cgi?doc&tool=cross">cross</a>
185 - <a href="tools.cgi?doc&tool=cook">cook</a>. Here is a quickstart
186 cmdline setup:
187 </p>
189 <pre>
190 Setup the build chroot
191 # tazdev gen-chroot --arch=arm
192 # tazdev -c --arch=arm
194 Setup the cross toolchain
195 # mkdir -p /cross && cd /cross
196 # wget http://mirror.slitaz.org/arm/cross/slitaz-arm-toolchain-20140304.tar.bz2
197 # tar xjf slitaz-arm-toolchain-20140304.tar.bz2
198 # cp -a slitaz-arm-toolchain-*/arm /cross
200 Check the toolchain installation
201 # export PATH=$PATH:/cross/arm/tools/bin
202 # arm-slitaz-linux-gnueabi-gcc -v
204 Setup cook environment:
205 # cook arm-setup
206 # cook setup --wok
208 Cross compile zlib and check testsuite output
209 # cook zlib
210 </pre>
212 <h2>ARM emulator</h2>
214 <p>
215 On SliTaz you need to install the 'qemu-arm' package which provides the
216 Qemu CPU emulator for the ARM platform. If you have built a distro
217 with the sat tool you can emulate it with:
218 </p>
220 <pre>
221 # sat emu
222 </pre>
224 <!-- Close content -->
225 </div>
227 <div id="footer">
228 © 2014 - <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
229 </div>
231 </body>
232 </html>