RAK7248 AWS IoT GreengrassV2 Instructions

: October 30, 2023
: RAK

RAK7248 AWS IoT GreengrassV2

AWS IoT GreengrassV2

To learn more about AWS IoT GreengrassV2, see how it works and what’s new .

Set Up Your Development Environment

Tools Installation (IDEs, Toolchains, SDKs)

RAK7248 is based on Raspberry Pi 4 SBC. By default, the latest Raspbian OS based on Linux is used. More information and the available releases can be found here .
RAKwireless provides ready to use image to be flashed on the SD card here .
The main service is the LoRa packet forwarder. It can be found here .

Additional Software References

Our FAQ page
Our Community Forum

Set Up Your Hardware

A detailed description of components and interfaces can be found in the Datasheet here .
The required power supply is a 5 V/3A USB C that is not included in the package. The device only comes with a USB cable and no adapter. There are no battery options.
The device has only one LED indicator that flashes green when there is activity.
The latest firmware version can be found here .
Instructions on how to set up the new firmware can be found here .

Setup Your AWS Account and Permissions

Refer to the instructions found at the Set up your AWS Account guide. Follow the steps outlined in these
sections to create your account and a user and get started:

Sign up for an AWS account.
Create a user and grant permissions.
Open the AWS IoT console.

Pay special attention to the Notes.

Create Resources in AWS IoT

Refer to the instructions found at the Create AWS IoT Resources guide. Follow the steps outlined in these sections to provision resources for your device:

Create an AWS IoT Policy.
Create a thing object.

Pay special attention to the Notes.

Install the AWS Command Line Interface

To install the AWS CLI on your host machine, refer to the instructions found at the Installing the AWS CLI v2
guide. Installing the CLI is needed to complete the instructions in this guide.
Once you have installed AWS CLI, configure it as per the instructions in this online guide . Set the appropriate values for Access key ID, Secret access key, and AWS Region. You can set the output format to “json” if you prefer.

Install AWS IoT Greengrass

Flash Raspberry Image to SD Card

Download the RAK7248-AWS-GreengrassV2 image.
Download the balenaEtcher software. There are options for Windows, macOS, and Linux. Clicking the Download button will provide you with the software directly, no installation is required.
Flash image to SD Card.

Download the AWS IoT Greengrass Core Software

Greengrass has already been included in the SD card image, its directory is ~/greengrass-nucleus.
You can also download the latest Greengrass core software and install it with commands as follows:
Verify the version of the AWS IoT Greengrass Core softwar.
You will see the Greengrass version displayed – similar to: AWS Greengrass v2.4.0.

Provide Your Credentials

Run the following commands to provide the credentials to the AWS IoT Greengrass Core software.

Run the Installer

Run the installer as shown below. Modify the values as per your region, install directory, and thing name.
Use the –provision true option to have the installer set up the “thing” and required policies for you. If you prefer to configure Greengrass manually, see the online guide.
if all goes well, you will see the following output on the device console:
The local development tools (specified by the –deploy-dev-tools option) take some time to deploy. The following command can be used to check the status of this deployment.
When the status is SUCCEEDED, run the following command to verify that the Greengrass CLI is installed and runs on your device. Replace /greengrass/v2 with the path to the base folder on your device as needed.

Create a Hello World Component

In Greengrass v2, components can be created on the edge device and uploaded to the cloud, or vice versa.

Create the Component on Your Edge Device

Follow the instructions online under the section To create a Hello World component to create, deploy, test, update and manage a simple component on your device.