Below are the instructions to set up your Windows computer (host machine) to be able to download the code from the GitHub repository, view and edit the code, compile the code to be usable by the hardware, and upload the code to the hardware’s flash memory. These installation steps are sufficient for the Getting Started tutorial, which uses Espressif’s AWS account and services for the RainMaker platform.
To download the code from the remote code repository on GitHub, you’ll need to install git, a widely adopted distributed version control system. It is primarily used for source code management and collaboration—often for tracking file changes or distributing code between a local machine and remote server. To install Git and dependencies we’ll need such as OpenSSL:
The Core2 for AWS IoT EduKit communicates with the host machine through a Silicon Labs CP210x USB to UART bridge. The on-board CP2104 is an USB-to-UART bridge to facilitate host communication with the ESP32-D0WD microcontroller. The microcontroller communicates bi-directionally over UART0, which the CP210x translates through a virtual communications port on the host machine it establishes over USB-C. To enable the mounting of the virtual serial port and communications across it, you will need to download and install the corresponding driver.
You must extract the contents of the folder, the driver will not install if the executable is run from within the archive.
Visual Studio Code (VS Code) is an open source integrated development environment (IDE) which allows you to view, edit, manage code and more. Download the latest Visual Studio Code for your operating system. For troubleshooting issues with Visual Studio Code installation or usage, please refer to their documentation.
PlatformIO (PIO) provides a professional embedded development platform which simplifies embedded software development. The Visual Studio Code extension provides the functionality of the Platform IO command line interface (CLI) in a graphical interface. You can download the extension and read more about PlatformIO here.
You need to restart VS Code after PlatformIO extension installation finishes.
All of the projects and files exist in a GitHub repository, where you can also view the revision history of each file in the repository (repo). To clone the code you’ll need for the tutorials, you’ll be using the PIO interface by:
https://github.com/m5stack/Core2-for-AWS-IoT-EduKit.gitinto the text field and then select the location you want to save the project in.
The ESP RainMaker Phone Apps are available for iOS and Android phones to provide Wi-Fi network configuration, user-creation, user-device association and device control. The apps can be found here:
If you do not posess a compatible Android or iOS device, you can use the RainMaker CLI and substitute the provided instructions.
If you haven’t already, it’s time to unbox the Core2 for AWS IoT EduKit reference hardware and connect it to your host computer’s USB 2.0 port using the supplied USB-A to USB-C cable to facilitate communication between them. Additionally, included in the package is a hex key that can be used for the installation of additional modules (sold separately). The device should automatically turn on once you plug it in, but if you need to turn it on, press the power button.
With the device ready and the software you’ll need for this tutorial installed, let’s identify the port your device is virtually mounted to so that you can perform read & write operations to that specific port.
COM3) to copy the device port.
If your Core2 for AWS IoT EduKit does not show up in the list of devices, check that it’s powered on and you are using the supplied USB-A to USB-C cable. Some USB-C hubs have compatibility issues with establishing a serial port.
With everything set up and your host machine ready and able to communicate with the Core2 for AWS IoT EduKit reference hardware, let’s continue to the next chapter — Running the ESP RainMaker Agent.