MQTT Network Server Ingestion Contract V1
Status
Section titled “Status”Draft.
Payload details are not yet finalized.
Purpose
Section titled “Purpose”This contract defines how the external Network Server publishes telemetry data to the platform over MQTT.
Initial Network Server
Section titled “Initial Network Server”Netmore.
Required Information
Section titled “Required Information”The final MQTT contract must document:
- Broker URL.
- TLS requirements.
- Authentication method.
- Topic pattern.
- QoS level.
- Retained message behavior.
- Payload format.
- Message ID field.
- Device identity field.
- Timestamp fields.
- Gateway metadata.
- Frame counter if available.
- Raw payload field.
- Encoding.
- Error cases.
- Duplicate delivery expectations.
- Out-of-order delivery expectations.
Required Platform Behavior
Section titled “Required Platform Behavior”The platform must:
- Tolerate duplicates.
- Tolerate delayed messages.
- Tolerate out-of-order messages.
- Validate payloads.
- Reject or quarantine malformed messages.
- Record unknown devices.
- Process known devices idempotently.
- Emit metrics and logs.
Open Questions
Section titled “Open Questions”- Exact topic structure.
- Exact payload structure.
- QoS level.
- Whether message IDs are globally unique.
- Whether DevEUI is always present.
- Whether frame counter is always present.
- Whether timestamp is device time or Network Server time.