Saltar al contenido principal
Esta es la ayuda que se abre desde el signo de pregunta de la ventana de exportación. El archivo exportado se reproduce desde una microSD con el firmware Oryx: convierte un ESP32 en un equipo autónomo que lee los archivos digitales y analógicos tal cual salen de la app, y se maneja con pantalla OLED y encoder o por el monitor serie.
Es otro firmware, distinto del de Conectar el dispositivo. Aquí el micro lee un archivo de una tarjeta y lo reproduce por su cuenta; allá la app le manda la señal en vivo y la controla. Cada placa lleva uno solo a la vez: con este cargado, la placa no aparece en Conectar dispositivo. En la app, el signo de pregunta junto al título de la guía lo recuerda.
Funciona en el ESP32 clásico y en el ESP32-S3. El S3 no tiene DAC: con él el reproductor solo toca archivos digitales, y si se abre uno analógico lo avisa en pantalla.

Cargar el firmware

En Exportar, el ícono de código junto al título abre la guía. Con el ESP32 enchufado por USB, Cargar desde el navegador → Cargar y elegir su puerto. Se carga la última versión publicada, la del chip que tenga la placa (ESP32 o ESP32-S3). Funciona en Chrome, Edge y Opera.
El código está en GitHub (oryx_signal_sd.ino), y la ayuda lo lee de ahí cada vez que se abre.

Conexiones

En la app, la guía tiene estas conexiones en el bloque Conexiones, con un selector para cada placa.
Las salidas del ESP32 son de 3,3 V. Si el circuito trabaja a 5 V, hace falta un adaptador de nivel.

Uso

Los .txt exportados se copian en la microSD. El equipo los lista por carpetas y reconoce solo si son digitales o analógicos. Al encender muestra Oryx Signal Studio y, debajo, TEST CODE. Lee archivos digitales de hasta 16 canales. Los 4 primeros salen por sus pines; los canales 5 a 16 se guardan en memoria solo si el archivo los trae, y en el sketch quedan en extraChannels (bit 0 = canal 5) y en la función vacía writeExtraChannels, para que tu código los saque por donde necesites. Al abrir un archivo, la reproducción arranca directo. La velocidad se da en la unidad que elijas, igual que en la app: Con la pantalla, al abrir un archivo aparece Speed unit: las cuatro unidades, cada una con la velocidad a la que arrancaría, y marcada la última que usaste (se recuerda aunque apagues la placa). Se elige con el encoder y un clic reproduce; mantener vuelve a los archivos. Durante la reproducción, la velocidad se edita dígito por dígito: girar mueve el cursor entre los dígitos, la unidad y Pause; un clic sobre un dígito lo pone a editar (parpadea) y girar lo sube o baja, con la señal cambiando en vivo; otro clic termina. Un clic sobre la unidad la cambia sin cambiar la velocidad (también con doble clic). Por el monitor serie, play arranca directo en la última unidad, y unit y speed la cambian. La cantidad de velocidad con la que arranca sale del archivo: primero su STEP_TIME (us); si no lo trae, su RPM; sin ninguno, la última velocidad usada. Se muestra convertida a la unidad que elijas. El VOLTAGE se lee y queda guardado en el firmware, pero no cambia la salida: está para que tu propio código lo use.
El reproductor microSD no recibe. Si el archivo trae canales de recepción (RX_CHANNELS o IO_CHANNELS, ver Recepción), sus pines quedan como entradas y no se manejan, para no chocar con lo que maneja el otro lado. Para comparar respuestas usa el generador por USB o WiFi.

Archivos grandes

Un archivo digital se lee primero una vez, por bloques, con el avance en pantalla (Reading 37%). Si sus eventos entran en la memoria, se reproduce desde ahí como siempre. Si no —por ejemplo, millones de pasos—, se reproduce leyéndolo de la tarjeta durante la reproducción: un búfer de 4096 eventos se va llenando por detrás y, al terminar el archivo, vuelve al principio sin cortar la señal. La duración de cada evento sale igual que en memoria. La tarjeta tiene un límite de lectura (del orden de 1 MB/s, unos 50 000 eventos por segundo con 4 canales). Con señales más rápidas no alcanza: la salida se sostiene un instante hasta que llegan más datos, la pantalla muestra SD too slow: lower speed y status cuenta esos cortes como underruns. La pantalla y el encoder siguen respondiendo igual. Mientras un archivo grande suena, ls y cd esperan a que lo pares. Los pasos más cortos (hasta 2,5 µs: relojes de 200 kHz, 400 000 bps) solo se sostienen con archivos que entran en la memoria. El tiempo se mide con el contador de ciclos del procesador, así que cada flanco cae a una fracción de microsegundo de donde debe.

Con pantalla y encoder

Por el monitor serie

A 115200 baudios. Está siempre activo, haya o no pantalla. En el ESP32-S3 contesta por los dos conectores de la placa: el USB nativo y el del conversor.