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 enhttps://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 (ostepUs, 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.