====== Configuración del Software ======

  - Utilice la utilidad Raspberry Pi Imager para programar la imagen del sistema operativo Raspberry Pi en la tarjeta microSD como se muestra a continuación.
    - Inserte la tarjeta microSD en el lector de tarjetas microSD y conecte el lector de tarjetas microSD a la computadora\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s0.png |Insertar tarjeta microSD}}</WRAP>
    - Abra la aplicación rpi-imager desde la carpeta Applications\Raspberry Pi Imager en la unidad flash\\ \\ <WRAP round tip>Si pregunta "¿Quieres permitir que esta aplicación realice cambios en tu dispositivo?" haga clic en el botón "Sí"</WRAP>
    - Seleccione el botón "CHOOSE OS"\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s1.png |Pantalla inicial}}</WRAP>
    - Seleccione la opción "Raspberry Pi OS (other)" de la lista\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s2.png |Seleccionar el tipo de imagen}}</WRAP>
    - Seleccione la opción "Raspberry Pi OS Lite (32 bit)" de la lista\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s3.png |Seleccionar archivo de imagen}}</WRAP>
    - Seleccione el botón "CHOOSE STORAGE"\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s4.png |Pantalla principal}}</WRAP>
    - Seleccione la tarjeta microSD\\ \\ <WRAP round tip>El tamaño de la tarjeta microSD debe ser de aproximadamente 16 GB</WRAP> <WRAP round tip>Si la tarjeta microSD ya tiene una imagen, se mostrará Montado como /Volumes/boot</WRAP> <WRAP box>{{ :pibot:lesson1:softwarewin:s5.png |Seleccionar tarjeta microSD}}</WRAP>
    - Mantenga presionadas las teclas Shift + Ctrl + X al mismo tiempo para abrir la ventana de opciones avanzadas
    - Haga clic en el cuadro junto a la opción "Set hostname:" y cambie el valor a "pibot##" donde el ## proviene de la etiqueta en el PiBot\\ \\ <WRAP round tip>Utilice la tecla de retroceso para eliminar el valor que ya está allí</WRAP> <WRAP box>{{ :pibot:lesson1:softwarewin:s5a.png |Opciones avanzadas - nombre de host}}</WRAP>
    - Haga clic en la casilla junto a la opción "Enable SSH" y establezca la contraseña para el usuario pi en "DogsAndCatsAreNice2."\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s5b.png |Opciones avanzadas - SSH}}</WRAP>
    - Desplácese hacia abajo, haga clic en el cuadro junto a la opción "Configure wifi" y escriba el SSID, la contraseña y seleccione el país Wifi para su red Wifi\\ \\ <WRAP round tip>El SSID y la contraseña se completarán de forma predeterminada según la red a la que esté conectada su computadora</WRAP> <WRAP round tip>Haz clic en la casilla junto a la opción "Show password" para ver la contraseña de Wifi.</WRAP> <WRAP round tip>Si su red inalámbrica no tiene contraseña, omita este paso y siga las instrucciones [[:es:pibot:lesson1:softwarewin:wifi|aquí]] después de completar los pasos a continuación para escribir la tarjeta SD</WRAP> <WRAP round tip>Si se encuentra fuera de los Estados Unidos, utilice el código de país Wifi con el [[https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes|Código de país ISO 3166 alpha-2]]</WRAP> <WRAP box>{{ :pibot:lesson1:softwarewin:s5c.png |Opciones avanzadas - Wifi}}</WRAP>
    - Desplácese hacia abajo, haga clic en el cuadro junto a la opción "Set locale settings" y seleccione la configuración de zona horaria y teclado para su ubicación\\ \\ <WRAP round tip>La zona horaria y el teclado se completarán de forma predeterminada según la configuración de su computadora</WRAP> <WRAP round tip>Si se encuentra fuera de los Estados Unidos, utilice la zona horaria con la [[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones| Zona horaria de la base de datos TZ]]</WRAP> <WRAP box>{{ :pibot:lesson1:softwarewin:s5d.png |Opciones avanzadas - configuración regional}}</WRAP>
    - Haga clic en el botón Guardar para cerrar la ventana de opciones avanzadas y volver a la ventana principal 
    - Seleccione el botón "WRITE"\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s6.png |Pantalla final}}</WRAP>
    - CHaga clic en el botón "YES" cuando se le pregunte si desea continuar.\\ \\ <WRAP round tip>Si se le solicita su contraseña para continuar, ingrésela para dar permiso para escribir en la tarjeta microSD</WRAP> <WRAP box>{{ :pibot:lesson1:softwarewin:s7.png |Solicitud de confirmación}}</WRAP>
    - Cuando la utilidad Raspberry Pi Imager haya finalizado, haga clic en el botón "CONTINUE" y cierre la utilidad Raspberry Pi Imager.
    - Retire el lector de tarjetas microSD de la computadora
  - Retire la tarjeta microSD del lector de tarjetas microSD y conéctela a la placa Raspberry Pi como se muestra a continuación\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s8.png |Insertar tarjeta microSD}}</WRAP>
  - Instale las baterías 18650 cargadas en la caja de la batería 18650 y deslice el interruptor a la posición "ON"
  - Espere de 3 a 5 minutos para que la luz verde deje de parpadear
  - Abra la aplicación putty desde la carpeta Applications\PuTTY\<versión> en la unidad flash\\ \\ <WRAP round tip>La carpeta <versión> será algo así como "0,75". Utilice la última versión disponible.</WRAP>
  - Escriba "pibot ##" en el cuadro Nombre de host (o dirección IP) "donde el ## proviene de la etiqueta del PiBot.\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s9.png |Configuración de PuTTY}}</WRAP>
  - Haga clic en el botón "Open" para conectarse al terminal Raspberry Pi a través de SSH\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s10.png |Conexión abierta PuTTY}}</WRAP>
  - Si aparece una ventana de "Alerta de seguridad de PuTTY", haga clic en el botón "Accept"\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s11.png |Alerta de seguridad PuTTY}}</WRAP>
  - Escriba "pi" en el mensaje "iniciar sesión como:" y presione Entrar\\ \\ <WRAP round important>La contraseña para ingresar cuando se le solicite es "DogsAndCatsAreNice2." sin las comillas. Los '.' al final es importante!</WRAP><WRAP box>{{ :pibot:lesson1:softwarewin:s12.png |PuTTY Acceso}}</WRAP>
  - Realice los siguientes pasos para habilitar la interfaz I2C en la placa Raspberry Pi
    - Escriba el siguiente comando y presione enter para ejecutar la utilidad de configuración de Raspberry Pi\\ \\ <code>sudo raspi-config</code>
    - Utilice las teclas de flecha hacia arriba y hacia abajo para seleccionar el elemento del menú "Interfacing Options" y luego presione la tecla Intro.\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s13.png |Menú Principal}}</WRAP>
    - Utilice las teclas de flecha hacia arriba y hacia abajo para seleccionar el elemento de menú "I2C" y presione la tecla Intro.\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s14.png |Menú de Interfaz}}</WRAP>
    - Utilice las teclas de flecha izquierda y derecha para seleccionar la opción "Yes" y presione la tecla Intro.\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s15.png |Habilitar I2C}}</WRAP>
    - Seleccione la opción "OK" y presione la tecla Intro.\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s16.png |I2C Confirmado}}</WRAP>
    - Utilice las teclas de flecha izquierda y derecha para seleccionar la opción "Finish" y presione la tecla Intro.\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s17.png |Salida}}</WRAP>
  - Escriba los siguientes comandos y presione enter después de cada línea para instalar la biblioteca rpi.GPIO y la aplicación PIP3\\ \\ <WRAP round tip>Responda "yes" o "y" cuando se le solicite instalar paquetes adicionales o continuar</WRAP> <code>sudo apt-get update
sudo apt-get upgrade
sudo apt-get install python3-rpi.gpio python3-pip</code>
  - Escriba el siguiente comando y presione enter para instalar la biblioteca Adafruit-pca9685\\ \\ <code>sudo pip3 install adafruit-pca9685</code>
  - Escriba los siguientes comandos y presione enter para crear un directorio para el código PiBot\\ \\ <code>mkdir -p ~/pibot
cd ~/pibot</code>
  - Escriba el siguiente comando y presione enter para descargar el código de Python para esta lección\\ \\ <code>wget http://osoyoo.com/driver/picar/picar-basic.py</code>
  - Coloque el PiBot en el suelo en un área libre de obstáculos.
  - Escriba el siguiente comando y presione enter para hacer que el PiBot se mueva\\ \\ <code>python3 picar-basic.py</code>
  - Escriba el siguiente comando y presione enter para cerrar la conexión SSH\\ \\ <code>exit</code>

===== Explicación del Software =====

  - Para ver el código que hace que PiBot se ejecute, realice los siguientes pasos
    - Abra VSCode desde el directorio de Applications en la unidad flash
    - Haga clic en el pequeño cuadrado verde en la esquina inferior izquierda de la pantalla.\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s18.png |Pantalla principal de VSCode}}</WRAP>
    - Seleccione la opción "Remote-SSH: Connect Current Window to Host ..."\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s19.png |VSCode Remote-SSH}}</WRAP>
    - Escriba "pi@pibot##" y presiona enter\\ \\ <WRAP round important>Reemplace el texto "pibot##" con la etiqueta en el PiBot</WRAP> <WRAP round important>Si aparece una ventana de "Windows Security Alert", haga clic en el botón "Allow Access"</WRAP> <WRAP round tip>Es posible que tarde un par de minutos en instalar algunos archivos en el PiBot.</WRAP> <WRAP box>{{ :pibot:lesson1:softwarewin:s20.png |Conexión remota VSCode}}</WRAP>
    - Seleccione "Linux" para la plataforma del host remoto\\ \\ <WRAP round important>Si pregunta "are you sure you want to continue", Seleccione "continue" para finalizar la conexión.</WRAP> <WRAP round important>La contraseña para ingresar cuando se le solicite es "DogsAndCatsAreNice2." sin las comillas. Los '.' al final es importante!</WRAP> <WRAP round tip>Es posible que tarde un par de minutos en instalar algunos archivos en el PiBot.</WRAP> <WRAP box>{{ :pibot:lesson1:softwarewin:s21.png |Conexión remota VSCode}}</WRAP>

    - Haga clic en el icono que parece dos hojas de papel en la parte superior izquierda de la ventana y haga clic en el botón "Open Folder".\\ \\ <WRAP box>{{ :pibot:lesson1:softwarewin:s22.png |Carpeta abierta VSCode}}</WRAP>
    - Seleccione la carpeta "pibot" y haga clic en el botón "OK"\\ \\ <WRAP round important>La contraseña para ingresar cuando se le solicite es "DogsAndCatsAreNice2." sin las comillas. Los '.' al final es importante!</WRAP> <WRAP round tip>Si pregunta "Do you trust the authors of this folder?" haga clic en el botón "Yes, I trust the authors"</WRAP> <WRAP box>{{ :pibot:lesson1:softwarewin:s23.png |Exploración de VSCode}}</WRAP>
    - Seleccione el archivo picar-basic.py en la lista de la izquierda\\ \\ <WRAP round tip>Si solicita instalar las extensiones recomendadas, haga clic en el botón de install</WRAP> <WRAP round important>La contraseña para ingresar cuando se le solicite es "DogsAndCatsAreNice2." sin las comillas. Los '.' al final es importante!</WRAP> <WRAP box>{{ :pibot:lesson1:softwarewin:s24.png |VSCode picar-basic.py}}</WRAP>
  - usque la línea 20 en el archivo picar-basic.py. Cual es el nombre de la variable? ¿Qué valor se asigna a la variable? ¿Qué crees que controla este valor en el PiBot?\\ \\ <WRAP round tip>Los números de línea se muestran a la izquierda de cada línea de texto y son una característica del editor de código de Visual Studio.</WRAP> <WRAP round tip>Las variables son "palabras" cortas que pueden contener valores. Le permiten cambiar el valor en un lugar y actualizarlo en varios lugares del código. También permiten que el código cambie el valor de la variable.</WRAP> <WRAP round tip>Los valores se asignan a las variables mediante el carácter '='</WRAP>
  - Busque los otros lugares en el código donde se usa esta variable. Cuantos de ellos hay?\\ \\ <WRAP round tip>Cuando ve un texto seguido de un '(' con más texto y luego un ')', es una llamada de función. El texto antes de '(' es el nombre de la función. El texto entre '(' y ')' son parámetros que se pasan a la función. Lo que hace la función se define mediante una 'def' delante del nombre de la función en algún lugar en el código.</WRAP> <WRAP round tip>Las funciones permiten utilizar un conjunto común de pasos en muchos lugares del código sin tener que escribir todos esos pasos cada vez.</WRAP>
  - Encuentre la definición de la función que usa la variable. ¿Qué hace la función?\\ \\ <WRAP round tip>En la definición de la función, el texto entre '(' y ')' puede ser diferente de cuando se llama. Cuando se llama a la función, la variable que se le pasa reemplaza el nombre de la definición.</WRAP> <WRAP round tip>Consulte la sección [[:es:pibot:lesson1#descripcion_electrica|Descripción Eléctrica]] en la página anterior para obtener una descripción de lo que hace el pwm</WRAP>
  - ¿Cómo cambiaría el código para que PiBot se mueva más rápido? ¿Qué tal hacer que se mueva más lento? Realice uno de esos cambios en el código y guárdelo usando File->Save.
  - Abra una terminal en Visual Studio Code desde el menú Terminal->New Terminal
  - Escriba el siguiente comando y presione enter para hacer que el PiBot se mueva con sus cambios\\ \\ <code>python3 picar-basic.py</code>
  - Pruebe el otro cambio en el código siguiendo los mismos pasos
  - Cuando haya terminado de probar sus cambios, escriba el siguiente comando en la terminal y presione Intro para apagar el PiBot\\ \\ <code>sudo shutdown -h now</code>
  - Haga clic en el pequeño rectángulo verde en la esquina inferior izquierda de la pantalla y seleccione "Close Remote Connection"
  - Espere de 3 a 5 minutos para que la luz verde de la Raspberry Pi deje de parpadear y apague el interruptor de la batería PiBot

[[:es:pibot:lesson1#software|Regresar a la Lección 1]]