The ESP32-WROOM-32, a popular microcontroller, offers a wealth of possibilities for embedded systems projects. One of the simplest yet effective ways to interact with this powerful chip is through Micropython, a lean and efficient implementation of Python 3. This post will guide you through controlling the onboard LED of the ESP32-WROOM-32 using Micropython, providing a complete pinout guide and practical examples. Understanding this fundamental interaction is crucial for any beginner venturing into ESP32 development.
Controlling the ESP32's Onboard LED with Micropython
Controlling the built-in LED is a common starting point for many embedded projects. This simple task provides a great introduction to the hardware and software interaction necessary for more complex applications. Micropython's ease of use makes it ideal for this purpose. We will use GPIO pins, which are the general-purpose input/output pins on the ESP32. These pins can be configured to control various peripherals, and the onboard LED is conveniently connected to one of them. We’ll learn how to toggle its state (on and off) and even create simple blinking effects. Understanding this process lays the foundation for controlling other peripherals.
Identifying the Correct GPIO Pin
Before we begin coding, we need to identify the GPIO pin connected to the onboard LED. The specific pin number varies slightly depending on the board revision, but it’s usually pin 2. Consult your ESP32-WROOM-32 datasheet for the exact pin number. Incorrect pin selection will result in your code not functioning correctly. It’s essential to double-check this information before proceeding. Always refer to the manufacturer's documentation to ensure you’re working with the correct pin assignment for your specific board version. Taking this step prevents significant frustration later on. Espressif's GPIO documentation provides helpful information.
Micropython Code for LED Control
Once you've identified the correct GPIO pin, you can proceed to write the Micropython code. The following code snippet demonstrates how to turn the onboard LED on and off. We'll use the machine module to access the GPIO pins. Remember to replace 2 with your LED's actual GPIO pin number. This code is remarkably simple, highlighting the ease of use of Micropython for controlling hardware. This simple example is a stepping stone to much more complex interactions with the ESP32.
from machine import Pin, time led = Pin(2, Pin.OUT) Replace 2 with your LED pin led.value(1) Turn LED ON (1 represents HIGH) time.sleep(2) Wait for 2 seconds led.value(0) Turn LED OFF (0 represents LOW) For a blinking effect, you can add a loop:
from machine import Pin, time led = Pin(2, Pin.OUT) while True: led.value(1) time.sleep(0.5) led.value(0) time.sleep(0.5) This loop will continuously toggle the LED state, creating a simple blink. This fundamental example can be expanded upon to create more sophisticated blinking patterns or integrate with other sensors and actuators. Remember to save this code to your ESP32's file system and run it using a Micropython interpreter.
ESP32-WROOM-32 Pinout and LED Location
Understanding the ESP32-WROOM-32's pinout is essential for any interaction with its hardware. The pinout diagram shows the location of each pin, including the one connected to the onboard LED. While the exact location might differ slightly across versions, the overall layout remains consistent. This is crucial for effective hardware interaction. A visual pinout diagram, combined with the code examples above, provides a complete understanding of how to control the onboard LED.
| Pin Number | Function | Description |
|---|---|---|
| 2 (Typically) | GPIO | Onboard LED |
| Other Pins | Various | Refer to the datasheet for details. 
|