Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,12 +28,16 @@ CreatorKit project is spread across couple of organizations :-
* [Button Sensor](https://github.com/CreatorKit/button-sensor): MikroE 6loWPAN Clicker based lwm2m client button sensor application.
* [Light Controller](https://github.com/CreatorKit/light-controller): CreatorKit [Project 2](projects/Project_2.md) application for Creator Ci40 platform.
* [Motion Sensor](https://github.com/CreatorKit/motion-sensor): MikroE 6loWPAN Clicker based lwm2m client motion sensor application.
* [Relay Gateway](https://github.com/CreatorKit/relay-gateway): CreatorKit [Project 3](projects/Project_3.md) application for Creator Ci40 platform.
* [Mobile Power Switch Android](https://github.com/CreatorKit/mobile_power_switch): CreatorKit [Project 3](projects/Project_3.md) android app for controlling relay.
* [Mobile Power Switch iOS](https://github.com/CreatorKit/mobile_ios_power_switch): CreatorKit [Project 3](projects/Project_3.md) iOS app for controlling relay.
* [Creator Docs](https://github.com/CreatorKit/creator-docs): Entry level documentation for CreatorKit project.

## Projects
CreatorKit as of now has following projects :-
* [Project 1](projects/Project_1.md)
* [Project 2](projects/Project_2.md)
* [Project 3](projects/Project_3.md)

## Getting Started
Please refer [Getting Started](GettingStarted.md) guide for detailed steps that describes how to get CreatorKit up and running.
Expand Down
28 changes: 28 additions & 0 deletions projects/Project_3.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
![Creator Logo](../images/creatorlogo.png)

# Project 3 - Relay controller

## Introduction

In this project mobile app is used to controll the relay click inserted on Ci40. Ci40 acts as a constrained device that is connected to Creator Device Server in cloud. Mobile app uses device server REST API to update IPSO resource on Ci40. Once Ci40 gets notification about IPSO resource update it changes relay state according to received value and responds with operation status.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

controll => control


## Steps
To complete these steps, refer to the [Getting Started](../GettingStarted.md) for detailed descriptions of each action.

* Get the code: Refer [this](../GettingStarted.md#getting-the-code) if you want to build from source or get pre-built binaries.
* [Boot](../GettingStarted.md#running-ci40-board) OpenWrt on Ci40
* [Connect](../GettingStarted.md#connecting-ci40-to-the-internet) Ci40 to the Internet
* [Make](https://console.creatordev.io/) an Creator Account if You don't have it yet
* [Provision](https://github.com/CreatorKit/relay-gateway#app-provisioning) Ci40 to the Creator Device Server
* Run mobile application ([Android](https://github.com/CreatorKit/mobile_power_switch) or [iOS](https://github.com/CreatorKit/mobile_ios_power_switch)) and log in using Creator Account credentials
* Use mobile application to controll relay state on Ci40

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

controll => control


## How it works
The Ci40 acts as a constrained device in this project. It connects to the Internet (over Ethernet and Wi-Fi) and registers as a client to Creator Device Server. It observes IPSO digital output resource and changes relay state when notification is received.

Mobile app controls the IPSO digital output resource. It uses Creator Device Server REST API to change the IPSO resource which is then propagated to app running on Ci40.

This project includes two applications

* [**Relay Gateway**](https://github.com/CreatorKit/relay-gateway): Runs on Ci40 and observes IPSO digital output resource registered by itself. Updates relay state as per the changes received. For more info, read [this](https://github.com/CreatorKit/relay-gateway/blob/master/README.md).
* **Mobile power switch** ([Android](https://github.com/CreatorKit/mobile_power_switch) or [iOS](https://github.com/CreatorKit/mobile_ios_power_switch)): Runs on phone and allows to control relay using switch. For more information please refer to [Android](https://github.com/CreatorKit/motion-sensor/blob/master/README.md) and [iOS]() apps docs.