你好！酷痞 Coolpy

欢迎你进入酷痞的物联网世界。这里有着自由的空气和自然的气息。接下来我将告诉你如果一步步建立一个自己专属的物联网平台。

由于目前的酷痞的官方域名还没有通过备案所以现在用临时域名解说本说明。

最终酷痞的官网地址：http://icoolpy.com

第一种方式：服务器运行酷痞及数据库方式：

1.进入酷痞官网后在首页最显眼位置就有相关下载连接点击下载后解决到硬盘根目录下。“路径中不可以使用中文”。如：d:\coolpydb d:\CoolpyWin

2.先启动CoolpyWinDB下的“32位或64位.bat”文件，如无意外即可启动数据库。请注意几个小白容易卡住的地方。

a.如果你使用的是阿里云最低配的win2008系统请把系统的虚拟内容设备4G或以上的虚拟内存后才运行。

b.如果你使用的是校园网请自觉到一个不是校园网的网络进行测试。因为校园网是一个比中国特色更加有特色的网络，很多不知名的问题连神都没办法解释。

c.注意防火墙要放行1337端口，如果你修改过端口号同样需要放行。

d.如果你是vista,win7,win2008或以上的系统请“不要”使用管理员系统运行。

e.windows server 2012要注意，要对两个CMD文件 右键-属性-解除锁定

3.启动酷痞服务器端“32位或64位运行.bat”文件，“路径中不可以使用中文”。

至此酷痞已经运行工作。

第二种方式：服务器运行酷痞而使用第三方数据库提供商服务

a.此方式无需下载酷痞数据库。因为你使用的是 http://mongolab.com之类的mongodb数据库服务提供商，你需要准备的是申请到自己的数据库并记录数据库的连接字符串。

b.设置连接字符串到酷痞：在酷痞服务端的一级目录里找到config.js文件，然后把'mongodb://localhost/coolpy' 改为你的第三方数据库连接字符串。

c.启动酷痞服务器端“32位或64位运行.bat”文件，同样需要注意以管理员身份运行启动。

至此酷痞已经运行工作。

关于酷痞系统常规参数的说明：

1.关于IP及端口

酷痞默认运行的IP地址是本机地址，即如果你运行于服务器即当前服务IP，默认端口是1337，当你需要修改IP地址或端口号请修改位于酷痞目录下的bin/coolpy.js文件，把app.listen(1337, '0.0.0.0');改为你想要的ip和端口即可。注意防火墙要放行对应端口号。

关于酷痞客户端的说明：

1.酷痞客户端是使用htm5技术开发的，所以没有app的概念，因为它只一个web页面。无论任何手机、平板或PC要访问Coolpy客户端可以直接在浏览器里输入http://酷痞服务ip:端口号。默认的本机测试地址是：http://127.0.0.1:1337 如果系统正常，无论你通过手机、平板还是PC访问都会直接显示一个友好的操作界面。

2.酷痞默认的管理员账号是：admin 密码也是：admin ，如果你已经用于实际营运环境请登陆后马上修改此账号的密码。此账号是系统最高权限的。

3.关于sdk的说明

登陆系统后你可以从右上角菜单中找到Coolpy arduino SDK的下载连接，此SDK是一系列示例如何通过arduino对酷痞的API接口调用的代码。

其中包含：

a.泛型数据结点操作示例：custom_data_point示例

b.提取最新数据结点值示例：get_last_data_point示例

c.GPS型数据结点操作示例：gps_data_point示例

d.开关操作示例：switch_data_point示例

e.数值型数据结点操作示例：value_data_point示例

以上每个数据结点例示都包含有增、删、改、查的操作示例，对应的示例名中包含有post为增，delete为删，put为改，get为查。

4.关于SDK的测试方式

a.首先你需要在Coolpy客户端操作里添加设备并添加传感器，传感器目前已经支持有数值型、泛型、GPS型、开关型。在传感器页里会得到传感器的API服务地址。如：http://xxxx.net:1337/v1.0/device/1/sensor/1/datapoints 其中device后的1代码设备id，sensor后的1代码传感器id，在SDK的源代码里把对device和sensor变量值。

b.关于SDK中的ukey值是一个客户访问密钥，没有它客户端是没办法操作API的，ukey可以在客户端里的 账号->我的账号设置->API KEY项即是你的ukey密钥。

c.SDK中的server地址即酷痞所在的服务器地址，可以是IP地址或网址。这里需要注意的是端口号不能直接放在地址之后。端口的设置在源代码里找到client.connect(server, 80)，把80改为你的端口号即可。SDK默认是访问80端口的。

----------------------------------------------------------------------------------

如果你有任何疑问请联系：

QQ：229292620

Email：jacle169@21cn.com