Ver Fonte

add doc for Rpi install

nico há 8 anos atrás
pai
commit
24f9c64fe8
3 ficheiros alterados com 105 adições e 0 exclusões
  1. 101 0
      Docs/RPi.md
  2. 3 0
      Docs/dev_env_install.md
  3. 1 0
      README.md

+ 101 - 0
Docs/RPi.md

@@ -0,0 +1,101 @@
+# Raspberry Pi configuration
+
+This documentation deals with the special configuration needed for get kalliope working on a RPi.
+
+## Packages
+
+On a Raspberry Pi, pulseaudio is not installed by default
+```
+sudo apt-get install pulseaudio pulseaudio-utils
+```
+
+Start the pulseaudio server
+```
+pulseaudio -D
+```
+
+## Microphone configuration
+
+Get your output card
+```
+aplay -l
+```
+
+Output example with a USB headset connected
+```
+**** List of PLAYBACK Hardware Devices ****
+card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
+  Subdevices: 7/8
+  Subdevice #0: subdevice #0
+  Subdevice #1: subdevice #1
+  Subdevice #2: subdevice #2
+  Subdevice #3: subdevice #3
+  Subdevice #4: subdevice #4
+  Subdevice #5: subdevice #5
+  Subdevice #6: subdevice #6
+  Subdevice #7: subdevice #7
+card 0: ALSA [bcm2835 ALSA], device 1: bcm2835 ALSA [bcm2835 IEC958/HDMI]
+  Subdevices: 1/1
+  Subdevice #0: subdevice #0
+card 1: Headset [Logitech USB Headset], device 0: USB Audio [USB Audio]
+  Subdevices: 0/1
+  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
+- usb audio on card 1 and device 1
+
+
+Get your input (microphone card)
+```
+arecord -l
+```
+
+Output example with a USB headset connected
+```
+**** List of CAPTURE Hardware Devices ****
+card 1: Headset [Logitech USB Headset], device 0: USB Audio [USB Audio]
+  Subdevices: 0/1
+  Subdevice #0: subdevice #0
+```
+
+Here we can see that we have 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 file in `/home/pi/.asoundrc` with the content bellow
+```
+pcm.!default {
+   type asym
+   playback.pcm {
+     type plug
+     slave.pcm "hw:1,0"
+   }
+   capture.pcm {
+     type plug
+     slave.pcm "hw:1,0"
+   }
+}
+```
+
+Where `playback.pcm` is the output audio and the `capture.pcm` is the input audio.
+
+Restart alsa to apply changes
+```
+sudo /etc/init.d/alsa-utils restart
+```
+
+Do not forget to test recording your voice:
+
+Capture audio from your microphone
+```
+rec test.wav
+```
+
+Then play the recorded audio file
+```
+mplayer test.wav
+```

+ 3 - 0
Docs/dev_env_install.md

@@ -4,6 +4,7 @@ This documentation aims at explaining step by step manual deployment of Kalliope
 
 Tested env
 - Ubuntu 16.04
+- Raspbian Jessie 
 
 
 
@@ -42,3 +43,5 @@ Install libs
 ```
 sudo pip install -r install/files/python_requirements.txt
 ```
+
+If you are running kalliope on a Raspberry Pi, you must perform some other step by [following the dedicated documentation](RPi.md).

+ 1 - 0
README.md

@@ -22,6 +22,7 @@ Kalliope is easy-peasy to use, see the hello world
 
 - [Automated installation](Docs/automated_install.md)
 - [Manual installation for developement](Docs/dev_env_install.md)
+- [Raspberry Pi configuration](Docs/RPi.md)
 
 ## Usage