AWS IoT Setup Guidance
AWS Account Setup
There are two primary steps to initialize your AWS environment:
Sign up for an AWS account
Refer to the Official AWS Sign-Up Guide for detailed registration steps.
Create a User with Administrative Access
Follow the Official Admin User Guide to set up your IAM credentials.
AWS IoT Resources Setup
Two core resources must be created within the AWS IoT Console:
AWS IoT Policy
This policy authorizes your device to interact with AWS services.
Setup: See Create IoT Policy Guide.
Concepts: Refer to AWS IoT Core Policies and Security Best Practices.
Examples: See Example IoT Policies for reference templates.
AWS IoT Thing & X.509 Certificate
The “Thing” is the virtual representation of your device. The certificate handles authentication, and the attached policy handles authorization.
Setup: Follow the Create AWS Thing Guide.
Management: See Managing Devices with AWS IoT for long-term maintenance.
Note
For a hands-on introduction, explore the AWS IoT Core Tutorials.
Ameba Configuration Setup
Once your AWS resources are ready, configure the following header files in your project:
1. aws_clientcredential.h
Navigate to demos/include/aws_clientcredential.h and update these fields:
clientcredentialMQTT_BROKER_ENDPOINT: Your unique AWS IoT Endpoint.Option A: Navigate to Settings. Your endpoint is under Device data endpoint.
Option B: Navigate to Connect > Domain Configurations if a custom domain is set.
clientcredentialIOT_THING_NAME: Your Thing Name.Find this under Manage > All devices > Things.
clientcredentialWIFI_SSID: Your local WiFi SSID.clientcredentialWIFI_PASSWORD: Your local WiFi Password.
2. aws_clientcredential_keys.h
Navigate to demos/include/aws_clientcredential_keys.h and update the security keys:
keyCLIENT_CERTIFICATE_PEM: Paste the content of yourdevice.pem.crt.keyCLIENT_PRIVATE_KEY_PEM: Paste the content of yourprivate.pem.key.
Next Steps
With the configuration complete, you are ready to compile. Please refer to the Ameba AWS Building Guide.
