Vocabulario del límite
Cuatro responsabilidades, una entrega explícita
La opción de ingreso cambia lo que debe ocurrir antes de que Orion reciba una publicación; no cambia el significado de estas responsabilidades.
1
Transporte
Autentica y aplica los límites de la solicitud antes de conservar un cuerpo no vacío aceptado.
2
Códec
Reconoce y decodifica una forma de datos registrada. Es código revisado que se distribuye con la compilación.
3
Normalizar
Conserva la identidad opaca device_key y point_key y aplica significado gobernado donde esté disponible.
4
Persistir
Guarda los puntos decodificados elegibles como lecturas trazables.
device_key y point_key son identificadores neutrales al transporte; no exigen que el publicador sea una pasarela física.
Opciones de ingreso
Elija la entrega que usted puede asumir
Cada fila indica qué cruza el límite de Orion y quién conserva la responsabilidad a cada lado.
Un protocolo recogido por un puente externo no es un listener nativo de Orion.
| Ruta | Qué recibe Orion | Límite entre códec y perfil | Orion asume | El integrador asume | Estado público |
|---|---|---|---|---|---|
| PAS800 · CEWS | JSON CEWS autenticado por el endpoint HTTPS acotado. | cews@3.0.0 decodifica el sobre; la resolución gobernada del catálogo puede aportar significado a los puntos. | El endpoint HTTPS, el códec registrado, la conservación del cuerpo aceptado y el procesamiento posterior elegible. | Configure el publicador PAS800, su credencial y la ruta de red; ponga en marcha los puntos resultantes. | Construido · ruta nativa Es la ruta específica PAS800/CEWS, no soporte general para equipos Schneider ni protocolos de campo. |
| JSON canónico de Orion | JSON orion.ingest.v1 autenticado con device_key y valores point_key con marca de tiempo. | orion-json@1 decodifica la forma fija; un perfil publicado opcional mapea point keys conocidos. | El endpoint HTTPS, el códec registrado, la conservación del cuerpo aceptado y el procesamiento posterior elegible. | Transforme la salida de la fuente en JSON de Orion, publique ese cuerpo y mantenga la entrega del lado de la fuente. | Construido · ruta canónica Poder hacer POST no es suficiente; el cuerpo debe cumplir la forma canónica. |
| Puente externo de borde | JSON canónico de Orion republicado por HTTPS después de la recolección externa. | orion-json@1 empieza en la entrega HTTPS; un perfil mapea claves conocidas, no el protocolo anterior. | El límite HTTPS canónico autenticado y el procesamiento posterior elegible. | Provea, proteja, supervise y mantenga el recolector externo MQTT, Modbus o BACnet y su traducción. | Recolección externa · no es soporte nativo El puente no convierte esos listeners de protocolo en parte de Orion. |
| Formato de entrada nuevo | Un formato que ninguno de los 2 códecs registrados reconoce. | Ningún perfil puede analizarlo; un códec Tier 2 debe revisarse, probarse y distribuirse con una compilación. | Revisar y distribuir el código del códec antes de afirmar soporte. | Aporte la especificación del formato, capturas representativas, límites esperados y detalles de publicación de la fuente. | Ausente · requiere revisión Hasta que ese códec se distribuya, el formato no es una ruta de ingreso soportada por Orion. |
Esta compilación
Qué puede decodificar Orion y qué pueden mapear los perfiles
El registro de runtime y el catálogo curado responden preguntas diferentes. Lea ambos antes de elegir una ruta.
Códecs registrados: 2 · paquetes de perfil curados cargables: 3
Códecs registrados
Los códecs son código revisado que reconoce y decodifica sobres y se distribuye con la compilación.
cews@3.0.0
https_cews|cews
Reconoce y decodifica el sobre acotado PAS800/CEWS.
Implementación: CewsParser
orion-json@1
api|orion-json
Reconoce y decodifica el sobre canónico orion.ingest.v1.
Implementación: OrionJsonCodec
Paquetes de perfil curados
Los perfiles son datos de mapeo verificados que se usan después de un códec compatible. No agregan un listener de protocolo.
setra-a@1.0.0
Setra SPM03EDN Three-Phase Power Meter
Equipo nombrado: Setra SPM03EDN
Códec requerido: orion-json@1
electricity · 14 puntos mapeados · No requiere habilitación
generic-inverter@1.2.0
Generic PV Inverter
Equipo nombrado: Familia genérica
Códec requerido: orion-json@1
electricity · 7 puntos mapeados · No requiere habilitación
premium-hvac-pack@1.0.0
Premium HVAC Sensor Pack
Equipo nombrado: Familia genérica
Códec requerido: orion-json@1
thermal · 5 puntos mapeados · Requiere habilitación
Cada paquete curado cargable actual declara orion-json@1. Su presencia amplía la cobertura de mapeo, no el catálogo de códecs o listeners.
Límite de extensión
Los datos de perfil y el código de códec reciben revisiones distintas
Llamar “driver” a ambos oculta el límite de seguridad y soporte.
Tier 1 · Perfil
Datos declarativos instalables que mapean point keys conocidos y transformaciones acotadas después de que exista el códec requerido y se supere la compuerta de instalación.
Tier 2 · Códec
Código decodificador revisado que reconoce un formato de entrada y se distribuye con la compilación; un operador no puede cargarlo en runtime.
Un perfil puede ampliar la cobertura de mapeo. No puede crear soporte de protocolo.
Evidencia del repositorio
Verifique los dos catálogos por separado
La evidencia del registro prueba formatos decodificables; la evidencia del catálogo prueba paquetes de mapeo cargables. Ninguna prueba un listener nativo para un protocolo externo.
Contrato
docs/orion-pro/01-architecture.md#channels-drivers-the-capture-edge
Contrato
docs/orion-pro/09-ingestion-channels.md#the-codec-contract-registry
Contrato
docs/orion-pro/09-ingestion-channels.md#drivers-codec-profile-two-tiers
Registro o catálogo
app/Providers/AppServiceProvider.php#register
Registro o catálogo
app/Support/Ingest/Codec/CodecRegistry.php#supported
Registro o catálogo
app/Support/Ingest/Profiles/CuratedCatalog.php#all
Guarda
tests/Feature/Ingest/CodecRoutingTest.php#test_a_cews_payload_routes_via_the_https_cews_cews_channel_and_parses
Guarda
tests/Feature/Ingest/CodecRoutingTest.php#test_a_payload_on_an_unregistered_transport_channel_is_flagged_unknown_version
Guarda
tests/Feature/Marketplace/CuratedCatalogTest.php#test_every_curated_bundle_checksums_and_installs_through_the_gate
Guarda
tests/Feature/Drivers/ProfileInstallGateTest.php#test_an_unregistered_codec_is_never_installable
Límites de la afirmación
Lo que esta página no convierte en soporte
Estos límites viajan con el mismo registro de manifiesto que la ruta, los hechos, la evidencia y el tema de Ayuda.
Límites de la afirmación 1
CEWS significa la ruta acotada HTTPS/JSON 3.0.0 del PAS800, no todo equipo Schneider ni cada protocolo detrás de él.
Límites de la afirmación 2
Los paquetes de perfil curados son datos de mapeo usados después de un códec compatible; no son códecs, listeners, certificación de equipos ni compatibilidad general.
Límites de la afirmación 3
MQTT, Modbus y BACnet siguen siendo responsabilidades de recolección externa salvo que se distribuya un listener nativo revisado por separado.
Límites de la afirmación 4
Un formato de entrada nuevo sigue sin soporte hasta que un códec Tier 2 revisado sea probado, registrado y distribuido con la compilación; esta historia no agrega ningún códec.
Límites de la afirmación 5
Transporte, Códec, Normalizar y Persistir nombran responsabilidades sin declarar que el publicador autenticado deba ser una pasarela física.
Completa sin scripts Cada límite, códec, perfil, elemento de evidencia y restricción está presente en la página renderizada por el servidor; los scripts no agregan hechos.