Eclipse Leshan™ is an OMA Lightweight M2M server and client Java implementation.
What is OMA LWM2M ?
Object and Resource Registry.
Leshan provides libraries which help people to develop their own Lightweight M2M server and client.
The project also provides a client, a server and a bootstrap server demonstration as an example of the Leshan API and for testing purpose.
| LWM2M Version Targeted | Leshan Version | Development State | Build Status | Standalone Demos |
|---|---|---|---|---|
| v1.0.2 core specification(pdf) |
v1.x Supported features |
stable released | jenkins-1.x | server-demo client-demo bsserver-demo |
| v1.1.1 core specification(html) transport bindings(html) |
v2.x (master) Supported features |
in development | jenkins-master | server-demo client-demo bsserver-demo |
Release (stable and milestones) are available on maven central.
Nightly build (snapshot) are available on eclipse repo. (more details)
The Leshan Documentation is available in our wiki 📘.
Join the project mailing list : subscribe.
Mail address: leshan-dev@eclipse.org.
Access to leshan-dev archives.
You can try live our servers demos instances:
- The lwm2m server at https://leshan.eclipseprojects.io/
(coap://leshan.eclipseprojects.io:5683 and coaps://leshan.eclipseprojects.io:5684) - The bootstrap server at https://leshan.eclipseprojects.io/bs/
(coap://leshan.eclipseprojects.io:5783 and coaps://leshan.eclipseprojects.io:5784)
(Automatic deployment of master branch)
Get and run the last binary of our demo server :
wget https://ci.eclipse.org/leshan/job/leshan/lastSuccessfulBuild/artifact/leshan-server-demo.jar
java -jar ./leshan-server-demo.jar
Get and run the last binary of our demo client :
wget https://ci.eclipse.org/leshan/job/leshan/lastSuccessfulBuild/artifact/leshan-client-demo.jar
java -jar ./leshan-client-demo.jar
Get and run the last binary of our bootstrap demo server :
wget https://ci.eclipse.org/leshan/job/leshan/lastSuccessfulBuild/artifact/leshan-bsserver-demo.jar
java -jar ./leshan-bsserver-demo.jar
ℹ️ : All the demos have a --help option.
Get sources :
#using ssh
git clone git@github.com:eclipse/leshan.gitor
#using https
git clone https://github.com/eclipse/leshan.git
Compile it, by running in leshan root folder :
mvn clean install
Run demo server:
java -jar leshan-server-demo/target/leshan-server-demo-*-SNAPSHOT-jar-with-dependencies.jar
Connect on Leshan demo UI: http://localhost:8080
Leshan server Demo provides a very simple UI to get the list of connected clients and interact with clients resources.
Now you can register a LWM2M client by running our client demo:
java -jar leshan-client-demo/target/leshan-client-demo-*-SNAPSHOT-jar-with-dependencies.jar
or trying the Eclipse Wakaama test client.
You can also try our bootstrap demo server:
java -jar leshan-bsserver-demo/target/leshan-bsserver-demo-*-SNAPSHOT-jar-with-dependencies.jar
Now you played a bit with our demo, you should start to code your own server or client using our Getting-started guide.