Project template for the M5Stack Core2 for AWS IoT EduKit reference hardware. Use this template as a baseline for creating your applications on your hardware. This includes all the drivers and configurations for using the hardware features on the devices. View the API reference for using the included board support package.
This repo uses Git Submodules to bring in dependent components.
Note: If you download the ZIP file provided by GitHub UI, you will not get the contents of the submodules. Since the downloaded zip will also not be a git repository, you will not be able to compile the code since that is a toolchain requirement. You must clone the repository using the instructions below.
If using Windows, because this repository and its submodules contain symbolic links, set core.symlinks
to true with the following command:
git config --global core.symlinks true
In addition to this, either enable Developer Mode or, whenever using a git command that writes to the system (e.g. git pull
, git clone
, and git submodule update --init --recursive
), use a console elevated as administrator so that git can properly create symbolic links for this repository. Otherwise, symbolic links will be written as normal files with the symbolic links' paths in them as text. This gives more explanation.
To clone using HTTPS:
git clone https://github.com/aws-iot-edukit/Project_Template-Core2_for_AWS.git --recurse-submodules
Using SSH:
git clone [email protected]:aws-iot-edukit/Project_Template-Core2_for_AWS.git --recurse-submodules
If you have downloaded the repo without using the --recurse-submodules
argument, you need to run:
git submodule update --init --recursive
This is the entry point for your application. Modify this file to create your own custom application.
This is the location of the board support package. These include drivers and helper libraries for controlling the on-board peripherals on the device.
This is a ported cryptoauthlib from Espressif. This fork is a specific port for the Core2 for AWS reference hardware. This library enables use of the on-board secure element and is tightly integrated with the ESP-IDF. The name of the folder should not be modified.
This is the partition table recommended for most applications. It provides sufficient file system sizes for storing Wi-Fi credentials, the user application, OTA updates, additional file storage, and storage for SPIFFS in the on-board flash. This utilizes the internal + external flash memory.
See CONTRIBUTING for more information.
This library is licensed under the MIT-0 License. See the LICENSE file.