开发中心（Dev Center）
SCICALA霜蝉云
SCICALA霜蝉云主要是为了解决设备与设备、设备与上位机应用（Android、IOS、PC）之间互联互通而开放的物联网平台。霜蝉云主要用来透传数据，接入设备几乎不需做修改便可接入实现远程透传数据。霜蝉云适用于远程监控与控制、物联网、智能家居、工业联网、智能微电网、车联网、智能化社区等领域。
霜蝉云运行示意图
霜蝉云平台有什么特点
（1）数据透传。发送的什么数据，接收什么数据，就像网络数据的路由器；
（2）支持不同的协议。用户原有设备不需要更改协议（例如modbus协议），即可接入霜蝉云，轻松实现远程操控；
（3）提供设备分组功能。设备分组即将不同设备划分到同一个小组中，从而实现按组透传数据，组内设备都可以收到数据；
（4）完善的用户、设备管理功能。用户分为企业用户和子级用户，企业用户可以管理子用户，可以为子用户分配设备。用户分级实现了权限管理，用户可以建立自己的账号体系，管理自己的用户和设备。
（5）提供完善的接口供开发者使用。霜蝉云具有完整的后台管理与设备管理功能，用户可以根据自己的需求开发应用或私有的业务服务器；
（6）管理设备的连接登录、鉴权、状态上报、命令发送、消息转发、2G/3G/4G网络模块续费及流量统计等基础功能。
框架说明
平台目前支持搭载WIFI模块、网络模块、2G/3G/4G模块、蓝牙模块等设备接入，其他连接方式的设备稍后开放公测。
霜蝉云应用模式
霜蝉云提供几种不同的应用模式，用户可以根据不同的应用场景，选择合适的应用模式。
设备与设备的互联互通模式
单个设备与单个设备：
单个设备与多个设备：
多个设备与多个设备：
设备与应用的互联互通模式
单个应用与单个或多个设备：
多个应用与单个或多个设备：
多个应用与同一设备通信采用主人绑定设备分享给其他用户应用的方式。
设备厂商服务器接入模式
SCICALA云管理设备的连接登录、鉴权、状态上报、命令发送、消息转发基础功能，设备厂商服务器负责解析设备的业务逻辑及数据存储。
设备互联互通
设备与设备互联同时支持SCICALA提供的软件虚拟模块接入。
设备与设备透传使用流程
说明：
1.注册账号是企业用户，企业子用户无法注册（霜蝉云平台不直接提供企业子用户注册功能，用户可以通过用户管理，实现企业子用户注册功能），由企业用户添加企业子用户。
2.添加设备时可以选择分配用户，将设备分配给该子用户。添加设备时需填写设备ID以及设备授权码，设备才能连接到霜蝉云服务器。
3.设备分组是实现互联互通模式关键功能，企业用户和子用户都可以创建自己的设备分组，设备分组只能分配自己所拥有的设备。
用户注册
首次使用没有账号，那么先注册一个账号，然后进入邮箱激活帐号。
审核
激活帐号后，请联系销售或者FAE,审核您的帐号，账号审核通过才可以登录。
用户管理
进入用户管理界面，点击添加用户，填写信息。填写信息时有几个需要注意的地方：
（1）子用户邮箱可不填，企业用户可以禁用所创建的子用户。
（2）用户等级：企业用户拥有所有的权限，可以管理子用户，并为子用户分配设备。企业用户还可以将设备分组。子用户可以将企业用户分配给自己的设备进行分组。
添加设备
点击设备管理，点击添加，单个添加设备，并填写信息。
1.填写设备ID。
2.输入设备授权码。
3.输入设备授权码名称，用户自定义名称。
4.选择所属用户，所选的企业子用户可以控制该设备。如果不选择则不分配给任何用户。
添加分组
设备分组主要解决设备之间一对多，多对多通信的问题，实现设备互联互通。
举例解释一下设备分组作用：如下图创建分组1将自动生成分组1_tran,分组1和分组1-tran是两个对应的对传组。
给分组分配好设备后，分组1中的某个设备发送的信息，分组1-tran中所有的设备都可以收到，同理 分组1-tran中某个设备发送的信息，分组1中的设备也都可以收到。
配置设备
配置设备：使设备能成功连接到SCICALA霜蝉云，并传输数据。具体配置方法请参考模块说明书。
数据透传
查看设备是否在线：配置完设备后，进入"设备管理"，就能看到设备是否在线。
设备在线即可进行数据透传。
设备与设备交互方式
单个设备与单个设备：
一对一交互方式，适用于单个设备与单个设备之间进行数据传输的情况。这种应用场景适用于设备之间点对点传输数据的情况。
实现这种逻辑关系用户只需要在后台管理系统中，新建一个分组，只添加一个设备，并且在对应的分组中也只添加一个设备。
单个设备与一组设备：
一对多交互方式，适用于一个设备和多个设备交互数据的情况。如上图，设备#1会收到分组#N中每个设备发送的数据，同样设备#1发送的数据分组#N的每个设备也都会收到。
(用户要想指定分组#N中的某一台设备进行控制或者监控,那么设备本身的协议要能够支持设备的识别。)
实现这种逻辑关系用户只需要在后台管理系统中，新建一个分组，只添加一个设备，并且在对应的分组中添加多个设备。
一组设备与一组设备:
多对多交互方式，适用于多个设备需要与多个设备交互数据的情况。如上图，分组#2N的每个设备会收到分组#1N中每个设备发送的数据，反之同样。
(用户要想使两个分组中的设备一对一交互，那么设备本身的协议要能够支持设备的识别。)
实现这种逻辑关系用户只需要在后台管理系统中，新建一个分组，添加多个设备，在对应的分组中添加多个设备。
第三方接口使用说明
SCloudAPI 接口 ( 简称“SCA”接口 ) 是SCICALA 霜蝉云面向设备厂商、以及个人开发者等用户，解决设备与上位机（Android、IOS、PC）之间相互通信，提供数据服务的载体。
基础消息接口
1. 用户订阅Subscribe (uname,upassword)
输入参数：
/**
* 创建一个用于连接云的连接，申请控制密钥
* @param uname 用户ID
* @param upassword 密码
*/
{
"uname" : "Guest",
"upassword":"123456"
}
输出示例：
{
"action" : "resSubscribe ",
"state":"1", //状态
"identity":"71d029e8-0c67-407a-af9f-63065d005808", // 身份id
"key":"0cc175b9c0f1b6a831c399e269772661" //密钥
"desc" : "success" // 结果
}
2. 取消订阅 UnSubscribe(identity,key)
输入参数：
/**
* 用于断开霜蝉云的连接
* @param identity 身份ID
* @param key 操作密钥
*/
{
"identity" : "71d029e8-0c67-407a-af9f-63065d005808",
"key":"0cc175b9c0f1b6a831c399e269772661"
}
输出示例：
{
"action" : "resUnSubscribe ",
"dstate":"1", //状态
"desc":"success" //结果
}
3. 绑定设备 DBind(deviceid,authcode,dname,compwd,key)
输入参数：
/**
* 用于绑定设备
* @param deviceid 设备ID
* @param authcode 授权码
* @param dname 设备名称
* @param compwd 设备通信密码
* @param key 操作密钥
*/
{
"deviceid" : "WES1234567891234",
"authcode":"A1B1C1D1",
"dname":"WIFI设备",
"compwd":"12345678",
"key":"0cc175b9c0f1b6a831c399e269772661"
}
输出示例：
{
"action" : "resDBind ",
"state":"1", //状态 绑定成功
"desc" : "success" // 结果
}
4. 解绑设备UnDBind(deviceid,key)
输入参数：
/**
* 用于解除设备绑定
* @param deviceid 设备ID
* @param key 操作密钥
*/
{
"deviceid" : "WES123456789ABCD",
"key":"0cc175b9c0f1b6a831c399e269772661"
}
输出示例：
{
"action" : "resUnDBind ",
"state":"1", //状态
"desc" : "success" // 结果
}
5. 获取设备列表 GetDevList (identity,key)
输入参数：
/**
* 用于获取设备列表
* @param identity 身份ID
* @param key 操作密钥
*/
{
"identity" : "71d029e8-0c67-407a-af9f-63065d005808",
"key":"0cc175b9c0f1b6a831c399e269772661"
}
输出示例：
{
"action" : "resGetDevList",
"state":"1",
"params" :
{
"deviceid" : "WE8SAB1647004561", // 设备ID
"name" : "SC8201", // 设备名称
"state" : "1" // 设备状态
},
"desc" : "success" // 结果
}
6. 更新设备信息 UpdateDevInfo (deviceid,dname,compwd,key)
输入参数：
/**
* 用于给设备发送数据
* @param deviceid 设备ID
* @param dname 设备名称
* @param compwd 通信密码
* @param key 操作密钥
*/
{
"deviceid" : "WES123456789ABCD",
"dname" : "WiFi-1",
"compwd" : "12345678",
"key":"0cc175b9c0f1b6a831c399e269772661",
"message":"scicala cloud"
}
输出示例：
{
"action" : "resUpdateDevInfo",
"state":"1", //状态
"desc" : "success" //结果
}
7. 发送数据 AppSend(deviceid,identity,key, message)
输入参数：
/**
* 用于给设备发送数据
* @param deviceid 设备ID
* @param identity 身份ID
* @param key 操作密钥
* @param message 发送消息
*/
{
"deviceid" : "WES123456789ABCD",
"identity" : "71d029e8-0c67-407a-af9f-63065d005808",
"key":"0cc175b9c0f1b6a831c399e269772661",
"message":"scicala cloud"
}
输出示例：
{
"action" : "resAppSend ",
"state":"1", //状态
"desc" : "success" //结果
}
8. 接收数据 ReceiveMessage
接收设备发来的数据
**
输出示例：
{
"did" : "WE8SAB1647004561", //设备id
"action" : "resDevSend", //响应
"date": "31 32 33 34 35 36 37 38 39", //消息
"state": "1 ", //状态
"desc" : "success" //结果
}
9. 用户注册UseRegist (email, password, key)
输入参数：
/**
* 用于快速注册用户
* @param email 邮箱
* @param password 密码
* @param key 操作密钥
*/
{
"email" : "Xiaoxi@qq.com",
"password":"123456",
"key":"0cc175b9c0f1b6a831c399e269772661"
}
输出示例：
{
"action" : "resUseRegist ",
"state":"1", //状态
"desc" : "success" //结果
}
10. 查询设备状态 DevStatusQuery (deviceid,key)
输入参数：
/**
* 用于获取设备状态
* @param deviceid 设备ID
* @param key 操作密钥
*/
{
"deviceid" : "WE8SAB1647004561",
"key":"0cc175b9c0f1b6a831c399e269772661"
}
输出示例：
{
"action" : "resDevStatusQuery",
"deviceid" : "WE8SAB1647004561", // 设备ID
"dstatus" : 1, // 设备状态 1在线 0离线
"state" : "1", // 执行状态
"desc" : "success" // 结果
}
11. 查询设备信息 GetQueryInfo (deviceid, qtype, key)
输入参数：
/**
* 用于查询设备信息(如串口参数、GPS等）
* @param deviceid 设备ID
* @param qtype 查询类型
* @param key 操作密钥
*/
{
"deviceid" : "WES123456789ABCD",
"qtype" : 1,
"key":"0cc175b9c0f1b6a831c399e269772661"
}
输出示例：
{
"action" : "resQuery",
"state":"1", //状态
"desc" : "success" //结果
}
Q：我不会编程开发怎么来让我的产品实现云端连接和远程控制？
A：模块集成了连接路由器，连接云服务器和连接手机APP的功能，所以不需要客户再做任何开发，只需要将模块接入设备串口上就可以实现连接云服务器，通过设备与设备的交互方式即可实现远程控制。
Q：我怎么看到我的设备是否成功连接到云服务？
A：通过云服务器后台管理系统。客户登陆后可以通过设备管理功能查看自己设备处于在线状态。
Q：手机APP可以连接云服务进行设备控制吗？
A：可以的，我们支持手机应用直连云服务。
Q：使用SCICALA霜蝉云需要哪些条件？
A：只需购买一个模块，可通过SCICALA霜蝉云实现远程数据透传。使用方法可以查看开发中心中的应用与设备交互方式。
SCICALA霜蝉云
SCICALA霜蝉云，是应用于物联网（IOT）的云服务平台，由上海霜蝉信息科技有限公司所开发和运维。面向开发者（企业）提供智能简单的硬件联网方案和云平台服务，提供一整套的联网方案供开发者(企业)所使用，平台搭配我们自主开发的目前最易使用且成本超低的智能硬件联网模块，实现从硬件接入网络到云服务的一体化解决方案，帮助传统企业快速实现互联网+转型。
SCICALA霜蝉云主要是为了解决设备与设备、设备与上位机应用（Android、IOS、PC）之间互联互通而开放的平台。霜蝉云主要用来透传数据，接入设备几乎不需做修改便可接入实现远程透传数据。霜蝉云适用于远程监控与控制、物联网、智能家居、工业联网、智能微电网、车联网、智能化社区等领域。
接入后服务：提供设备联网状态查询、OTA固件升级、设备分类管理、企业账号可以建立自己的账号体系、定位服务、模块对传服务、2G/3G/4G模块续费服务等，使用我们开放的数据接口开发者(企业)还可以开发自己的APP(应用)或业务服务器(企业私有云)实现更多个性化的服务功能。
开发者服务：提供智能硬件联网模块、自助开发工具和技术支持，帮助物联网开发者利用SCICALA云平台更快地实践产品想法。同时与高校及风电企业合作建立实验室，持续不断的技术推广，尽我们团队的最大努力来促进物联网产业的发展。
互联网+时代，改变世界改变人类的生活方式，万物联网（Internet of Things）让生活变的如此智能。
SCICALA云团队
support@scicala.com