Implements RFC7252

Californium is a Java CoAP implementation for IoT Cloud services. Thus, the focus is on scalability and usability instead of resource-efficiency like for embedded devices. Yet Californium is also suitable for embedded JVMs.

More information can be found at http://www.eclipse.org/californium/ and http://coap.technology/.

A bug, an idea, an issue? Join the Mailing list

Use mvn clean install in the Cf root directory to build everything. Executable JARs of the examples with all dependencies are copied to ./run/.

To use Californium as library in your projects, add the following dependencies and Maven repository to your pom.xml (without the dots):

  <dependencies>
    ...
    <dependency>
            <groupId>org.eclipse.californium</groupId>
            <artifactId>californium-core</artifactId>
            <version>1.0.0-SNAPSHOT</version>
    </dependency>
    ...
  </dependencies>
  ...
  <repositories>
    ...
    <repository>
      <id>repo.eclipse.org</id>
      <name>Californium Repository</name>
      <url>https://repo.eclipse.org/content/repositories/californium/</url>
    </repository>
    ...
  </repositories>

The project also includes the project files for Eclipse. Make sure to have the following before importing the Californium (Cf) projects:

• Eclipse EGit
• m2e - Maven Integration for Eclipse
• UTF-8 workspace text file encoding (Preferences » General » Workspace)

Then choose [Import... » Git » Projects from Git » Local] to import californium into Eclipse.

In case you are using plain Eclipse projects without Maven, you also need to clone and import the element-connector. Add this project to Properties » Java Build Path » Projects.

A test server is running at coap://iot.eclipse.org:5683/. The root resource responds with its current version.

Another interop server with a different implementation can be found at coap://coap.me:5683/. More information can be found at http://coap.me/.