In this chapter, we download and install the software that you will need to view, edit, compile a binary firmware, and transfer the firmware to the device for it to run. Additionally, you’ll be downloading an app on your phone to control the device.
Download and install the SiLabs CP210x drivers to enable your computer to communicate with the Core2 for AWS IoT EduKit device. The on-board CP2104 is an USB-to-UART bridge to facilitate host communication with the ESP32-D0WD microcontroller:
Since OS X Mavericks, Apple has included the necessary USB to serial drivers and no other steps are necessary. To verify that the drivers are installed, loaded, and the device is read for programming, connect the device via the provided USB-C cable and run:
ls -l /dev/cu.S* || ls -l /dev/cu.usbserial*
If your host machine recognizes and is able to communicate with the device, you will see a return value of
/dev/cu.SLAB_USBtoUART or a value that starts with
/dev/cu.usbserial-. Keep this value on hand, as we’ll be using it later.
If the results of the command above returns empty, check the physical connection first. If it doesn’t resolve the issue, follow the instructions for macOS <= 10.8.
On macOS 10.13 and later, the installation of the SiLabs system extension may be blocked. To unblock, open your Mac’s System Preferences Security & Privacy pane, unlock changes by clicking the , allow the developer, and then relock by clicking the . For more information, see Apple Technical Note TN2459.
Linux kernel version 3.x.x and 4.x.x already include the drivers as part of the distribution. To verify they are installed and loaded, run the command in your terminal:
modinfo usbserial modinfo cp210x
If they are not loaded, run the command:
sudo modprobe usbserial sudo modprobe cp210x
The tutorials were only tested on Windows 10 64-bit. We do not support any other configuration of the Windows operating system.
Visual Studio 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 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.
If you already have Espressif IoT Development Framework (ESP-IDF) installed on your computer, you might see an error about missing files or unable to install dependencies such as the esp-windows-curses. This is due to conflicts. To resolve the issue at this time, please reference this post on the PlatformIO Community forum.
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 instructions.
git clone https://github.com/m5stack/Core2-for-AWS-IoT-EduKit.git
Windows has file path length limitations that can cause errors depending on where the project is placed. It is recommended that you clone this repo or extract the zip with a shorter initial path length if this error should occur (e.g. C:\).
Lastly, let’s make sure the device is plugged in to your computer and powered on. The device should automatically turn on once plugged in and connected to a power source, but if you need to turn it on, press the power button.
With the device ready, let’s go to the next chapter — Running the ESP RainMaker Agent.