Pico Game Challenge: Spring Edition 2025 - Recursos del Código Base
==================================================================

Bienvenidos al Pico Game Challenge, un concurso semestral organizado por la Facultad de Ingeniería Mecánica y Eléctrica (FIME) y la Facultad de Telemática de la Universidad de Colima. Este archivo ZIP contiene los recursos necesarios para comenzar tu proyecto basado en el juego "Battle in the Sky". A continuación, encontrarás una descripción de los archivos incluidos y cómo usarlos.

Contenido del ZIP
----------------
1. main.py
   - Descripción: Código base del juego "Battle in the Sky" escrito en MicroPython para Raspberry Pi Pico W.
   - Autor: Pablo Armando Alcaraz Valencia
   - Copyright: (c) 2025 Pablo Armando Alcaraz Valencia
   - Licencia: MIT (ver LICENSE.txt para detalles)
   - Funcionalidad: Implementa un juego simple donde controlas una nave (avatar) para esquivar obstáculos y disparar proyectiles. Incluye soporte para pantalla OLED SSD1306, botones, buzzer y conectividad WiFi para enviar estadísticas al servidor.
   - Nota: Este es el archivo principal que se ejecuta al encender el Raspberry Pi Pico W. Debes personalizarlo según las reglas del concurso.

2. secrets.py
   - Descripción: Archivo de configuración para las credenciales WiFi.
   - Instrucciones: Edita este archivo para incluir el SSID y la contraseña de una red WiFi a la que tengas acceso. Ejemplo:
       SSID = "TuRedWiFi"
       PASSWORD = "TuContraseña"
   - Nota: No compartas este archivo con tus credenciales reales. Los valores actuales ("FIME" y "pablo123pablo") son de ejemplo y deben reemplazarse.

3. ssd1306.py
   - Descripción: Librería de MicroPython para controlar la pantalla OLED SSD1306 (128x64 píxeles).
   - Fuente: Basada en la librería oficial de MicroPython (https://github.com/micropython/micropython-lib/tree/master/micropython/drivers/display/ssd1306).
   - Uso: Requerida por main.py para mostrar gráficos en la pantalla OLED. No necesitas modificarla.

4. LICENSE.txt
   - Descripción: Licencia MIT que rige el uso del código base. Puedes usar, copiar, modificar y distribuir el código siempre que incluyas este archivo en tu proyecto.

Requisitos
----------
- Hardware:
  - Raspberry Pi Pico W
  - Pantalla OLED SSD1306 (128x64 píxeles)
  - 3 botones (Right, Left, Fire) con resistencias según la Guía Técnica
  - Buzzer
  - Batería de 3.7V con interruptor
  - Cables y protoboard
- Software:
  - MicroPython instalado en el Raspberry Pi Pico W (descarga desde https://micropython.org/download/rp2-pico-w/)
  - Software para transferir archivos (como Thonny: https://thonny.org/)

Cómo empezar
------------
1. Configura tu hardware: Conecta los componentes según el esquemático (schematic.png) y la Guía Técnica (guide.txt), disponibles en la página oficial del concurso.
2. Instala MicroPython: Si aún no lo has hecho, flashea tu Raspberry Pi Pico W con el firmware de MicroPython.
3. Edita secrets.py: Actualiza las credenciales WiFi con las de tu red.
4. Copia los archivos: Usa Thonny o un software similar para transferir main.py, secrets.py y ssd1306.py al almacenamiento del Raspberry Pi Pico W.
5. Ejecuta el juego: Asegúrate de que main.py sea el archivo principal (se ejecutará automáticamente al encender el dispositivo). Enciende tu consola y presiona cualquier botón para comenzar.
6. Personaliza: Modifica main.py para agregar tus propias funcionalidades, gráficos o mecánicas, siguiendo las reglas del concurso.

Reglas del concurso
-------------------
- Debes usar este código base ("Battle in the Sky") como punto de partida.
- Personaliza la consola y el juego (gráficos, mecánicas, hardware) para destacar.
- Entrega un video de 3 minutos mostrando tu consola funcionando y un informe breve (máximo 2 páginas) antes del 30 de mayo de 2025.

Notas adicionales
-----------------
- El juego envía estadísticas (disparos, enemigos destruidos, tiempo de juego) a un servidor remoto en https://pabloalcaraz.mx/PicoChallenge/SpringEdition_2025/data/scores/hook.php cuando termina una partida, siempre que esté conectado a WiFi.
- Consulta la Guía Técnica (guide.txt) para detalles sobre el ensamblaje del circuito.
- Si tienes dudas, contacta al coordinador del evento en pablo_alcaraz@ucol.mx.

¡Buena suerte en el Pico Game Challenge!
----------------------------------------
Esperamos ver tu creatividad y habilidades en acción. Innova, crea y compite por premios increíbles, incluyendo un Nintendo Switch para el primer lugar.

Pablo Armando Alcaraz Valencia
Coordinador del Pico Game Challenge
Universidad de Colima