Covia UM-125 User manual

CYBERDYNE 株式会社 御中
User manual
Model: UM-125
Brand: Covia
Manufacture: Amigo Technology Inc.

改版履歴
日付 Date
改版者 Revision
版数 Edition
number
改訂内容 Revised content
2017/01/07
Covia Inc.
0.01 版
初版 First eiditon
2017/02/05
Covia Inc.
0.50 版
記載を追加 Additional records
© Covia Inc. reserves all rights, including rights of disposal such as copying and passing on to third parties.
Created on Jan-6-2017
UM-125_system_requirement_v001.docx
Page 2 / 19

Confidential
UM-125（CDC-AP）ソフトウェア機能仕様書
版数
改版日
作成者
0.01 版
2016.01.07
Covia Inc.
1 はじめに Introduction
本仕様書では、UM-125（CDC-AP）ゲートウェイ装置のソフトウェア仕様について記述する。本仕
様書では、原則として GUI の表示形態、表示方法などについては記述しないものとする。
In this Instruction book, UM-125 introduces a Gateway Device of software specification(CDC-
AP). GUI serves as a general display mode in this instruction book, which includes no records of
the displaying method.
2 前提条件 Precondition
2.1 関連規格 Associated specification
本仕様書に記載する内容は、以下の規格に準拠する。
Content recorded in this instruction book measures up to the following standard.
2.2 関連資料
本仕様書に記載する内容は、以下の資料に準拠する。
Content recorded in this instruction book has the following information.
No.
資料 Information
版数 edition
number
出展元 Publish company
1
CCS Web API Document
1
CYBERDYNE 株式会社（Ltd）
2
CNDP 仕様書（CNDP Specification table）
1
CYBERDYNE 株式会社
3
NDP-PROP 仕様書（NDP-PROP Specification
table）
1
CYBERDYNE 株式会社
4
© Covia Inc. reserves all rights, including rights of disposal such as copying and passing on to third parties.
Created on Jan-6-2017
UM-125_system_requirement_v001.docx
Page 3 / 19

Confidential
UM-125（CDC-AP）ソフトウェア機能仕様書（Software
functional specification table）
版数
改版日
作成者
0.01 版
2016.01.07
Covia Inc.
2.3 凡例 Guide
(1) 本仕様書中の項目名は『』内に示す。
【例】『目的』、『機能概要』
(2) 編記
本仕様書の改版時に、変更・追加、削除などの理由・説明等を特に明記する場合には、【編
記】として記載する。この記述は基本的に、次回改版時には削除される。
（1）Project names mentioned in this instruction book is presented in『』.
Esp. 『目的』、『機能概要』
（2）Edit by symbols
In this instruction book, modification, supplement and amendment, especially for reason and
interpretation, etc. when need to be deleted, use 【編記】 to illustrate. Such description
means that it will be deleted in the next version at that time.
2.4 用語 Term
本仕様書で仕様する用語にうち、製品に固有の述語など、特殊で一般的でないものにつき
下表に記載する。
The product-related technical terms in the instruction book are particularly rare and are
described in the following format.
No.
用語 Term
意味 Meanings
1
2
© Covia Inc. reserves all rights, including rights of disposal such as copying and passing on to third parties.
Created on Jan-6-2017
UM-125_system_requirement_v001.docx
Page 4 / 19

2.5 注意事項 Attentions
本仕様書に定義している動作説明において、メモリ構成、フロー図などを用いて説明してい
る箇所が存在する。これは、文章での記述だけでは困難と判断した場合について記載したも
のであり、具体的な実現手法については本仕様書では特に記載しない。
In this instruction book, the act of the memory configuration is defined by parts of the
flowchart. There’s no record of specific implementation procedure for it’s difficult to
describe or judge merely in this book.
© Covia Inc. reserves all rights, including rights of disposal such as copying and passing on to third parties.
Created on Jan-6-2017
UM-125_system_requirement_v001.docx
Page 5 / 19

Confidential
UM-125（CDC-AP）ソフトウェア機能仕様書
版数
改版日
作成者
0.01 版
2016.01.07
Covia Inc.
3 概要 Outline
クラウドサーバーが提供する Web API を利用する際の通信プロトコルにおける基本事項につ
いて本項に記述する。
Use the Web API to provide the cloud server with the basic knowledge of the communication
protocol described in this section.
3.1 ハードウェア概要 Hardware overview
UM-125 のハードウェアブロック図を以下に示す。
The hardware block diagram of the UM 125 is shown below.
© Covia Inc. reserves all rights, including rights of disposal such as copying and passing on to third parties.
Created on Jan-6-2017
UM-125_system_requirement_v001.docx
Page 6 / 19

Confidential
UM-125（CDC-AP）ソフトウェア機能仕様書
版数
改版日
作成者
0.01 版
2016.01.07
Covia Inc.
3.2 ソフトウェア概要 Software overview
UM-125（CDC-AP）のソフトウェアブロック図を以下に示す。
A software block diagram of UM 125 (CDC-AP) is shown below.
No
区分
名称
説明
1
HTML/CSS/JS
WebGUI 部である。Web 経由のログイン画面、各種設定
機能などが含まれる。
This is a part of WebGUI which includes login
screen, settings through the internet, etc.
2
Web Server
独自の軽量 Web サーバー、アプリケーション・サーバー
である。HTTP 通信のみしかサポートしない。
It’s an original lightweight web server of
application. It supports only HTTP communication.
3
Application
Web API Module
WebAPI として公開する機能を提供するモジュールであ
る。
Web API as a module that provides a function to
publish.
システム管理（状態管理・制御）と CDC-AP（マスタ・ス
4
System Manager
レーブ）制御を行うシステムとしてのコアなモジュールと
なる。同時に CNDP（マスタ・スレーブ）にもなる部分で
CNDP Coordinator
© Covia Inc. reserves all rights, including rights of disposal such as copying and passing on to third parties.
Created on Jan-6-2017
UM-125_system_requirement_v001.docx
Page 7 / 19

Confidential
UM-125（CDC-AP）ソフトウェア機能仕様書
版数
改版日
作成者
0.01 版
2016.01.07
Covia Inc.
BT/BLE
CNDP Coordinator と連携して、制御する BT/BLE デバイ
5
スを判断し、CC2564/CC2541 Driver Application を利用
Coordinator
して、デバイスインスタンスの制御を行うモジュールであ
Application
る。
Cooperate with CNDP
Coordinator to control the BT /
BLE device
Use CC2564 / CC2541 Driver
Application to confirm the scan.
It is a module that controls the
device instance.
6
CCS2
CCS2 サーバーとの通信を行い、通信内容により、System
Communicator
Manager に状況をレポートするモジュールである。
CCS2 communicates with the server, communication
content, and system communication.
This is a module that reflects the management situation.
7
FW Updator
UM-125（CDC-AP）のファームウェアを更新するモジュー
である。
UM-125（CDC-AP）is a module
for firmware update.
8
CURL
HTTP/HTTPS 通信用のライブラリ・コマンドを提供する
オープンソースソフトウェアである。
Provide library commands for HTTP /
HTTPS communication
It’s a open source software.
9
OpenSSL
SSL/TLS プロトコル、および暗号化ライブラリを提供す
るオープンソースソフトウェアである。
SSL / TLS protocol, and encryption library.
It is open source software.
10
Python
Python 言語（スクリプト）の実行エンジン機能を提供す
るオープンソースソフトウェアである。
This is an open source software for running
the Python language running engine
functionality (script).
11
Open
JSON Parsor
JSON 構造のデータをデコードするためのライブラリ機能
を提供するオープンソースソフトウェアである。
This is an open source software for providing decoding
library for data of JSON structure.
Source
12
MTD Utils
フラッシュメモリに対する Write/Read/Erase 機能コマン
ドを提供するオープンソースソフトウェアである。
This is a software that provides flash / read / erase
function commands.
13
Wireless Tools
Wi-Fi 関連の機能コマンドを提供するオープンソースソフ
トウェアである。
Open source software that
provides Wi-Fi related function
commands.
14
DHCP
DHCP サーバー、クライアント機能を提供するオープンソ
ースソフトウェアである。
This is an open source to
provide DHCP server and
client-side scanning software.
14
© Covia Inc. reserves all rights, including rights of disposal such as copying and passing on to third parties.
Created on Jan-6-2017
UM-125_system_requirement_v001.docx
Page 8 / 19

4 機能仕様 Functional specification
クラウドサーバーが提供する Web API を利用する際の通信プロトコルにおける基本事項につ
いて本項に記述する。
Basic items in the communication protocol when using the Web API provided by the cloud
server are described in this section.
4.1 機能一覧 Function overview
UM-125（CDC-AP）にて提供する機能を下表に示す。
The functions provided by UM 125 (CDC-AP) are shown in the table below.
ネットワーク機能 Network function
無線 LAN 機能（2.4/5GHz 同時利用可能）Wireless LAN function (2.4 / 5GHz simultaneous possible for use)
無線方式 Wireless mode
5GHz
IEEE802.11a/n/ac
2.4GHz
IEEE802.11b/g/n
暗号化方式 Cipher mode
WEP（64/128bit）、WPA2-PSK（AES）, WPA/WPA2-PSK（AES/TKIP）
SSID 機能 SSID function
マルチ SSID、ステルス SSID Multi SSID, Stealth SSID
その他 Others
UM120 機能に準拠 Conform to UM120 function.
ルータ機能 Router function
フィルタリング機能
Filtering function
IP フィルタリング、MAC フィルタリング、URL フィルタリング
IP filtering, MAC filtering, URL filtering
その他 Others
ルーティング、ポートマッピング、DNS ルーティング、DDNS、DoS、DMZ、
など、他 UM120 機能に準拠
Routing, port mapping, DNS routing, DDNS, DoS, DMZ,
For example, follow other UM120 functions.
設定機能 Setting function
各種設定 Web 画面
Various setting Web
screens
WebAPI
※Basic 認証にて WebAPI 経由で設定変更可能
Settings can be changed via WebAPI with basic authentication
CDC-AP（CYBERDYNE Data Communication Access Point）機能 Function
CDNP エージェント機能 CDNP agent
function
CNDP クライアント機能（デバイスに対して 1 つのインスタンス起
動）
CNDP client function (one instance activation for device)
Bluetooth（BT）アグリゲータ機能 Bluetooth (BT) aggregator function
聚合函数 Aggregate function
CNDP-AP 機能設定機能 CNDP-AP function setting function
WebGUI/WebAPI 認証機能
WebGUI / WebAPI
authentication function
スクリプトを実行する際に実行権限を分けるための認証機能
Authorized certification function will be executed when executing script.
CNDP エージェント設定
CNDP agent setting
CNDP エージェント機能の有効／無効設定
Enable / disable CNDP agent function
Bluetooth 機能設定
Bluetooth Function
setting
Bluetooth 機能の有効／無効設定
Enable / disable Bluetooth function
© Covia Inc. reserves all rights, including rights of disposal such as copying and passing on to third parties.
Created on Jan-6-2017
UM-125_system_requirement_v001.docx
Page 9 / 19

Confidential
UM-125（CDC-AP）ソフトウェア機能仕様書
版数
改版日
作成者
0.01 版
2016.01.07
Covia Inc.
CCS2 サーバー設定
CCS2 server setting
CCS2 サーバーアドレスおよびユーザーアカウント認証設定
CCS2 server address and user account authentication settings
FW アップデータ設定
FW update settings
FW アップデートの自動／手動設定
Automatic / manual setting of FW
update
デバイス設定
Device
settings
処理対象のデバイスを判断するためのホワイトリスト・ブラックリ
ストの設定
White list / black list setting for judging
the processing target device
スクリプト設定
Script settings
スクリプトの登録および実行
Register and execute script
通信帯域設定
Communicatio
n band setting
CNDP プロトコル通信の帯域制御設定
Bandwidth control setting for CNDP
protocol communication
設定機能 Setting
function
T.B.D
© Covia Inc. reserves all rights, including rights of disposal such as copying and passing on to third parties.
Created on Jan-6-2017
UM-125_system_requirement_v001.docx
Page 10/ 19