Alexa Gadgets Embedded Sample Code

This repository contains resources for Alexa Gadgets developers. For information on how to get started, developer documentation, and API references, please visit the Alexa Gadgets Toolkit developer pages.

License

This library is licensed under the Amazon Software License.

Folders

/AlexaGadgetsProtobuf

This folder contains the protocol buffer (protobuf) message definition files and scripts to compile the corresponding serializer/deserializers.

/AlexaGadgetsProtobuf/examples

This folder contains an example of a single protobuf definition and a shell script to compile all of the protobuf definitions for the Alexa Gadgets Toolkit.

/ConnectionHelpers

This folder contains a collection of code snippets to help with establishing the Bluetooth pairing and connections between a gadget and a compatible Amazon Echo device.

/ConnectionHelpers/BT

This folder contains code snippets specific for Bluetooth classic.

/ConnectionHelpers/BT/Checksum

This folder contains sample code for calculating the checksum of the packets exchanged. For more information, see Exchanging Packets.

/ConnectionHelpers/BT/DeviceSecret

This folder contains sample code for generating the device secret using SHA256. These credentials are required in order to connect a gadget to a compatible Amazon Echo device. Fore more information on how to sue the device secret in the initial handshake, please see Bluetooth pairing and connecting.

/ConnectionHelpers/BT/EIR

This folder contains sample code for the Extended Inquiry Response (EIR). This is the first step in pairing a gadget with an Echo. For more information on the EIR, please see Extended Inquiry Response.

/ConnectionHelpers/BT/SDP

This folder contains sample code for the Service Discover Protocol (SDP) database settings that must be added to the SDP database in order for your gadget to establish a bluetooth connection. For more information please see SDP Settings.

/ConnectionHelpers/BT/PacketHelper

This folder contains sample code for extracting packets from streaming buffers. Your Bluetooth connection is a stream based protocol, so there is no guarantee that you receive one packet at a time. For more information please see Exchange Packets.

/ConnectionHelpers/BLE

This folder contains code snippets specific for Bluetooth Low Energy (BLE).

/ConnectionHelpers/BLE/Handshake

This folder contains sample code for handshake between Echo device and your BLE gadget. For more information please see BLE pairing and connection flow.