Setting Up an AWS Developer Account

Important! Set up an Amazon Web Service (AWS) Account before setting up an account for a developer

Sign In as the Root Access AWS User

1. Sign in by entering an AWS Root Access User Account Email and then press “Next”

2. Enter the password for the Root Access User and press “Sign In”

Set Up a Group

1. Log onto the AWS Console, locate the Security, Identify & Compliance Section and select IAM (Identity and Access Management). Or use the search bar and enter IAM.

2.  Select “Groups” in the left side menu

3.  Click “Create New Group”

4.  Enter a name for the group and then press “Next Step”

5.  On the Attach Policy screen, select the policies for any buttons you have set up as a root access user and then press “Next Step”

6.  Review the policies and then press “Create Group”

7.  You are returned to the group home page once you create the group. To add additional policies so the developer can work with both the buttons and the serverless functions that power the buttons, click on the group you just created.

8.  On the permissions screen, click “Attach Policy”

9.  In the policies screen, find and select the policies below.

10.  After you have selected the policies you want to add to the developers group, click “Attach Policy”

Adding the Developer’s User Account

1. After attaching the policies to the group, select “Users” from the left menu bar

2.  Click on “Add User”

3.  Add a username, then check the boxes “Programmatic Access” and “AWS Management Console Access.” Keep the defaults of “Autogenerated password” and “require password to be reset” when the developer logs in for the first time. Click on “Next Permissions”

4.  On the “Set Permissions” screen, click on the checkbox of the developers group you created earlier to add the developer to this group and press “Next Tags”

5.  You can add up to 50 key/value pairs to help you find and organize your users. We recommend using the key “Email” and provide the developer’s email address. Press “Next Review”

6.  Review all of the details for this user and then press “Create User”

7.  Congratulations, you have successfully set up a developer’s account! Download the credentials with the “Download CSV” button, or view the password by clicking on the “Show” link next to the password field. Important! Make sure you copy the password as it will be unavailable after you leave this screen. Click on the “Send Email” link on the right to send an email with a link for your developer to log into your AWS account.

Setting Up an AWS Developer Account

Configuring the Root User for Multi-Factor Authentication

Important!

  1. Set up an Amazon Web Service (AWS) Account for a Root User
  2. Set up a Developer Account

What is Multi-Factor Authentication (MFA)?

Multi-Factor Authentication is a system requirement that utilizes two or more methods of identification to authenticate a user.

For the Root User, one method of authentication is already set up by using the combination of email and password to log on.

A variety of second authentication methods are available from AWS MFA homepage:   https://aws.amazon.com/iam/details/mfa/

In this example we are using Google Authenticator, which you can download on your phone from the Google Play or Apple’s App Store.

Configuring the Root User For MFA

1. Log into the AWS Console as the Root User. On the dropdown menu attached to the Organization name in the top menu bar, choose My Security Credentials.

2.  You will get a popup warning stating that you should set up another user with limited permissions. This step has already been completed; choose “Continue to Security Credentials.”

3.  Click on Multi-Factor Authentication (MFA), then click Activate MFA

4.  Select the radio button at the top, “Virtual MFA device” and press the “Continue” button.

5.  The popup screen shows several choices; since our app for two-factor authentication is already installed, go to Step 2 and press “Show QR Code.”

6.  Open the Google Authenticator app and press the “Begin” button.

7.  Press the “Skip” button in the lower left hand corner to go straight to the set up.

8.  On the next screen choose “Scan a barcode”

9.  You will be asked to give permission to use the camera, choose “Allow”

10.  Point the camera to your computer with the barcode showing, center the square that appears over the barcode, and the app will scan it automatically.

11.  You will now see the account added in the Google Authenticator app. Make a note of the code display and return to the MFA Popup in the AWS console.

12.  Enter the code from the authenticator in the MFA Code 1 box, hit the tab key, then return to the authenticator app. The MFA code changes in the App in about 30 seconds, wait for a second code to appear, make a note of it, and enter it in the MFA Code 2 box. Press the “Assign MFA” button.

13.  You should see a success message. Press “Close” and log out of the console.

Test Logging In as the Root User with MFA Activated

1. Log into the AWS console with the usual root user email and password credentials and press “Sign In”

2.  A second authentication page will appear where you will enter the MFA code.

3.  Open the Google Authenticator app on your phone and make a note of the code.

4.  Enter the code in the MFA code box on AWS and press “Submit”

5.  You are now logged into the AWS console. Congratulations! You have successfully configured and tested your root user account for MFA.

In this day and age of increased security threats it is best to be prepared before disaster strikes! For additional information on increased security methods, contact Revolution11 to schedule a consultation today. Learn what systems we have put in place for businesses of every size.

Configuring the Root User for Multi-Factor Authentication

Using the AWS IoT Button Wi-Fi App

What is the AWS IoT Button Wi-Fi App?

The Amazon Web Service (AWS) IoT Button Wi-Fi App is an application published by Amazon that allows the end user to set the button’s Wi-Fi network. The application does not allow the end user to change the button’s functionality. An AWS account is NOT required to use this application.

Setting or Changing the Wi-Fi Network on the AWS IoT Button

  1. Open the app on your phone or tablet and press “Setup AWS IoT Button Wi-Fi”

2.  On the next screen press “Scan DSN Barcode” (Device Serial Number). This brings up the scanner in your camera app to scan the barcode on the box.

3. Give the app permission to use your camera on first use… Click “OK”

4.  Position the scanner box in the camera app at the bottom barcode on the box flap. (See instructions below if you do not have the box with the sticker label).

5.  Once the scanner captures the barcode, it will show the DSN in the next screen of the app. Press “Configure Button”

6.  Press the physical button on the device for about 6 seconds until it flashes blue.  Once it is flashing, press the button at the bottom of the screen that says “Copy Password And Go To Settings”.

7.  On the Wi-Fi Settings Screen, under Choose a Network, select the Button Configuration from the Wi-Fi Networks.

8.  When prompted for the network password, paste the password that is stored on the device’s clipboard.

9. Return to the app, choose the Wi-Fi network to attach the button to and enter the password for that network.

10.  Press “Confirm Wi-Fi”

11.  You will see this message while the button is connecting to the new network

12.  Once the button has joined the new network you will get a confirmation screen.  Press “Done”

Congratulations, you have set up your AWS IoT button on a new Wi-Fi network!

*Instructions For Lost Box Barcode

If you do not have the box with the barcode that the button came in, there is a QR Code on the back of the button itself that represents the Device Serial Number (DSN). The DSN is also printed on the back of the button. Download a QR Scanning App from Apple’s App Store or Google’s Play store if you don’t have a QR Scanning app on your device already.

1. Open your scanning app and scan the QR Code on the right hand side of the back of the button. Once the QR Code is Scanned, copy the DSN.

2.  Open the AWS IoT Button Wi-Fi App and press the “Setup AWS IoT Button Wi-Fi” button at the bottom of the screen.

3.  Click on “Manually Enter DSN”

4.  On the next screen, click into the DSN field

5.  Paste the DSN from the clipboard (type it manually if you could not scan it)

6.  Click on “Configure Button” and change the Wi-Fi Network by following the instructions above.

Using the AWS IoT Button Wi-Fi App

Configuring the Ingics iGS01S Wi-Fi BLE Gateway

Ingics IGS01S Wi-Fi BLE Gateway

Important! Set up an Amazon Web Service (AWS) Account before beginning Gateway configuration

Gateway Set Up for Your Wi-Fi Network

Once you receive your Gateway follow these steps to configure:

  1. The Gateway comes with an antennae and a USB charging cable; you supply your own USB charging adapter. The instructions for adding this unit to your Wi-Fi Network are very straightforward and can be found here.
Ingics IGS01S Package Contents

Set Up the Gateway on the AWS IoT Core

1. Log onto the AWS Console and select IoT Core under the Internet of Things heading. Select Get Started the first time you access this screen.

Choose IoT Core

2.  To create a Gateway policy, select Secure on the left hand menu, then select Policies on the sub-menu. Press the Create button in the upper right hand corner.

Create Policy

3.  On the next screen, name the policy.

Under Add Statements, use the Action box to create a general IoT policy. Start typing I…o…t and then select the first statement:

“IoT:*” from picklist as the value in this field; this is a general policy for all IoT devices.

Clear out the string that auto-populates in the Amazon Resource Name (ARN) field and replace with a wildcard (*). The Resource ARN is the end point for this resource and acts as a general policy for any resource.

Under Effect, choose Allow

Press Create in the lower right hand corner

Name Policy

4.  Next Choose Manage → Things on the left menu. Press Create

Create

5.  Choose Create a Single Thing

Create Single Thing

6.  Name the Gateway; add types and groups if you will have more than one Gateway and if you would like an attribute key and value. An example type is Wi-Fi Gateway. An example group is Gateways. *See note below on Naming Conventions
Click Create a Type and fill in the appropriate information.
Press Next.

Name Gateway Part I
Name Gateway Part II

7.  Choose One-Click certificate creation and click Create Certificate

Create Certificate

8.  This is where you need to pay attention! Download the certificates and place them in a folder.

In the next step we will get the “root certificate.” For now, press Activate

Download Certificate

9.  Get the root certificate. Go to: https://docs.aws.amazon.com/iot/latest/developerguide/managing-device-certs.html#server-authentication

Click on Amazon Root CA 1 under the Amazon Trust Service Endpoints heading. Save the text that comes up in your browser as a file named ca.crt  Use bbedit (or another text editor) to save the file http://www.barebones.com/products/bbedit/index.html

Root Certificate

10. Return to the webpage where you activated the certificates and press Attach a Policy

Attach Policy

11.  Choose the policy you created earlier and press Attach

Add A Policy For Your Thing

12. Choose Register Thing.

13. Go back to the main menu and select Manage → Things. Select your gateway and press Interact. This is where you will find the endpoint of your thing in the top field. Copy this value and save it.

14. Make Sure you are on the Gateways Wi Fi; log onto the admin console. Review instructions here. You can download the Android app Fing to help you determine the IP address of the device.

15.  Click on the Applications tab and choose MQTT Client under Applications. Enter the endpoint you saved when you set up the gateway on AWS in the Host/IP field and press Save. This will reboot the gateway.

MQTT Settings

16.  Press the advanced tab. Use Choose File to pick the certificate and private key files you saved (Step 8). Press Upload Certificate and Upload Key after choosing the files and then press Reboot.

Upload Certificate and Key

Checking MQTT Publishing at AWS

  1. On the Applications Services Tab of the Gateway Admin tool you will see the default topic the gateway is publishing to. Change it to:  /in/ac233fc01615/status so it is formatted correctly and press Save.
Topic Setting

2.  Log back on to AWS, choose the IoT Core under Service, choose Manage/Things and select the Gateway

Select Gateway

3.  Choose Activity on the left menu

Choose Activity

3.  Click on MQTT Client, paste the default topic into first text box and press Subscribe to Topic

Subscribe to Topic

4.  This gateway does not send JSON so you will just see the strings for the beacons it is picking up.

Message Results


*NOTE

It is important to have a naming convention that allows our team to quickly identify the location, type, and manufacturer of the device when working with devices in the cloud. Revolution11 highly recommends the following naming convention, based on the useful information in this blog: https://www.netcraftsmen.com/device-naming-conventions/

The blog makes a great point in describing how your device names need to work easily in a Command Line Interface (CLI).

The only information that we have added to the standard in this blog is the addition of the manufacturer.

Best practice for naming looks like this:

ftbr-blewifi-ing-01 represents

  • Location: Fort Bragg,
  • Type of device: ble wi-fi gateway
  • Manufacturer: Ingics
  • Number: first of several devices at this location
Configuring the Ingics iGS01S Wi-Fi BLE Gateway

Bluetooth Gateway Roundup

The Contenders

What is a Bluetooth Gateway?

A Bluetooth Gateway is a device that scans for, and captures, Bluetooth radio signals. The Gateway is attached to a network either via ethernet or by joining a Wi-Fi Network. They can easily be configured to send the captured data to Cloud Services such as Amazon Web Services (AWS).

See our blog Setting Up a Cloud Account & Hooking Up A Smart Thing for examples of how to set up services for each gateway.

Revolution11 Currently Supports Bluetooth Gateways From Two Manufacturers

Ingics

This manufacturer produces two versions of the Bluetooth Gateway. Both versions work with the many varieties of Ingics’ sensor beacons, including:

  • temperature and humidity
  • proximity
  • human detection
  • motion detection
  • sensors that work with magnets

Ingics Sensors do not use the Eddystone or iBeacon protocols. They send their own protocol, which means you will need to be comfortable parsing the custom strings the beacons produce to make use of them.

You can, however use Eddystone or iBeacon sensors with Ingics Gateways. This requires some setup in Advanced/BLE Filter. See details here https://www.ingics.com/doc/iGS01/AP007_iGS01_payload_filter.pdf

IGS01S Wi-Fi BLE Gateway

This is a great choice if you are going to leave your Gateway configured to a Wi-FI Network for long periods of time.

IGS02E Ethernet BLE Gateway

This is a great choice if you will be moving the gateway from place to place. You only need to configure and set it up with AWS once; then you have the ability to plug it into new networks via the ethernet cable.

Minew

Minew produces the G1 Wi-Fi BLE Gateway, which is a great system for beginners. It attaches to your Wi-Fi network and supports standard iBeacons. Minew sells a sensor beacon that collects temperature and humidity, and they have a great lineup of beacons in a variety of form factors that use multiple power sources. The JSON that comes out of the Gateway is human readable, and the ability to appropriately match power requirements with your use case in their beacon lineup is a huge plus. And it has fancy flashing disco lights!

Bluetooth Gateway Roundup

Capturing Button Data in a SQL Database

serverlessApp.png

With a SQL database it is possible to capture the JSON data generated by an AT&T LTE-M or AWS Enterprise Button. With the help of our friends at Tek-Connect, Revolution11 has created a serverless app to make the process of capturing button clicks for these devices in a SQL database as intuitive as possible.

Our serverless application supports the following flavors of SQL: MySQL, MS SQL, Postgres SQL, Oracle SQL, SQL Lite or Web SQL.

How to Deploy and Use a Custom Serverless Application to Capture the JSON Button Output

Setting Up The Application

1. Log in to the AWS Console and choose the Lambda service. Once you are on the dashboard, press ‘Create Function’ in the upper right hand corner.

capturingfilemaker1

2. On the next screen, choose the AWS Serverless Repository – the panel located on the right side.

capturingfilemaker2

3. In the search bar, type in “SQL” or “Revolution11” in the Public Applications area. Click on the rev11-attiotbutton-SQLi application.

CapturingSQL3.jpg

4. A Read Me section is found on the left-hand side of the page; this provides the parameters necessary to use the application. Fill out the parameters for your SQL Server address, sql type, and other information on the right-hand side of the page and press the ‘Deploy’ button.

capturingsql4

5. A status screen will appear while the application is being deployed. Once the process finishes, press the Test App button in the upper right of the screen.

CapturingSQL5.jpg

6. An overview screen for the app appears. Click on the hyper-linked name of the application (rev11atttiotbuttonsqli).

CapturingSQL6.jpg

7. The next page sets up the function for the buttons. Add the AWS IoT trigger by clicking on it in the list of triggers to the right.

capturingsql7

8. The AWS IoT Trigger appears in the workflow now. Scroll down to the configuration triggers area to set up the function to work with buttons.

capturingsql8

9. It is possible to use one of the rules created for another button, but in case a rule has not been created, we will create a new one. Choose Custom IoT rule, give the rule a name, and add a query statement as shown in the screenshot below. Press the Save button in the upper right-hand corner to save the changes.

CapturingSQL9.jpg

10. Let’s test the function! On the top of the screen, find the dropdown to ‘Select a test event’. Since we haven’t created any tests to use, the only choice in the dropdown is to ‘Configure a test event’ — choose this option.

CapturingSQL10.jpg

11. Go ahead and use the supplied Hello World template. Give the test event a name and press the Create button at the bottom right of the screen. This test will send the JSON in the body of the test with the function.

capturingfilemaker11

12. You will now see the name of the test you created in the dropdown. Press the Test button to the right of the dropdown to run the test.

CapturingSQL12.jpg

13. When the test has finished running, you will see the results at the top of the page. In this case it was successful. Now, check your SQL Database, there should be a new record with the JSON from the test event.

capturingsql13

14. In the event of an unsuccessful test, this same area will tell you what failed. For this screenshot, I have changed the name of the “column” environment variable to a column not in the database. You should see that error in the details.

CapturingSQL14.jpg

Configuring the Button

1. Configuring the LTE-M or AWS to use this Lambda function is the same as in past blog posts. In the AWS Server Console, navigate to the one click service and click on ‘Create a project’.

capturingfilemaker15

2. Give the project a name and press next.

capturingfilemaker16

3. Press ‘Start’ to define a device template.

capturingfilemaker17

4. Press ‘All button types’ on the next screen.

capturingfilemaker18

5. Enter the Device template name; in the Action dropdown, choose ‘Select a Lambda’ function and choose the function that was just created when you created the application; press ‘Create project’.

capturingfilemaker19

6. On the next screen choose Create your first placement – click ‘Create placements’.

capturingfilemaker20

7. Give the placement a name and press the choose device button to choose a device to tie to the function.

capturingfilemaker21

8. On the next screen, select the device and press ‘Create placement’.

capturingfilemaker22

You can now test your button!

Download a PDF of this blog: Capturing Button Data in a SQL Database

Capturing Button Data in a SQL Database

Capturing Button Data in a FileMaker Database

With a FileMaker database, it is possible to capture the JSON data generated by an AT&T LTE-M or AWS Enterprise Button. DB Services already wrote a great blog about using a

custom Lambda to record the JSON into a FileMaker Database from the 1st generation of AWS Buttons here: https://dbservices.com/articles/iot-filemaker-and-you/.  With the help of our friends at Tek-Connect, we decided to take it a step further and create a serverless app to make the process of capturing button clicks for these devices in FileMaker as easy as possible.

FileMaker’s ScriptMaker opens up a world of possibilities that customize what happens when pressing these buttons. In earlier blogs, we have demonstrated using Twilio for Text Messaging and Mandrill and MailChimp to send transactional email. You can build workflows using these tools with your FileMaker Solution. Perhaps a client wants their field reps to re-order products from the field using these buttons. With one click, a FileMaker solution can create an order record in a database, send a text to the rep and his customers letting them know the product(s) have been ordered, and send a notification to the warehouse to pick and ship the product. In future blogs, we will be exploring adding more functionality to these buttons.

How to Deploy and Use a Custom Serverless Application to Capture the JSON Button Output

Setting Up The Application

1. Log in to the AWS Console and choose the Lambda service. Once you are on the dashboard, press ‘Create Function’ in the upper right hand corner.

capturingfilemaker1

2. On the next screen, choose the AWS Serverless Repository (the last pane on the right).

capturingfilemaker2

3. In the search bar, type in “FileMaker” or “Revolution11” in the Public Applications area. Click on the rev11-attiotbutton-filemakerapi application.

capturingfilemaker3

4. A Read Me section is found in the middle of the page on the left-side; this provides the parameters necessary to use the application. (A sample FileMaker application can be downloaded with this blog post.) Fill out the parameters for your FileMaker Server, file, and other information on the right-hand side of the screen and press the ‘Deploy’ button.

capturingfilemaker4

5. A status screen will appear while the application is being deployed. Once the process finishes, press the Test App button in the upper right of the screen.

capturingfilemaker5

6. An overview screen for the app appears. Click on the hyper-linked name of the application (rev11atttiotbuttonfilemakerapi).

capturingfilemaker6

7. The next page sets up the function for the buttons. Add the AWS IoT trigger by clicking on it in the list of triggers to the right.

capturingfilemaker7

8. The AWS IoT Trigger appears in the workflow now. Scroll down to the configuration triggers area to set up the function to work with buttons.

capturingfilemaker8

9. It is possible to use one of the rules created for another button, but in case one has not been created, we will make a new one. Choose Custom IoT rule, give the rule a name and add a query statement as in the screenshot below. Press the save button in the upper right hand corner to save the changes.

capturingfilemaker9

10. Let’s test the function! On the top of the screen, find the dropdown to ‘Select a test event’. Since we haven’t created any tests to use, the only choice in the dropdown is to ‘Configure a test event’ — choose this option.

capturingfilemaker10

11. Go ahead and use the supplied Hello World template. Give the test event a name and press the Create button at the bottom right of the screen. This test will send the JSON in the body of the test with the function.

capturingfilemaker11

12. You will now see the name of the test you created in the dropdown. Press the Test button to the right of the dropdown to run the test.

capturingfilemaker12

13. When the test has finished running, you will see the results at the top of the page. In this case it was successful. Now, check your FileMaker Database, there should be a new record with the JSON from the test event.

capturingfilemaker13

14. In the event of an unsuccessful test, this same area will tell you what failed. For this screenshot, I have changed the name of the “field” environment variable to a field not in the database. You should see that error in the details.

capturingfilemaker14

Configuring the Button

1. Configuring the LTE-M or AWS to use this Lambda function is the same as in past blog posts. In the AWS Server Console, navigate to the one click service and click on ‘Create a project’.

capturingfilemaker15

2. Give the project a name and press next.

capturingfilemaker16

3. Press ‘Start’ to define a device template.

capturingfilemaker17

4. Press ‘All button types’ on the next screen.

capturingfilemaker18

5. Enter the Device template name; in the Action dropdown, choose ‘Select a Lambda’ function and choose the function that was just created when you created the application; press ‘Create project’.

capturingfilemaker19

6. On the next screen choose Create your first placement – click ‘Create placements’.

capturingfilemaker20

7. Give the placement a name and press the choose device button to choose a device to tie to the function.

capturingfilemaker21

8. On the next screen, select the device and press ‘Create placement’.

capturingfilemaker22

You can now test your button!

You can download a sample FileMaker File to host on your FileMaker Server here.

Download a PDF of this blog: Capturing Button Data in a FileMaker Database

Capturing Button Data in a FileMaker Database

AWS Enterprise Button Configuration

AWS.ATT.button.

Before Button Configuration, set up an Amazon Web Service (AWS) Account

Next, download the AWS IoT 1-Click App from either the iOS App Store or Google’s Play Store Order an AWS Enterprise Button Here (Affiliate Link Full Disclosure) :

Once you receive your AWS Button follow these steps to configure:

1. Open box by prying open the panel on the end that has the white sticker (Keep track of the box so you can scan the sticker with the app).

awsenterprise1

2. Log into the AWS IoT 1-ClickApplication

3. Configure the Button on your mobile device by opening the AWS IoT 1-Click and signing in with your AWS password. This opens the app for button configuration on the setup tab. Press the Claim with Device ID button

awsenterprise2

4. Press the scan button to scan the serial number on the box (You can enter the serial number manually if you have lost the box)

awsenterprise3

5. The app will display “1 Device Added” when it has identified the serial number.
Press ‘Stop Scanning’.

awsenterprise4

6. The Device Added Confirmation Screen will appear. Press the ‘Claim’ button to claim the device.

awsenterprise5

7. A pop-up will appear asking to confirm that you would like to configure this device. Press ‘Yes’.

awsenterprise6

8. On the next screen you will be instructed to Press the Button on the AWS Enterprise Device.

awsenterprise7

9. Once the device is found, the next screen will prompt you to add your wi-fi credentials for the wi-fi network you would like to use with this button. Enter your settings and press ‘Confirm’.

awsenterprise8

10. The configuration screen will show the configuration status change from ‘in progress’ to ‘succeeded’. Once the configuration has succeeded (the light on the device will change from flashing blue to a solid green flash), press the ‘next’ button.

awsenterprise10

11. The next screen will prompt you to press the button on the device to finalize the claim. Once this has succeed, press the ‘finish’ button.

awsenterprise11

12. Press the devices tab at the bottom of the screen to view the device in the app.
Click on the device in the list to enable it.

awsenterprise12

13. On the next screen, click on the ‘enable’ slider.

awsenterprise13

Configuring the Button Action

1. Log on to your AWS Console

2. Click ‘All Services’ and navigate to → Internet of Things → IoT 1-Click

3. Choose the 1-Click Service, this is what you will use to assign a Lambda Function to the device.

awsenterprise14

4. On the left hand side of the screen you will see the menu for managing 1-Click Devices

awsenterprise15

5. Click on the ‘Manage’ option in the 1-Click Menu

6. Create a test project to attach for the AWS Enterprise Button. Press the ‘Create a Project’ button.

awsenterprise16

7. Enter a Project name and Description and press the ‘Next’ button.

awsenterprise17

8. Press Start to Define a Device Template for the Lambda Function you want the device to use.

awsenterprise18

9. Name the template, and set an action (Lambda Function). In this case, choose ‘Send SMS’.

awsenterprise19

10. Scroll down to Create Placements and enter a device placement name and enter a phone number (+1xxxxxxxxxx) and write a message in the placement attributes. Press ‘Create Project’.

awsenterprise20

11. A confirmation screen will appear, press the ‘Create placements’ button.

awsenterprise21

12. On the next screen, give the placement a name and press the choose a device.

awsenterprise22

13. Click on ‘Choose’ next to the AWS Device

awsenterprise23

14. Press the ‘Create placement’ button at the bottom of the screen.

awsenterprise24

15. You will now see this device in the Placements for this Project.

awsenterprise25

16. Press the button once on the AWS Enterprise Device. When the light on the device turns solid green a text is sent to specified the number.

Download a PDF of this blog: AWS Enterprise Button Configuration

AWS Enterprise Button Configuration

AT&T LTE-M Button Configuration

ltem-button-1

Before Button Configuration:
1. Set up an Amazon Web Service (AWS) Account.
2. Download the AWS 1-Click App from either the iOS App Store or Google’s Play Store.
3. Order an AT&T LTE-M Button here:

https://marketplace.att.com/products/att-ltem-button

Adding, Claiming and Enabling the Button

Once you receive your LTE-M Button follow these steps to configure:
1. Open box by prying open the panel on the end that has the white sticker.

ATT1

2. Configure the Button on your mobile device by opening the AWS IoT 1-Click and signing in with your AWS password. This opens the app for button configuration on the setup tab. Press the Claim with Device ID button.

lte-m button2

3. Press the scan button to scan the serial number on the box (You can enter the serial number manually if you have lost the box).

ATT3

4. Scan the Serial Number (SN) barcode on the box with your mobile device, or type in the SN number located on the device. The SN will auto-populate on the screen, press the claim button to add this button to your AWS Account.

ATT4

5. Click the button on the AT&T LTE-M device and press the finish button to finalize the claim. The LED light on the button will turn a solid green once it has successfully transmitted data to AWS. Once you see “Claim Succeeded” message on the screen, press the ‘Finish’ button.

ATT5

6. Press the devices tab at the bottom of the screen to view the device in the app. Click on the device in the list to enable it.

LTE-M Button6.jpg

7. On the next screen, click on the ‘enable’ slider.

lte-m button7

Configuring the Action for the Button

1. Log on to your AWS Console.
2. Click All Services, navigate to → Internet of Things → IoT 1-Click
3. Choose the 1-Click Service, this is what you will use to assign a Lambda Function to the device.

ATT7

4. On the left hand side of the screen you will see the menu for managing 1-Click Devices

ATT8

5. Click on the Manage Option in the 1-Click Menu
6. Create a test project to attach for the AT&T LTE-M Button. Press the ‘Create a Project’  button.

ATT9

7. Enter a Project name and Description and press the ‘Next’ button.

ATT10

8. Press Start to Define a Device Template for the Lambda Function you want the device to use.

ATT11

9. Name the template, and set an action (Lambda Function). In this case, choose ‘Send SMS’.

ATT12

10. A confirmation screen will appear, press the ‘Create Placements’ button.

awsenterprise21

11. On the next screen, give the placement a name.

ATT13

12. Scroll down to Create Placements and enter a device placement name and enter a phone number (+1xxxxxxxxxx) and write a message in the placement attributes. Press ‘Create Project’.

awsenterprise20

13. Press ‘Choose a Device’ to add the AT&T Button to this placement, click on ‘Choose’ to the right of the available devices on the screen, and then press the ‘Create Placement’ button at the bottom of the screen.

lte-m button15

14. You will now see this device in the Placements for this Project.

lte-m button18

15. Press the button once on the AT&T LTE-M Device. When the light on the device turns solid green a text is sent to the specified number.

Download a PDF of this blog: AT&T LTE-M Button Configuration

AT&T LTE-M Button Configuration

AWS IoT Button Configuration

Once you have established your AWS account, you are ready for AWS Internet of Things (IoT) button configuration.

Order here (This is an affliate link full disclosure)

Open box by prying open the panel on the end that has the white sticker

IOT1

2. Remove the documentation that is included in the box and then use your mobile phone’s camera to scan the QR code to open the “Getting Started” page on your phone.

IOT2

3. Review ‘Cloud Programmable Dash Button’ — read the intro description on what the button is, and what it can do.

4. Review ‘Trigger AWS Lambda functions from simple devices’ and the description of the IoT Service.

5. Configure the Button on your mobile device. Open the app: AWSBTNDev – sign in with your AWS password. This opens the app for configuring your button.

6. Click the Plus Sign to configure the new button

7. Click “Agree and Get Started” on the Set up your Button screen.

8. Scan the DSN barcode on the box with your mobile device. The DSN and Name values will auto-populate on the screen.

9. Go to Settings on your mobile device and connect to the button’s wireless network using the password provided on the screen. Utilize the automatic copy/paste function to transfer the password.

10. Select the wi-fi network and enter the password copied from the previous action.

11. Once the certificate has downloaded, set the button action. Select the Lamda function that sends an email on click of the button, then select “Set Action.”

12.Send test email via button click.

13. On first button click, verify the email address through Amazon Web Services automated email.

IOT3

14. Receive email via the AWS IoT button! Your first action is complete.

IOT4

Important Note!

Amazon Web Services has identified a defect that may prevent some AWS IoT developer buttons from operating as expected. To determine if your AWS IoT developer button is impacted, check whether your button flashes a red LED in a long-short-short pattern after it is clicked.

If your button is impacted, here are the two options you can choose from:

Option 1: You can re-provision (see steps below) the impacted developer buttons using the AWS Developer button app. Re-provisioning will apply the correct firmware, and result in a series of white LED flashes for a few seconds, and then subsequent button clicks should become functional with a green LED confirmation. If impacted, you can let AWS know if this option will work for you. AWS has outlined the re-provisioning steps below for your reference.

Option 2: AWS can offer replacement for all your impacted developer buttons. Please note that 2nd Generation developer buttons are out-of-stock so currently they can offer you 1st Generation developer buttons as replacement. Please let them know if you prefer this option.

Re-provisioning steps:

  1. Install and open the “AWS IoT Button Dev” application in the iOS or Android app stores, and log in to the app with your AWS account or IAM user.
  2. If the button is already registered under your account, make a note of the Lambda function used by the button, and then choose the “delete” option for that.
  3. Then choose “Set up AWS IoT Button”, scan the DSN barcode (or type it in manually from the back of the button), and click “Register Button”.
  4. Once, the app automatically sets up your cloud resources, follow the instructions in the app to configure the button’s Wi-Fi.
  5. When asked to associate a lambda function with the button, choose the original function to keep the same functionality. The button should then resume normal.

Download a PDF of this blog: AWS IoT Button Configuration
Download a PDF of links below: AWS IoT Button Config Links

AWS IoT Button Config Links
West dashboard homehttps://us-west-1.console.aws.amazon.com/console/home?region=us-west-1
AWS IoT Button Wizard Quickstart Guidehttps://docs.aws.amazon.com/iot/latest/developerguide/iot-button-lambda.html
FAQhttps://aws.amazon.com/iotbutton/faq/
Review ‘Cloud Programmable Dash Button’https://aws.amazon.com/iotbutton/
Review ‘Trigger AWS Lambda functions from simple devices’https://aws.amazon.com/iot-1-click/
AWS Lambda Resourceshttps://aws.amazon.com/lambda/resources/#Getting_Started
AWS Lambda overview and introductory video with sample use caseshttps://aws.amazon.com/lambda/
Working with Lambda Functionshttps://docs.aws.amazon.com/lambda/latest/dg/lambda-introduction-function.html
Console-based Getting Started exercisehttps://docs.aws.amazon.com/lambda/latest/dg/getting-started.html
Deploying Applications with AWS Lambdahttps://docs.aws.amazon.com/lambda/latest/dg/deploying-lambda-apps.html
Use Caseshttps://docs.aws.amazon.com/lambda/latest/dg/use-cases.html
Best Practices for Working with AWS Lambda Functionshttps://docs.aws.amazon.com/lambda/latest/dg/best-practices.html
Tech supporthttps://aws.amazon.com/contact-us
After Registering Buttons Via Mobile
Dashboard > Connect to AWS IoThttps://us-west-2.console.aws.amazon.com/iotv2/home?region=us-west-2#/connectdevice/
Connect an IoT devicehttps://us-west-2.console.aws.amazon.com/iotv2/home?region=us-west-2#/connectdevice/
Choose button from list of registered buttonshttps://us-west-2.console.aws.amazon.com/iotv2/home?region=us-west-2#/connectdevice/
Download a connection kithttps://us-west-2.console.aws.amazon.com/iotv2/home?region=us-west-2#/connectdevice/
Configure and test your device
AWS IoT Button Configuration