andpp/mopidy
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

docs: updates to the Raspberry Pi install guide.

Browse Source
This commit is contained in:
Nick Steel 2018-04-15 23:15:01 +01:00
parent 86e5e7d347
commit ba708001f4
2 changed files with 40 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/installation/debian.rst
View File

@ -16,11 +16,11 @@ from scratch, we have a guide for installing Debian/Raspbian and Mopidy. See
The packages are built for: The packages are built for:
- Debian jessie (stable), which also works for Raspbian jessie and Ubuntu 14.04 - Debian stretch (stable), which also works for Raspbian stretch and Ubuntu
LTS and newer. 16.04 LTS and newer.
The packages are available for multiple CPU architectures: i386, amd64, armel, The packages are available for multiple CPU architectures: i386, amd64, armel,
and armhf (compatible with Raspberry Pi 1 and 2). and armhf (compatible with all Raspberry Pi models).
.. note:: .. note::
@ -35,16 +35,17 @@ and armhf (compatible with Raspberry Pi 1 and 2).
#. Add the APT repo to your package sources:: #. Add the APT repo to your package sources::
sudo wget -q -O /etc/apt/sources.list.d/mopidy.list https://apt.mopidy.com/jessie.list sudo wget -q -O /etc/apt/sources.list.d/mopidy.list https://apt.mopidy.com/stretch.list
#. Install Mopidy and all dependencies:: #. Install Mopidy and all dependencies::
sudo apt-get update sudo apt-get update
sudo apt-get install mopidy sudo apt-get install mopidy
#. Finally, you need to set a couple of :doc:`config values </config>`, and then #. Finally, you need to set a couple of :doc:`config values </config>`, and
you're ready to :doc:`run Mopidy </running>` or run Mopidy as a then you're ready to :doc:`run Mopidy </running>`. Alternatively you may
:ref:`service <service>`. want to have Mopidy run as a :ref:`system service <service>`, automatically
starting at boot.
When a new release of Mopidy is out, and you can't wait for you system to When a new release of Mopidy is out, and you can't wait for you system to
figure it out for itself, run the following to upgrade right away:: figure it out for itself, run the following to upgrade right away::

65
docs/installation/raspberrypi.rst
View File

@ -5,23 +5,23 @@ Raspberry Pi
************ ************
Mopidy runs on all versions of `Raspberry Pi <https://www.raspberrypi.org/>`_. Mopidy runs on all versions of `Raspberry Pi <https://www.raspberrypi.org/>`_.
However, note that Raspberry Pi 2 B's CPU is approximately six times as However, note that the Raspberry Pi 2 and 3 are significantly more powerful than
powerful as Raspberry Pi 1 and Raspberry Pi Zero, so Mopidy will be more joyful the Raspberry Pi 1 and Raspberry Pi Zero; Mopidy will run noticably faster on
to use on a Raspberry Pi 2. the later models.
.. image:: raspberrypi2.jpg .. image:: raspberrypi2.jpg
:width: 640 :width: 640
:height: 363 :height: 363
How to for Raspbian Jessie How to for Raspbian
========================== ===================
#. Download the latest Jessie or Jessie Lite disk image from #. Download the latest Raspbian Desktop or Lite disk image from
http://www.raspberrypi.org/downloads/raspbian/. http://www.raspberrypi.org/downloads/raspbian/.
If you're only using your Pi for Mopidy, go with Jessie Lite as you won't Unless you need a full graphical desktop the Lite image is preferable since
need the full graphical desktop included in the Jessie image. it's much smaller.
#. Flash the Raspbian image you downloaded to your SD card. #. Flash the Raspbian image you downloaded to your SD card.
@ -32,12 +32,11 @@ How to for Raspbian Jessie
You'll need to enable SSH if you are not connecting a monitor and a keyboard. You'll need to enable SSH if you are not connecting a monitor and a keyboard.
As of the November 2016 release, Raspbian has the SSH server disabled by As of the November 2016 release, Raspbian has the SSH server disabled by
default. SSH can be enabled by placing a file named 'ssh', without any default. SSH can be enabled by placing a file named 'ssh', without any
extension, onto the boot partition of the SD card. extension, onto the boot partition of the SD card. See `here
<https://www.raspberrypi.org/documentation/remote-access/ssh/README.md>`_ for
more details.
#. If you connect a monitor and a keyboard, you'll see that the Pi boots right #. If you boot with only a network cable connected, you'll have to find the IP
into the ``raspi-config`` tool.
If you boot with only a network cable connected, you'll have to find the IP
address of the Pi yourself, e.g. by looking in the client list on your address of the Pi yourself, e.g. by looking in the client list on your
router/DHCP server. When you have found the Pi's IP address, you can SSH to router/DHCP server. When you have found the Pi's IP address, you can SSH to
the IP address and login with the user ``pi`` and password ``raspberry``. the IP address and login with the user ``pi`` and password ``raspberry``.
@ -47,32 +46,37 @@ How to for Raspbian Jessie
#. Use the ``raspi-config`` tool to setup the basics of your Pi. You might want #. Use the ``raspi-config`` tool to setup the basics of your Pi. You might want
to do one or more of the following: to do one or more of the following:
- Expand the file system to fill the SD card.
- Change the password of the ``pi`` user. - Change the password of the ``pi`` user.
- Change the time zone. - Change the language, time zone, etc.
Under "Advanced Options": Under "Advanced Options":
- Set a hostname. - Set a hostname.
- Enable SSH if not already enabled. - Enable SSH if not already enabled.
- If your will use HDMI for display and 3.5mm jack for audio, force the - Force a specific audio output.
audio output to the 3.5mm jack. By default it will use HDMI for audio By default, when using a HDMI display the
output if an HDMI cable is connected and the 3.5mm jack if not. audio will also be output over HDMI, otherwise the 3.5mm jack will be used.
- Adjust the memory split.
If you're not using a display (i.e. Raspbian
Lite), you should set the minimum value here in order to make best use of
the available RAM.
Once done, select "Finish" and restart your Pi. Once done, select "Finish". Depending on what you changed you may be asked if
you want to restart your Pi, select "Yes" and then log back in again
afterwards.
If you want to change any settings later, you can simply rerun ``sudo If you want to change any settings later, you can simply rerun ``sudo
raspi-config``. raspi-config``.
#. Once you've rebooted and has logged in as the ``pi`` user, you can enter
``sudo -i`` to become ``root``.
#. Install Mopidy and its dependencies as described in :ref:`debian-install`. #. Install Mopidy and any Mopidy extensions you want, as described in
:ref:`debian-install`.
#. Finally, you need to set a couple of :doc:`config values </config>`, and .. note::
then you're ready to :doc:`run Mopidy </running>`. Alternatively you may
want to have Mopidy run as a :ref:`system service <service>`, automatically If you used the Raspbian *Desktop* image you may also need to add the
starting at boot. ``mopidy`` user to the ``video`` group. Run ``sudo adduser mopidy video``
to do this.
Testing sound output Testing sound output
@ -84,10 +88,5 @@ You can test sound output independent of Mopidy by running::
If you hear a voice saying "Front Center", then your sound is working. If you hear a voice saying "Front Center", then your sound is working.
If you want to change your audio output setting, simply rerun ``sudo If you want to change your audio output setting, simply rerun ``sudo
raspi-config``. Alternatively, you can change the audio output setting raspi-config``.
directly by running:
- Auto (HDMI if connected, else 3.5mm jack): ``sudo amixer cset numid=3 0``
- Use 3.5mm jack: ``sudo amixer cset numid=3 1``
- Use HDMI: ``sudo amixer cset numid=3 2``