device-sdk-java

This repository contains Cisco's IoT device SDK written in Java. Device SDKs are the applications which run on Cisco's gateways and enable you to extract observations from client devices connected to Cisco's gateways and send the information to Cisco Kinetic Data Delivery Platform. The Cisco gateways provide the application users with internet connectivity, application running on gateway which helps in device management and a secure platform to connect to Cisco's cloud.

To get started, clone this repository.

• Overview
• How to use the Cisco IoT SDKs for Java
• Java Docs for Libraries
• Sample Application
• Writing Rules
• Change Logs
• Directory Structure
• Support

Overview

This repository contains sample applications and libraries for

How to use the Cisco IoT SDKs for Java

Connect your device to the gateway. The IoT device SDKs enable you to implement applications for a gateway. These gateways can be connected to any sort of device and can extract and process information received from these devices.

The application will run on Mac, Linux, IOx. To start developing these applications, refer documentation as shown below.

Java docs for libraries

There are a number of libraries required in order to run sample applications - iotsp-edge-rule-engine and iotsp-batching. These libraries are stored here. The Javadoc for these libraries can be found here. In order to access any libraries Javadoc, run the following commands from root of the folder.

cd libs/javadoc-jars
mkdir tmpFolder
cp <Jar name of library whose java doc is to be accessed> tmpFolder/
cd tmpFolder/
jar -xvf <Jar name of library whose java doc is to be accessed>

Then navigate to this "tmpFolder" from your finder and open "index.html" using any web browser.

Sample Application

In this repository, you can find simple sample implementations that will kickstart your development.

Writing Rules

To write rules, please refer Cisco's tutorial on their DSL.

Directory Structure

Pi-Sensehat

• The Pi-Sensehat directory contains all the materials necessary to install the sensehat application on the raspberry pi. In this directory the readme contains instructions to install the application. The sensehat-app directory is to be installed into the home/pi/projects directory on the raspberry pi.

examples

• The examples directory contains two subdirectories - iotsp-batching and iotsp-edge-rule-engine. These directories contain information on how to install and run the sample applications. They also provide APIs and documentation on different options the sample applications provide and use.

libs

This directory contains libraries and their java-docs, necessary for runnning the above sample applications. It contains 2 folders:

• lib-jars - This folder contains the library jars
• javadoc jars - This folder contains java doc jars for all the libraries.

Change Log

Please find change log here.

Support

Please email all questions and feedback to [email protected]