AWS IoT Button

1. Open the box. Configure the button to connect to your home or office Wi-Fi. See 'How do I configure to use at home or office Wi-Fi?' below
   
2. To activate the AWS IoT button to your account, click on the link and sign into your AWS Management Console (administrator privileges required). Watch the Activation Wizard Video to see how to use the wizard to activate a button.
   • Input your Device Serial Number (DSN on the back of the device) and activation code that you received on a piece of card with the AWS IoT Button. (Note that only one AWS IoT Button can be associated with an AWS account and the code is valid only for one AWS IoT Button activation)
   • Select pre-configured rule (Send me an email, Send me a text) or Create a new AWS IoT Rule using Rule Builder for advanced rules that use Lambda, Kinesis, S3, SNS.
     
   • Rule SQL Statement: SELECT * FROM 'iotbutton/+'
3. Press the button and verify the specified action actually happens! Or checkout CloudWatch Logs for any errors.
4. Update the Shadow state (LED color sequence) in the console and see the magic!

Hackster.io has organized The AWS IoT Mega Contest just for you. We can’t wait to see what you build using the AWS IoT Button. Please apply for the contest by submitting your idea. Once you qualify, Hackster.io has great prizes for you!

How do I configure to use at home or office Wi-Fi?

• Press and hold the button for 15 seconds, until it shows a blue blinking light.
• Use your phone/computer to connect to the "Amazon ConfigureMe - XXXX" Wi-Fi network. The XXXX will be the last 4 digits of your device’s serial number.
• In a browser, (Safari not supported) navigate to http://192.168.0.1
• Select the network you want the button to connect to and enter its password.

 

How can I get an AWS IoT Button?

AWS IoT Buttons are provided from time to time as part of AWS public events such as the re:invent conference as a “hello world” device to try out AWS IoT. We currently don’t plan to sell them. However, if you have a great use case for the AWS IoT Button and would like us to get back to you if buttons become available for sale, contact us at aws-iot-button@amazon.com

 

Will it work at AWS re:Invent conference? Where else will it work?

The AWS IoT Button is designed to work in a home or office environment and not ideal for conferences with a congested Wi-Fi spectrum. Hence it might not be able to connect to Wi-Fi in places like expo halls, lunch rooms, keynote rooms, hallways etc. If it can connect to the Internet, it will work.

 

What payload is sent from the device when you press it?

The payload contains the device serial number, the measured battery voltage and a click type.

The following JSON template shows what is sent as the payload.

{

   "serialNumber": "GXXXXXXXXXXXXXXXXX",

   "batteryVoltage": "mV",

    "clickType": "SINGLE | DOUBLE | LONG"

}

A “LONG” clickType is sent if the first press lasts longer than 1.5 seconds. “SINGLE” and “DOUBLE” clickType payloads are sent for short clicks.

 

How do I configure the LED color sequence?

In the console, edit the shadow state for your AWS IoT Button (Thing) so that it has a desired state like below:

{ "desired": { "sequence": "c,m,y" }}

This will make the button pulse cyan, magenta, yellow before it shows the green success light. Each color is pulsed twice, followed by a gap of 0.5 seconds, and then the next color. The colors must be separated by commas, and are lower case characters representing the first letter of the color you want. The valid colors are Red, Cyan, Orange, Yellow, Blue, Green, Magenta and Purple.

 

What do the LED color patterns mean?

• Blinking White : Connecting to Wi-Fi, getting IP address, connecting to AWS IoT
• Blinking Orange : Pre-DHCP error occurred
• Blinking Red : Post-DHCP error occurred
• Pulsing Red : Battery Low
• Solid Red : Battery Dead
• Solid Green (1 second) : Successfully connected to WiFi and published a message to AWS IoT
• Blinking Blue : Soft AP mode
• Pulsing Color (rcoybgmp) : AWS IoT Shadow User defined Sequence

 

Can I get some examples of Lamdba Functions that I can use?

You can use any of the AWS Lambda Blueprints in the Lambda Console to get started with AWS IoT Button and AWS Lambda. Some simple examples:

• LambdaToIoTHTTP Gist
  
• LambdaToDynamoDB Gist
  
• LambdaToLambda Gist
  
• LambdaToTwilio Gist
• LambdaToSNS Gist
• LambdaToConsoleLog Gist
• RuleToSNS Gist

 

How long will the battery last?

The device’s battery should last for over 1000 presses. When the device runs out of battery, there is no way to recharge or replace the battery.

I am having trouble activating my device

Please make sure you are typing the Device Serial Number and Activation Code correctly. Only one device can be activated per AWS account. Devices can only be activated once.

I am having trouble getting my device to connect to AWS IoT successfully

• Check your device’s certificate is ACTIVE.
  
• Check that your device has a policy attached that allows publishing to “iotbutton/”
• Check that port 8443 isn’t blocked on your network - try visiting this page http://portquiz.net:8443/. Requests to port 8443 must be allowed.

My button blinks red fairly frequently (10-40% of the time)

This is because Thing does not have a default Shadow State. We recommend always having a thing-shadow state set. If you do not want to make use of the custom LED pattern flashing, set the desired state for sequence to be an empty string (e.g. {"desired": { "sequence": "" }}) in the Console Detail under "Update State".

I am having trouble configuring the device’s Wi-Fi Mode

• You must use Firefox, Chrome or IE to configure the Wi-Fi. These are tested and work. Device Wi-Fi configuration using Safari isn’t supported.
• Navigate to http://www.configuremybutton.com or http://192.168.0.1.
  SSIDs and Wi-Fi passwords containing spaces are not supported.
• Make sure you aren’t connected to a VPN when trying to access the configuration web page.
  

I am still having problems and this guide isn’t helping

Please stop by AWS Mobile and IoT Booth or New Services Booth if you’re still having issues. Kindly note that button may not connect to Wi-Fi reliably in highly crowded areas in the conference venue due to congested spectrum. After the conference, send us an email at aws-iot-button@amazon.com

I am an IAM user with restricted access

For the AWS IoT Button Activation Wizard to work, please provide "iot:*" permissions to your IAM user policy.