For more information on getting started with your download, refer to the Getting Started section of Amazon FreeRTOS webpage.
For more information on Amazon FreeRTOS, refer to the Amazon FreeRTOS User Guide.
Use the following MCU hardware to get started:
- Texas Instruments - CC3220SF-LAUNCHXL.
- STMicroelectronics - STM32L4 Discovery kit IoT node.
- NXP - LPC54018 IoT Module.
- Microchip - Curiosity PIC32MZEF.
- Espressif -ESP32-DevKitC & ESP-WROVER-KIT -
SOON
To evaluate Amazon FreeRTOS without using an MCU-based hardware, use the following:
- Windows Simulator - Microsoft Windows 7 or newer, with at least a dual core and a hard-wired Ethernet connection.
Based on your MCU hardware, download one of the following Integrated Development Environments (IDEs):
- Texas Instruments - Code Composer Studio.
- STMicroelectronics - STM32 System Workbench.
- NXP - IAR Embedded Workbench.
- Microchip - MPLAB X IDE.
- Windows Simulator - Visual Studio Community Edition.
In the console, create your user and choose Add permissions.
Choose Attach existing policies directly.
In the search box, type:
AmazonFreeRTOSFullAccess
AWSIoTFullAccess
In the AWS IoT console choose Secure, choose Policies and create a policy.
In the Add statements section, choose Advanced mode.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iot:Connect",
"Resource":"arn:aws:iot:<aws-region>:<aws-account-id>:*"
},
{
"Effect": "Allow",
"Action": "iot:Publish",
"Resource": "arn:aws:iot:<aws-region>:<aws-account-id>:*"
},
{
"Effect": "Allow",
"Action": "iot:Subscribe",
"Resource": "arn:aws:iot:<aws-region>>:<aws-account-id>:*"
},
{
"Effect": "Allow",
"Action": "iot:Receive",
"Resource": "arn:aws:iot:<aws-region>:<aws-account-id>:*"
}
]
}
In the AWS IoT console go to Manage and then create a single Things in this way:
Type a name for your thing.
Add a certificate for your thing page (choose Create certificate).
Download your private key and certificate.
Choose Activate, because Certificates must be activated prior to use.
Choose Attach a policy to attach.
Choose the policy you just created and choose Register thing.
Import the Amazon FreeRTOS Sample Code into the STM32 System Workbench
Copy your AWS IoT endpoint from the Endpoint text box. It should look like <1234567890123>.iot..amazonaws.com.
In aws_clientcredential.h set clientcredentialMQTT_BROKER_ENDPOINT to your AWS IoT endpoint.
Go to :
<BASE_FOLDER>\demos\common\devmode_key_provisioning\CertificateConfigurationTool\CertificateConfigurator.html.
Under Certificate PEM file, choose the -certificate.pem.crt you downloaded from the AWS IoT console.
Under Private Key PEM file, choose the -private.pem.key you downloaded from the AWS IoT console.
Choose Generate and save aws_clientcredential_keys.h, and then save the file in <BASE_FOLDER>\demos\common\include.
In the AWS IoT console go to Test In the Subscription topic text box, type freertos/demos/echo and then choose Subscribe to topic.