![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/06\/Raspberry-Pi-Pico-Digital-Inputs-Outputs-MicroPython.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nWe have a similar guide using Arduino IDE<\/strong>: Raspberry Pi Pico: Control Digital Outputs and Read Digital Inputs (Arduino IDE)<\/a>.<\/p>\n\n\n\n To follow this tutorial you need MicroPython firmware installed in your Raspberry Pi Pico board. You also need an IDE to write and upload the code to your board. <\/p>\n\n\n\n The recommended MicroPython IDE for the Raspberry Pi Pico is Thonny IDE. Follow the next tutorial to learn how to install Thonny IDE, flash micropython firmware, and upload code to the board.<\/p>\n\n\n\n To show you how to use digital inputs and digital outputs, we’ll build a simple project example with a pushbutton and an LED. We’ll read the state of the pushbutton and light up the LED accordingly as illustrated in the following figure.<\/p>\n\n\n The Raspberry Pi Pico comes with 40 pins, 26 of which are programmable GPIOs that you can use to connect peripherals.<\/p>\n\n\n\n You can use the following pinouts as a reference to identify and locate each GPIO on your board. The pinout is slightly different for the Pico and Pico W.<\/p>\n\n\n\n The following picture shows the Raspberry Pi Pico pinout (which functions are supported by each pin).<\/p>\n\n\n The pins marked in red are power pins that output 3.3V. The black pins are GND pins. All pins in light green can be used as “regular” GPIOs (input and output).<\/p>\n\n\n\n To get the value of a GPIO, first, you need to create a Pin<\/span> object and set it as an input. For example:<\/p>\n\n\n\n This creates a Pin<\/span> object called button<\/span> on GPIO 21. So, when you use this line of code, you’re telling your program that GPIO 21 should act as an input (Pin.IN<\/span>).<\/p>\n\n\n\n You also have the option to tell the inputs to use the microcontroller’s internal pull-up or pull-down resistor. For a pushbutton, it’s useful to use the internal pull-down resistor. For that, you can add a third parameter to the Pin()<\/span> constructor (PULL_DOWN<\/span>).<\/p>\n\n\n\n Depending on the way you’re wiring your pushbutton, you may want to use the internal pull-up resistor, in that case:<\/p>\n\n\n\n After declaring it as an input, to get its value, you need to use the value()<\/span> method on the Pin<\/span> object without passing any argument. For example, to get the state of a Pin<\/span> object called button<\/span>, use the following expression:<\/p>\n\n\n\n We’ll show you in more detail how everything works in the project example.<\/p>\n\n\n\n To set a GPIO on or off, first, you need to set it as an output. For example:<\/p>\n\n\n\n This creates a Pin<\/span> object called led<\/span> on GPIO 20. So, when you use this line of code, you’re telling your program that GPIO 20 should act as an output (Pin.OUT<\/span>).<\/p>\n\n\n\n To control the GPIO, use the value()<\/span> method on the Pin<\/span> object and pass 1<\/span> or 0<\/span> as an argument. For example, the following command sets a Pin<\/span> object (led<\/span>) to HIGH\u2014turns the led on:<\/p>\n\n\n\n To set the GPIO to LOW, pass 0<\/span> as an argument\u2014turns the led off:<\/p>\n\n\n\n Before proceeding, you need to assemble a circuit with an LED and a pushbutton. We’ll connect the LED to GPIO 20<\/span> and the pushbutton to GPIO 21<\/span>.<\/p>\n\n\n\n Here\u2019s a list of the parts you need to build the circuit:<\/p>\n\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> You can use the following diagram as a reference to connect the pushbutton and LED to the Raspberry Pi Pico board.<\/p>\n\n\n The following code reads the state of the pushbutton and lights up the LED accordingly.<\/p>\n\n\n View raw code<\/a><\/p>\n\n\n\n You start by importing the Pin<\/span> class from the machine<\/span> module, and the sleep<\/span> class from the time<\/span> module.<\/p>\n\n\n\n Then, create a Pin<\/span> object called led<\/span> on GPIO 20<\/span>. LEDs are outputs, so pass as second argument Pin.OUT<\/span>. <\/p>\n\n\n\n We also create an object called button<\/span> on GPIO 21<\/span>. Buttons are inputs, and we want to use the internal pull-down resistor, so we declare it as follows.<\/p>\n\n\n\n Use button.value()<\/span> to return\/read the button state. Then, pass the button.value()<\/span> expression as an argument to the LED value.<\/p>\n\n\n\n This way, when we press the button, button.value()<\/span> returns 1<\/span>. So, this is the same as having led.value(1)<\/span>. <\/p>\n\n\n\n This sets the LED state to 1<\/span>, lighting up the LED. When the pushbutton is not being pressed, button.value()<\/span> returns 0<\/span>. So, we have led.value(0)<\/span>, and the LED stays off.<\/p>\n\n\n\n Save the code to your Raspberry Pi Pico board using Thonny IDE<\/a> or any other MicroPython IDE of your choice.<\/p>\n\n\n\n Follow the next instructions if you’re using Thonny IDE.<\/p>\n\n\n\n Copy the code provided to the Thonny IDE untitled file.<\/p>\n\n\n With the code copied to the file, click on the Save <\/strong>icon. Then, select Raspberry Pi Pico<\/strong>.<\/p>\n\n\n Save the file with the following name: main.py<\/strong>. Overwrite any existing files with the same name.<\/p>\n\n\n Note:<\/strong> When you name a file main.py<\/span>, the Raspberry Pi Pico will run that file automatically on boot. If you call it a different name, it will still be saved on the board filesystem, but it will not run automatically on boot.<\/p>\n\n\n\n Reset your board (unplug and plug it into your computer).<\/p>\n\n\n\n Then, the LED should light up when you press the button and stay off when you release it.<\/p>\n\n\n\n To wrap up, to read the value of a GPIO, we simply need to use the value()<\/span> method on the corresponding Pin<\/span> object. To set the value of a GPIO, we just need to pass as argument 1<\/span> or 0<\/span> to the value()<\/span> method to set it on or off, respectively.<\/p>\n\n\n\n We hope you’ve found this tutorial useful. If you’re just getting started with the Raspberry Pi Pico, make sure you read our getting started guide:<\/p>\n\n\n\n If you prefer to program the Raspberry Pi Pico using Arduino IDE, you can get started with the following tutorial:<\/p>\n\n\n\n You can check out all our Raspberry Pi Pico tutorials and projects on the following link:<\/p>\n\n\n\n You can also learn more about this amazing board using our dedicated Raspberry Pi Pico eBook:<\/p>\n\n\n\nPrerequisites<\/h2>\n\n\n\n
\n
Project Overview<\/h2>\n\n\n\n
![\"Control](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/04\/led_pushbutton.png?resize=825%2C411&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nRaspberry Pi Pico GPIOs<\/h2>\n\n\n\n
![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/05\/Raspberry-Pi-Pico-pinout.png?resize=842%2C642&quality=100&strip=all&ssl=1\")
<\/a>![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/05\/Raspberry-Pi-Pico-W-Pinout.png?resize=861%2C620&quality=100&strip=all&ssl=1\")
<\/a><\/figure><\/div>\n\n\nDigital Inputs<\/h3>\n\n\n\n
button = Pin(21, Pin.IN)<\/code><\/pre>\n\n\n\nbutton = Pin(21, Pin.IN, Pin.PULL_DOWN)<\/code><\/pre>\n\n\n\nbutton = Pin(21, Pin.IN, Pin.PULL_UP)<\/code><\/pre>\n\n\n\nbutton.value()<\/code><\/pre>\n\n\n\nDigital Outputs<\/h3>\n\n\n\n
led = Pin(20, Pin.OUT)<\/code><\/pre>\n\n\n\nled.value(1)<\/code><\/pre>\n\n\n\nled.value(0)<\/code><\/pre>\n\n\n\nSchematic<\/h2>\n\n\n\n
Parts Required<\/h3>\n\n\n\n
\n
![](\"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\nSchematic \u2013 Raspberry Pi Pico
<\/h3>\n\n\n\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/06\/Raspberry-pico-pushbutton-led-circuit_diagram.png?resize=606%2C842&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nScript<\/h2>\n\n\n\n
# Rui Santos\r\n# Complete project details at https:\/\/RandomNerdTutorials.com\/raspberry-pi-pico-outputs-inputs-micropython\/\r\n\r\nfrom machine import Pin\r\nfrom time import sleep\r\n\r\nled = Pin(20, Pin.OUT)\r\nbutton = Pin(21, Pin.IN, Pin.PULL_DOWN)\r\n\r\nwhile True:\r\n led.value(button.value())\r\n sleep(0.1)\r\n print(button.value())<\/code><\/pre>\n\tHow the Code Works<\/h3>\n\n\n\n
from machine import Pin\nfrom time import sleep<\/code><\/pre>\n\n\n\nled = Pin(20, Pin.OUT)<\/code><\/pre>\n\n\n\nbutton = Pin(21, Pin.IN, Pin.PULL_DOWN)<\/code><\/pre>\n\n\n\nled.value(button.value())<\/code><\/pre>\n\n\n\nDemonstration<\/h2>\n\n\n\n
![\"Thonny](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/06\/Thonny-IDE-file-digital-inputs-outputs-fff.png?resize=679%2C663&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"Saving](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/05\/Save-file-to-Raspberry-Pi-Pico.png?resize=214%2C203&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"micropython](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/06\/micropython-main-py-file.png?resize=545%2C327&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/06\/Raspberry-Pi-Pico-Pushbutton-LED-off-demonstration.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure>\n\n\n\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/06\/Raspberry-Pi-Pico-Pushbutton-LED-demonstration.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure>\n<\/figure>\n\n\n\nWrapping Up<\/h2>\n\n\n\n
\n
\n
\n