Documentación Web English Pruébalo en el navegador

El firmware

Cada Pico necesita su propio programa, su firmware. Viene en un fichero .uf2 que se copia en la Pico como un fichero en un pendrive: no hace falta ningún programa especial.

Pico Fichero Qué lleva
Pico CPU zxv_cpu.uf2 La máquina: el BASIC, los servicios (USB, tarjeta SD, reloj) y la unidad ROM: con los ejemplos de serie
Pico ULA zxv_ula_link.uf2 La imagen y el sonido, que recibe de la Pico CPU

Ojo con el de la ULA: es zxv_ula_link.uf2, no zxv_ula.uf2. El segundo es una prueba que enseña unas demos ella sola, sin la Pico CPU.

Dónde están los ficheros

  1. Ve a la página de Releases del proyecto en GitHub (https://github.com/cronomantic/ZX-V/releases).
  2. En la última versión, baja zxv-uf2.zip y descomprímelo. Lleva todos los .uf2: los que necesitas son zxv_cpu.uf2 y zxv_ula_link.uf2. Los demás son pruebas (ver Programas de prueba). Trae también zxv-update.bin, para actualizar una máquina desde su tarjeta (Cómo se actualiza).

Cómo se carga en una Pico

  1. Mantén pulsado el botón BOOTSEL de la Pico (el único que tiene) y, sin soltarlo, conecta su micro-USB al ordenador. Luego suéltalo.
  2. En el ordenador aparece una unidad llamada RP2350.
  3. Copia el .uf2 a esa unidad (arrastrándolo). Al terminar la copia, la Pico se reinicia sola con el firmware nuevo y la unidad desaparece.

Una vez para cada Pico, cada una con su fichero. Cada fichero lleva la flash entera de la Pico: el firmware, sitio para una segunda copia (la que usan las actualizaciones desde la tarjeta) y, en la Pico CPU, la unidad ROM:.

Cómo se actualiza

Desde la tarjeta, sin cable:

  1. Baja el zxv-uf2.zip nuevo, descomprímelo y copia zxv-update.bin en la carpeta principal de la tarjeta microSD de la máquina.
  2. Pon la tarjeta en la máquina y, en el editor del BASIC, pulsa EDIT (Tab) y elige Actualizar firmware. El cuadro dice la versión que hay en la tarjeta y la de la máquina. Pulsa Enter para actualizar, o Esc para dejarlo.
  3. La máquina se reinicia en una pantalla de actualización con cuatro pasos: comprueba el fichero y actualiza la Pico ULA, la Pico CPU y la unidad ROM:. Tarda uno o dos minutos; no la apagues. En esa pantalla el teclado USB no funciona: cuando termina, se reinicia sola a los cinco segundos con la versión nueva. Luego puedes borrar zxv-update.bin de la tarjeta.

Cada Pico guarda dos copias de su firmware: la actualización se escribe en la que no está en uso, y la Pico solo pasa a ella cuando está escrita y comprobada. Así, si se va la corriente a medias o falla la tarjeta, las dos Pico siguen arrancando; como mucho, la unidad ROM: queda vacía hasta que repites la actualización. Si algo sale mal, la pantalla dice qué (y se reinicia sola al medio minuto), y en la Pico CPU no ha cambiado nada si no se llegó a su paso.

La primera vez. Las Pico con la versión 0.9.0 o anterior no tienen aún las dos copias: grábalas las dos una vez por USB como arriba, con los zxv_cpu.uf2 y zxv_ula_link.uf2 nuevos. Desde ahí, basta la tarjeta. El cuadro del menú EDIT lo dice si una Pico lo necesita. En el emulador no hay nada que actualizar, y el cuadro también lo dice.

Por USB sigue funcionando como antes: repite lo de arriba con las dos Pico. Usa siempre los dos ficheros de la misma versión: si la CPU y la ULA llevan versiones distintas del enlace, la CPU lo dice en su informe (ver abajo), y puede que no salga la imagen.

Sin tocar BOOTSEL. Si tienes picotool (viene con la extensión Raspberry Pi Pico de VS Code), una Pico que ya lleva un firmware de ZX-V se puede actualizar por su cable USB, sin tocar BOOTSEL:

picotool load -f -x zxv_cpu.uf2

-f reinicia la Pico en modo de carga y -x arranca el firmware nuevo al acabar. Si la Pico está colgada, o nunca ha llevado el firmware de ZX-V, usa BOOTSEL.

El informe

Cada 5 segundos la Pico CPU escribe un informe, en el idioma de la máquina (el que elige LANGUAGE), sobre el enlace, el sonido, la tarjeta, los aparatos USB, el reloj y la ULA. Es lo primero que hay que mirar cuando algo no va. Se ve de dos formas:

La Pico ULA escribe sus mensajes por su micro-USB.

Cargar programas desde el PC (J5)

La tira UART de la placa (J5) es para mandar programas desde el PC y ejecutarlos, sin sacar la tarjeta. Hace falta soldar sus 3 pines y un adaptador USB-serie de 3,3 V (muchos eligen la tensión con un puente o un selector: ponlo en 3,3 V):

En el PC, zxv-link-gui, con ventana, que va en los paquetes del emulador. Se usa en pasos, de arriba abajo:

  1. Placa: elige el puerto del adaptador; al elegirlo se conecta y dice qué firmware tiene la máquina y si el BASIC espera una orden.
  2. Programa: elígelo, arrástralo a la ventana o pulsa uno de los recientes. Eso solo lo pone ahí: nada se manda todavía.
  3. Desde dónde lo carga la placa: EXT:, lo normal (la carpeta compartida, sin copiar nada a la tarjeta: ver La unidad EXT:), o La tarjeta (copia antes el programa y sus ficheros).
  4. Con EXT:, el recuadro EXT: es dice qué carpeta es, y Elegir... cambia de carpeta. Si el programa no está dentro, avisa y ofrece Copiarlo a esa carpeta (con sus ficheros, y usa esa copia) o Ejecutar desde la tarjeta.
  5. Con La tarjeta, los ficheros de su carpeta que puede cargar (gráficos, música, sonidos...), marcados, y los que añadas. Con la placa conectada dice qué hay en la tarjeta con cada nombre: nada, lo mismo (no se manda), lo que puso zxv-link la última vez pero ha cambiado (se sustituye) u otro distinto que no puso zxv-link (antes de sustituirlo, pregunta). También dice si la placa no tiene tarjeta.
  6. Ejecutar en la placa (lo manda todo y lo ejecuta) o Solo copiar a la tarjeta (sin ejecutar nada; sin programa, copia solo los ficheros del paso 3). Son los únicos botones que mandan algo. Si hay otro programa en marcha, pregunta antes de pararlo. Mientras manda, Parar lo deja.
  7. Resultado: cómo va cada fichero, la orden que se teclea en la máquina y lo que la máquina lee y escribe en EXT:.

Debajo, los programas recientes y el informe de la máquina mientras está conectada. Desconectar suelta el puerto, para usarlo con otro programa (como la extensión de VS Code).

Lo mismo, en la consola, con zxv-link:

zxv-link ports
zxv-link --port COM5 run juego.zxv
zxv-link --port COM5 send graficos.gfx
zxv-link --port COM5 info
zxv-link --port COM5 log

Lo que hay en la tarjeta no se pierde sin querer:

J5 habla en tramas con zxv-link: un terminal no sirve.

Desde VS Code, la extensión de ZX-V hace lo mismo con ZX-V: Ejecutar en la placa (desde EXT: o desde la tarjeta: ver abajo), y depura el BASIC de la ROM en la placa con "target": "board": para eso usa zxv-link serve, que ofrece el depurador por TCP igual que el emulador con --basic-debug.

La unidad EXT:

Además de SD: (la tarjeta) y ROM: (el disco de la ROM, de solo lectura), la máquina tiene una tercera unidad: EXT:, la unidad externa, los ficheros de una carpeta que sirve otro equipo (el servidor: un PC, una Raspberry Pi, un móvil, otra ZX-V...). Hoy va por J5, con el mismo adaptador; más adelante, quizá por Wi-Fi. Es una sola unidad sea cual sea el enlace: un programa que usa EXT:datos.dat funciona igual por cable que por Wi-Fi (si hubiera servidor por los dos, gana el cable).

Los programas y el BASIC la usan como las otras, para leer y escribir: LOAD "EXT:juego.bas", SAVE "EXT:copia", CAT "EXT:", CD "EXT:", OPEN # y las funciones de ficheros de la API de C, con los mismos nombres que en la tarjeta. Sin servidor, todo lo de EXT: da el error −18 (V Error de disco (EXT: sin servidor)); si el servidor se va, la primera llamada espera 1,5 segundos y falla, y las siguientes fallan enseguida hasta que vuelve. Nada se cuelga. Por J5 va a unos 80 KB/s (un programa de 100 KB carga en poco más de un segundo); la tarjeta es más rápida.

La carpeta se elige a propósito, nunca es la del programa: la máquina puede crear ficheros en ella, y la del programa podría ser tu carpeta personal, Descargas o una carpeta del sistema. En zxv-link-gui es, por defecto, Documentos/ZX-V-EXT (se crea la primera vez; no es Documentos/ZX-V, que es la tarjeta del emulador), y Elegir... pone otra. Se sirve mientras la placa está conectada (Se sirve como EXT: mientras la placa está conectada.), así que la máquina también puede usarla sola: con SAVE "EXT:copia" desde el BASIC guardas en el PC lo que tecleas en la máquina.

En la consola:

zxv-link --port COM5 serve --folder CARPETA
zxv-link --port COM5 serve --folder CARPETA --run CARPETA/juegos/juego.zxv

Lo que hay en la carpeta no se pierde sin querer (con zxv-link, la ventana y la extensión de VS Code):

En VS Code, ZX-V: Ejecutar en la placa carga por defecto desde EXT: (el ajuste zxv.boardFrom: ext o card). La carpeta es la del espacio de trabajo, u otra con el ajuste zxv.extFolder; zxv.extOverwrite deja sustituir. zxv-link sigue sirviendo mientras el programa está en marcha: en la barra de estado sale EXT:, y un clic (o ZX-V: Dejar de servir EXT:) lo para. Si el programa está fuera de la carpeta, ofrece ejecutarlo desde la tarjeta. Al depurar en la placa ("target": "board"), lo mismo: la carpeta se sirve mientras dura la sesión y el programa se carga desde EXT:.

Para hacer otro servidor (en otro equipo, en otro lenguaje), lo que viaja por J5 está en El protocolo.

Si no hay imagen o no hay sonido

No hay imagen

Fíjate en el LED rojo del enlace (ENLACE en la placa) al encender.

Las veces que parpadea al arrancar son el modo de vídeo más uno (una vez en el modo 0, dos en el 1).

El modo seguro. Mantén apretado MODO mientras enciendes: la ULA arranca en DVI, que lo acepta cualquier pantalla. Dura solo hasta el siguiente reinicio. Para quedarte con un modo, pulsa MODO brevemente con la máquina en marcha: cada pulsación corta pasa de HDMI a DVI o al revés, lo guarda y reinicia la ULA. Si tu pantalla solo se ve en el modo seguro, pulsa MODO hasta que el LED del enlace parpadee dos veces al arrancar: es el modo 1, el mismo que el seguro, y se queda guardado.

Modo Salida Sonido en la pantalla
0 HDMI 640 × 480, 60 Hz (el de partida) Sí
1 DVI 640 × 480, 60 Hz (el modo seguro) No

Se ven unas demos en lugar del BASIC (un juego que se desplaza, rayas de colores, círculos): la Pico ULA lleva zxv_ula.uf2, la prueba. Cárgale zxv_ula_link.uf2.

Puntos que bailan sobre una imagen que se reconoce son errores de transmisión entre la ULA y la pantalla. En una protoboard, busca un cable suelto y deja los del HDMI cortos y por parejas. Algunas teles necesitan además 5 V en el pin 18 del conector HDMI (En una protoboard).

No hay sonido

Otras cosas

La página de diagnóstico

Una pulsación larga de MODO (de 1 a 5 segundos) o Ctrl+Alt+F12 en el teclado enseñan una franja azul en el centro de la pantalla con cómo van las dos Pico, al día cada segundo: arriba la ULA (su modo, las imágenes por segundo, los errores del enlace, el CRC de las paletas que le llegan, el sonido); abajo la CPU (enlace, sonido, tarjeta, USB, reloj). Si lo de la CPU no llega en 2,5 segundos, la página lo dice. Lo mismo otra vez la quita. Sale sin tildes: la fuente de la página solo tiene ASCII. Va en el idioma de la máquina, que la CPU le manda a la ULA con cada imagen. Los mensajes de la Pico ULA por su micro-USB también, en cuanto funciona el enlace.

Programas de prueba

En zxv-uf2.zip vienen también unas pruebas. Dos son útiles al montarla:

Fichero En Qué hace
zxv_ula.uf2 Una Pico 2 sola La imagen y el sonido de la ULA con unas demos, sin la Pico CPU. Comprueba la salida HDMI y el jack. El pulsador MODO va igual
zxv_hdmi.uf2 Una Pico 2 sola Barras de colores y un tono de prueba a cada lado (izquierda, derecha y centro) por el HDMI. zxv_dvi.uf2 es lo mismo en DVI, sin sonido

Los demás (zxv_linktx, zxv_bench, zxv_bench_ram, zxv_isatest) son para quien desarrolla el firmware. Acuérdate de volver a cargar el firmware de verdad después.