slitaz-forge rev 540

arm: edit pibook
author Paul Issott <paul@slitaz.org>
date Thu May 01 20:51:50 2014 +0100 (2014-05-01)
parents 40ad99b9e839
children a0cc5234d537
files arm/codex/pibook.html
line diff
     1.1 --- a/arm/codex/pibook.html	Thu May 01 16:45:34 2014 +0000
     1.2 +++ b/arm/codex/pibook.html	Thu May 01 20:51:50 2014 +0100
     1.3 @@ -39,9 +39,9 @@
     1.4  
     1.5  <p>
     1.6  	With the PiBook you will learn how to get started with SliTaz ARM and 
     1.7 -	the Raspberry Pi, configure the system, install additionnal software
     1.8 +	the Raspberry Pi, configure the system, install additional software
     1.9  	packages, setup a custom desktop and use pre-installed applications.
    1.10 -	The book also cover GPIO usage, boards setup such has the official
    1.11 +	The book also covers GPIO usage and boards setup such as the official
    1.12  	Raspberry Pi Camera or PiGlow, and basic electronic usage.
    1.13  </p>
    1.14  
    1.15 @@ -53,7 +53,7 @@
    1.16  	<li><a href="#update">System &amp; kernel update</a></li>
    1.17  	<li><a href="#add-apps">Installing new packages</a></li>
    1.18  	<li><a href="#def-apps">Installed applications</a></li>
    1.19 -	<li><a href="#pi-pkgs">Rasperry Pi packages</a></li>
    1.20 +	<li><a href="#pi-pkgs">Raspberry Pi packages</a></li>
    1.21  	<li><a href="#remote">GUI &amp; secure remote control</a></li>
    1.22  	<li><a href="#setup">Pi setup suggestions</a></li>
    1.23  	<li><a href="#desktop">Desktop customization</a></li>
    1.24 @@ -63,7 +63,7 @@
    1.25  </ul>
    1.26  
    1.27  <p>
    1.28 -	The Pibook is completed by the general documentation found in the
    1.29 +	The Pibook is complemented by the general documentation found in the
    1.30  	<a href="./.">SliTaz ARM Codex</a>.
    1.31  </p>
    1.32  
    1.33 @@ -90,10 +90,10 @@
    1.34  <p>
    1.35  	On the first SliTaz Raspberry Pi boot you will be prompted to configure
    1.36  	basic system settings such as the system keymap and the root password.
    1.37 -	Then you will prompt to create the default user with it password.
    1.38 +	Then you will be prompted to create the default user with its password.
    1.39  </p>
    1.40  <p>
    1.41 -	On any secure GNU/Linux system the will have a leat the administrator
    1.42 +	On any secure GNU/Linux system you will have to have at least the administrator
    1.43  	(root) and the default human user. In this way, users can fully use
    1.44  	the system but can't break it.
    1.45  </p>
    1.46 @@ -107,16 +107,16 @@
    1.47  <h2 id="config">System configuration</h2>
    1.48  
    1.49  <p>
    1.50 -	All SliTaz Raspberry Pi basic configuration can be done via a nice
    1.51 +	All SliTaz Raspberry Pi basic configurations can be done via a nice
    1.52  	Ncurses driven GUI with mouse support under an X session and via
    1.53  	a CGI/web administration interface. Please check the detailed 
    1.54 -	<a href="#remote">remote control section</a> on the book for more 
    1.55 +	<a href="#remote">remote control section</a> in the book for more 
    1.56  	information about the CGI/Web control panel.
    1.57  </p>
    1.58  
    1.59  <pre class="box-up">
    1.60  tazberry      : Dedicated tool for all Raspberry Pi specific configs
    1.61 -slitaz-config : Slitaz system configs such as keymaps, lang, users.
    1.62 +slitaz-config : Slitaz system configs such as keymaps, lang, users
    1.63  </pre>
    1.64  
    1.65  <p>
    1.66 @@ -133,35 +133,35 @@
    1.67  
    1.68  <p>
    1.69  	The Raspberry Pi has two audio output modes: HDMI and headphone jack.
    1.70 -	You can switch between these modes at any time. SliTaz Raspberry Pi
    1.71 -	provide a custom web admin plugin to graphicaly configure and check
    1.72 -	audio setting locally or remotly. The web audion control let you 
    1.73 -	switch audion output and paly a sound to test settings. You can directly
    1.74 -	access to the audio control panel with an URL in form of:
    1.75 +	You can switch between these two modes at any time. SliTaz Raspberry Pi
    1.76 +	provides a custom web admin plugin to graphically configure and check
    1.77 +	audio settings locally or remotely. The web audio control lets you 
    1.78 +	switch audio output and play a sound to test settings. You can directly
    1.79 +	access the audio control panel with a URL in the form of:
    1.80  </p>
    1.81  <pre>
    1.82  http://192.168.x.xxx/adm/tools.cgi?audio
    1.83  </pre>
    1.84  <p>
    1.85 -	You can also configure the Raspberry Pi audio outout from the command 
    1.86 -	line wher the last number is the output mode (0=auto 1=jack 2=hdmi):
    1.87 +	You can also configure the Raspberry Pi audio output from the command 
    1.88 +	line where the last number is the output mode (0=auto 1=jack 2=hdmi):
    1.89  </p>
    1.90  <pre>
    1.91  # amxier cset numid=3 1
    1.92  </pre>
    1.93  <p>
    1.94 -	The desktop flavor include Alsa audio mixer and mpg123 cmdline
    1.95 +	The desktop flavor includes Alsa audio mixer and mpg123 cmdline
    1.96  	audio player. Please check the Codex apps page for a common list of 
    1.97  	<a href="apps.html#multimedia">multimedia applications</a>.
    1.98  </p>
    1.99  
   1.100  <h2 id="update">System &amp; kernel update</h2>
   1.101  <p>
   1.102 -	It is always a good idea to check for update! It will bring you fixes
   1.103 +	It is always a good idea to check for updates! It will bring you fixes
   1.104  	and new features. With SliTaz Raspberry Pi you have to upgrade all
   1.105 -	the installed packages and the custom Linux Kernel. Udate can be done
   1.106 +	the installed packages and the custom Linux Kernel. Updates can be done
   1.107  	via spk-dialog and tazberry found in the "System Tools menu" or directly
   1.108 -	from the command line:
   1.109 +	from a command line:
   1.110  </p>
   1.111  <pre>
   1.112  # spk-dialog
   1.113 @@ -172,7 +172,7 @@
   1.114  
   1.115  <p>
   1.116  	After your system is configured and connected to the web, you may want
   1.117 -	to install new packages to add functionnylities to your SliTaz system.
   1.118 +	to install new packages to add functionality to your SliTaz system.
   1.119  	You can install new applications via spk-dialog GUI or from the command
   1.120  	line with spk-add:
   1.121  </p>
   1.122 @@ -181,7 +181,7 @@
   1.123  </pre>
   1.124  <p>
   1.125  	You can find a list of packages on the SliTaz Raspberry Pi website
   1.126 -	or using spk-find utility. You can search by package name, keywork
   1.127 +	or by using the spk-find utility. You can search by package name, keyword
   1.128  	or description:
   1.129  </p>
   1.130  <pre>
   1.131 @@ -191,21 +191,21 @@
   1.132  <h2 id="def-apps">Installed applications</h2>
   1.133  
   1.134  <p>
   1.135 -	SliTaz Raspberry Pi can come in many flavor with a custom pre-installed
   1.136 -	packages set. This section will cover the base and desktop flavor, more
   1.137 -	information about a spécific flavor max be found on the SliTaz Raspberry
   1.138 +	SliTaz Raspberry Pi can come in many flavors with a custom pre-installed
   1.139 +	packages set. This section will cover the base and desktop flavors, more
   1.140 +	information about a spécific flavor may be found on the SliTaz Raspberry
   1.141  	Pi website.
   1.142  </p>
   1.143  
   1.144  <h3>Base system</h3>
   1.145  <p>
   1.146 -	The base flavor provide a text mode system with cmdline only tools, all
   1.147 -	Busybox applets are present. It support for wireless network but no sound.
   1.148 -	The default and most usefull applications are:
   1.149 +	The base flavor provides a text mode system with cmdline only tools, all
   1.150 +	Busybox applets are present. It supports wireless networks but no sound.
   1.151 +	The default and most useful applications are:
   1.152  </p>
   1.153  
   1.154  <ul>
   1.155 -	<li>Dropber SSH client &amp; server</li>
   1.156 +	<li>Dropbear SSH client &amp; server</li>
   1.157  	<li>Busybox HTTPd, NTPd, FTPd servers</li>
   1.158  	<li>The CGI/Web admin interface and TazBerry</li>
   1.159  	<li>Clex file manager and Lynx web browser</li>
   1.160 @@ -215,44 +215,44 @@
   1.161  
   1.162  <h3>Desktop environment</h3>
   1.163  <p>
   1.164 -	The SliTaz Raspberry Pi desktop flavor focus on providing a fast, 
   1.165 -	elegent, and easy to use desktop enviromnent. The desktop is powerd
   1.166 -	by JWM window manger, you will all the base applications plus GUI
   1.167 +	The SliTaz Raspberry Pi desktop flavor focuses on providing a fast, 
   1.168 +	elegant, and easy to use desktop environment. The desktop is powered
   1.169 +	by JWM window manger and you will find all the base applications plus GUI
   1.170  	programs:
   1.171  </p>
   1.172  
   1.173  <ul>
   1.174  	<li>Text editors: Adie + FLTK Editor</li>
   1.175  	<li>File manager: PathFinder</li>
   1.176 -	<li>Web browsesr: Dillo</li>
   1.177 +	<li>Web browser: Dillo</li>
   1.178  	<li>X terminal: Xterm</li>
   1.179  	<li>Audio mixer: Alsamixer</li>
   1.180  	<li>Audio player: mpg123</li>
   1.181  	<li>2 nice games: Blocks Attack + Sudoku</li>
   1.182 -	<li>Fluid FLTK GUI desinger</li>
   1.183 +	<li>Fluid FLTK GUI designer</li>
   1.184  	<li>Lua programming language</li>
   1.185  	<li>SQLite database support</li>
   1.186  	<li>Htop processes monitor</li>
   1.187  </ul>
   1.188  
   1.189 -<h2 id="pi-pkgs">Rasperry Pi Packages</h2>
   1.190 +<h2 id="pi-pkgs">Raspberry Pi Packages</h2>
   1.191  
   1.192  <p>
   1.193 -	Some custom tools and libraries have been package specially for the
   1.194 +	Some custom tools and libraries have been packaged specially for the
   1.195  	SliTaz Raspberry Pi distribution. Here is a list of packages and
   1.196  	a short description:
   1.197  </p>
   1.198  
   1.199  <ul>
   1.200 -	<li>slitaz-arm-rpi - Provide the CGI/adm plugins, tazberry and custom
   1.201 +	<li>slitaz-arm-rpi - Provides the CGI/adm plugins, tazberry and custom
   1.202  	config files.</li>
   1.203  	
   1.204 -	<li>raspberrypi-boot - Provide the R-Pi bootloader firmware.</li>
   1.205 +	<li>raspberrypi-boot - Provides the R-Pi bootloader firmware.</li>
   1.206  	
   1.207 -	<li>raspberrypi-boot-x - Provide the R-Pi bootloader firmware with 
   1.208 +	<li>raspberrypi-boot-x - Provides the R-Pi bootloader firmware with 
   1.209  	Pi Camera support.</li>
   1.210  	
   1.211 -	<li>raspberrypi-vc -Raspberry Pi VideoCore Tools, includind 
   1.212 +	<li>raspberrypi-vc -Raspberry Pi VideoCore Tools, including
   1.213  	raspistill and raspivid.</li>
   1.214  	
   1.215  	<li>gst-omx - A gstreamer-1.0 plugin which can do hardware-accelerated 
   1.216 @@ -261,30 +261,30 @@
   1.217  	<li>wiringpi - A GPIO access library written in C for the BCM2835 
   1.218  	used in the Raspberry Pi.</li>
   1.219  	
   1.220 -	<li>wiringpi-piglow - The WiringPi tool for PiGlow, usefull to handle
   1.221 +	<li>wiringpi-piglow - The WiringPi tool for PiGlow, useful to handle
   1.222  	leds from SHell scripts.</li>
   1.223  	
   1.224  	<li>picamera - Provides a pure Python interface to the Raspberry 
   1.225 -	Pi camera module</li>
   1.226 +	Pi camera module.</li>
   1.227  	
   1.228  	<li>libbcm2835 - Provides access to GPIO and other IO functions on 
   1.229  	the Broadcom BCM 2835 chip.</li>
   1.230  	
   1.231 -	<li>rcswitch-pi - RCSwitch implementation for the Raspberry Pi</li>
   1.232 +	<li>rcswitch-pi - RCSwitch implementation for the Raspberry Pi.</li>
   1.233  	
   1.234 -	<li>python-rpi-gpio - Python class to control the GPIO on a Raspberry Pi</li>
   1.235 +	<li>python-rpi-gpio - Python class to control the GPIO on a Raspberry Pi.</li>
   1.236  	
   1.237 -	<li>python-rpi-pyglow - Control Piglow from Python. Include a custom 
   1.238 +	<li>python-rpi-pyglow - Control Piglow from Python. Includes a custom 
   1.239  	SliTaz utility to easily play with PiGlow.</li>
   1.240  	
   1.241 -	<li>(xorg-xf86-video-fbturbo) - Buggy Xorg server module for the R-Pi</li>
   1.242 +	<li>(xorg-xf86-video-fbturbo) - Buggy Xorg server module for the R-Pi.</li>
   1.243  </ul>
   1.244  
   1.245  <h2 id="remote">GUI &amp; secure remote control</h2>
   1.246  
   1.247  <p>
   1.248 -	This section will cover remote control using SliTaz CGI/Web admin
   1.249 -	interface, SSH secure SHell connection and graphical desktop control
   1.250 +	This section will cover remote control using the SliTaz CGI/Web admin
   1.251 +	interface, SSH secure SHell connections and graphical desktop control
   1.252  	with VNC.
   1.253  </p>
   1.254  
   1.255 @@ -292,23 +292,23 @@
   1.256  
   1.257  <p>
   1.258  	The CGI/Web interface is a nice way to control your Raspberry Pi machine
   1.259 -	usind Dillo from the desktop or any web browser from an other computer,
   1.260 +	using Dillo from the desktop or any web browser from another computer,
   1.261  	mobile or tablet device. Remote control via the CGI interface is enabled
   1.262 -	by default. To stop/start the service or use an other port, please refer
   1.263 +	by default. To stop/start the service or to use another port, please refer
   1.264  	to the SliTaz ARM Codex: <a href="system.html#cgi-adm">System page</a>
   1.265  </p>
   1.266  
   1.267  <p>
   1.268 -	SliTaz Raspberry Pi provide plugins to easily handle your Pi, in a nifty
   1.269 +	SliTaz Raspberry Pi provides plugins to easily handle your Pi. In a nifty
   1.270  	and clean interface you can: poweroff/reboot the system, configure boot
   1.271  	settings including blacklisted modules, set audio output and test sound,
   1.272 -	play with GPIO pins and get I2C information, turn on/off the green led :-)
   1.273 -	The tool let you do quiet a few more handy actions that you will discover
   1.274 -	browsinf the interface.
   1.275 +	play with GPIO pins and get I2C information, and turn on/off the green led :-)
   1.276 +	The tool lets you do quite a few more handy actions that you will discover
   1.277 +	browsing the interface.
   1.278  </p>
   1.279  
   1.280  <p>
   1.281 -	You must first found out the local IP address of you Raspberry Pi machine.
   1.282 +	First you must found out the local IP address of you Raspberry Pi machine.
   1.283  	On your SliTaz Pi you can use 'ipinfo' to get the IP, then connect using
   1.284  	this IP. To connect you must use 'root' as user name with the correct
   1.285  	system administrator password.
   1.286 @@ -319,10 +319,10 @@
   1.287  
   1.288  <h3>Secure SSH connection</h3>
   1.289  <p>
   1.290 -	By default all flavors provide Dropbear Secure SHell, a lighteight but
   1.291 -	powerfull and standard compliant SSH client and server. The server is
   1.292 -	not started by default, you van start it manually from the cmdline and
   1.293 -	edit /etc/init.d/rcS.conf to start it automaticaly on each boot:
   1.294 +	By default all flavors provide Dropbear Secure SHell, a lightweight but
   1.295 +	powerful and standard compliant SSH client and server. The server is
   1.296 +	not started by default, you can start it manually from the cmdline and
   1.297 +	edit /etc/init.d/rcS.conf to start it automatically on each boot:
   1.298  </p>
   1.299  <pre>
   1.300  # startd dropbear
   1.301 @@ -331,8 +331,8 @@
   1.302  
   1.303  <h3>VNC Desktop control</h3>
   1.304  <p>
   1.305 -	VNC is geate tool letting you remotly control a desktop. The steps are:
   1.306 -	install and start the VNV server on your Pi, install a VNC client on
   1.307 +	VNC is great tool for letting you remotely control a desktop. The steps are:
   1.308 +	install and start the VNC server on your Pi, install a VNC client on
   1.309  	your desktop machine, mobile phone or tablet. To install the server
   1.310  	and start it on your Raspberry Pi (via an SSH connection or with an
   1.311  	attached keyboard and screen):
   1.312 @@ -345,22 +345,22 @@
   1.313  <h2 id="setup">Pi setup suggestions</h2>
   1.314  
   1.315  <p>
   1.316 -	What can you do with you SliTaz Raspberry Pi distro ? Use it as a tiny
   1.317 +	What can you do with your SliTaz Raspberry Pi distro? Use it as a tiny
   1.318  	desktop! Learn Linux, Lua, Python, SHell scripting. Play with some
   1.319 -	electronics circuits, sensors, leds and Raspberry Pi plugable boards.
   1.320 -	Setup servers, use the cam for fun or security purpose, create a secure
   1.321 +	electronics circuits, sensors, leds and Raspberry Pi pluggable boards.
   1.322 +	Setup servers, use the cam for fun or security purposes, create a secure
   1.323  	wifi network, ...- So much can be done with a Pi! 
   1.324  </p>
   1.325  
   1.326  <ul>
   1.327 -	<li>Kids learning computer with Scratch and games</li>
   1.328 +	<li>Kids learn about computers with Scratch and games</li>
   1.329  	<li>Web server with SHell and Python CGI support</li>
   1.330  	<li>Secure and anonymous wifi network with Tor</li>
   1.331  	<li>Development system including a wide range of tools</li>
   1.332 -	<li>Electronic circuits playground with breadboard</li>
   1.333 +	<li>Electronic circuits playground with breadboards</li>
   1.334  	<li>Security camera with infra red support</li>
   1.335  	<li>Audio player and streamer with MPD</li>
   1.336 -	<li>Video player with MPlayer or gst-omx (provide hardware 
   1.337 +	<li>Video player with MPlayer or gst-omx (provides hardware 
   1.338  	accelerated decoding on the Raspberry Pi)</li>
   1.339  	<li>Video streamer with gst-omx or ffserver</li>
   1.340  	<li><a href="setup.html">Codex setup guides</a></li>
   1.341 @@ -370,16 +370,16 @@
   1.342  
   1.343  <p>
   1.344  	Your SliTaz Raspberry Pi Desktop can be customized to infinity! With
   1.345 -	a little edit of configuration files and autostart script you can
   1.346 +	a little editing of configuration files and autostart scripts you can
   1.347  	configure the entire environment. The default window manager is
   1.348  	JWM, but it can be replaced by OpenBox, Enlightenment (e17) or the
   1.349  	DWM dynamic window manager.
   1.350  </p>
   1.351  
   1.352  <p>
   1.353 -	JWM autostarted applications and theme is set in a xml.jwmrc file.
   1.354 -	By default the system wide config is used, let copy it to your home
   1.355 -	folder as .jwmrc hidden file and then edit it:
   1.356 +	JWM autostarted applications and themes are set in a xml.jwmrc file.
   1.357 +	By default the system wide config is used, lets copy it to your home
   1.358 +	folder as a .jwmrc hidden file and then edit it:
   1.359  </p>
   1.360  <pre>
   1.361  $ cp /etc/xdg/jwm/system.jwmrc ~/.jwmrc
   1.362 @@ -387,7 +387,7 @@
   1.363  </pre>
   1.364  <p>
   1.365  	The system wide menu path is: <b>/etc/xdg/jwm/menus.jwmrc</b> and
   1.366 -	is updated by SliTaz packages manager. You can also copy it in
   1.367 +	is updated by SliTaz packages manager. You can also copy it to
   1.368  	your home folder if you want to customize it. See the official 
   1.369  	<a href="http://joewing.net/projects/jwm/config.shtml">configuration documentation</a>
   1.370  	for comprehensive documentation on configuring JWM.
   1.371 @@ -414,10 +414,10 @@
   1.372  <h2 id="gpio">GPIO Pins &amp; I2C Bus</h2>
   1.373  
   1.374  <p>
   1.375 -	SliTaz provide all the necessary tools to work with the Raspberry Pi
   1.376 -	GPIO pins and I2C bus. The CGI/Web admin interface let you control
   1.377 -	the GPIO pins and get I2C informations. Pi I2C kernel module is
   1.378 -	blacklisted by default and can be load manually, on-demand by scripts
   1.379 +	SliTaz provides all the necessary tools to work with the Raspberry Pi
   1.380 +	GPIO pins and I2C bus. The CGI/Web admin interface lets you control
   1.381 +	the GPIO pins and get I2C information. Pi I2C kernel module is
   1.382 +	blacklisted by default and can be loaded manually, by on-demand scripts
   1.383  	or at boot by commenting the blacklist line in:
   1.384  </p>
   1.385  <pre class="box-up">
   1.386 @@ -427,16 +427,16 @@
   1.387  <h2 id="picam">Pi Camera - Pi NoIR</h2>
   1.388  
   1.389  <p>
   1.390 -	Rspberry Pi onboard camera work flowlessly with SliTaz. You can
   1.391 +	Raspberry Pi onboard camera works flawlessly with SliTaz. You can
   1.392  	setup then shot, record and stream video with our easy to use and
   1.393 -	home made tools and he official VideoCore Tools from The Raspberry Pi
   1.394 +	home made tools and the official VideoCore Tools from The Raspberry Pi
   1.395  	foundation. Official documentation can be found on elinux.org wiki:
   1.396  	<a href="http://elinux.org/Rpi_Camera_Module">Rpi Camera Module</a>
   1.397  </p>
   1.398  
   1.399  <p>
   1.400  	To setup your camera from your Pi device, you can run TazBerry from
   1.401 -	the desktop menu or directly start the the cam setup from cmdline:
   1.402 +	the desktop menu or directly start the cam setup from a cmdline:
   1.403  </p>
   1.404  <pre>
   1.405  # tazberry cam-setup
   1.406 @@ -454,9 +454,9 @@
   1.407  
   1.408  <p>
   1.409  	PiGlow is a fun and cheap little board to learn and play with leds. It
   1.410 -	can do very nice effect, support easy on/off switch and brightness
   1.411 -	setting. Plug in you PiGlow board, boot you Raspberry Pi, intall Python
   1.412 -	PyGlow examples and utility and testsuite:
   1.413 +	can do very nice effects, support easy on/off switches and brightness
   1.414 +	settings. Plug in your PiGlow board, boot your Raspberry Pi, install the Python
   1.415 +	PyGlow examples and utilities and testsuite:
   1.416  </p>
   1.417  
   1.418  <pre>