Cookwala

Esta página fue traducida por una máquina y aún no ha sido revisada por una persona. El inglés es la referencia; las correcciones son bienvenidas en GitHub. GitHub

Cookwala / For

Para fabricantes de aparatos: hornos, placas, multicocinas, robots de cocina y humanoides

Un aparato que implementa Cookwala lee una receta firmada, comprueba cada paso frente a lo que puede hacer y medir, rechaza lo que no puede verificar antes de que nada se caliente, y mantiene sus propios límites de seguridad digan lo que digan la receta, el agente o la red. Cinco endpoints, un documento de capacidades, pruebas públicas.

Por qué es importante para usted

La parte difícil ya es suya: el movimiento, el control del calor, los sensores. Cookwala le da la capa de tarea encima, abierta y libre de regalías: un formato de receta que una máquina puede planificar, envelopes de operación con bandas físicas, una escalera de sensores por paso, límites de seguridad locales que nada puede subir, y un rechazo que es una respuesta normal, no un error. Sus clientes obtienen todas las cocinas sin que usted escriba una receta; su regulador obtiene una historia de seguridad legible; su equipo comercial obtiene un informe de conformidad firmado en lugar de una afirmación.

Lo que existe hoy: la API Core 0.2, un ejecutor de referencia para correr junto al suyo, 51 vectores de conformidad Core incluidos los dry runs del ejecutor, un formato de informe firmado y un verificador. Lo que no existe: un certificador, una prueba de hardware, una segunda implementación. Usted sería el primero, y el estándar cambiaría donde demuestre que está equivocado.

Formas de entrada, de lo ligero a lo profundo

  1. Ligero. Escriba un documento de capacidades para un producto y haga un dry run de las nueve recetas de ejemplo en el navegador o la CLI; lea las secciones 3 y 6 de Core 0.2 en una tarde.
  2. Medio. Implemente los cinco endpoints Core en un hub junto a su firmware, ejecute las suites del ejecutor, arranque el hub de referencia con un token y compare las respuestas en el cable.
  3. Profundo. Aplique el paquete de límites de seguridad en el aparato, mida la parada local, publique un informe de conformidad firmado, abra un pull request que lo registre y díganos qué cambiar en Core 0.3.

Primer éxito, en menos de 15 minutos

Menos de 15 minutos, sin hardware: ejecute las suites del ejecutor y luego haga un dry run de una receta contra su propio documento de capacidades.

git clone https://github.com/amado2k5/cookwala && cd cookwala && pip install -e sdk/python
python tools/run_conformance.py envelope   # 14 vectors: bands, altitude, sensor ladders
python tools/run_conformance.py dryrun     # 7 vectors: refusal before heat
cp examples/capabilities/robot-arm.json my-device.json   # edit ops, sensors, safety
cookwala dryrun examples/koshari.cookwala.json --device my-device.json --human-present
conformance: 14/14 passed · conformance: 7/7 passed · accepted or refused with the step and the reason

El camino después de eso

  1. Escribir el documento de capacidades: operaciones, sensores con su precisión, seguridad (certificaciones, detección de presencia, parada)
  2. Hacer un dry run de las recetas de ejemplo; cada rechazo nombra el paso y la razón
  3. Implementar POST /v1/executions, GET status, stop, resume y el registro, más GET /v1/capabilities y /v1/safety-limits
  4. Ejecutar las suites del ejecutor (envelope, dryrun, transitions) y las comprobaciones de red del README del hub
  5. Publicar un informe de conformidad firmado; hasta que exista un servicio de registro, un pull request lo añade al archivo del registro
  6. Nada está certificado aún: no existe certificador, y el informe dice qué prueba y qué no

Otros caminos