Selaa lähdekoodia

Merge pull request #312 from jpeters/patch-1

Updated raspbian_jessie.md
Nicolas Marcq 7 vuotta sitten
vanhempi
commit
b1e58f2d1e
1 muutettua tiedostoa jossa 31 lisäystä ja 30 poistoa
  1. 31 30
      Docs/installation/raspbian_jessie.md

+ 31 - 30
Docs/installation/raspbian_jessie.md

@@ -2,14 +2,14 @@
 
 ## Install the pre-compiled disk image
 
-Download the last image [from the release page](https://github.com/kalliope-project/kalliope/releases) of Kalliope and load it as usual into your SD card.
+Download the last image [from the release page](https://github.com/kalliope-project/kalliope/releases) of Kalliope and load it as usual onto an SD card.
 
 **Login:** pi
 **Password:** raspberry
 
-Once installed, use the `raspi-config` command to expend the file system and fill the whole available space on your SD card.
-The SSH server is already active. You only need to get the ip of your Rpi via the command `ip a` and then connect via your favourite SSH client.
-We placed in `/home/pi` the two starter config we made for [French](https://github.com/kalliope-project/kalliope_starter_fr), [English](https://github.com/kalliope-project/kalliope_starter_en) and [German](https://github.com/kalliope-project/kalliope_starter_de).
+Once installed, use the `raspi-config` command to expand the file system and fill the available space on the SD card.
+The SSH server is enable by default. Get the IP of your Rpi via the command `ip a` and then connect via your favourite SSH client.
+The two starter config files are located in `/home/pi` for [French](https://github.com/kalliope-project/kalliope_starter_fr), [English](https://github.com/kalliope-project/kalliope_starter_en) and [German](https://github.com/kalliope-project/kalliope_starter_de).
 
 ## Manual installation
 
@@ -19,47 +19,47 @@ Supported Raspbian images:
 [raspbian-2017-01-10](http://downloads.raspberrypi.org/raspbian/images/raspbian-2017-01-10/)
 [raspbian-2017-04-10](http://downloads.raspberrypi.org/raspbian/images/raspbian-2017-04-10/)
 
-> **Note:** We recommend to use a **lite** installation of Raspbian without any graphical interface for a better experience. 
+> **Note:** It is recommended to use a **lite** installation of Raspbian without any graphical interface for a better experience. 
 
-> **Note:** The first Raspberry Pi is not officially supported. The installation will works but a single core with only 700Mhz may produce a some latencies.
+> **Note:** The first Raspberry Pi is not officially supported. The installation will works but a single core with only 700Mhz may produce latency.
 
 ### Debian packages requirements
 
-Install some required system libraries and software:
+Install the required system libraries and software:
 
 ```bash
 sudo apt-get update
 sudo apt-get install git python-dev libsmpeg0 libttspico-utils libsmpeg0 flac dialog libffi-dev libffi-dev libssl-dev portaudio19-dev build-essential libssl-dev libffi-dev sox libatlas3-base mplayer libyaml-dev libpython2.7-dev libav-tools
 ```
 
-Let's install the last release of python-pip
+Install the last release of python-pip:
 ```bash
 wget https://bootstrap.pypa.io/get-pip.py
 sudo python get-pip.py
 ```
 
-On a Raspberry Pi, pulseaudio is not installed by default
+On a Raspberry Pi, pulseaudio is not installed by default:
 ```bash
 sudo apt-get install pulseaudio pulseaudio-utils
 ```
 
-Start the pulseaudio server
+Start the pulseaudio server:
 ```bash
 pulseaudio -D
 ```
 
 ## Raspberry Pi configuration
 
-This part deals with the special configuration needed to get kalliope working on a RPi.
+This section deals with the special configuration needed to get kalliope working on a RPi.
 
 ### Microphone configuration
 
-Get your output card
+Get the output card:
 ```bash
 aplay -l
 ```
 
-Output example with a USB headset connected
+Output example with a USB headset connected:
 ```bash
 **** List of PLAYBACK Hardware Devices ****
 card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
@@ -80,17 +80,17 @@ card 1: Headset [Logitech USB Headset], device 0: USB Audio [USB Audio]
   Subdevice #0: subdevice #0
 ```
 
-Here, we can see that we have 
-- the analog audio (where the jack is connected) on the card 0 and device 1
+Here one shall see: 
+- the analog audio (where the jack is connected) on card 0 and device 1
 - usb audio on card 1 and device 1
 
 
-Get your input (microphone card)
+Get the input (microphone card):
 ```bash
 arecord -l
 ```
 
-Output example with a USB headset connected
+Output example with a USB headset connected:
 ```bash
 **** List of CAPTURE Hardware Devices ****
 card 1: Headset [Logitech USB Headset], device 0: USB Audio [USB Audio]
@@ -98,13 +98,13 @@ card 1: Headset [Logitech USB Headset], device 0: USB Audio [USB Audio]
   Subdevice #0: subdevice #0
 ```
 
-Here we can see that we have one peripheral on card 1 and device 0
+Here one shall see one peripheral on card 1 and device 0
 
-Now, we create a configuration file that will do apply the following configuration:
-- output audio (what Kalliope say) on the analog audio (via speakers connected to the jack)
-- input audio (what we say to Kalliope) on the USB microphone
+Create a configuration file that applies the following configuration:
+- output audio (what Kalliope says) on the analog audio (via speakers connected to the jack)
+- input audio (what is said to Kalliope) on the USB microphone
 
-Create a file in `/home/pi/.asoundrc` with the content bellow
+Create a file in `/home/pi/.asoundrc` with the content below
 ```
 pcm.!default {
    type asym
@@ -121,26 +121,27 @@ pcm.!default {
 
 Where `playback.pcm` is the output audio and the `capture.pcm` is the input audio.
 
-Restart alsa to apply changes
+Restart alsa to apply changes:
 ```bash
 sudo /etc/init.d/alsa-utils restart
 ```
 
-You can adjust the microphone sensibility by running alsamixer:
+Adjust the microphone sensibility by running alsamixer:
 ```bash
 alsamixer
 ```
-And then select your microphone device by pressing F6 and finally move up the `mic` sensibility level
+
+Select the microphone device by pressing F6 and move up the `mic` sensibility level:
 ![logo](../../images/alsamixer_mic_level.png)
 
-To ensure that you can record your voice, run the following command to capture audio input from your microphone
+To ensure voice recording, run the following command to capture audio input from the microphone:
 ```bash
 rec test.wav
 ```
 
-Press CTRL-C after capturing a sample of your voice.
+Press CTRL-C after capturing a voice sample.
 
-Then play the recorded audio file
+Play the recorded audio file:
 ```bash
 mplayer test.wav
 ```
@@ -148,11 +149,11 @@ mplayer test.wav
 
 ### HDMI / Analog audio
 
-By default the audio stream will get out by HDMI if something is plugged to this port.
+By default, the audio stream will use HDMI if something is plugged into this port.
 Check the [official documentation](https://www.raspberrypi.org/documentation/configuration/audio-config.md) to switch from HDMI to analog.
 
 ```bash
 sudo raspi-config
 ```
 
-Then, follow the [main installation documentation](../installation.md).
+Then follow the [main installation documentation](../installation.md).