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.

This library is licensed under the Amazon Software License.

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

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.

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.

This folder contains code snippets specific for Bluetooth classic.

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

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.

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.

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.

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.

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

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