background image

© 2020, Amazon Web Services, Inc. or its affiliates. All rights reserved. 

 

The configuration steps required to create the “Hello World” application and test a device’s ability to communicate 

across the IoT network includes the following: 

 

Creating and Testing the Lambda Function

 

 

Creating the Destination Rule

 

 

Configuring Amazon SNS

 

 

Configuring IoT Analytics

 

 

Testing your “Hello World” Application

 

8.2 Creating and Testing the Lambda Function 

The lambda function is used to process device messages, after they have been processed by the IoT Rules Engine. 

The IoT Rules Engine processes these messages using a configured destination rule. 
To create the lambda function to process device messages processed by the destination rule, follow these steps: 

1. 

Go to the AWS Lambda console (console.aws.amazon.com/lambda). 

2. 

Click on 

Functions

 in the navigation pane. 

3. 

Click on 

Create function

.  

4. 

Select 

Author from scratch. 

 Under 

Basic information

, enter the function name “

sailboatdecoder

” and 

choose 

Runtime Node.js 12.x.

 from the 

Runtime

 drop-down menu. 

5. 

Click on 

Create function

.  

6. 

Navigate to 

<<provide your github repository URL>>

 and copy the code for the lambda function. 

7. 

Under 

Function code

, paste the copied code into the editor under the 

index.js

 tab.  

8. 

Once the code has been pasted, choose 

Deploy

 to deploy the lambda code. 

9. 

Click on the 

Permissions

 tab of the lambda function 

10. 

Change the 

Lambda Role Policy

 permission by following these steps: 

a.

 

Under 

Execution role

, click on the hyperlink under 

Role name

b.

 

On the 

Permissions

 tab, find the policy name and click on it. 

c.

 

Choose 

Edit policy

, and choose the

 JSON 

tab. 

d.

 

Append the following to the 

Statement

 section of the policy to allow publishing to AWS IoT: 

"Effect": "Allow", 

"Action": [ 

"iot:Publish" 

], 

"Resource": [ 

"*" 

}

 

e.

 

Choose 

Review Policy

, then

 Save changes

To test the lambda function, use the following steps to create a test event: 

1. 

In the drop-down for 

Select a test event

, choose 

Configure test events

2. 

Enter a name for the test event under

 Event name

3. 

Paste the following sample payload in the area under 

Event name

    "MessageId": "55d122ab-6355-2233-9874-ff47c5222108", 

    "WirelessDeviceId": "65d128ab-90dd-4668-9556-fe47c589610b",  

    "PayloadData": "zA0LYgHpAX//f/8=", 

    "WirelessMetadata": 

    { 

        "LoRaWAN": 

Summary of Contents for 7310-8

Page 1: ...2020 Amazon Web Services Inc or its affiliates All rights reserved 7310 8 LoRaWAN Gateway with AWS IoT Core Getting Started Guide...

Page 2: ...nt Information 3 2 Overview 3 3 Hardware Description 3 4 Configuring your AWS Account and Permissions 3 5 Getting Started with ADTRAN s 7310 8 Gateway 4 6 Configuring the ADTRAN 7310 8 LoRaWAN Gateway...

Page 3: ...3 1 Data Sheet The data sheet for the ADTRAN 7310 8 gateway can be found here 3 2 Standard Kit Contents The ADTRAN 7310 8 gateway includes the following items in the standard kit ADTRAN s 8 channel En...

Page 4: ...re required for configuring roles and policies in IAM First you must create an IAM role for the Configuration and Update Server CUPS and review its associated policies and then you must create an AWS...

Page 5: ...ou MUST enter the role name as IoTWirelessGatewayCertManagerRole and cannot use a different name This is for consistency with future releases 7 Once the role is created you will need to specify the tr...

Page 6: ...e connect to the IAM console and follow these steps 1 Select Roles from the menu on the left and then select Create Role 2 In the Create Role menu under Select type of trusted entity select Another AW...

Page 7: ...t the documentation for your gateway to locate this value 5 3 2 Registering the LoRaWAN Gateway To register the LoRaWAN gateway with AWS IoT Core for LoRaWAN connect to the AWS IoT console and follow...

Page 8: ...in the following sections 5 4 1 Preparation To complete the endpoint device registration process you will need the following information available LoRaWAN region This must match the gateway LoRaWAN r...

Page 9: ...DlBucketSize4096 AddGwMetadatatrue DevStatusReqFreq 24 DrMax15 TargetPer5 MinGwDiversity1 Proceed in the device configuration only if you have a device and service profile that will work for you 5 4 3...

Page 10: ...reparation Be sure to enter a name for your device in the Wireless device name optional field 5 Navigate to the Profiles section under Wireless device profile select the appropriate profile from the d...

Page 11: ...ce s serial number for example 0007 4 To connect to a discovered device select the device from the list and enter your PIN when prompted The PIN will always be the last 5 digits of the of the gateway...

Page 12: ...mitted and received encapsulated LoRaWAN packets on the port LED Color State Description NET TXNET RX Green Off Indicates no traffic is being passed on the port Flashing Indicates transmitted TX or re...

Page 13: ...t your gateway from the list by pressing it entering your unique 5 digit PIN and selecting Connect NOTE The PIN is last 5 digits of the device serial number and also the default gateway name For secur...

Page 14: ...can use the ADTRAN IoT app to verify the 7310 8 gateway information including hardware and software versions serial number part numbers and model information as well as traffic statistics errors and c...

Page 15: ...nu and select Gateway Status The relevant information is listed in this menu NOTE The Connected Devices count is not currently integrated with AWS Basic Station To verify and configure gateway Etherne...

Page 16: ...nu Select Reset to Factory Default to return the device to the factory default settings NOTE Restoring the gateway to the factory default settings will clear existing certificates reset counters and r...

Page 17: ...tions to the 7310 8 Gateway The first step in provisioning the ADTRAN 7310 8 gateway for use with AWS is to upload the configured CUPS certifications to the gateway To upload the CUPS certificates fol...

Page 18: ...r use with AWS to is provisioning and starting the device s packet forwarding program To provision and start the device s packet forwarding program follow these steps 1 Open the ADTRAN IoT app on your...

Page 19: ...y and device configuration are completed provisioned OTAA devices can join the AWS IoT network and start to send messages Messages from devices are received by AWS IoT Core for LoRaWAN and then forwar...

Page 20: ...from the Runtime drop down menu 5 Click on Create function 6 Navigate to provide your github repository URL and copy the code for the lambda function 7 Under Function code paste the copied code into t...

Page 21: ...o topic The output should look similar to this 8 3 Creating the Destination Rule In this step you create the IoT rule that forwards the device payload to your application This rule is associated with...

Page 22: ...s been given permission to execute the action 12 Choose Add action 13 Add one more action to invoke the Lambda function Under Set one or more actions choose Add action 14 Choose Send a message to a La...

Page 23: ...e number you entered is valid you will receive a text message and your phone number will be confirmed 8 Create an Amazon SNS Topic as follows a In the navigation pane choose Topics b Select Create top...

Page 24: ...to create an IoT analytics rule configure AWS IoT analytics and configure Amazon QuickSight The steps required to perform this configuration are provided in the following sections 8 5 1 Creating an Io...

Page 25: ...d then select Refresh or Schedule Refresh for periodic refresh of dataset 8 6 Testing your Hello World Application Using your device create a condition to generate an event such as a high temperature...

Page 26: ...tion connected to AWS The LoRa Radio Sub Band page on the ADTRAN IoT app is not used for AWS 11 OTA Updates The following outlines the OTA update upgrade procedure 1 Connect to the gateway via the ADT...

Reviews: