![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2018\/10\/micropython-esp32-esp8266-gpios.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nPrerequisites<\/h2>\n\n\n\n
To program the ESP32 and ESP8266 with MicroPython, we use uPyCraft IDE as a programming environment. Follow the next tutorials to install uPyCraft IDE and flash MicroPython firmware on your board:<\/p>\n\n\n\n
- Install uPyCraft IDE: Windows PC<\/a>, MacOS X<\/a>, or Linux Ubuntu<\/a><\/li>
- Flash\/Upload MicroPython Firmware to ESP32 and ESP8266<\/a><\/li><\/ul>\n\n\n\n
Alternatively, if you’re having trouble using uPyCraftIDE, we recommend using Thonny IDE instead: Getting Started with Thonny MicroPython (Python) IDE for ESP32 and ESP8266<\/a><\/p>\n\n\n\n
If this is your first time dealing with MicroPython you may find these next tutorials useful:<\/p>\n\n\n\n
- Getting Started with MicroPython on ESP32 and ESP8266<\/a><\/li>
- MicroPython Programming Basics with ESP32 and ESP8266<\/a><\/li><\/ul>\n\n\n\n
Project Overview<\/h2>\n\n\n\n
With this tutorial you’ll learn how to use the ESP32 or ESP8266 GPIOs with MicroPython. You can read the separate guide for each topic:<\/p>\n\n\n\n
- Read digital inputs<\/a><\/li>
- Control digital outputs<\/a><\/li>
- Read analog inputs<\/a><\/li>
- Generate PWM signals<\/a><\/li><\/ul>\n\n\n\n
We’ll build a simple example that works as follows:<\/p>\n\n\n\n
- Read the state of a pushbutton and set the LED state accordingly – when you press the pushbutton the LED lights up.<\/li><\/ul>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2018\/10\/led_pushbutton.png?resize=750%2C373&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n- Read the voltage from a potentiometer and dim an LED accordingly to the shaft’s position of the potentiometer.<\/li><\/ul>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2018\/10\/led-fade.png?resize=750%2C152&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nSchematic<\/h2>\n\n\n\n
The circuit for this project involves wiring two LEDs, a pushbutton, and a potentiometer. Here’s a list of all the parts needed to build the circuit:<\/p>\n\n\n\n
- ESP32<\/a> or ESP8266<\/a> (read: ESP32 vs ESP8266<\/a>)<\/li>
- 2x LEDs<\/a><\/li>
- 2x 330 Ohm resistor<\/a><\/li>
- Pushbutton<\/a><\/li>
- Potentiometer<\/a><\/li>
- Breadboard<\/a><\/li>
- Jumper wires<\/a><\/li><\/ul>\n\n\n
You can use the preceding links or go directly to MakerAdvisor.com\/tools<\/a> to find all the parts for your projects at the best price!<\/p>
![](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2017\/10\/header-200.png?w=1200&quality=100&strip=all&ssl=1\")
<\/a><\/p>\n\n\n\nESP32 – Schematic<\/h3>\n\n\n\n
Follow the next schematic diagram if you’re using an ESP32:<\/p>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2018\/10\/interacting-with-GPIOs-ESP32_bb.png?resize=826%2C988&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nNote: <\/strong> the ESP32 supports analog reading in several GPIOs: 0, 2, 4, 12, 13, 14, 15, 25, 26, 27 32, 33, 34, 35, 36, and 39.<\/p>\n\n\n\n
Recommended reading:<\/strong> ESP32 Pinout Reference: Which GPIO pins should you use?<\/a><\/p>\n\n\n\n
ESP8266 – Schematic<\/h3>\n\n\n\n
Follow the next schematic diagram if you’re using an ESP8266:<\/p>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2018\/10\/interacting-with-GPIOs-ESP8266_bb.png?resize=688%2C1054&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nNote: <\/strong> the ESP8266 only supports analog reading in pin ADC0 (A0).<\/p>\n\n\n\n
Code<\/h2>\n\n\n\n
Copy the following code to the main.py<\/em> file in the uPyCraft IDE.<\/p>\n\n\n\n
Note: <\/strong> analog reading works differently in ESP32 and ESP8266. The code works right away in ESP32. To use with ESP8266, you have to uncomment and comment the lines described in the MicroPython script.<\/p>\n\n\n
# Complete project details at https:\/\/RandomNerdTutorials.com\n# Created by Rui Santos\n\nfrom machine import Pin, ADC, PWM\nfrom time import sleep\n\nled = Pin(2, Pin.OUT)\nbutton = Pin(15, Pin.IN)\n\n#Configure ADC for ESP32\npot = ADC(Pin(34))\npot.width(ADC.WIDTH_10BIT)\npot.atten(ADC.ATTN_11DB)\n\n#Configure ADC for ESP8266\n#pot = ADC(0)\n\nled_pwm = PWM(Pin(4),5000)\n\nwhile True:\n button_state = button.value()\n led.value(button_state)\n\n pot_value = pot.read()\n led_pwm.duty(pot_value)\n\n sleep(0.1)\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\n
How the code works<\/h3>\n\n\n\n
Continue reading to learn on how the code works.<\/p>\n\n\n\n
Importing Libraries<\/h4>\n\n\n\n
To interact with the GPIOs you need to import the machine<\/span> module that contains classes to interact with the GPIOs. Import the Pin<\/span> class to interact with the pins, the ADC<\/span> class to read analog value, and the PWM<\/span> class to generate PWM signals.<\/p>\n\n\n\n
from machine import Pin, ADC, PWM<\/code><\/pre>\n\n\n\nImport the sleep()<\/span> method from the time<\/span> module. The sleep()<\/span> method allows you to add delays to the code.<\/p>\n\n\n\n
from time import sleep<\/code><\/pre>\n\n\n\nInstantiating Pins<\/h4>\n\n\n\n
After importing all the necessary modules, instantiate a Pin<\/span> object called led<\/span> on GPIO 2<\/span> that is an OUTPUT.<\/p>\n\n\n\n
led = Pin(2, Pin.OUT)<\/code><\/pre>\n\n\n\nThe Pin<\/span> object accepts the following attributes in the following order:<\/p>\n\n\n\n
Pin(Pin number, pin mode, pull, value)<\/code><\/pre>\n\n\n\n- Pin number<\/strong> refers to the GPIO we want to control;<\/li>
- Pin mode<\/strong> can be input (IN<\/span>), output (OUT<\/span>) or open-drain (OPEN_DRAIN<\/span>);<\/li>
- The pull<\/strong> argument is used if we want to activate a pull up or pull down internal resistor (PULL_UP<\/span>, or PULL_DOWN<\/span>);<\/li>
- The value<\/strong>corresponds to the GPIO state (if is is on or off): it can be 0<\/span> or 1<\/span> (True or False). Setting 1<\/span> means the GPIO is on. If we don\u2019t pass any parameter, its state is 0<\/span> by default (that’s what we’ll do in this example).<\/li><\/ul>\n\n\n\n
After instantiating the led<\/span> object, you need another instance of the Pin<\/span> class for the pushbutton. The pushbutton is connected to GPIO 15<\/span> and it’s set as an input. So, it looks as follows:<\/p>\n\n\n\n
button = Pin(15, Pin.IN)<\/code><\/pre>\n\n\n\nInstantiating ADC<\/h4>\n\n\n\n
In the ESP32, to create an ADC<\/span> object for the potentiometer on GPIO 34:<\/p>\n\n\n\n
pot = ADC(Pin(34))<\/code><\/pre>\n\n\n\nIf you’re using an ESP8266, it only supports ADC on ADC0 (A0) pin. To instantiate an ADC object with the ESP8266:<\/p>\n\n\n\n
pot = ADC(0)<\/code><\/pre>\n\n\n\nThe following line applies just to the ESP32. It defines that we want to be able to read voltage in full range. This means we want to read voltage from 0 to 3.3 V.<\/p>\n\n\n\n
pot.atten(ADC.ATTN_11DB)<\/code><\/pre>\n\n\n\nThe next line means we want readings with 10 bit resolution (from 0 to 1023)<\/p>\n\n\n\n
pot.width(ADC.WIDTH_10BIT)<\/code><\/pre>\n\n\n\nThe width()<\/span> method accepts other parameters to set other resolutions:<\/p>\n\n\n\n
- WIDTH_9BIT<\/strong>: range 0 to 511<\/li>
- WIDTH_10BIT<\/strong>: range 0 to 1023<\/li>
- WIDTH_11BIT<\/strong>: range 0 to 2047<\/li>
- WIDTH_12BIT<\/strong>: range 0 to 4095<\/li><\/ul>\n\n\n\n
If you don’t specify the resolution, it will be 12-bit resolution by default on the ESP32.<\/p>\n\n\n\n
Instantiating PWM<\/h4>\n\n\n\n
Then, create a PWM<\/span> object called led_pwm<\/span> on GPIO 4<\/span> with 5000 Hz.<\/p>\n\n\n\n
led_pwm = PWM(Pin(4), 5000)<\/code><\/pre>\n\n\n\nTo create a PWM<\/span> object, you need to pass as parameters: pin, signal’s frequency, and duty cycle.<\/p>\n\n\n\n
The frequency <\/strong>can be a value between 0 and 78125. A frequency of 5000 Hz for an LED works just fine.<\/p>\n\n\n\n
The duty cycle<\/strong> can be a value between 0 and 1023. In which 1023 corresponds to 100% duty cycle (full brightness), and 0 corresponds to 0% duty cycle (unlit LED).<\/p>\n\n\n\n
We\u2019ll just set the duty in the while loop, so we don\u2019t need to pass the duty cycle parameter at the moment. If you don\u2019t set the duty cycle when instantiating the PWM<\/span> object, it will be 0 by default.<\/p>\n\n\n\n
Getting the GPIO state<\/h4>\n\n\n\n
Then, we have a while loop that is always True. This is similar to the loop()<\/span> function in the Arduino IDE.<\/p>\n\n\n\n
We start by getting the button state and save it in the button_state<\/span> variable. To get the pin state use the value()<\/span> method as follows:<\/p>\n\n\n\n
button_state = button.value()<\/code><\/pre>\n\n\n\nThis returns 1 or 0 depending on whether the button is pressed or not.<\/p>\n\n\n\n
Setting the GPIO state<\/h4>\n\n\n\n
To set the pin state, use the value(state)<\/span> method in the Pin<\/span> object. In this case we’re setting the button_state<\/span> variable as an argument. This way the LED turns on when we press the pushbutton:<\/p>\n\n\n\n
led.value(button_state)<\/code><\/pre>\n\n\n\nReading analog inputs<\/h4>\n\n\n\n
To read an analog input, use the read()<\/span> method on an ADC<\/span> object (in this case the ADC object is called pot<\/span>).<\/p>\n\n\n\n
pot_value = pot.read()<\/code><\/pre>\n\n\n\nControlling duty cycle<\/h4>\n\n\n\n
To control the duty cycle, use the duty()<\/span> method on the PWM object (led_pwm<\/span>). The duty()<\/span> method accepts a value between 0 and 1023 (in which 0 corresponds to 0% duty cycle, and 1023 to 100% duty cycle). So, pass as argument the pot_value<\/span> (that varies between 0 and 1023). This way you change the duty cycle by rotating the potentiometer.<\/p>\n\n\n\n
led_pwm.duty(pot_value)<\/code><\/pre>\n\n\n\nTesting the Code<\/h3>\n\n\n\n
Upload the main.py<\/em> file to your ESP32 or ESP8266. For that, open uPyCraft IDE and copy the code provided to the main.py<\/em> file. Go to Tools<\/strong> > Serial<\/strong> and select the serial port. Select your board in Tools<\/strong> > Board<\/strong>.<\/p>\n\n\n\n
Then, upload the code to the ESP32 or ESP8266 by pressing the Download and Run<\/strong> button.<\/p>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2018\/10\/uPycraft-ide-tools-menu-download-and-run.png?resize=238%2C45&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nNote: <\/strong> to get you familiar with uPyCraft IDE youn can read the following tutorial – Getting Started with MicroPython on ESP32 and ESP8266<\/a><\/p>\n\n\n\n
After uploading the code, press the ESP32\/ESP8266 on-board EN\/RST button to run the new script.<\/p>\n\n\n\n
Now, test your setup. The LED should light up when you press the pushbutton.<\/p>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2018\/10\/esp32-es8266-micropython-pushbutton.jpg?resize=750%2C500&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nThe LED brightness changes when you rotate the potentiometer.<\/p>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2018\/10\/esp32-es8266-micropython-pot-pwm.jpg?resize=750%2C500&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nWrapping Up<\/h2>\n\n\n\n
This simple example showed you how to read digital and analog inputs, control digital outputs and generate PWM signals with the ESP32 and ESP8266 boards using MicroPython. <\/p>\n\n\n\n
If you like MicroPython, you may like the following projects:<\/p>\n\n\n\n
- ESP32\/ESP8266 MicroPython Interrrupts<\/a><\/li>
- MicroPython: WS2812B Addressable RGB LEDs with ESP32\/ESP8266<\/a><\/li>
- Low Power Weather Station Datalogger using ESP8266 and BME280 with MicroPython<\/a><\/li>
- ESP32\/ESP8266 MicroPython Web Server<\/a><\/li><\/ul>\n\n\n\n
We hope you\u2019ve found this article about how to control ESP32 and ESP8266 GPIOs with MicroPython useful. If you want to learn more about MicroPython, make sure you take a look at our eBook: MicroPython Programming with ESP32 and ESP8266<\/a>.<\/strong><\/p>\n\n\n\n
Thanks for reading.<\/p>\n","protected":false},"excerpt":{"rendered":"
In this article we’re going to take a look on how to interact with the ESP32 and ESP8266 GPIOs using MicroPython. We’ll show you how to read digital and analog … <\/p>\n
- MicroPython: WS2812B Addressable RGB LEDs with ESP32\/ESP8266<\/a><\/li>
- WIDTH_10BIT<\/strong>: range 0 to 1023<\/li>
- Pin mode<\/strong> can be input (IN<\/span>), output (OUT<\/span>) or open-drain (OPEN_DRAIN<\/span>);<\/li>
- 2x LEDs<\/a><\/li>
- ESP32<\/a> or ESP8266<\/a> (read: ESP32 vs ESP8266<\/a>)<\/li>
- Read the voltage from a potentiometer and dim an LED accordingly to the shaft’s position of the potentiometer.<\/li><\/ul>\n\n\n\n
- Control digital outputs<\/a><\/li>
- MicroPython Programming Basics with ESP32 and ESP8266<\/a><\/li><\/ul>\n\n\n\n
- Flash\/Upload MicroPython Firmware to ESP32 and ESP8266<\/a><\/li><\/ul>\n\n\n\n