Calendario Perpetuo con Google Calendar V2

Guia completa de construccion, instalacion y configuracion

El Calendario Perpetuo mostrando enero con festivos, aniversarios y el reloj de colores

1 Introduccion

Este proyecto es un calendario perpetuo fisico que muestra todos los dias del mes actual usando LEDs de colores. Los digitos de los dias estan posicionados de tal manera que cualquier mes puede mostrarse simplemente encendiendo los LEDs en las posiciones correctas.

Enero 2022 - Domingo como primer dia

Enero 2022 - Lunes como primer dia

El calendario se sincroniza automaticamente con Google Calendar para mostrar:

• Dias festivos - importados de calendarios publicos de tu pais
• Aniversarios - cumpleanos, fechas importantes
• Tareas - eventos y recordatorios

Cada tipo de evento se muestra en un color diferente, permitiendo ver de un vistazo que dias son especiales.

Principio de Funcionamiento

Los numeros permanecen fijos en su lugar. Solo los LEDs se encienden en diferentes posiciones y colores segun el mes:

• Verde - Dias laborables (lunes a viernes)
• Rojo - Fines de semana (sabado y domingo)
• Azul - Dia actual
• Magenta - Festivos
• Cyan - Aniversarios
• Naranja - Tareas

2 Caracteristicas

La Version 2 incluye mejoras significativas sobre el proyecto original:

Especificaciones Tecnicas

3 Materiales Necesarios

Componentes Electronicos

Materiales de Construccion

Acrilico ahumado de 2mm de grosor

Piezas Impresas en 3D

Soporte para los LEDs con relieves

Rejilla separadora

Marco frontal

Pata y tapa trasera

Herramientas

• Soldador y estano
• Pistola de pegamento caliente
• Lija (para redondear esquinas del acrilico)
• Impresora 3D (o acceso a servicio de impresion)
• Cable USB para programar el ESP8266

4 Construccion

Paso 4.1: Preparar las Tiras LED

Corta la tira de LEDs en las siguientes piezas:

• 5 piezas de 13 LEDs cada una
• 1 pieza de 10 LEDs

Las 6 tiras de LEDs cortadas y listas para montar

Paso 4.2: Montar los LEDs en el Soporte

1. Posiciona las tiras de LEDs en el soporte, entre los relieves
2. Presiona firmemente con un palo de plastico para buena adherencia
3. Los relieves permiten acercar los LEDs a 12mm de distancia (como si fuera 83 LEDs/m)
4. Respeta las direcciones de las flechas (zigzag)

LEDs montados en el soporte mostrando el patron zigzag

Paso 4.3: Esquema de Conexiones

Diagrama completo de conexiones - nota el patron zigzag y la resistencia de 3K

Paso 4.4: Preparar el Papel con Numeros

Plantilla impresa con los numeros y nombres de meses

Paso 4.5: Ensamblaje Final

El ensamblaje se realiza en capas, de atras hacia adelante:

1. Soporte con LEDs - Base con las tiras LED montadas y soldadas
2. Modulo ESP y regulador - Fijados con pegamento caliente en la ranura
3. Rejilla 3D - Sobre el soporte, separa la luz de cada LED
4. Papel impreso - Con los numeros hacia arriba
5. Acrilico ahumado - Difunde la luz y protege
6. Marco frontal - Fija todo en su lugar
7. Pata trasera - Con cinta adhesiva de espuma

5 Instalacion del Firmware

Opcion A: Web Flasher (Recomendado)

La forma mas facil de instalar. No requiere ningun software.

1. Conecta el ESP8266 a tu computadora via USB
2. Abre Chrome, Edge u Opera (Firefox/Safari no soportados)
3. Visita: https://XE1E.github.io/Perpetual-Calendar-with-Google-Calendar-Connection-V2/
4. Selecciona la version:
   • Estandar - Calendario basico
   • Reloj de Colores - Incluye reloj HH:MM:SS en LEDs 62-67
5. Haz clic en "Instalar"
6. Selecciona el puerto serial cuando aparezca
7. Espera ~30 segundos a que termine

Opcion B: PlatformIO

# Clonar repositorio
git clone https://github.com/XE1E/Perpetual-Calendar-with-Google-Calendar-Connection-V2.git

# Version estandar
pio run -e standard -t upload

# Version con reloj de colores
pio run -e color_coded_clock -t upload

Opcion C: Arduino IDE

1. Instala Arduino IDE
2. Anade soporte ESP8266: http://arduino.esp8266.com/stable/package_esp8266com_index.json
3. Instala la libreria FastLED desde el gestor de librerias
4. Selecciona placa: NodeMCU 1.0
5. Carga el sketch

6 Configuracion Inicial

Paso 6.1: Conectar al Punto de Acceso

Despues de flashear, el ESP8266 crea una red WiFi:

Paso 6.2: Configurar WiFi

1. Conecta tu telefono/PC a la red "Calendario"
2. Abre un navegador y ve a http://192.168.4.1
3. Haz clic en "Configuracion de Red"
4. Ingresa el SSID y contrasena de tu red WiFi
5. Opcionalmente, configura una red de respaldo
6. Guarda y reinicia

Paso 6.3: Configurar NTP

1. Ve a "Configuracion NTP"
2. Servidor NTP: time.cloudflare.com (o uno local)
3. Zona horaria: Selecciona tu zona (ej: UTC-6 para Mexico Centro)
4. Horario de verano: Activa si aplica en tu region

Paso 6.4: Acceso Normal

Una vez configurado, accede al calendario mediante:

• mDNS: http://perpetualcalendar.local
• IP directa: La IP que le asigno tu router (visible en Serial Monitor)

7 Configuracion de Google Calendar

Paso 7.1: Crear Calendarios en Google

Necesitas tres calendarios separados:

1. Festivos - Importa el calendario de festivos de tu pais desde "Explorar calendarios de interes"
2. Aniversarios - Crea un nuevo calendario para cumpleanos y fechas importantes
3. Tareas - Crea un nuevo calendario para tareas y recordatorios

Paso 7.2: Obtener IDs de Calendarios

1. Ve a calendar.google.com
2. Haz clic en los tres puntos junto al calendario
3. Selecciona "Configuracion y uso compartido"
4. Busca "ID del calendario" (formato: xxx@group.calendar.google.com)
5. Copia el ID de cada calendario

Paso 7.3: Crear Google Apps Scripts

Para cada calendario, crea un script en script.google.com:

function doGet() {
  var calId = 'TU_CALENDAR_ID_AQUI';
  var calendar = CalendarApp.getCalendarById(calId);

  if (!calendar) {
    return ContentService.createTextOutput('Error: Calendario no encontrado');
  }

  var now = new Date();
  var start = new Date(now.getFullYear(), now.getMonth(), 1);
  var end = new Date(now.getFullYear(), now.getMonth() + 1, 0, 23, 59, 59);
  var events = calendar.getEvents(start, end);

  var days = "";
  var added = {};
  for (var i = 0; i < events.length; i++) {
    var d = events[i].getStartTime().getDate();
    if (!added[d]) {
      days += d + "-";
      added[d] = true;
    }
  }

  return ContentService.createTextOutput(days);
}

Paso 7.4: Publicar los Scripts

1. En cada script, ve a "Implementar" → "Nueva implementacion"
2. Tipo: "Aplicacion web"
3. Ejecutar como: "Yo"
4. Quien tiene acceso: "Cualquier persona"
5. Haz clic en "Implementar"
6. Autoriza el acceso a tu cuenta de Google
7. Copia el ID de implementacion (no la URL completa)

Paso 7.5: Configurar en el Calendario

1. Accede a la interfaz web del calendario
2. Ve a "Apps Script Settings"
3. Pega los IDs de cada script en su campo correspondiente
4. Guarda la configuracion

8 Reloj con Codigo de Colores

La version "Color Coded Clock" usa los LEDs 62-67 para mostrar la hora en formato HH:MM:SS, donde cada digito se representa con un color diferente.

Distribucion de LEDs

Tabla de Colores por Digito

Ejemplo: 14:35:27

• LED 62 = 1 → Rojo (decena hora)
• LED 63 = 4 → Verde (unidad hora)
• LED 64 = 3 → Amarillo (decena minuto)
• LED 65 = 5 → Cyan (unidad minuto)
• LED 66 = 2 → Naranja (decena segundo)
• LED 67 = 7 → Purpura (unidad segundo)

9 Interfaz Web

Paginas Disponibles

9.1 Calendario Perpetuo (Menu Principal)

Pagina principal con acceso a todas las opciones de configuracion. Incluye boton para cambiar entre espanol e ingles.

9.2 Configuracion de Red

Permite configurar la conexion WiFi del dispositivo.

9.3 Informacion del Sistema

Muestra el estado actual del dispositivo y permite acciones de mantenimiento.

Acciones disponibles:

• Reiniciar ESP: Reinicia el dispositivo (equivale a desconectar y reconectar)
• Borrar WiFi: Elimina las credenciales WiFi guardadas y reinicia en modo AP para reconfigurar

9.4 Configuracion NTP

Configura la sincronizacion de hora por Internet.

9.5 Apps Script Config

Configura los IDs de los Google Apps Scripts para sincronizar calendarios.

9.6 Ajuste Manual de Hora

Permite establecer la fecha y hora manualmente sin usar NTP.

9.7 Configuracion LEDs

Controla el brillo y permite probar los LEDs.

Botones:

• Probar LEDs: Hace parpadear todos los LEDs 3 veces en blanco para verificar funcionamiento
• Actualizar Calendario: Fuerza una actualizacion inmediata de la visualizacion

9.8 Brillo Automatico

Configura el brillo segun la hora del dia para ahorrar energia y evitar molestias nocturnas.

Estado Actual: Muestra la hora actual, si esta en modo dia o noche, y el brillo aplicado.

9.9 Configuracion Colores

Personaliza los colores de cada tipo de dia en el calendario.

Botones:

• Vista Previa: Aplica los colores temporalmente para ver como quedan
• Guardar: Guarda los colores en memoria permanente
• Restablecer: Vuelve a los colores por defecto

Correccion Gamma: Ajusta el perfil de color y temperatura para mejorar la apariencia de los LEDs.

9.10 Actualizacion OTA

Permite actualizar el firmware sin cables, directamente por WiFi.

Instrucciones para actualizar:

1. Abrir Arduino IDE o PlatformIO
2. Ir a Tools > Port
3. Seleccionar el puerto de red (aparece como perpetualcalendar at 192.168.x.x)
4. Subir el sketch normalmente

10 Resolucion de Problemas

Animacion Arcoiris Continua

Causa: No se recibe respuesta del servidor NTP.

Solucion:

• Verifica la conexion a Internet
• Prueba otro servidor NTP (ej: time.google.com)
• Verifica que el puerto UDP 123 no este bloqueado

No se Muestran Eventos de Google

Causa: Problema con los scripts de Google Apps.

Solucion:

• Verifica que los IDs de scripts esten correctos
• Asegurate de que los scripts esten publicados como "Cualquier persona"
• Los eventos deben tener fecha dentro del mes actual
• Prueba el script en el navegador: https://script.google.com/macros/s/TU_ID/exec

Hora Incorrecta

Solucion:

• Verifica la zona horaria en la configuracion NTP
• Activa/desactiva horario de verano segun tu region

No Funciona mDNS

Solucion:

• En Windows: Instala Bonjour (viene con iTunes)
• En Android: Usa la IP directa
• Espera 30 segundos despues del reinicio

LEDs No Encienden

Solucion:

• Verifica la conexion del pin de datos (GPIO 2)
• Verifica la alimentacion de 5V
• Verifica la resistencia de 3K entre GPIO2 y VCC
• Usa la funcion "Test LEDs" en la pagina de brillo
• Verifica la direccion de las flechas en la tira LED

ESP No Inicia / Se Reinicia

Causa: Falta la resistencia de 3K o problema de alimentacion.

Solucion:

• Asegurate de tener la resistencia de 3K entre GPIO2 y VCC
• Verifica que la fuente de 5V tenga suficiente corriente (3A minimo)
• Conecta los GND de todas las fuentes juntos