ESP32 Dev Environment

1 Hardware

  • USB-to-MicroUSB convertor
  • ESP32 dev board Widora-AIR-ESP32 Board
  • Dev host (supported OS: macOS, Linux and Windows)

the basic dev environment is needed, such as git and brew command tools.

2 Install Driver

here the driver is USB-to-UART chip driver

macOS

$ brew tap caskroom/drivers
$ brew cask install silicon-labs-vcp-driver
$ ls /dev/cu.SLAB*

Connect your dev board to PC, if /dev/cu.SLAB_USBtoUART is shown in terminal, it means that the installation is successful.

Linux

Since the cp210x driver in Linux (kernel version >= 2.6) is built-in, we don’t need extra installation.

Connect your dev board to PC, execute the following command.

$ dmesg
[xxx] cp210x 2-1:1.0: cp210x converter detected
[xxx] usb 2-1: cp210x converter now attached to ttyUSBx

So the full device path of dev board is /dev/ttyUSBx.

Windows

Driver Download

After download and installation, connect board to PC, open Device Manager, if there is an item called Silicon Labs CP210x USB to UART Bridge (COMx), it means that the installation is successful.

The full device path of dev board is COMx.

3 Install flash tool

$ git clone https://github.com/young-mu/esptool
$ cd esptool
$ python setup.py install

If you use Linux, add sudo before the installation command.

Open a new terminal, execute the following command

$ esptool.py version

If 2.0-beta3 is shown in terminal, it means that the installation is successful.

4 Install Ruff SDK

Ruff SDK v1.8.0 (or higher version) supports Ruff Lite (ESP32)

  • If you never installed Ruff SDK, please download and install the lastest version
  • If you installed Ruff SDK before, please upgrade to v1.8.0 or higher version

Please refer to SDK installation