Difference between revisions of "WISE-PaaS/SRP Services"

Revision as of 08:14, 16 January 2017

OVERVIEW

• API Management

Adopt Azure API Management/Open-source (WSO2) to integrate various SRP services API.

• Common Service APIs/Lib

Basic Account/Device/Group/Role operation APIs, including Add/Edit/Delete/Search/Advance Search WISE-PaaS administration information (Product Support, version, capability…etc.)

• Custom/SRP Service

RMM/IMM/OTA/SCADA self-service APIs

• Common Data Workers

Including device basic information and sensor data from broker. (Common MQTT Topic) For structure info (device Info) store into PostgreSQL For non-structure (sensor Info) store into MongoDB/DocumentDB/...etc.

• Custom/SRP Data Workers

Process RMM/IMM/OTA/SCADA self-MQTT topic message and store into self-database (RMM/IMM/OTASCADA DB)

• Message Broker (RabbitMQ)

Adopt RabbitMQ as default cluster broker, and plugin MQTT as communication protocol.

• Device Agent

Define common MQTT topic handshake message and custom/SRP topic format.

• Database (SQL/NoSQL)

PostgreSQL as default relation database and including Common/RMM /SCADA/IMM/etc. MongoDB/DoucmentDB for sensor information collect.

COMMON DATABASE SCHEME

Concept & Design Rules

• Device belong to multi-groups or not to any group.
• Each account have non or multi-groups.
• Each group must belong to someone account.
• Group of group (1-3 Levels)
• Each account must belong to someone role.

Common Database Scheme

Common Database Table Details

Table Account

Table Role

Table Group

Table Device

Non-Structure Data (MongoDB/DocumentDB)

• Default Collections

• Event
  • WISE-PaaS platform event message
  • Format

                        {         "product": "RMM",        

                                  "type": "DEVICE",        

                                  "subtype": "DEVICE_DISCONNECTED",        

                                  "severity": "ERROR",        

                                  "message": "DEVICE_DISCONNECTED",        

                                  "extMsg": <JSONObject>,        

                                  "device_id": 2,        

                                  "device_name": "AC09",        

                                  "account_id": 2,        

                                   "account_name": "admin",        

                                   "ts": ISODate('2016-11-29T05:13:46.759Z') }

• Handler (Plugin)
  • Handler (Plugin) report data (source data)
• Capability
  • Handler capability structure
• Heartbeat
  • WISE-PaaS device’s keepalive mechanism, ensure device connection state.

• Sensor Collections (Dynamic generate and transfer to key/value)

• SUSIControl
• HDDMonitor
• Modbus
• SenHub
• IoTGW
• …

API MANAGEMENT (RESTFUL APIS)

Common REST APIs

• Device APIs
• Group APIs
• Account APIs
• Role APIs
• Data Management APIs
• NoSQL APIs

Custom REST API Categories

• RMM
• IMM
• SCADA
• OTA

DEVICE CONNECTIVITY

Message Topics

Handshake Sequence

Data Format

• Basic JSON Format
• IPSO Format (Application Framework)

DEVOPS MANAGEMENT

Continuous Integration & Continuous Delivery

Version Control

Build and Test

Release & Deploy

CUSTOM SERVICE INTEGRATION

Access Methods

Internal Messaging(ZMQ)

Java Library

Common Restful APIs

RMM/OTA/SCADA/IMM Integration

• Scenario 1) RMM show more information about account
• Scenario 2) OTA deploy a package for region devices

Document