Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DRAFT: Add submodule to latest esp-idf and updated readme #54

Closed
wants to merge 6 commits into from

Conversation

rawalexe
Copy link
Member

@rawalexe rawalexe commented Oct 8, 2023

Add submodule to latest esp-idf and updated readme

Description

Updates the Readme to add instruction on how to use the Amazon's version of FreeRTOS and adds a submodule pointer to latest esp-idf

Test Steps

Checklist:

  • I have tested my changes. No regression in existing tests.
  • I have modified and/or added unit-tests to cover the code changes in this Pull Request.

Related Issue

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

@rawalexe rawalexe requested a review from a team as a code owner October 8, 2023 15:54
@Skptak
Copy link
Member

Skptak commented Oct 8, 2023

/bot run formatting

@@ -4,3 +4,6 @@
[submodule "components/esp-aws-iot"]
path = components/esp-aws-iot
url = https://github.com/espressif/esp-aws-iot.git
[submodule "esp-idf"]
path = esp-idf
url = [email protected]:espressif/esp-idf.git
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use the https url here

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

will do

@@ -45,6 +45,7 @@ Once completed, one can progress to the [Use Security Features](UseSecurityFeatu
- WiFi access point with access to the internet.

### 1.2 Software Requirements
> **NOTE:** For convenience sake, there is an esp-idf v5.1.1 submoduled at the root of the directory, other versions on esp-idf may also be used but does not guarantee full compatibility.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we're going to add this submodule we should change the instructions to tell users to run the install and export scripts

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sounds like a good idea, but a link to latest esp-idf document might also makes sense. what you think?

@@ -45,6 +45,7 @@ Once completed, one can progress to the [Use Security Features](UseSecurityFeatu
- WiFi access point with access to the internet.

### 1.2 Software Requirements
> **NOTE:** For convenience sake, there is an esp-idf v5.1.1 submoduled at the root of the directory, other versions on esp-idf may also be used but does not guarantee full compatibility.

- ESP-IDF 4.4.3 or higher to configure, build, and flash the project. To setup for the ESP32-C3, follow Espressif's [Getting Started Guide for the ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is incorrect now if we're telling users to use 5.1.1

Copy link
Member Author

@rawalexe rawalexe Oct 8, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well we still want people to use other version of esp-idf but just are saying the full support will be only for 1. Might help us with ops burden. Also a standardized setting for debugging for future

@@ -61,6 +62,7 @@ Once completed, one can progress to the [Use Security Features](UseSecurityFeatu
to configure the basic settings (security credentials, the default AWS output format and the default AWS Region)
that AWS CLI uses to interact with AWS. (If you don't have an AWS account and user, follow steps 1 and 2 in the AWS IoT Core Setup Guide below before following the Configuration basics for the AWS CLI.)


Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Blank line

GettingStartedGuide.md Show resolved Hide resolved
6. If you are using the `ESP32` chip you may experience buffer overflow, feel free to decrease the task's buffer size of the demo or `coreMQTT-Agent network buffer size` to fit your use case.
7. You may also increase the `Timeout for receiving CONNACK in milliseconds` if you are experiencing timeout issues.
8. Furthermore you may want to use the Amazon's FreeRTOS that can be enabled from `Component config > FreeRTOS > Kernel> Run the Amazon SMP FreeRTOS kernel instead (FEATURE UNDER DEVELOPMENT)`
8. Go back to main menu, Save and Exit.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be 9. Right?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

correct will update

6. Go back to main menu, Save and Exit.
6. If you are using the `ESP32` chip you may experience buffer overflow, feel free to decrease the task's buffer size of the demo or `coreMQTT-Agent network buffer size` to fit your use case.
7. You may also increase the `Timeout for receiving CONNACK in milliseconds` if you are experiencing timeout issues.
8. Furthermore you may want to use the Amazon's FreeRTOS that can be enabled from `Component config > FreeRTOS > Kernel> Run the Amazon SMP FreeRTOS kernel instead (FEATURE UNDER DEVELOPMENT)`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Think this line should be "If you want to use the FreeRTOS-Kernel's Symmetrical multiprocessing feature..."?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

noted, thank you

@rawalexe rawalexe changed the title Add submodule to latest esp-idf and updated readme DRAFT: Add submodule to latest esp-idf and updated readme Oct 8, 2023
@rawalexe rawalexe marked this pull request as draft October 24, 2023 21:22
@rawalexe rawalexe closed this Jan 29, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants