Código

Desde la ventana con el prompt del REPL en el Thony, podemos ver como funcionará el botón al oprimirlo, checando el estado del pin al que está conectado con los siguientes comandos:

Primero importamos la biblioteca machine, para poder trabajar con los pines de nuestro microcontrolador.

Despues definimos un objeto, pin_boton, que será el pin al que estará conectado el botón, en este caso usaremos el pin 15, que será un pin de entrada.

     import machine
     pin_boton = machine.Pin(15, machine.Pin.IN)

para checar el estado del pin usaremos la instrucción print(), con la que mandaremos a imprimir a la pantalla el valor del estado del pin de entrada donde tenemos conectado el botón:

     print(pin_boton.value())

si no tenemos oprimido el boton estará en un valor de voltaje 0 y nos imprimirá un 0. Si oprimimos el botón y mientras lo mantenemos oprimido, repetimos esta intrucción, nos imprimirá un 1, ya que el pin estará en un voltaje alto.

Resistencias pull-up y pull-down internas

Ya que las resistencias pull-up y pull-down son muy utilizadas, muchos de los nuevos microcontroladores, como los que estamos usando, ya tienen sus propias resistencias integradas en el microcontrolador para cada uno de los pines. Con estas resistencias internas ya no nos será necesario ponerle una resistencia pull-down a nuestros botones y el circuito quedará entonces así:

Y este será el nuevo diagrama

Ahora, para volver a checar el estado de nuestro pin, utilizando estas resistencias internas, tendremos que declarar nuestro objeto para el pin del botón de la siguiente forma:

 import machine
 pin_boton = machine.Pin(15, machine.Pin.IN, machine.Pin.PULL_DOWN)

de esta manera hemos declarado nuestro pin 15 como un pin de entrada al que le hemos habilitado la conexión a la correspondiente resistencia pull-down interna.

Vamos ahora a programar nuestro nuevo circuito con un script que escribiremos en la ventana de programación del Thonny, con este script podremos estar checando el estado de nuestro botón.

Para hacerlo, vamos a usar el comando if que nos permite checar una condición y ver si es verdadera o falsa y de acuerdo a este valor, realiazar ciertas acciones. En este caso checaremos el valor del pin de entrada conectado al botón y de ser positivo, igual a 1, imprimiremos un mensaje.

   import machine   # importamos la biblioteca machine
   import utime     # importamos la biblioteca utime para los tiempos

   pin_boton = machine.Pin(15, machine.Pin.IN, machine.Pin.PULL_DOWN)
     
   while True:      # iniciamos un loop infinito con un while
       if pin_boton.value() == 1:    # checa si el valor del pin es 1
           print('El boton ha sido presionado')   # imprime un mensaje
           utime.sleep(2)    # espera 2 sgs antes de volver a hacerlo 

Como podrás ver en el codigo del if, utilizamos el operador == para checar la igualdad. Hacerlo con el operador =, usando un solo simbolo = que es el operador para asignar un valor a una variable, es un error muy común de programación, que no siempre es fácil de encontrar.

Y también verás que despues de imprimir el mensaje hemos puesto a dormir al microcontrolador por unos segundos, de no hacerlo así, es tan rápida la ejecución del programa, que mientras mantenemos oprimido el botón, se enviarían una gran cantidad de mensajes.