Acoptex.com

members

Basics: Project 070o

Project name: Installing uPyCraft IDE to program ESP32 Development board and ESP8266 ESP-12E module

Tags: ESP32 Dev Module, ESP32 development board, ESP32 Development board with WiFi and Bluetooth, ESP32-DevKitC V4 development board, ESP-WROOM-32 module with ESP32‑D0WDQ6 chip, Espressif Systems, ESP32-based development board, ESP32 modules, ESP32-WROOM-32, ESP32-WROOM-32U, ESP32-WROOM-32D, ESP32-SOLO-1, USB-UART bridge, IOT, ESP-WROOM-32 Dev Module, ESP32 DEVKITV1, Installing the ESP32 Board in Arduino IDE, Uploading sketch, ESP8266, WI FI module, ESP-12E, Ai Thinker, AI-Cloud, SOC, GPIO, General Purpose Input Output, System On a Chip, IOT, internet of things, FTDI232, FTDI 232, how to upload sketch, LoLin NODEMCU V3, NODEMCU, V3, Development Board with USB-to-Serial Onboard, NodeMCU DevKit, uPyCraft IDE, Linux Ubuntu, Windows, Mac OS X, Source Code Pro font, SourceCodePro font, Please install SourceCodePro font

Attachments: 

In this project, you need these parts :

1. ESP32 development board with WiFi and Bluetooth and USB A / micro USB B cable 1 pc

2. ESP8266 ESP-12E module with micro USB cable 1pc

General

We will learn how to install uPyCraft IDE to program ESP32 Development board and ESP8266 ESP-12E module.

There are different firmwares that you can use to program the ESP32 Development board and ESP8266 ESP-12E module. If you want to program the ESP32 Development board or ESP8266 ESP-12E module using the MicroPython firmware, we recommend using uPyCraft IDE. uPyCraft IDE runs in any major operating system. In this project we show you how to install the uPyCraft IDE for MicroPython on Windows OS, Mac OS X.

Understanding the ESP8266 ESP-12E WI FI module (LoLin NODEMCU V3)

You can read more about it here.

Understanding the ESP32 Development board with WiFi and Bluetooth

You can read more about it here.

TX - transmit pin. GPIO pin

RX  - receive pin.  GPIO pin

3V3 (or 3V or 3.3V) - power supply pin (3-3.6V). 

GND ( or G) - ground pin.

RST - reset pin. Keep it on high (3.3V) for normal operation. Put it on 0V to reset the chip.

EN - Chip enable. Keep it on high (3.3V) for normal operation.

Vin - External power supply 5VDC.

D0-D8 - GPIO (General Purpose Input Output) pins 

D5-D8 - SPI interface

D1-D2– I²C/TWI Interface

SC (or CMD) - (Chip Select) - the pin that the master can use to enable and disable specific devices. GPIO pin

SO (or SDO) - Master In Slave Out (MISO) - SPI communication. The Slave line for sending data to the master. GPIO pin

SK (or CLK) - SCK (Serial Clock) - SPI communication.The clock pulses which synchronize data transmission generated by the master. GPIO pin

S1 (or SD1) - Master Out/Slave In (MOSI). SPI communication. The Master line for sending data to the peripherals. GPIO pin

S2 (or SD2) - GPIO pin

S3 (or SD3) - GPIO pin

VU (or VUSB) - external power 5VDC.

A0 - ADC output.

RSV - reserved

Signals and connections of the ESP32 Development board with WiFi and Bluetooth

You can find more information (datasheets, schematics, pins descriptions, functional desgn descriptions) about each board (made by Espresiff Systems) by pressing Getting started link close to each board here.

Let's check our development board - ESP32 DEVKITV1 with ESP-WROOM-32 module from Espressif Systems:

Pinout diagram for the ESP Wroom 32 breakout:

ESP32-WROOM-32 - ESP32-WROOM-32 module soldered to the development board. Optionally ESP32-WROOM-32D, ESP32-WROOM-32U or ESP32-SOLO-1 module may be soldered instead of the ESP32-WROOM-32.

USB-UART Bridge - A single chip USB-UART bridge provides up to 3 Mbps transfers rates.

BOOT button - Download button: holding down the Boot button and pressing the EN button initiates the firmware download mode. Then user can download firmware through the serial port.

EN button - Reset button: pressing this button resets the system.

Micro USB Port - USB interface. It functions as the power supply for the board and the communication interface between PC and the ESP module.

TX0, TX2 - transmit pin. GPIO pin

RX0, RX2  - receive pin.  GPIO pin

3V3 (or 3V or 3.3V) - power supply pin (3-3.6V). 

GND - ground pin.

EN - Chip enable. Keep it on high (3.3V) for normal operation.

Vin - External power supply 5VDC.

Step by Step instruction

WINDOWS 10 OS

1. Installing Python 3.7.x on Windows 10 OS (64bit version)

Before installing the uPyCraft IDE, make sure you have the latest version of Python 3.7.x installed in your PC.

1. You need to install Python 3.7.X on your PC. Go to python.org website and download the latest version of Python 3.7.X for your OS (Operating System) (We are using Python 3.7.0 version in this project. You can download 64bit version here or 32bit version here. The installation process is similarfor both of them).
2. 
3. Double-click on the downloaded file (python-3.7.0.exe or python-3.7.0-amd64.exe ) to start the Python installation wizard. Make sure that add python 3.7 to PATH selected. Click on Install now
4. 
5. Wait a few seconds while the software completes the installation process.
6. Press Yes button to give access to the drive.
7. 
8. When it’s done, you should see the message Setup was successful. Press Close button.
9. 

2. Installing uPyCraft IDE on Windows 10 OS (64bit version)

1. Download uPyCraft IDE for Windows here.
2. When downloading process completed you will see uPyCraft_V1.1.exe file in your Downloads folder.
3. Double-click that file. You will see the small pop up window Please install Source Code Pro font. Press Yes button. 
4. 
5. A new window opens with the uPyCraft IDE software.
6. 
7. Source Code Pro is a set of OpenType fonts that have been designed to work well in user interface (UI) environments. In addition to a functional OpenType font, this open source project provides all of the source files that were used to build this OpenType font by using the AFDKO makeotf tool. 
8. Download Source Code Pro fonts here. Extract the fonts from zip file to a folder. Navigate to the folder that contains the Source Code Pro fonts and select all fonts (we selected all with .ttf to install). Right-click the selected fonts and choose Install as Administrator. The fonts are now installed. You should not get the pop up window again when running uPyCraft IDE software.
9. We will be using this software to flash our ESP based boards with MicroPython firmware as well as to program the boards.

Mac OS X

1. Installing Python 3.7.x on Mac OS X

Before installing the uPyCraft IDE, make sure you have the latest version of Python 3.7.x installed in your PC.

1. Open a terminal window and type the next command: brew install python3
2. 
3. Wait a few seconds while the installation procedure is completed.
4. Since uPyCraft IDE is open source and downloaded from the Internet, it’s not a verified app in the App Store. For security reasons, Mac OS X blocks unknown apps to run on your computer. We will explain you how to enable any downloaded software to run in your Mac.
5. Go to apple sign->System Preferences... and select it from menu.
6. 
7. Open the Security & Privacy.
8. 
9. At the bottom left corner, press lock icon to modify your Security & Privacy settings.
10. 
11. Type your username/password and press Unlock button.
12. 
13. Select the option Allow apps downloaded from: Anywhere.
14. 
15. Close that window.

2. Installing uPyCraft IDE on Mac OS X

1. Download uPyCraft IDE for Mac OS X here.
2. When downloading process completed you will see uPyCraft_mac_V1.0.zip file in your Downloads folder.
3. Unzip the uPyCraft_mac_V1.0.zip file and you should see a new file called uPyCraft. Double-click the uPyCraft file.
4. Press Open button to run it.
5. 
6. We will be using this software to flash our ESP based boards with MicroPython firmware as well as to program the boards.

Linux Ubuntu

1. Installing Python 3.7.x on Linux Ubuntu

Before installing the uPyCraft IDE, make sure you have the latest version of Python 3.7.x installed in your PC.

1. Run this command to install Python 3 and pip: sudo apt install python3 python3-pip
2. 

2. Installing uPyCraft IDE on Linux Ubuntu 

We are using Linux Ubuntu 16.04. If you want to run it on a different Ubuntu version or Linux distribution, we recommend using uPyCraft IDE source code and compile the software yourself.

1. Download uPyCraft IDE for Linux Ubuntu here.
2. Open your Terminal window, navigate to your Downloads folder with the command: cd Downloads
3. List all the files with the command: ls -l
   
4. You will see uPyCraft_linux_V1.0 file in your Downloads folder. Make that file executable with the following command: chmod +x uPyCraft_linux_V1.X
5. If you want to open/run the uPyCraft IDE software, type the command: ./uPyCraft_linux_V1.X
6. We will be using this software to flash our ESP based boards with MicroPython firmware as well as to program the boards.
7. 

Summary

We have learnt how to install uPyCraft IDE to program ESP32 Development board and ESP8266 ESP-12E module.

Libraries

• No libraries required for this project

Sketch

• None