Secure offline coordination, built into OEM devices

A semiconductor integration packages a 449.5 KiB embedded runtime, gateway software, and qualification tools for smart-access and energy-device manufacturers

An embedded engineer validates a development board connected to a gateway and smart-access product.

Problem

The semiconductor team's engineering review began with two concrete questions: where was the device-side source, and what supported the memory figures? Mobile and TypeScript bindings demonstrated an application experience, but the team needed to inspect what actually ran on a constrained device before building an OEM integration around it.

Solution

Offline Protocol answered that requirement with a shipped Rust leaf implementation, a reproducible Cortex-M33 footprint harness, and a clear split between embedded and gateway responsibilities. The offline-protocol-leaf, offline-protocol-core, and offline-protocol-mls crates1 provide secure device requests and durable protocol state. The gateway's Offline Protocol Mesh SDK2 handles discovery, routing, and reliable delivery. OEM teams integrate through defined radio and storage interfaces while retaining their application policy, branded experience, and release process.

Outcome

The complete reference leaf, including real Messaging Layer Security, links at 449.5 KiB.3 A representative encrypted message occupies 472 bytes, down from 1,342 in the prior representation.4 OEM engineers now have inspectable code, reproducible size measurements, and a reusable integration and qualification package for smart-access and energy products. This makes secure offline coordination a concrete component of the product design, with a defined device footprint and less integration work to recreate for each OEM.

Embedded device, gateway, and application responsibilities

offline-protocol-leaf1 combines the embedded protocol surface with offline-protocol-core and offline-protocol-mls. The platform supplies frame I/O, entropy, time, and atomic durable storage. The leaf joins the established secure group and responds; it does not run the full std/Tokio routing engine.

Constrained deviceGateway + applicationEnterpriseLeafEmbedded leafleaf, core, MLSFull gateway runtimeDiscovery, routing, reliabilityProtocol framesOEM platform contractFrame I/O, entropy, timeAtomic storage + outcome journalVendor radio stack + BSPOEM appRequestOutcomeOverviewBranded applicationHosted RelayEncrypted forwardingOEM recipientBusiness commit receipts
Constrained deviceLeafEmbedded leafleaf, core, MLSFrame I/O, entropy, timeAtomic storage, vendor radio stackProtocol framesOEM appRequestOutcomeOverviewFull gatewayDiscovery + routingBranded appEnterprise deliveryRelay → OEM recipientBusiness commit receipts
01 / Embedded, gateway, and enterprise responsibilities

The gateway runs the Offline Protocol Mesh SDK2, including discovery, service routing, and reliability. Dynamic Offline Relay Switch (DORS) selects its qualified transports. OfflineID5 provides device identity, and Messaging Layer Security (MLS)6 protects the application exchange.

Bluetooth, Matter, Thread, Zigbee, Z-Wave, and Wi-SUN retain their vendor implementation and certification requirements. An adapter exposes a supported byte path to Offline Protocol. Compatibility with a vendor platform is not a claim that every radio protocol is a native transport or that separate networks can be bridged without qualification.

The reference build makes the footprint concrete

The linked Cortex-M33 leaf image occupies 449.5 KiB in the supplied reference build. Against a 1,536 KiB flash class, that is 29.3%, leaving 1,086.5 KiB before the radio stack, RTOS, bootloader, OTA arrangement, storage, and OEM application are allocated.7

Embedded footprintEncrypted wire format449.5KiB29.3% of a 1,536 KiB flash classEach square = 16 KiB1,342472bytes / prior representationbytes / binary frameBLE fragments at the fixture MTU10 → 4 fragments64.8% fewer bytesSame representative encrypted message.Actual MTU, energy and radio timing remain board tests.The remaining 1,086.5 KiB accommodates radio, RTOS, bootloader, OTA, storage and the OEM application.These are protocol-image and wire-fixture measurements, with their build and framing conditions preserved.
Linked Cortex-M33 image449.5KiB29.3% of the 1,536 KiB flash classEach square = 16 KiB1,086.5 KiB remains for the rest of the product.Encrypted message / same fixture1,342 B472 BPrior representationBinary frame4 BLE fragments, down from 1064.8% fewer bytesFragment count uses the fixture ATT MTU.Radio energy and timing are measured on the board.
02 / Reference footprint and wire-size baselines

The representative encrypted short-message fixture is 472 bytes, compared with 1,342 bytes in the prior representation. That is a 64.8% smaller encoded frame, before radio and retry overhead. Under the fixture's BLE fragmentation assumptions, the message uses four fragments instead of ten.4 MTU and radio behavior remain board-level measurements.

The reported MLS software-path microbenchmarks are 79.5 microseconds to seal and 91.3 microseconds to open on Apple Silicon.3 They establish that software benchmark's cost; they are not Cortex-M33 execution time or end-to-end request latency.

The reported footprint is a reference-build snapshot, not a fixed size across SDK and compiler versions. The footprint harness documents rustc 1.97.1 and targets thumbv8m.main-none-eabihf with size optimization, LTO, and abort-on-panic.7 Linking establishes flash consumption. Running the actual board establishes peak heap, task stack, interoperability, radio timing, and energy use. These measurements answer different OEM decisions.

Persistence is part of the device contract

Provisioning establishes the device identity and secure group state before operational requests are accepted.8 An OEM capability request carries a stable ID, scope, expiry, and payload version. The leaf verifies it under the secure context and applies the OEM's application policy.

Gateway / clientLeaf runtimeDevice persistenceR7: identity, scope, expiryVerify + apply OEM policyPersist required state and outcomeLeafStoreSecure protocol stateOEM outcome journalDurable commit completesOnly now emit the responseLost response? Retry the same R7Return the journaled result.Keep cryptographic state monotonic.Recovery of a physical action is defined by the OEM journal and actuator interface.
One request / two durable recordsRequest R7LeafLeaf runtimeVerify identity + scopeCheck expiry + request IDApply OEM policyPersist before respondingLeafStoreSecure protocol stateOEM journalApplication outcomeReset recovery loads both required records.Emit the attributed responseA stored outcome exists before it leaves the device.Lost response or restartRetry R7; consult the OEM outcome journal.Return the recorded result under the same ID.Physical-action recovery follows the OEM actuator contract.
03 / The secure request and persistence boundary

LeafStore provides atomic durable protocol-state storage. Required state is persisted before a response is emitted. Reset recovery cannot roll cryptographic state back and reuse it as though no exchange occurred. Entropy, trustworthy time inputs, key storage, and update behavior are explicit platform responsibilities.

For physical actions, an OEM outcome journal and actuator interface determine what can be recovered after a power failure. A network receipt alone cannot promise exactly-once actuation. Read-only diagnostics are therefore a useful first qualification fixture before separately authorized physical-action workflows.

The package an OEM integrates

Integration surfaceWhat ships at that boundary
Embedded deviceLeaf/core/MLS crates, provisioning fixture, frame interface, and storage contract.
Gateway or phoneoffline-protocol, transport, router, reliability, services, and the matching protocol build.
Branded applicationSupported offline-protocol-uniffi or @offline-protocol/mesh-sdk bindings and a versioned capability schema.
Operations recipientEndpoint outbox, authenticated Relay delivery, and recipient ingestion receipts where an enterprise workflow needs them.

Data Edge Sync can support service views in the richer gateway profile through offline-protocol-data; it is not loaded onto the constrained leaf as a substitute for firmware state. The supplier distributes a reusable board-support interface and gateway profile, while OEMs own their application, partition plan, radio certification, release process, and field support.

The distribution package has two application profiles. Smart access connects a lock or controller, hub, and companion phone around authorized service requests and outcome evidence. Smart energy connects meter or field-device observations to the local gateway and existing head-end recipient. Both include reference firmware, a reproducible qualification suite, and an integration profile that sales and field engineering can take to additional OEMs.

Qualification follows the actual product

The integration progresses from pinned-version software interoperability to the selected board and then the OEM's complete firmware image. Each result records hardware, radio conditions, payload size, and firmware revision.

  • Fit: the leaf qualification gate is below 500 KiB; the complete firmware must also fit the OEM's flash and OTA plan. Peak heap and stack are measured during pairing, receive, response, and rekey.
  • Trust: invalid, expired, stale, and replayed requests must leave protected application state unchanged.
  • Responsiveness: the selected local profile targets median authenticated request-to-response below 250 ms, excluding mechanical actuation.
  • Recovery: reset and lost-receipt fixtures target at least 99.9% duplicate-free application outcomes, checked against the persistent journal.
  • Interoperability: provisioning, frames, and group state must agree across the pinned leaf/gateway builds before actual radio qualification.

The delivered engineering result is an inspectable embedded implementation with repeatable size and wire-cost baselines. The original questions about device-side code and footprint now resolve to source, build settings, and measurement fixtures. Board qualification then measures the radio, memory, and recovery behavior of the OEM's complete product.

Managed services and expansion

Extend smart-access productsAuthorized requests and device healthVersioned capability profilesConnect energy-device servicesRetained readings and local diagnosticsLeaf + gateway integrationBuild the aftermarket offeringCommissioning, support, and field evidenceHosted Relay + Telemetry
Extend smart-access productsAuthorized requests and device healthVersioned capability profilesConnect energy-device servicesRetained readings and local diagnosticsLeaf + gateway integrationBuild the aftermarket offeringCommissioning, support, and field evidenceHosted Relay + Telemetry
04 / From embedded integration to branded aftermarket services

The embedded integration gives the semiconductor supplier a repeatable route into additional OEM products. The next layer is the service experience around those devices: commissioning, diagnostics, field maintenance, and ongoing support under the OEM's own brand.

Product-specific capability profiles. Capability Exchange9 can package versioned service contracts for each product family. A smart-access profile can expose device health and authorized service-request outcomes; an energy profile can expose retained observations and diagnostic status. The richer gateway hosts discovery and routing, while the constrained leaf handles its supported requests and durable state. Adding these services does not require placing a hosted-service client or replicated database on every embedded device.

Managed aftermarket support. An OEM can connect gateway delivery through Hosted Relay and opt selected diagnostics into managed Telemetry.10 Support teams can then correlate provisioning, retry, and recovery problems with firmware and hardware revisions. Diagnostic collection is bounded and buffered at the gateway so it does not hold up local device requests. Commissioning evidence and field-service records create further support workflows using the same device identity.

Distribution beyond the first design. Additional OEMs inherit the reference firmware, gateway profile, storage contract, and qualification fixtures, then qualify their own boards and application behavior. This supports a commercial platform license with integration and distribution rights, product-specific engineering support, and optional managed operations.11 The manufacturer can expand its service offering over the installed base while retaining its branded application, firmware release process, and customer relationship.

References

  1. 01Embedded leaf implementation
  2. 02Offline Protocol Mesh SDK
  3. 03Embedded reference measurements: SDK 0.24 release
  4. 04Binary wire format and payload-size measurements
  5. 05OfflineID and device identity
  6. 06Messaging Layer Security: RFC 9420
  7. 07Embedded footprint harness and measurement boundaries
  8. 08Leaf provisioning and persistence contract
  9. 09Service discovery and authenticated invocation
  10. 10Runtime telemetry
  11. 11Commercial licensing and deployment options

Bring the failure case. Leave with evidence. One workflow, agreed criteria, 4 to 16 weeks.

Scope an integration Read the docs