LwM2M Client Conformance Tool
Conformance Validation Based on Official OMA Interoperability Test Specifications
The OMA LwM2M Client Conformance Tool enables device manufacturers, software developers, and test engineers to independently verify that their LwM2M Client implementation conforms to OMA specifications before deployment, interoperability events, or customer trials.
The tool executes an automated suite of conformance tests against an OMA-hosted Eclipse Leshan reference implementation of an LwM2M Server, validating that LwM2M Client implementations behave in accordance with supported OMA LwM2M specifications.
Test suites are derived directly from official OMA specifications, including:
Supported targets include real devices, software implementations, gateways, and bridge or connector solutions that interconnect legacy or non-IP devices.
At the completion of each test run, the tool generates a detailed HTML report identifying passed, failed, and incomplete test cases, helping engineering teams rapidly identify implementation issues, demonstrate conformance, and improve interoperability readiness.
Why Use the Conformance Tool?
Validate Against Official OMA Test Cases
Standards-Based Validation
Execute tests derived directly from OMA normative specifications rather than proprietary or vendor-specific test environments.
Reduce Interoperability Risk
Improve Deployment Readiness
Identify protocol implementation issues before participating in interoperability events, field trials, or production deployments.
Accelerate Debugging
Faster Issue Resolution
Receive detailed pass/fail reports that help pinpoint exactly which client behaviours require attention.
Demonstrate Standards Compliance
Objective Conformance Evidence
Generate conformance evidence that can support procurement requirements, customer evaluations, and RFP responses.
What It Tests
Your Device or Software
Test Real Implementations
Tests real devices, software implementations, and bridge/connector solutions across standard IP networks, including NB-IoT, LTE-M, Wi-SUN, 6LoWPAN, Ethernet, and Wi-Fi.
Client Operations
Validate Protocol Behaviour
Covers Read, Write, Execute, Create, Delete, Observe, and Notify operations across LwM2M 1.0 and 1.1, including Composite Operations and OSCORE security.
Test Profiles
Relevant Test Selection
Supports test suites derived from both the OMA LwM2M Interoperability and Smart City test specifications, allowing organizations to execute only the tests relevant to their implementation.
HTML Test Reports
Actionable Results
Generates structured HTML reports with detailed pass/fail results to help identify implementation issues and accelerate troubleshooting.
The tool validates client behaviour against OMA test specifications and a reference LwM2M Server implementation. It is intended to complement, not replace, interoperability testing with independent server implementations.
Architecture
The conformance tool operates as an automated test harness that validates a Device Under Test (DUT) through an OMA-hosted Eclipse Leshan reference implementation of an LwM2M Server.
The DUT communicates with the server over a standard IP network while the conformance tool executes test procedures and verifies client responses against expected protocol behaviour.
Architecture of the OMA LwM2M Client Conformance Tool
The Device Under Test (DUT) establishes a standard LwM2M connection to the OMA-hosted Eclipse Leshan LwM2M reference server, while the conformance tool orchestrates and validates the resulting protocol exchanges.
Getting Started — Begin Your Conformance Journey
1. Register Your Implementation
Submit your details to the OMA team and tell us about your organization, device or software type, LwM2M version, and target profile.
This information allows us to provision access and direct you to the appropriate resources.
Submit Registration
2. Receive Repository Access
Once approved, you will receive access to the OMA Conformance Tool GitHub repository, including the test framework, supported profiles, configuration examples, and supporting documentation.
3. Follow the Setup Guide
The repository README is the authoritative guide for installation, configuration, running tests, interpreting results, and troubleshooting.
View the README on GitHub
Resources
OMA Conformance Tool
Source Code & Documentation
Access the conformance tool source code, supported test profiles, setup instructions, configuration examples, and project documentation.
LwM2M Interoperability Test Specification
Test Specification V1.2.1
Official OMA interoperability test specification defining normative test cases used to validate LwM2M client behaviour and protocol compliance.
Smart City Test Specification
Test Specification V1.0
Official OMA Smart City conformance specification containing test cases used to validate Smart City device and application implementations.
