This README file contains information on the contents of the
alexa layer.

Please see the corresponding sections below for details.

Dependencies
============

This layer depends on:

  URI: git://git.openembedded.org/bitbake
  branch: master

  URI: git://git.openembedded.org/openembedded-core
  layers: meta
  branch: master

  URI: git://git.openembedded.org/meta-openembedded
  layers: meta-oe, meta-multimedia, meta-python
  branch: master


Patches
=======

Please submit any patches against the alexa layer to the
yocto mailing list (yocto@yoctoproject.org) and cc: the maintainer:

California Sullivan <california.l.sullivan@intel.com>

Table of Contents
=================

  I. Adding the alexa layer to your build
 II. Walkthrough
III. Issues / To-do


I. Adding the alexa layer to your build
=================================================

In order to use this layer, you need to make the build system aware of
it.

Assuming the alexa layer exists at the top-level of your
yocto build tree, you can add it to the build system by adding the
location of the alexa layer to bblayers.conf, along with any
other layers needed. e.g.:

  BBLAYERS ?= " \
    /path/to/yocto/meta \
    /path/to/yocto/meta-poky \
    /path/to/yocto/meta-yocto-bsp \
    /path/to/yocto/meta-openembedded/meta-oe \
    /path/to/yocto/meta-openembedded/meta-python \
    /path/to/yocto/meta-openembedded/meta-multimedia \
    /path/to/yocto/meta-alexa-demo \
    "


II. Walkthrough
========

0. Set up Amazon account. See here: https://github.com/alexa-pi/AlexaPi/wiki/Installation#1-register-at-amazon

1. Make sure your yocto kernel has the proper sound drivers for your hardware.

2. Add alexapi to your IMAGE_INSTALL variable to add the client.

3. Build/flash/boot board as usual.

4. Run the setup: './opt/AlexaPi/src/scripts/setup.py'

5. Use alsamixer to make sure alsa sees your sound hardware and make any configuration changes. May need to turn up mic gain.

6. Complete the setup using your Amazon information, then to to the page you are directed to to complete the handshake.

7. Once the handshake is complete, kill the setup script and run the client: 'python /opt/AlexaPi/src/main.py'

8. Speak clearly: "hey alexa," wait for a response, then ask a question.

II. Issues / To-do
========

1. Doesn't seem to work with the init script.

2. Needs better way to configure at build time. Currently there is only the option to supply a complete config.