Eclipse Leshan is an OMA Lightweight M2M (LWM2M) implementation in Java.
Java JavaScript HTML CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
eclipse Remove unnecessary casts and warn about them Feb 3, 2017
leshan-all Bump version to 1.0.0-SNAPSHOT Jul 19, 2018
leshan-bsserver-demo Fix X509 bootstrap server demo UI Aug 17, 2018
leshan-client-cf #435: Add support of RPK Aug 16, 2018
leshan-client-core Add support of RPK to Leshan Client Demo Aug 16, 2018
leshan-client-demo Print hexa public and private key in log of Leshan client demo. Aug 17, 2018
leshan-core-cf Bump version to 1.0.0-SNAPSHOT Jul 19, 2018
leshan-core Add RPK support to bsserver demo Aug 17, 2018
leshan-integration-tests #537: Add RPK API for bootstrap server Aug 16, 2018
leshan-server-cf #537: Add RPK API for bootstrap server Aug 16, 2018
leshan-server-cluster Allow the use of -Dlogback.configurationFile for demos Jul 19, 2018
leshan-server-core #548 : change bootstrapStore API, add device Identity to getBootstrap Aug 1, 2018
leshan-server-demo Display more RPK information in leshan-server-demo UI. Aug 17, 2018
.gitignore Add support of RPK to Leshan Client Demo Aug 16, 2018
CONTRIBUTING.md Link CONTRIBUTING.md to the "How to contribute" wiki page. Nov 22, 2017
LICENSE-edl-v1.0.md Add LICENSE file for github Nov 23, 2017
LICENSE.epl-v1.0.md Add LICENSE file for github Nov 23, 2017
README.md Readme: update link to the lwm2m spec 1.0.2 and use https for sandbox Jun 29, 2018
about.html Initial contribution Feb 7, 2015
jar-with-dependencies-with-logback.xml #473: Include logback.xml in jar as default config for demo Mar 1, 2018
notice.html Initial contribution Feb 7, 2015
pom.xml Bump version to 1.0.0-SNAPSHOT Jul 19, 2018

README.md

Build Status

Leshan

Eclipse Leshan™ is an OMA Lightweight M2M server and client Java implementation.

What is OMA LWM2M ?
The specification.
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.

Here you can see which part of the specification is currently covered by Leshan.

The Leshan Documentation is available in our wiki 📘.

Contact

Join the project mailing list : subscribe.
Mail address: leshan-dev@eclipse.org.
Access to leshan-dev archives.

Test Server Sandbox

You can try live our servers demos instances:

(Automatic deployment of master branch)

Leshan

Test Leshan Demos locally

Get and run the last binary of our demo server :

wget https://hudson.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://hudson.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://hudson.eclipse.org/leshan/job/leshan/lastSuccessfulBuild/artifact/leshan-bsserver-demo.jar
java -jar ./leshan-bsserver-demo.jar

ℹ️ : All the demos have a --help option.

Compile Leshan & Run Demos

Get sources :

#using ssh
git clone git@github.com:eclipse/leshan.git

or

#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 

Let's start to code !

Now you played a bit with our demo, you should start to code your own server or client using our Getting-started guide.