Skip to content

Instantly share code, notes, and snippets.

@0xMDIV
Forked from mill1000/README.md
Created October 2, 2019 21:36
Show Gist options
  • Save 0xMDIV/47875bc2c7d2e2c34b0a78be5bfd2bc5 to your computer and use it in GitHub Desktop.
Save 0xMDIV/47875bc2c7d2e2c34b0a78be5bfd2bc5 to your computer and use it in GitHub Desktop.

Revisions

  1. @mill1000 mill1000 revised this gist Jul 9, 2019. 1 changed file with 2 additions and 1 deletion.
    3 changes: 2 additions & 1 deletion bt-agent-a2dp.service
    Original file line number Diff line number Diff line change
    @@ -4,10 +4,11 @@ After=bluetooth.service
    Wants=bluetooth.service

    [Service]
    ExecStartPre=/bin/sh -c "echo discoverable on | bluetoothctl"
    ExecStart=/usr/bin/python -u /usr/local/bin/a2dp-agent
    StandardOutput=syslog
    StandardError=syslog
    SyslogIdentifier=A2DP-Agent

    [Install]
    WantedBy=multi-user.target
    WantedBy=bluetooth.service
  2. @mill1000 mill1000 revised this gist Jul 9, 2019. 1 changed file with 1 addition and 0 deletions.
    1 change: 1 addition & 0 deletions README.md
    Original file line number Diff line number Diff line change
    @@ -94,6 +94,7 @@ Now run the following command to enable the A2DP Agent service
    ```
    sudo systemctl enable bt-agent-a2dp.service
    ```
    Thanks to @matthijskooijman for fixing up some issues in the Bluetooth Agent service.

    Bluetooth devices should now be able to discover, pair and connect to the Raspberry Pi without any user intervention.

  3. @mill1000 mill1000 revised this gist Apr 11, 2019. 1 changed file with 6 additions and 1 deletion.
    7 changes: 6 additions & 1 deletion README.md
    Original file line number Diff line number Diff line change
    @@ -68,6 +68,8 @@ sudo chmod +x /usr/local/bin/a2dp-agent

    ### Testing The Agent
    Before continuing, verify that the agent is functional. The Raspberry Pi should be discoverable, pairable and recognized as an audio device.

    Note: At this point the device will not output any audio. This step is only to verify the Bluetooth is discoverable and bindable.
    1. Manually run the agent by executing
    ```
    sudo /usr/local/bin/a2dp-agent
    @@ -114,4 +116,7 @@ Now run the following command to enable A2DP Playback service
    sudo systemctl enable a2dp-playback.service
    ```

    Reboot and enjoy!
    Reboot and enjoy!

    ## Low Volume Output
    If you are experiencing low volume output, run `alsamixer` and increase the volume of the Pi's soundcard.
  4. @mill1000 mill1000 renamed this gist Dec 8, 2017. 1 changed file with 0 additions and 0 deletions.
  5. @mill1000 mill1000 renamed this gist Dec 8, 2017. 1 changed file with 0 additions and 0 deletions.
  6. @mill1000 mill1000 renamed this gist Dec 8, 2017. 1 changed file with 0 additions and 0 deletions.
    File renamed without changes.
  7. @mill1000 mill1000 revised this gist Dec 8, 2017. 2 changed files with 28 additions and 0 deletions.
    15 changes: 15 additions & 0 deletions a2dp-playback.service
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,15 @@
    [Unit]
    Description=A2DP Playback
    After=bluealsa.service syslog.service
    Requires=bluealsa.service

    [Service]
    ExecStartPre=/bin/sleep 3
    ExecStart=/usr/bin/bluealsa-aplay --profile-a2dp 00:00:00:00:00:00
    StandardOutput=syslog
    StandardError=syslog
    SyslogIdentifier=A2DP-Playback
    User=pi

    [Install]
    WantedBy=multi-user.target
    13 changes: 13 additions & 0 deletions bt-agent-a2dp.service
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,13 @@
    [Unit]
    Description=A2DP Bluetooth Agent
    After=bluetooth.service
    Wants=bluetooth.service

    [Service]
    ExecStart=/usr/bin/python -u /usr/local/bin/a2dp-agent
    StandardOutput=syslog
    StandardError=syslog
    SyslogIdentifier=A2DP-Agent

    [Install]
    WantedBy=multi-user.target
  8. @mill1000 mill1000 revised this gist Dec 8, 2017. 1 changed file with 99 additions and 0 deletions.
    99 changes: 99 additions & 0 deletions a2dp-agent
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,99 @@
    #!/usr/bin/python

    from __future__ import absolute_import, print_function, unicode_literals

    import sys
    import dbus
    import dbus.service
    import dbus.mainloop.glib
    try:
    from gi.repository import GObject
    except ImportError:
    import gobject as GObject

    AGENT_INTERFACE = "org.bluez.Agent1"
    AGENT_PATH = "/test/agent"

    class Rejected(dbus.DBusException):
    _dbus_error_name = "org.bluez.Error.Rejected"

    class Agent(dbus.service.Object):
    exit_on_release = True

    def set_exit_on_release(self, exit_on_release):
    self.exit_on_release = exit_on_release

    @dbus.service.method(AGENT_INTERFACE,
    in_signature="", out_signature="")
    def Release(self):
    print("Release")
    if self.exit_on_release:
    mainloop.quit()

    @dbus.service.method(AGENT_INTERFACE,
    in_signature="os", out_signature="")
    def AuthorizeService(self, device, uuid):
    print("AuthorizeService (%s, %s)" % (device, uuid))
    if uuid == "0000110d-0000-1000-8000-00805f9b34fb":
    print("Authorized A2DP Service")
    return
    print("Rejecting non-A2DP Service")
    raise Rejected("Connection rejected")

    @dbus.service.method(AGENT_INTERFACE,
    in_signature="o", out_signature="s")
    def RequestPinCode(self, device):
    print("RequestPinCode (%s)" % (device))
    return "0000"

    @dbus.service.method(AGENT_INTERFACE,
    in_signature="o", out_signature="u")
    def RequestPasskey(self, device):
    print("RequestPasskey (%s)" % (device))
    return dbus.UInt32("password")

    @dbus.service.method(AGENT_INTERFACE,
    in_signature="ouq", out_signature="")
    def DisplayPasskey(self, device, passkey, entered):
    print("DisplayPasskey (%s, %06u entered %u)" %
    (device, passkey, entered))

    @dbus.service.method(AGENT_INTERFACE,
    in_signature="os", out_signature="")
    def DisplayPinCode(self, device, pincode):
    print("DisplayPinCode (%s, %s)" % (device, pincode))

    @dbus.service.method(AGENT_INTERFACE,
    in_signature="ou", out_signature="")
    def RequestConfirmation(self, device, passkey):
    print("RequestConfirmation (%s, %06d)" % (device, passkey))
    return

    @dbus.service.method(AGENT_INTERFACE,
    in_signature="o", out_signature="")
    def RequestAuthorization(self, device):
    print("RequestAuthorization (%s)" % (device))
    raise Rejected("Pairing rejected")

    @dbus.service.method(AGENT_INTERFACE,
    in_signature="", out_signature="")
    def Cancel(self):
    print("Cancel")

    if __name__ == '__main__':
    dbus.mainloop.glib.DBusGMainLoop(set_as_default=True)

    bus = dbus.SystemBus()

    agent = Agent(bus, AGENT_PATH)

    obj = bus.get_object("org.bluez", "/org/bluez");
    manager = dbus.Interface(obj, "org.bluez.AgentManager1")
    manager.RegisterAgent(AGENT_PATH, "NoInputNoOutput")

    print("A2DP Agent Registered")

    manager.RequestDefaultAgent(AGENT_PATH)

    mainloop = GObject.MainLoop()
    mainloop.run()
  9. @mill1000 mill1000 revised this gist Dec 8, 2017. 1 changed file with 10 additions and 10 deletions.
    20 changes: 10 additions & 10 deletions README.md
    Original file line number Diff line number Diff line change
    @@ -2,7 +2,7 @@
    This gist will show how to setup Raspbian Stretch as a headless Bluetooth A2DP audio sink. This will allow your phone, laptop or other Bluetooth device to play audio wirelessly through a Rasperry Pi.

    ## Motivation
    A quick search will turn up a plethora of tutorials on setting up A2DP on the Raspberry Pi. However, I felt this gist was necessary beacuse this solution is:
    A quick search will turn up a plethora of tutorials on setting up A2DP on the Raspberry Pi. However, I felt this gist was necessary because this solution is:
    * Automatic & Headless - Once setup, the system is entirely automatic. No user iteration is required to pair, connect or start playback. Therefore the Raspberry Pi can be run headless.
    * Simple - This solution has few dependencies, readily available packages and minimal configuration.
    * Up to date - As of December 2017. Written for Raspbian Stretch & Bluez 5.43
    @@ -33,7 +33,7 @@ sudo apt-get upgrade
    ```
    Then reboot the Pi to ensure the latest kernel is loaded.

    Now install the per-requisite packages.
    Now install the required packages.
    ```
    sudo apt-get install bluealsa python-dbus
    ```
    @@ -58,16 +58,16 @@ exit
    ```

    ## Install The A2DP Bluetooth Agent
    A Bluetooth agent is a piece of software that handles pairing and authorization of Bluetooth devices. The following agent allows the Raspberry Pi to automatically pair and accept A2DP connection from Bluetooth devices.
    A Bluetooth agent is a piece of software that handles pairing and authorization of Bluetooth devices. The following agent allows the Raspberry Pi to automatically pair and accept A2DP connections from Bluetooth devices.
    All other Bluetooth services are rejected.

    Copy the included file a2dp-agent to `/usr/local/bin` and make the file executable with
    Copy the included file **a2dp-agent** to `/usr/local/bin` and make the file executable with
    ```
    sudo chmod +x /usr/local/bin/a2dp-agent
    ```

    ### Testing The Agent
    Before continuing, we will verify that the agent is functional, and that the Raspberry Pi is discoverable and recognized as an audio device.
    Before continuing, verify that the agent is functional. The Raspberry Pi should be discoverable, pairable and recognized as an audio device.
    1. Manually run the agent by executing
    ```
    sudo /usr/local/bin/a2dp-agent
    @@ -84,10 +84,10 @@ AuthorizeService (/org/bluez/hci0/dev_94_01_C2_47_01_AA, 0000111E-0000-1000-8000
    Rejecting non-A2DP Service
    ```

    If the Raspberry Pi is not recognized as a audio device, ensure that the bluealsa package was installed as documented in [Initial Setup](#Initial-Setup)
    If the Raspberry Pi is not recognized as a audio device, ensure that the bluealsa package was installed as part of the [Initial Setup](#initial-setup)

    ## Install The A2DP Bluetooth Agent As A Service
    To make the A2DP Bluetooth Agent run on boot copy the included file bt-agent-a2dp.service to `/etc/systemd/system`.
    To make the A2DP Bluetooth Agent run on boot copy the included file **bt-agent-a2dp.service** to `/etc/systemd/system`.
    Now run the following command to enable the A2DP Agent service
    ```
    sudo systemctl enable bt-agent-a2dp.service
    @@ -98,17 +98,17 @@ Bluetooth devices should now be able to discover, pair and connect to the Raspbe
    ## Testing Audio Playback
    Now that Bluetooth devices can pair and connect with the Raspberry Pi we can test the audio playback.

    The tool `bluealsa-aplay` is used to forward audio from the Bluetooth device and forward it to the ALSA output device (sound card).
    The tool `bluealsa-aplay` is used to forward audio from the Bluetooth device to the ALSA output device (sound card).

    Execute the following command to accept A2DP audio from any connected Bluetooth device.
    ```
    bluealsa-aplay -vv 00:00:00:00:00:00
    ```

    Play a song on the Bluetooth device and the Raspberry Pi should be output audio on either the headphone jack or the HDMI port. See [this guide](https://www.raspberrypi.org/documentation/configuration/audio-config.md) for configuring the audio output device of the Raspberry Pi.
    Play a song on the Bluetooth device and the Raspberry Pi should output audio on either the headphone jack or the HDMI port. See [this guide](https://www.raspberrypi.org/documentation/configuration/audio-config.md) for configuring the audio output device of the Raspberry Pi.

    ### Install The Audio Playback As A Service
    To make the audio playback run on boot copy the included file a2dp-playback.service to `/etc/systemd/system`.
    To make the audio playback run on boot copy the included file **a2dp-playback.service** to `/etc/systemd/system`.
    Now run the following command to enable A2DP Playback service
    ```
    sudo systemctl enable a2dp-playback.service
  10. @mill1000 mill1000 revised this gist Dec 8, 2017. 1 changed file with 25 additions and 6 deletions.
    31 changes: 25 additions & 6 deletions README.md
    Original file line number Diff line number Diff line change
    @@ -8,8 +8,9 @@ A quick search will turn up a plethora of tutorials on setting up A2DP on the Ra
    * Up to date - As of December 2017. Written for Raspbian Stretch & Bluez 5.43

    ## Prerequisites
    * Raspberry Pi - I used the Raspberry Pi 3. The Pi 3 has integrated Bluetooth, however there is a [known bug](https://github.com/raspberrypi/linux/issues/1402) when the WiFi is used simultaneously.
    * Raspbian Stretch Lite - See the offical guide on how to install the latest Raspbian OS: https://www.raspberrypi.org/learning/software-guide/quickstart/
    * Raspbian Stretch - I used the Lite version as this is a headless setup. See the [official guide](https://www.raspberrypi.org/learning/software-guide/quickstart/) if you need help.
    * [Bluez-alsa](https://github.com/Arkq/bluez-alsa) - Available in the Raspbian package repo. This software allows us to stream A2DP audio over Bluetooth without PulseAudio.
    * Raspberry Pi with Bluetooth - The Raspberry Pi 3 has integrated Bluetooth, however there is a [known bug](https://github.com/raspberrypi/linux/issues/1402) when the WiFi is used simultaneously. Cheap USB Bluetooth dongles work equally well.

    ## Disabling Integrated Bluetooth
    If you are using a separate USB Bluetooth dongle, disable the integrated Bluetooth to prevent conflicts.
    @@ -83,16 +84,34 @@ AuthorizeService (/org/bluez/hci0/dev_94_01_C2_47_01_AA, 0000111E-0000-1000-8000
    Rejecting non-A2DP Service
    ```

    If the Raspberry Pi is not recognized as a audio device, ensure that the bluealsa package was installed as documented in the Initial Setup heading.
    If the Raspberry Pi is not recognized as a audio device, ensure that the bluealsa package was installed as documented in [Initial Setup](#Initial-Setup)

    ### Install A2DP Agent Service
    To make the A2Dp Agent run on boot copy the included file bt-agent-a2dp.service to `/etc/systemd/system`.
    ## Install The A2DP Bluetooth Agent As A Service
    To make the A2DP Bluetooth Agent run on boot copy the included file bt-agent-a2dp.service to `/etc/systemd/system`.
    Now run the following command to enable the A2DP Agent service
    ```
    sudo systemctl enable bt-agent-a2dp.service
    ```

    Bluetooth devices should now be able to discover, pair and connect to the Raspberry Pi without any user intervention.

    ## Testing Audio Playback
    Now that Bluetooth devices can pair and connect with the Raspberry Pi we can test the audio playback.

    > Written with [StackEdit](https://stackedit.io/).
    The tool `bluealsa-aplay` is used to forward audio from the Bluetooth device and forward it to the ALSA output device (sound card).

    Execute the following command to accept A2DP audio from any connected Bluetooth device.
    ```
    bluealsa-aplay -vv 00:00:00:00:00:00
    ```

    Play a song on the Bluetooth device and the Raspberry Pi should be output audio on either the headphone jack or the HDMI port. See [this guide](https://www.raspberrypi.org/documentation/configuration/audio-config.md) for configuring the audio output device of the Raspberry Pi.

    ### Install The Audio Playback As A Service
    To make the audio playback run on boot copy the included file a2dp-playback.service to `/etc/systemd/system`.
    Now run the following command to enable A2DP Playback service
    ```
    sudo systemctl enable a2dp-playback.service
    ```

    Reboot and enjoy!
  11. @mill1000 mill1000 revised this gist Dec 8, 2017. 1 changed file with 51 additions and 11 deletions.
    62 changes: 51 additions & 11 deletions README.md
    Original file line number Diff line number Diff line change
    @@ -7,52 +7,92 @@ A quick search will turn up a plethora of tutorials on setting up A2DP on the Ra
    * Simple - This solution has few dependencies, readily available packages and minimal configuration.
    * Up to date - As of December 2017. Written for Raspbian Stretch & Bluez 5.43

    ## Pre-requisites
    ## Prerequisites
    * Raspberry Pi - I used the Raspberry Pi 3. The Pi 3 has integrated Bluetooth, however there is a [known bug](https://github.com/raspberrypi/linux/issues/1402) when the WiFi is used simultaneously.
    * Raspbian Stretch Lite - See the offical guide on how to install the latest Raspbian OS: https://www.raspberrypi.org/learning/software-guide/quickstart/

    ## Disabling Integrated Bluetooth
    If you are using a separate USB Bluetooth dongle, disbale the integrated Bluetooth to prevent conflicts.
    If you are using a separate USB Bluetooth dongle, disable the integrated Bluetooth to prevent conflicts.

    To disable the integrated Bluetooth
    Add the
    To disable the integrated Bluetooth add the following
    ```
    # Disable onboard Bluetooth
    dtoverlay=pi3-disable-bt
    ```
    to ``/boot/config.txt`` and execute the following command
    to `/boot/config.txt` and execute the following command
    ```
    sudo systemctl disable hciuart.service
    ```

    ## Initial Setup
    First execute the following commands to make sure the system is up to date.
    First make sure the system is up to date using the following commands.
    ```
    sudo apt-get update
    sudo apt-get upgrade
    ```
    Then reboot the Pi to ensure the latest kernal is loaded.
    Then reboot the Pi to ensure the latest kernel is loaded.

    Now install the pre-requisite packages.
    Now install the per-requisite packages.
    ```
    sudo apt-get install bluealsa python-dbus
    ```

    ## Make Bluetooth Discoverable
    Normally a Bluetooth device is only discoverable for a limited amount of time. Since this is a headless setup we want the device to always be discoverable.

    * Set the DiscoverableTimeout in ``/etc/bluetooth/main.conf`` to 0
    1. Set the DiscoverableTimeout in `/etc/bluetooth/main.conf` to 0
    ```
    # How long to stay in discoverable mode before going back to non-discoverable
    # The value is in seconds. Default is 180, i.e. 3 minutes.
    # 0 = disable timer, i.e. stay discoverable forever
    DiscoverableTimeout = 0
    ```

    * Enable discovery on the Bluetooth controller
    2. Enable discovery on the Bluetooth controller
    ```
    sudo bluetoothctl
    power on
    discoverable on
    exit
    ```
    ```

    ## Install The A2DP Bluetooth Agent
    A Bluetooth agent is a piece of software that handles pairing and authorization of Bluetooth devices. The following agent allows the Raspberry Pi to automatically pair and accept A2DP connection from Bluetooth devices.
    All other Bluetooth services are rejected.

    Copy the included file a2dp-agent to `/usr/local/bin` and make the file executable with
    ```
    sudo chmod +x /usr/local/bin/a2dp-agent
    ```

    ### Testing The Agent
    Before continuing, we will verify that the agent is functional, and that the Raspberry Pi is discoverable and recognized as an audio device.
    1. Manually run the agent by executing
    ```
    sudo /usr/local/bin/a2dp-agent
    ```
    2. Attempt to pair and connect with the Raspberry Pi using your phone or computer.
    3. The agent should output the accepted and rejected Bluetooth UUIDs
    ```
    A2DP Agent Registered
    AuthorizeService (/org/bluez/hci0/dev_94_01_C2_47_01_AA, 0000111E-0000-1000-8000-00805F9B34FB)
    Rejecting non-A2DP Service
    AuthorizeService (/org/bluez/hci0/dev_94_01_C2_47_01_AA, 0000110d-0000-1000-8000-00805f9b34fb)
    Authorized A2DP Service
    AuthorizeService (/org/bluez/hci0/dev_94_01_C2_47_01_AA, 0000111E-0000-1000-8000-00805F9B34FB)
    Rejecting non-A2DP Service
    ```

    If the Raspberry Pi is not recognized as a audio device, ensure that the bluealsa package was installed as documented in the Initial Setup heading.

    ### Install A2DP Agent Service
    To make the A2Dp Agent run on boot copy the included file bt-agent-a2dp.service to `/etc/systemd/system`.
    Now run the following command to enable the A2DP Agent service
    ```
    sudo systemctl enable bt-agent-a2dp.service
    ```

    Bluetooth devices should now be able to discover, pair and connect to the Raspberry Pi without any user intervention.


    > Written with [StackEdit](https://stackedit.io/).
  12. @mill1000 mill1000 revised this gist Dec 8, 2017. 1 changed file with 21 additions and 4 deletions.
    25 changes: 21 additions & 4 deletions README.md
    Original file line number Diff line number Diff line change
    @@ -20,9 +20,7 @@ Add the
    # Disable onboard Bluetooth
    dtoverlay=pi3-disable-bt
    ```
    to ``/boot/config.txt``

    Execute the following command
    to ``/boot/config.txt`` and execute the following command
    ```
    sudo systemctl disable hciuart.service
    ```
    @@ -35,7 +33,26 @@ sudo apt-get upgrade
    ```
    Then reboot the Pi to ensure the latest kernal is loaded.

    Install the pre-requisite packages.
    Now install the pre-requisite packages.
    ```
    sudo apt-get install bluealsa python-dbus
    ```

    ## Make Bluetooth Discoverable
    Normally a Bluetooth device is only discoverable for a limited amount of time. Since this is a headless setup we want the device to always be discoverable.

    * Set the DiscoverableTimeout in ``/etc/bluetooth/main.conf`` to 0
    ```
    # How long to stay in discoverable mode before going back to non-discoverable
    # The value is in seconds. Default is 180, i.e. 3 minutes.
    # 0 = disable timer, i.e. stay discoverable forever
    DiscoverableTimeout = 0
    ```

    * Enable discovery on the Bluetooth controller
    ```
    sudo bluetoothctl
    power on
    discoverable on
    exit
    ```
  13. @mill1000 mill1000 revised this gist Dec 8, 2017. 1 changed file with 5 additions and 2 deletions.
    7 changes: 5 additions & 2 deletions README.md
    Original file line number Diff line number Diff line change
    @@ -16,8 +16,11 @@ If you are using a separate USB Bluetooth dongle, disbale the integrated Bluetoo

    To disable the integrated Bluetooth
    Add the
    ```dtoverlay=pi3-disable-bt``` to ``/boot/config.txt``

    ```
    # Disable onboard Bluetooth
    dtoverlay=pi3-disable-bt
    ```
    to ``/boot/config.txt``

    Execute the following command
    ```
  14. @mill1000 mill1000 revised this gist Dec 8, 2017. 1 changed file with 3 additions and 2 deletions.
    5 changes: 3 additions & 2 deletions README.md
    Original file line number Diff line number Diff line change
    @@ -15,8 +15,9 @@ A quick search will turn up a plethora of tutorials on setting up A2DP on the Ra
    If you are using a separate USB Bluetooth dongle, disbale the integrated Bluetooth to prevent conflicts.

    To disable the integrated Bluetooth
    Add the following line to ``/boot/config.txt``
    ```dtoverlay=pi3-disable-bt```
    Add the
    ```dtoverlay=pi3-disable-bt``` to ``/boot/config.txt``


    Execute the following command
    ```
  15. @mill1000 mill1000 revised this gist Dec 8, 2017. 1 changed file with 7 additions and 3 deletions.
    10 changes: 7 additions & 3 deletions README.md
    Original file line number Diff line number Diff line change
    @@ -14,10 +14,14 @@ A quick search will turn up a plethora of tutorials on setting up A2DP on the Ra
    ## Disabling Integrated Bluetooth
    If you are using a separate USB Bluetooth dongle, disbale the integrated Bluetooth to prevent conflicts.

    To disable the integrated Bluetooth:
    * Add the following line to ``/boot/config.txt``
    dtoverlay=pi3-disable-bt
    To disable the integrated Bluetooth
    Add the following line to ``/boot/config.txt``
    ```dtoverlay=pi3-disable-bt```

    Execute the following command
    ```
    sudo systemctl disable hciuart.service
    ```

    ## Initial Setup
    First execute the following commands to make sure the system is up to date.
  16. @mill1000 mill1000 created this gist Dec 8, 2017.
    33 changes: 33 additions & 0 deletions README.md
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,33 @@
    ## About
    This gist will show how to setup Raspbian Stretch as a headless Bluetooth A2DP audio sink. This will allow your phone, laptop or other Bluetooth device to play audio wirelessly through a Rasperry Pi.

    ## Motivation
    A quick search will turn up a plethora of tutorials on setting up A2DP on the Raspberry Pi. However, I felt this gist was necessary beacuse this solution is:
    * Automatic & Headless - Once setup, the system is entirely automatic. No user iteration is required to pair, connect or start playback. Therefore the Raspberry Pi can be run headless.
    * Simple - This solution has few dependencies, readily available packages and minimal configuration.
    * Up to date - As of December 2017. Written for Raspbian Stretch & Bluez 5.43

    ## Pre-requisites
    * Raspberry Pi - I used the Raspberry Pi 3. The Pi 3 has integrated Bluetooth, however there is a [known bug](https://github.com/raspberrypi/linux/issues/1402) when the WiFi is used simultaneously.
    * Raspbian Stretch Lite - See the offical guide on how to install the latest Raspbian OS: https://www.raspberrypi.org/learning/software-guide/quickstart/

    ## Disabling Integrated Bluetooth
    If you are using a separate USB Bluetooth dongle, disbale the integrated Bluetooth to prevent conflicts.

    To disable the integrated Bluetooth:
    * Add the following line to ``/boot/config.txt``
    dtoverlay=pi3-disable-bt


    ## Initial Setup
    First execute the following commands to make sure the system is up to date.
    ```
    sudo apt-get update
    sudo apt-get upgrade
    ```
    Then reboot the Pi to ensure the latest kernal is loaded.

    Install the pre-requisite packages.
    ```
    sudo apt-get install bluealsa python-dbus
    ```