This README file contains information on the contents of the
alexa-led 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.yoctoproject.org/meta-alexa-demo
  layers: meta-alexapi
  branch: dev

Patches
=======

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

Maintainer: Amanda Brindle <amanda.r.brindle@intel.com>


Table of Contents
=================
  
  I. Prerequisite
 II. Adding the alexa-led layer to your build
III. Adding installations to your build
 IV. Demo Tutorials

I. Prerequisite
=================================================

Add alexapi to your image by following the README in the meta-alexapi layer,
and test that you can speak to Alexa. (ex: Alexa, what time is it?)

II. Adding the alexa-led layer to your build
=================================================

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

Assuming the alexa-led 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-led 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-intel \
    /path/to/yocto/meta-alexapi \ 
    /path/to/yocto/meta-alexa-led \
    "


III. Adding installations to your build
========

In local.conf add:

IMAGE_INSTALL_append = " alexa-led alexapi alsa-utils nodejs nodejs-npm portaudio-v19 curl "

If you get the ERROR: Nothing PROVIDES 'libmad' and/or ERROR: libmad was skipped: because it has a restricted license not whitelisted in LICENSE_FLAGS_WHITELIST

In local.conf add:

LICENSE_FLAGS_WHITELIST = "commercial"

Optionally, you can add more to IMAGE_INSTALL_append, such as git in case you want to clone the dev branch of alexapi, or connman-client to help connect to wifi:

IMAGE_INSTALL_append = " git connman-client "

You can also add gcc, make, cmake, and other development tools if you want to build code:

IMAGE_INSTALL_append = " gcc make cmake "

Then, look for EXTRA_IMAGE_FEATURES ?= "debug-tweaks", and add tools-sdk. 

IV. Demo Tutorials
=====================================

To complete the demo to make an led blink, follow the demo tutorials found in the tutorials folder.