application

Backend of ToIoT

Table of contents

• Installation
• Run
• Registration
• Logic
• Health Check

Installation

$ go get github.com/KumKeeHyun/PDK

or

// toiot/application
$ go get github.com/KumKeeHyun/PDK/application

// toiot/logic-core
$ go get github.com/KumKeeHyun/PDK/logic-core

// toiot/health-check
$ go get github.com/KumKeeHyun/PDK/health-check

docker

// latest tag is 0.3

// toiot/application
$ docker pull kbzjung359/pdk-app

// toiot/logic-core
$ docker pull kbzjung359/pdk-logic

// toiot/health-check
$ docker pull kbzjung359/pdk-health

or

// In the directory where the Dockerfile are located
$ docker build -t (image name) .

Run

// toiot/application, toiot/logic-core, toiot/health-check
$ go run main.go

or

// In the directory where the docker-compose.yml are located
$ docker-compose up

Environment variable

The setting value of each microservice is set by reading environment variables.

toiot/application (Registration)

• Currently DBMS only supports mysql

toiot/logic-core (Logic)

toiot/health-check (Health Check)

Registration

Manage sensor registration and deletion

Structure

The sensors are divided into three concepts and managed

Sensor

A sensor used for measurement

type Sensor struct {
    Name string
    ValueList []struct {
        Name string
    }
}

Node

A board installed in a specific place to form a sensor network

type Node struct {
    Name, Group string
    Location struct {
        Lat float64
        Lon float64
    }
    SinkID uint
    Sensors []Sensor
}

Sink

A board that router, sink of sensor network

type Sink struct {
    Name, Location, IP string
    Nodes []Node
}

UUID

Unique number assigned to each sensor and node. uuid is used for sensor data collection, data enrichment.

• [https://github.com/rs/xid]

Restful API

Logic

Manage sensor data pipeline, event processing for sensor data

Structure

type Ring struct {
	SensorUUID string
	LogicName string
	Logic []struct {
		Element string
		Argument map[string]interface{} 
	}
}

Restful API

Health Check

Manage sensor status

Structure

type States struct {
    Timestamp string
    State []struct{
        NodeUUID string
        State bool
    }
}

Status

1. Red

• When not running for "count * tick-interval" time

1. Yellow

• State changes intermittently

1. Green

• When it works well for "count * tick-interval" time

Restful API