Download FreeRTOS
 

Quality RTOS & Embedded Software

LIBRARIES
WHAT'S NEW
FreeRTOS-Plus-TCP now has unified IPv4 and IPv6 functionalities and multi-interface support.
Achieving Unbrickable MCU FOTA for your FreeRTOS-powered Firmware:
FreeRTOS 202012 LTS end of support announced.
FreeRTOS website now available in Simplified Chinese
New FreeRTOS Long Term Support version now available.

ESP32-C3

by Espressif

The ESP32-C3 has been configured to work with the AWS Quick Connect demo. This demo uses AWS services to take care of the AWS account creation and AWS IoT configuration required to connect your device to AWS IoT. Once connected, messages containing data collected from sensors are sent from the device, allowing you to simulate AWS IoT applications.

To begin the Quick Connect demo:

Step 1: Connect the ESP32-C3 to a computer using a USB 2.0 cable (Micro B).

Step 2: Download the Quick Connect setup package for the computer you will use to set up the ESP32-C3 board.
Download QuickConnect_Espressif-ESP32C3_windows.x64.zip for Windows
Download QuickConnect_Espressif-ESP32C3_macos.x64.tar.gz for Mac
Download QuickConnect_Espressif-ESP32C3_linux.x64.tar.gz for Linux

Step 3: For Windows users, download and install the USB to UART Virtual Com Port driver which can be found here.
For Linux users, the currently logged user should have read and write access to the serial port over USB. On most Linux distributions, this is done by adding the user to dialout group with the following command:

sudo usermod -a -G dialout $USER
Make sure you re-login to enable read and write permissions for the serial port.

Step 4: Unzip the Quick Connect archive, and run the file Start_Quick_Connect.
Note: You may receive warnings while trying to run the application. If so, see the troubleshooting section below.

Step 5: Follow & complete all of the prompts in the command line interface. Note: This board only supports 2.4 GHz wifi connections.

Step 6: When Start_Quick_Connect is complete, a file called CLICK-ME.html will be created in the same directory. Double-click CLICK-ME.html to open a custom URL where you can visualize data from the sensors on your ESP32-C3 board.


To update the Quick Connect demo:

Step 1 Set up the integrated development environment (IDE) - skip this step if already set up: Follow the ESP32C3 getting started guide up to and including step 4 (NOTE: Ensure that you download version 4.4 or higher).

Step 2 Load the quick connect projects: In the command line interface (CLI) that was set up in the previous step, download the source code for the AWS Quick Connect demo, and follow the instructions in the “How to use” section of the README file to clone the repository.
Keep this CLI open for future steps.

Step 3 Edit the project: In a text or code editor of your choice, open main/main.c, located inside the aws-quickconnect folder.
Inside the file, navigate to the function prvQuickConnectSendingTask.
pcSendBuffer contains the JSON we send to the visualizer. To add a new graph component, add a new field to the JSON of the format '[ { "label": <title>, "display_type" : "line_graph", "values": [ { "unit" : <unit>, "value" : <val>, "label" : "" } ] } ]'.
To see an example of this, please set CUSTOM_GRAPH_ENABLED to 1.

Step 4 Build the project:

From the same CLI as before, run cd aws-quickconnect && idf.py set-target esp32c3.
Then run idf.py -p <PORT> build, where <PORT> is from this guide.

Step 5 Flash the board: In case the Start_Quick_Connect executable is still open, close it. This is important as you will not be able to flash the built binary to your device as them serial port will be busy.
From the same CLI as before, run idf.py -p <PORT> build.
After successfully flashing, you should see a second graph appear on the visualizer page.

Specifications

ESP32-C3-DevKitC-02 is an entry-level development board based on the ESP32-C3-WROOM-02, a general-purpose module with 4 MB SPI flash. This board integrates complete Wi-Fi and Bluetooth LE functions. Meant for simple and secure connectivity applications, the ESP32-C3 is a single-core, 32-bit, RISC-V-based MCU with 400KB of SRAM, which is capable of running at 160MHz. It has integrated 2.4 GHz Wi-Fi and Bluetooth 5 (LE) with a long-range support. It has 22 programmable GPIOs with support for ADC, SPI, UART, I2C, I2S, RMT, TWAI, and PWM.


Hardware Architecture

RISC-V

Network Connectivity

Bluetooth LE (BLE), Sub-GHz, Wi-Fi 2.4 GHz only

Mounting / Form Factor

Embedded

Operating System

FreeRTOS

Security

Secure boot, flash encryption, digital signature and HMAC peripheral

Power

USB Powered

Learn more

I/O Interfaces

Programmable GPIOs, SPI, UART, USB, I2C, I2S, PWM, JTAG, GDMA, TWAI, ADC

Environmental

Extended

Programming Language

C/C++

Storage

Flash/SRAM

Troubleshooting:

Permission issues while running the application:

Windows: After double-clicking the Quick Connect executable, depending on your security settings, you may see a pop up window that says "Windows protected your PC". Click on the "More info" link to see a "Run anyway" button. Click on the "Run anyway" button.

Mac: After double-clicking the Quick Connect executable, depending on your security settings, you may see a pop up window that says "Start_Quick_Connect cannot be opened because it is from an unidentified developer". Right click on the Start_Quick_Connect file in the Finder app and select the "Open" option. Then click on the "Open" button in the popup that shows up.

Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.