加拿大外贸
电大电子(深圳)有限公司http://www.diandachn.com目录
微信读取温湿度传感器数值开发实例... 1
1. 概述... 2
2. 准备工作... 2
3. 开发流程... 2
4. 详细步骤... 4
4.1. 注册开发者账号... 4
4.2. 使用个人微信号开通测试公众号... 4
4.3. 在FogCloud上创建、定义自己的产品... 5
4.4. 在FogCloud上创建产品对应的微信APP. 7
4.5. Github上创建微信APP代码托管仓库... 8
4.6. 配置微信APP以及微信测试公众号... 8
4.7. 使用MiCO SDK开发固件... 12
4.8. 用IAR或MDK工具开发MiCOKit固件代码(代码注释)... 18
4.9. 使用Github工具托管APP代码... 21
4.10. FogCloud上生成设备二维码... 24
4.11. 使用手机微信扫码,测试“Airkiss”配网功能以及设备控制功能... 28
5. 版本更新... 30
) V1 ]# Z1 P3 s# {, f5 C
1. 概述
本文档仅介绍如何使用MiCOKit开发套件(MiCOKit-3288或MiCOKit-3165)开发一个简单的,通过微信读取温湿度传感器数值的应用实例过程。
2. 准备工作
注意:开始前请确定射频驱动为最新版本
版本查询及升级方法请参考MiCO社区 → wiki中心 →MiCOKit板块射频驱动升级
1. MiCOKit-3288开发套件;
2. 开发工具请使用IAR7.3版本及以上;
3. FogCloud开发者账号(Fog云使用、开发必须);
4. SDK_MiCOKit_V2.2.0.3(下载请至:http://mico.io/wiki/doku.php?id=micokit_sdk);
5. 个人微信号(开通测试公众号);
6. github个人账号(托管微信APP代码);
7. 网页编辑工具(sublime等);
8. 大致了解MQTT协议及json格式。
3. 开发流程
1. 注册FogCloud开发者账号;
2. 使用个人微信号开通测试公众号;
3. 在FogCloud上创建、定义自己的产品;
4. 在FogCloud上创建产品对应的微信APP;
5. Github上创建微信APP代码托管仓库;
6. 配置微信APP和微信测试公众号;
7. 使用MiCOKit SDK开发固件;
8.用IAR或MDK工具开发MiCOKit固件代码(代码注释);
9. 使用Github工具托管APP代码;
10. 在FogCloud上生成设备微信二维码;
11. 手机微信扫码,测试Airkiss配网功能、设备控制功能。
" M, S* @1 K5 E" r+ ~ x
4. 详细步骤4.1. 注册开发者账号
登录www.fogcloud.io直接注册账号即可。该账号将用来管理你的产品及APP。
4.2. 使用个人微信号开通测试公众号
浏览器打开http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login,点击登录,使用手机微信扫码,进入后即开通了测试公众号。
8 Y, w5 |" N! l+ ^* e1 H/ r
获得微信号、appID、appsecrect,用于后续在FogCloud上创建产品对应的微信APP。
4.3. 在FogCloud上创建、定义自己的产品
根据提示填写相关信息,创建完成后,如下
9 e! N' M% H u/ j& Q* q, n ?
点击产品名称,进入详细信息:
产品ID/KEY会写到设备固件代码中;
创建产品的数据模型,数据模型是用来在云端定义产品功能、性能等特征数据的标准格式,可以储存设备监控、收集、控制、用户行为等数据,从而对数据进行分析,提升产品服务,开发案例过程中定义数据模型,能够有效帮助开发者将APP、云端与设备端的关键功能、特征数据等同步,避免开发过程出错。
本实例读取温度与湿度数据,所需创建的数据点为:
1)温度(temp) 读写属性为0 时间序列为否
2)湿度(humi) 读写属性为0 时间序列为否
*属性名和描述可按个人习惯添加
注意:在创建数据点时,“时间序列”选项:选中时云端保存历史数据;不选时云端只保存最新的数据。数据模型的具体作用在后面的进阶教程中详细讲解。
4.4. 在FogCloud上创建产品对应的微信APP
根据提示,填写相关信息,其中:微信号、AppID/AppSecret从步骤2中开通的微信测试公众号中获得。
1 c& g# t: ]3 Z3 ?5 u1 K/ h. U" q
4.5. Github上创建微信APP代码托管仓库
请登录github.com自行创建新仓库。并克隆到本地,克隆方法详见《上传文件到GitHub》。该步骤的目的是获得一个可以在任何地方访问的git仓库,后面会使用该仓库托管微信APP的代码(其他类似git仓库托管工具也可以)。
获得仓库地址,例如:https://github.com/wangeshen/MiCOKit_test.git
4.6. 配置微信APP以及微信测试公众号
(a) FogCloud上的微信APP信息:
其中URL和Token会在后续配置微信测试号时用到。
* H( ( O7 s. e* p$ q
(b)Git部署(同步微信APP代码到FogCloud)
其中:
Repo即步骤5中创建的github仓库地址,填写后保存;
Deploy key和Web HookUrl可添加到github仓库的设置中,以自动同步代码到FogCloud;也可以不添加,但是github仓库中代码更新后,需要手动点击“发布”按钮来同步代码,同步后右边可看到最新的代码提交记录。
7 ] m# r7 V J" }0 l0 r+ ^
(c) 微信菜单管理
通过FogCloud提供的微信公众号首页菜单定制功能,方便的定制手机端微信上的控制界面及功能;至少包含“Airkiss”按钮,打开微信Airkiss配网功能,“OAuth”按钮(名称可自定义)进入设备控制。
(d) 设置微信测试公众号 URL与Token在创建的APP信息中可以找到
修改配置信息:
URL一般为:http://4addb71f-1b5c-XXXX-94c5-f ... ylink.io/wechat.php
下划线部分作为JS接口安全域名和授权回调页面域名。域名中不包含http:// 和 /wechat.php!!!
开通微信测试号的所有测试功能,如下图1,2,3:
点击4修改,填写网页授权域名,打开如下:
同“JS接口安全域名”,格式为前面提供的URL的域名部分,如xxxx.app.easylink.io,其中“xxxx”为FogCloud上创建的微信APP的id。
4.7. 使用MiCO SDK开发固件
(a) 登陆MiCO开发者网站mico.io,去MiCO社区注册账号,并登陆;
(b) 重新打开mico.io首页,开发者中心 ==> Wiki中心—MiCOKit发布中心,下载MiCOKit SDK。
(c) 打开MiCOKit SDK中的微信开发实例工程:
1),开发者手中拿到的可能是硬件平台可能是MiCOKit3288或者MiCOKit3165,在编译工程时要先选择硬件平台;
2)将FogCloud上创建的产品ID/KEY写入固件(必须替换):
3)修改版本号,这样才能把新的产品ID/KEY烧入FLASH
4)添加读取温湿度代码:
5)改为从开发板上读取温湿度数据后,打包成JSON格式,并上传到FogCloud。
5 Q, ?- j2 w7 X/ ~, O+ [
6)错误代码参考:在运行过程中如果出现错误,可在user_log中查看错误代码。
8 H0 l7 * Q1 ^8 r) Z. h
7)MiCOKit SDK固件烧录。(详细固件烧录方法及步骤请参考http://mico.io wiki中心)
选择使用的烧录工具J-Link或者ST-LINK:
8)编译/连接:
9)烧录/下载:
4.8. 用IAR或MDK工具开发MiCOKit固件代码(代码注释)
//应用程序入口在application_start(void),一系列动作(如配网、连接云等)以后,用户程序入口在这里。
OSStatus user_main( mico_Context_t * constmico_context )
{
user_log_trace();
OSStatus err =kUnknownErr;
json_object*send_json_object = NULL;
const char*upload_data = NULL;
uint8_t ret =0;
uint8_tdht11_temperature = 0;
uint8_tdht11_humidity = 0;
// 将温度与湿度数值同步显示在OLED上
charoled_show_line[OLED_DISPLAY_MAX_CHAR_PER_ROW+1] = {''};
require(mico_context,exit);
// 初始化温湿度传感器DHT11
ret =DHT11_Init();
if(0 !=ret){
// 检查初始化时是否有错误
err =kNoResourcesErr;
user_log("DHT11 init failed!");
goto exit;
}
else{
err =kNoErr;
}
while(1){
mico_thread_sleep(2); // 每隔2秒进行一次数据采集和上报云端
// 检查与Fogcloud的连接状态
if(!mico_context->appStatus.fogcloudStatus.isCloudConnected){
continue;
}
// 与Fogcloud连接后,开始数据采集
ret =DHT11_Read_Data(&dht11_temperature, &dht11_humidity);
if(0 !=ret){
err =kReadErr;
}
else{
err =kNoErr;
// 在OLED显示温度与湿度数值,每行最多显示16个字母
OLED_ShowString(OLED_DISPLAY_COLUMN_START, OLED_DISPLAY_ROW_2," "); // 第二行不显示
memset(oled_show_line, '', OLED_DISPLAY_MAX_CHAR_PER_ROW+1);
snprintf(oled_show_line, OLED_DISPLAY_MAX_CHAR_PER_ROW+1, "T:-C ", dht11_temperature);
OLED_ShowString(OLED_DISPLAY_COLUMN_START, OLED_DISPLAY_ROW_3,(uint8_t*)oled_show_line);
memset(oled_show_line, '', OLED_DISPLAY_MAX_CHAR_PER_ROW+1);
snprintf(oled_show_line, OLED_DISPLAY_MAX_CHAR_PER_ROW+1, "H: -%% ", dht11_humidity);
OLED_ShowString(OLED_DISPLAY_COLUMN_START, OLED_DISPLAY_ROW_4,(uint8_t*)oled_show_line);
// 创建一个json对象
send_json_object = json_object_new_object();
if(NULL ==send_json_object){
user_log("create json object error!");
err =kNoMemoryErr;
}
else{
// 创建完成后,将温度与湿度数值打包为json格式
json_object_object_add(send_json_object, "dht11_temperature",json_object_new_int(dht11_temperature));
json_object_object_add(send_json_object,"dht11_humidity", json_object_new_int(dht11_humidity));
upload_data = json_object_to_json_string(send_json_object);
if(NULL== upload_data){
user_log("create upload data string error!");
err = kNoMemoryErr;
}
else{
// 将json包发至Fogcloud, 第二个参数(NULL)代表发送默认值: '/out'
MicoFogCloudMsgSend(mico_context, NULL, (unsigned char*)upload_data,strlen(upload_data));
user_log("upload data success!rntopic=%s/outtdht11_temperature=%d,dht11_humidity=%d",
mico_context->flashContentInRam.appConfig.fogcloudConfig.deviceId,
dht11_temperature, dht11_humidity);
err =kNoErr;
}
// 释放json对象,这步不能省略,否则会造成内存溢出
json_object_put(send_json_object);
send_json_object = NULL;
}
}
}
exit:
user_log("ERROR: user_main exit with err=%d", err);
return err;
}
4.9. 使用Github工具托管APP代码
在例程包中(MiCOKitSDK的APP目录下),找到微信APP控制页面代码(index.html和yourID.html),将yourID.html.重命名为你的产品ID,如cabca380.html。拷贝这两个文件到本地git仓库,再同步到git服务器。同步方法详见《上传文件到GitHub》。
index.html —— OAuth按钮跳转到该页面(一般为设备列表页面,可不做改动)
xxxx.html —— 设备控制页面(其中xxxx为FogCloud上创建的产品id)
详细代码见附件代码包,部分代码解释如下:
修改、并提交代码后,如果没有配置WebHook让FogCloud自动更新代码,则需要到FogCloud上手动点击“发布”按钮更新代码,并通过git提交记录确认是否更新成功。
4.10. FogCloud上生成设备二维码
(a) 创建新设备
(b)填写设备MAC地址(由小写字母和数字构成,设备上电后会向串口发送MAC地址及其他数据,可用串口工具查看)接口创建设备。
5 q% ]9 N4 T( F$ s: X0 h8 e6 h q
学习更多资源请关注电大官网:http://www.diandachn.com
加拿大电商我的客户需要从非洲免关税国家进口一些商品,所谓的免关税是不是也不用交增值税。 如果要交增值税,增值税的税率是多少? 菜鸟向各位前辈请教了。 评论 关税与增值税是俩个税种 加拿大电商Hallo, bitte schicken Sie uns mehr info uber die QT8-15- Machine MfG Alfredo 评论 晕死 是德语 你去德语区问问吧 评论 要你关于QT8-15- 这个型号机器的信息 评论 跟你要关于QT8-15- 这个型号机器的资料信息
·中文新闻 工党政府赋予工会“巨大的权力”
·中文新闻 莉莉·詹姆斯 (Lily James) 凌晨 4 点被发现与身价 65 亿英镑的 Air