Saltar al contenido principal
Las exportaciones por pasos describen niveles: en qué paso cambia cada canal. El Oryx Signal Format (.osf) describe lo mismo como operaciones: escribir 3F 0A por TX en el paso 4, esperar 4F 4B 0A por RX, leer dos bytes de 0x48. Un equipo puede ejecutarlas con sus periféricos (UART, SPI e I2C por hardware) y validar lo que recibe sin recorrer cada paso.

Cuándo aparece

En Exportar, como primera opción y marcada Recomendado, cuando todos los canales que van al archivo (y tienen dibujo) son de un bus UART, SPI o I2C que Oryx sabe leer. Si hay otro tipo de canal —un PWM, un canal dibujado a mano sin protocolo, una señal analógica— o algo que no se puede decir sin perder información (un byte con la paridad mal a propósito, SPI Dual/Quad/Octal o DDR), no aparece y quedan los formatos de siempre. Está en todos los planes. El archivo se baja como .osf: es JSON por dentro, así que lo abre cualquier lector de JSON.

Estructura

Un documento común a todos los protocolos, con versión: Cada operación tiene un intervalo [at, end) en pasos. Dos operaciones cuyos intervalos se superponen corren a la vez (dos buses que hablan al mismo tiempo). after señala el pedido al que responde una operación.

Operaciones

Las operaciones I2C pueden llevar tenBit (dirección de 10 bits) y repeatedStart (terminan con un START repetido en vez de STOP).

Ejemplo: UART con respuesta

Ejemplo: SPI con intercambio simultáneo

role es controller cuando Oryx da el reloj (lo normal). Si el reloj está en RX, el bus se exporta como peripheral.

Ejemplo: I2C, escritura y lectura

Ejemplo: varios protocolos a la vez

UART, SPI e I2C en un solo documento. La SPI y la lectura I2C empiezan mientras sigue la escritura UART, y la respuesta UART sigue a su pedido:

Ejemplo: transacciones seguidas

Validar un archivo

El esquema JSON (draft 2020-12) está publicado en https://oryx.mechatronstudio.com/schemas/oryx-signal-format-1.json y cada archivo lo nombra en $schema. Cualquier validador de JSON Schema lo comprueba; además, que cada referencia exista (canales, buses, dispositivos, after) lo revisa Oryx antes de bajar el archivo.
Una versión nueva del formato cambia version. Un lector de la versión 1 debe rechazar un número que no conoce en vez de adivinar.

Cómo pasar de pasos a tiempo

Todo va en pasos, como en el resto de Oryx. Al ejecutar, el tiempo de paso lo decide el equipo (o stepUs, si se exportó): en UART, bitSteps × tiempo de paso es la duración de un bit (9600 baudios = 104,17 µs por bit); en SPI e I2C, clockHalfSteps × 2 × tiempo de paso es el período del reloj.