awsdocs / aws-freertos-docs

FreeRTOS Documentation

NOTICE

This repository is archived, read-only, and no longer updated. For more information, read the announcement on the AWS News Blog.

You can find up-to-date AWS technical documentation on the AWS Documentation website, where you can also submit feedback and suggestions for improvement.

aws-freertos-docs's Issues

Wrong source file to set up IDE test project for Wi-Fi library

In afr-porting-wifi.md (commit 130ad25), to set up the Wi-Fi library in the IDE project, it reads:

Add the source file aws_test_wifi.c to the aws_tests IDE project.

But there is no aws_test_wifi.c found in the amazon-freertos source version 202012.00.

Acm command does not work with AWS CLI v2

AWS CLI v2 changes the way that b64 encoded files are read (https://docs.aws.amazon.com/cli/latest/userguide/cliv2-migration.html#cliv2-migration-binaryparam) and that breaks the acm import-certificate command syntax used in the examples.

The correct way to import certificates in the v2 CLI is:

aws acm import-certificate --certificate fileb://... --private-key fileb://...

This works also in v1.

Latest OTA create role documentation is missing iam:PassRole

The commit c031cc0 update to aws-freertos-docs/doc_source/create-service-role.md removed the permissions PassRole from the policy document. It appears that this is still required as without it submitting the OTA job results in this error:

        "otaUpdateStatus": "CREATE_FAILED",
        "errorInfo": {
            "code": "AWSIotException",
            "message": "User: arn:aws:sts::<account_id>:assumed-role/iot-ota/#### is not authorized to perform: iam:PassRole on resource: arn:aws:iam::<account_id>:role/iot-ota (Service: AWSIot; Status Code: 403; Error Code: AccessDeniedException; Request ID: <req_id>)"
        }

When the role is created according to the previous documentation updates are able to be submitted successfully.

OTA Bitmapping with JSON array

The bitmap for OTA seems like it is behaving differently for me in that with the documentation it says:

{"b" : binary }

I have to treat my bitmap like a JSON array i.e.

{"b": [255,255,255] } //for 24 blocks for instance

where the array size is determined by (number of blocks)/8

so array index 1 has blocks 8-15 for example

is this the way to deal with bitmapping?

Wrong chip referred in the ESP32 pages

https://docs.aws.amazon.com/freertos/latest/userguide/getting_started_esp32wroom-32se.html

Under "Download and configure FreeRTOS" there is a sectional copy and paste error referring to the ATECC608A part from Microchip. This page is about the Espressif ESP32. That section is completely wrong.