Saltar al contenido principal
El generador necesita un sketch cargado una sola vez. Recibe la señal que está abierta en el editor y la reproduce por sus salidas.
No se conecta a internet, ni a una nube, ni a ningún servidor: el enlace es siempre punto a punto, por el cable USB o por tu WiFi.
Son dos firmware distintos. Este es el del enlace con la app (USB / WiFi); el otro es el del reproductor microSD. Cada placa lleva uno solo a la vez: una placa con el del microSD no aparece en Conectar dispositivo hasta que le cargues este, y al revés. En la app, el signo de pregunta junto al título de cada guía lo recuerda.

Qué hace falta

Cómo se carga

1

Instalar el core

Arduino IDE → Gestor de tarjetas → esp32 by Espressif Systems.
2

Elegir la placa

ESP32 Dev Module, o ESP32S3 Dev Module con USB CDC On Boot: Enabled (menú Herramientas), y el puerto donde está conectada.
3

Subir el sketch

Abrir oryx_signal_esp32.ino y subir. No necesita librerías externas.
4

Cerrar el monitor serie

Antes de conectar desde la app: si está abierto, el puerto queda ocupado.
El monitor serie (921 600 baudios) muestra un saludo al arrancar. Todo lo que imprime el equipo para que lo lea una persona va con # adelante, para no confundirse con las respuestas del protocolo.
Sin el Arduino IDE: en la app, en Conectar dispositivo, el ícono de código junto al título abre la guía del firmware; ahí Cargar desde el navegador → Cargar. Se conecta la placa por USB, se elige su puerto y el navegador escribe la última versión publicada (Chrome, Edge u Opera). Reconoce solo si es un ESP32 o un ESP32-S3 y carga la versión de ese chip. La red WiFi guardada en el equipo se conserva.La misma guía tiene los pasos del Arduino IDE y el código, leído de GitHub cada vez que se abre, con un botón para copiarlo.

Recepción

Para usar canales RX hace falta el firmware de enlace con recepción: el equipo pasa esos pines a entradas, marca cada flanco con su hora y le manda a la app lo que llegó en cada vuelta. Los canales RX analógicos se miden con el ADC en los GPIO 34, 35, 32 y 33 (ESP32 clásico). Con un firmware anterior, una señal con canales RX no se envía (la app lo avisa). Ver Recepción.

Salidas

Un pin por canal, en el orden del editor. Ya conectado, el panel de la app muestra por qué GPIO sale cada canal.
El equipo recibe los 16 canales digitales que se pueden diseñar en Oryx, pero solo los 8 primeros tienen pin. Los canales 9 a 16 llegan con la señal y el firmware los guarda: en el sketch, canalesExtra tiene su valor en cada momento (bit 0 = canal 9) y la función vacía escribirCanalesExtra se llama en cada cambio, lista para que tu código los saque por donde necesites (un expansor I2C, un 74HC595, otra placa). En la app aparecen como Sin pin.
El ESP32-S3 no tiene DAC, así que no emite señales analógicas: para emitirlas hace falta un ESP32 clásico. Sí mide canales RX analógicos, en los GPIO 1, 2, 8 y 9 (ver Recepción).

Voltaje

El voltaje (0 a 99,99 V) solo se recibe y se guarda: el equipo no lo usa. Las salidas digitales salen siempre a 3,3 V y las analógicas usan todo el rango del DAC (0 a 3,3 V). En el sketch queda en la variable mv, en milivoltios, para quien quiera darle un uso en su propio circuito (una etapa de potencia, un DAC externo, lo que haga falta).

Topes del equipo

Si tu señal no entra, la app te lo dice antes de mandarla y te explica qué se ajustó.

Velocidad

En la app es una sola casilla con la unidad a elegir: µs/paso, RPM, bps o Hz (ver Conectar el dispositivo). Al equipo llega de dos formas:
  • µs/paso, bps y Hz llegan como tiempo de paso (SET T), con decimales.
  • RPM llega como RPM (SET R). Una vuelta entera de la señal es una vuelta del motor:
El tiempo de paso se usa con decimales, sin redondear al microsegundo: así la velocidad real es la pedida. Con RPM, si llega otra señal con otro largo, el equipo recalcula el tiempo de paso solo. Cambiar la velocidad acelera o frena la señal en el acto, como un motor: la vuelta sigue desde donde iba, sin volver al principio ni cortar un pulso. El contador de vueltas no se pone en cero: para eso está Reiniciar.

Cuándo se detiene automáticamente la señal

Si el cable se suelta o cierras la pestaña, la señal se para y las salidas bajan. Es a propósito: el equipo no puede enterarse de que del otro lado ya no hay nadie, así que si pasa un rato sin recibir órdenes da el enlace por terminado.