Aulas

Revisiones calificadas automáticamente

Escribe las verificaciones una sola vez; cada entrega se mide contra ellas.

Qué es una revisión

Una revisión es una cosa que esperas que haga el circuito de un estudiante, escrita en una frase: el pin 13 parpadea cada 1000 ms, con margen de 50 ms. Agregas algunas a una asignación, y desde entonces cada estudiante que presione Revisar mi trabajo recibe cada una marcada como aprobada o reprobada con el número que se midió junto al número que pediste.

La calificación corre en el motor real, en el navegador donde se presiona. No se envía nada a ningún lado para calificar, no hay nada en cola, y la misma lista corre igual en tu máquina y en la de ellos.

Agregarlas

En la página de la clase, bajo una asignación, presiona Revisiones. Ves lo que ya tiene, y un menú de Agregar una revisión con los tipos de abajo. Cada tipo es una frase con huecos: llena los huecos y la frase es la revisión.

Dos campos merecen más explicación.

Lo que ve el estudiante. El nombre que le das a una revisión es todo lo que el grupo lee cuando falla, así que escríbelo como lo que pediste: "El foco parpadea una vez por segundo", no "revisión 1". Si lo dejas en blanco, se usa la frase en su lugar.

El pin. Un pin se escribe <part>:<pin>, así que uno1:13 es el pin 13 de la placa llamada uno1. Los cuadros te ofrecen los componentes y pines que ya tiene tu propio circuito inicial, así que normalmente puedes elegir en lugar de escribir.

Presiona Guardar las revisiones cuando la lista esté correcta. La lista se guarda completa, así que quitar una y guardar es la forma de retirar una revisión.

Pruébalo en el inicial

Junto a Guardar está Pruébalo en el inicial, y es el botón que importa. Ejecuta tu lista contra tu propia solución, ahí mismo, y te muestra cada chequeo con lo que midió.

Ejecútalo antes de asignar la tarea. Un chequeo que falla con tu propia respuesta es un chequeo que fallará en treinta respuestas, y así lo descubres en cuatro segundos y no en plena clase.

Los tipos

Tipo Qué mide
Un pin está en alto o en bajo El nivel de un pin en un momento
Un pin parpadea El periodo entre un flanco de subida y el siguiente, promediado en la ventana
Un pin lleva PWM La frecuencia de conmutación, y el ciclo útil si das uno
Un pin hace un fundido Cuánto se mueve el ciclo útil del PWM: la ventana se corta en diez rebanadas, se mide el ciclo útil de cada rebanada donde el pin estaba conmutando, y el mayor menos el menor debe alcanzar el rango que des. Un parpadeo nunca es un fundido
El monitor serie imprime algo Texto o una expresión regular, en cualquier parte de lo que imprimieron las placas
El monitor serie imprime cosas en orden Varios patrones, cada uno después del anterior
Una red está en un voltaje El voltaje resuelto de la red donde está un pin
Un LED está encendido / está apagado El brillo propio del componente LED, tal como lo dibuja el lienzo
Después de que se presiona un botón Presiona un botón y luego mantiene un pin en un nivel
La placa sirve una página Obtiene una ruta del propio servidor web simulado de la placa y busca texto en la página
El sketch compila Si el sketch del estudiante compiló

Dos notas sobre los casos complicados. Una verificación de PWM acepta cualquiera para el ciclo útil, que es la respuesta correcta para un sketch que lo barre: los ejemplos de fundido tienen una frecuencia que vale la pena verificar y no un solo ciclo útil. La placa sirve una página solo significa algo donde el WiFi está simulado, que hoy son el ESP32-C3, el ESP32-C6, el ESP32 DevKit, el NodeMCU y el Pico W; consulta el artículo sobre WiFi para saber qué es y qué no es esa red.

Lo que ve el estudiante

En su página de la clase, debajo del trabajo, Revisar mi trabajo. Ejecuta tu lista sobre lo que entregó y muestra cada verificación con la medición y la expectativa:

Reprobada La lámpara parpadea una vez por segundo Parpadeó cada 1462 ms. Se esperaba: el pin 13 de uno1 parpadea cada 1 s, con margen de 50 ms, observado durante 4 s.

Ese es todo el punto de la redacción: un estudiante al que se le dice "reprobada" no aprende nada, y un estudiante al que se le dice que parpadeó a 1462 ms cuando pediste 1000 sabe exactamente qué número debe ir a cambiar.

Nada de tu circuito llega a ellos. Ellos ven los nombres que escribiste, lo que midió su propio circuito y lo que pedía la verificación. Tu solución, tu propia ejecución y el trabajo de todos los demás se quedan donde están.

Lo que te regresa

Los resultados suben junto con la entrega. De tu lado:

  • el muro de la clase muestra la calificación como una píldora en cada tarjeta, para que puedas revisar el salón de un vistazo;
  • Lo que regresó muestra cada entrega con la calificación y todas las verificaciones;
  • cada verificación reprobada tiene un botón de Citar que deja la oración directamente en el cuadro de retroalimentación.

Hay un botón más, Calificar, y está ahí por una limitación honesta. Los resultados de un estudiante son lo que midió su navegador. Su navegador le pertenece, y un estudiante decidido podría publicar números que nunca produjo. Calificar ejecuta la misma lista sobre la misma entrega en tu máquina, y el panel siempre dice cuál de las dos está mostrando. Para el trabajo que cuenta para algo, presiona Calificar.

Lo que una verificación puede y no puede ver

Una verificación mide la simulación. Es una medición real de firmware real sobre un modelo real del chip, y no es un banco de trabajo:

  • El tiempo es ideal. El reloj es el reloj del chip tal como lo describe nuestro contrato de placa. No hay deriva del cristal, ni temperatura, ni jitter que no esté en el modelo.
  • No hay ruido analógico. Una red lee el voltaje que produjo el solucionador. Un circuito que sería marginal en una protoboard aquí se lee limpio.
  • El brillo de un LED es el del modelo, un pasa bajas de la corriente que lo atraviesa, que es lo que hace que "encendido" signifique algo bajo PWM. No es un fotómetro.
  • No se mide nada mecánico. Sin rebote que un componente no modele, sin calor, sin cables que se salgan.
  • La red está simulada. La página que sirve una placa viene de nuestro propio runtime y de los tres orígenes .mokxi; no hay internet detrás.

Donde eso importa, dilo al grupo. La regla de Mokxi es que lo que se le muestra a un estudiante es preciso, o dice claramente que no lo es, y cada panel de resultados del producto lleva la línea: cada chequeo aquí mide la simulación, no un banco de trabajo: temporización ideal, sin ruido analógico.

Los límites

  • Veinte chequeos en una sola tarea.
  • Un chequeo puede observar hasta sesenta segundos de tiempo simulado, y una ejecución completa se corta bastante antes de eso en el reloj también. Un sketch que espera algo que nunca sucede regresa como se acabó el tiempo con lo que se midió hasta ese momento, en lugar de colgar la página.
  • Una entrega cuyo sketch fue editado se compila antes de calificarse, con el mismo compilador que usa el editor. La primera compilación en un navegador descarga el toolchain, que es una descarga grande; después queda en caché. Un sketch que no compila nunca se califica contra el ejemplo del que partió. La ejecución se niega, y los resultados dicen por qué.