5、qq物联开发步骤

1.QQ物联开发步骤

1）测试环境无需申请上线，即可任意调试。
意思是什么呢，它是告诉大家，在调试的时候不要点击上面的提交上线，
因为目还在调试此设备，一旦上线，QQ物联官方就会来审核你的设备，
导致延长研发周期，在有十足的把握时，在去提交上线。如果产品已经提交上线，
通过QQ物联官方审核，后续产品的配置页面的修改都需要腾讯审核。

2）测试环境最多有100个设备可以调试，上线之后接入设备的个数就不受限制。

第二小节 配置设备后台

功能配置---》特殊功能
用来定义手机QQ与QQ物联设备两者之间的特殊消息的数据格式

显示类型：只能是QQ物联设备向手机QQ发送用于显示的的数据
控制类型：QQ物联设备与手机QQ可以互传控制消息的数据

控制类型的功能描述{"on":"1","off":"0"}

第三节

每个设备类型在申请的时候就已经固定设备的公私钥对了，每个设备唯一不同的就是SN已经根据SN用设备私钥前面的license，设备公钥在申请的时候已经上传了

第4课第5节 使用datapoint接口来收发手机QQ的数据

1)led驱动和应用程序的测试

make
arm-linux-gcc -o jz2440_led_app jz2440_led_app.c

ifconfig eth0 192.168.1.185

mount -t nfs -o nolock 192.168.1.184:/work/nfs_root/qq_iot /mnt

insmod jz2440_led_drv.ko
./jz2440_led_app

2)lcd界面的绘制
framebuffer\fb.c
FBDeviceInit()---framebuffer的初始化
gui\gui_base.c
GUI_Clear清屏
GUI_SetPixel描点
GUI_DrawHLine画横线
GUI_DrawVLine画竖线
GUI_DrawLine画任意线
GUI_FillRectangle填充矩形
GUI_SetFont设置字体
GUI_PutChar显示字符
GUI_PutString显示字符串
GUI_DrawCircle画圆
GUI_DispNum显示数字

Makefile的二个问题
（1）编译后输出的目标文件是什么？
（2）当前目录要编译那么文件、要编译哪些子目录？

注意：
（1）当前目录要编译的文件、要编译的子目录都由
当前目录下Makefile来决定。

通用makefile的使用
i) 修改顶层Makefile中TARGET
TARGET := 目标文件名

ii)修改各级Makefile中obj-y，添加你所需要编译的文件或者目录
obj-y += xxx.o
obj-y += yyy/

3)使用datapoint接口来收发手机QQ的数据

参考:
http://iot.open.qq.com/wiki/index.html#!FUNC/DataPoint_Common_CMD.md
http://iot.open.qq.com/wiki/index.html#!FUNC/DataPoint_Custom_CMD.md
http://iot.open.qq.com/wiki/index.html#!FUNC/DataPoint_Sync_Status.md

结构体
tx_data_point

// 初始化datapoint
SDK_API int tx_init_data_point(const tx_data_point_notify *notify);

// 上报datapoint数据
// [in] id: 上报的datapoint ID
// [in] value: 上报的datapoint value
// [out] cookie: 返回调用cookie
// [in] ret_callback: 发送结果callback
SDK_API int tx_report_data_point(unsigned int id, char * value, unsigned int * cookie, on_report_data_point_ret ret_callback);

// 应答收到的datapoint
// [in] from_client: datapoint信令来自某个绑定者， 必须和已收到的datapoint时的from_client一致，否则会被过滤
// [in] id: 应答的datapoint对应的ID， 必须和已收到的datapoint的ID一致，否则会被过滤
// [in] value: 应答的datapoint的自定义数据
// [in] seq: 应答的datapoint对应的seq， 必须和已收到的datapoint的seq一致，否则会被过滤
// [out] cookie: 返回调用cookie
// [in] ret_callback: 发送结果callback
SDK_API int tx_ack_data_point(unsigned long long from_client, unsigned int id, char * value, unsigned int seq, unsigned int ret_code, unsigned int * cookie, on_ack_data_point_ret ret_callback);

第4课第7节 使用datapoint接口来收发手机QQ的数据

1）视频演示
ubuntu下：
make clean
make
cp net_bind_detector /work/nfs_root/qq_iot/
sudo cp -rfd res/ /work/nfs_root/qq_iot/

开发板linux下：
ifconfig eth0 192.168.1.185

挂载网络文件系统、复制文件
mount -t nfs -o nolock 192.168.1.184:/work/nfs_root/qq_iot /mnt
cd /mnt
cp -rfd res/ /qq_iot/
cp net_bind_detector /qq_iot/

加载led驱动
cd /lib/modules/3.4.2/
insmod jz2440_led_drv.ko

查看链接库文件
cd /qq_iot/
ls （net_bind_detector依赖于库文件）
ls /lib/libtxdevicesdk*

查看密钥
cd /etc/qq_iot/demo_bind
ls
cat config

网络设置
cd /qq_iot/
route add default gw 192.168.1.1
cat /etc/resolv.conf
ping news.qq.com

cd /qq_iot/
./net_bind_detector
先后输入
sendtextmsg 测试文本的发送
sendpic 测试图片文件的发送
sendaudio 测试音频文件的发送
sendvideo 测试视频文件的发送
注意一下，上面这几个(sendpic、sendaudio、sendvideo)都是
通过tx_send_structuring_msg来发送的。

第4课第8节 使用datapoint接口来收发手机QQ的数据

实际看一下第一个项目net_bind_detector的代码
1)看一下目录

led ---------led的应用程序(很简单)
framebuffer ---------framebuffer底层实现，来自前面的自制gui(已讲解)
gui ---------自制gui(已讲解)
lib ---------腾讯QQ物联SDK的库文件存放位置
include ---------头文件
qq_dev_sdk ---------腾讯QQ物联SDK的头文件存放位置
initDevice ---------设备初始化(已讲解)
DataPoint ---------tx_init_data_point、
tx_ack_data_point、
tx_report_data_point接口的实现
fileTransfer ---------tx_init_file_transfer接口的实现
msg ---------tx_send_text_msg、
tx_send_structuring_msg接口的实现
res ---------存放图片文件、音频文件、视频文件

2）公有功能和特殊功能
公有功能：（腾讯QQ物联团队规定的）
该类产品具有的公有功能。
可以由开发者选择打开或者关闭。

特殊功能：某个厂家自己的产品有一些额外的功能，
可以用“特殊功能”来实现。

特殊功能由datapoint接口来实现：
datapoint的使用方法：
参考：
http://iot.open.qq.com/wiki/index.html#!FUNC/DataPoint_Common_CMD.md
http://iot.open.qq.com/wiki/index.html#!FUNC/DataPoint_Custom_CMD.md
http://iot.open.qq.com/wiki/index.html#!FUNC/DataPoint_Sync_Status.md

TXDataPoint.h中：

结构体
tx_data_point

// 初始化datapoint
SDK_API int tx_init_data_point(const tx_data_point_notify *notify);

// 上报datapoint数据
// [in] id: 上报的datapoint ID
// [in] value: 上报的datapoint value
// [out] cookie: 返回调用cookie
// [in] ret_callback: 发送结果callback
SDK_API int tx_report_data_point(unsigned int id, char * value, unsigned int * cookie, on_report_data_point_ret ret_callback);

// 应答收到的datapoint
// [in] from_client: datapoint信令来自某个绑定者， 必须和已收到的datapoint时的from_client一致，否则会被过滤
// [in] id: 应答的datapoint对应的ID， 必须和已收到的datapoint的ID一致，否则会被过滤
// [in] value: 应答的datapoint的自定义数据
// [in] seq: 应答的datapoint对应的seq， 必须和已收到的datapoint的seq一致，否则会被过滤
// [out] cookie: 返回调用cookie
// [in] ret_callback: 发送结果callback
SDK_API int tx_ack_data_point(unsigned long long from_client, unsigned int id, char * value, unsigned int seq, unsigned int ret_code, unsigned int * cookie, on_ack_data_point_ret ret_callback);

a.LED1_ID ,根据datapoint.value来打开/关闭，tx_ack_data_point

b.LED2_ID ,根据datapoint.value来打开/关闭，tx_report_data_point

c.BRIGHTNESS_ID,根据datapoint.value得到亮度值，tx_report_data_point

d.TEMPER_SWITCH_ID,根据datapoint.value来启动/关闭定时器
其中，启动定时器后，不断的上报数值，tx_report_data_point

为什么需要tx_ack_data_point和tx_report_data_point呢？
答：更新手机QQ的状态

tx_ack_data_point 参数多，复杂一些
tx_report_data_point 参数少，简单

第4课第9节 使用tx_send_text_msg接口向手机QQ发送文本
使用tx_send_structuring_msg接口向手机QQ发送图片文件、音频文件、视频文件

实际看一下第一个项目net_bind_detector的代码
1)看一下目录

led ---------led的应用程序(很简单)
framebuffer ---------framebuffer底层实现，来自前面的自制gui(已讲解)
gui ---------自制gui(已讲解)
lib ---------腾讯QQ物联SDK的库文件存放位置
include ---------头文件
qq_dev_sdk ---------腾讯QQ物联SDK的头文件存放位置
initDevice ---------设备初始化(已讲解)
DataPoint ---------tx_init_data_point、
tx_ack_data_point、
tx_report_data_point接口的实现
fileTransfer ---------tx_init_file_transfer接口的实现
msg ---------tx_send_text_msg、
tx_send_structuring_msg接口的实现
res ---------存放图片文件、音频文件、视频文件

参考：
http://iot.open.qq.com/wiki/index.html#!CASE/Android_TV.md

注意：
msg\text_utf8.c 和
msg\alarm_utf8.c
的编码格式为utf-8.

原因：QQ物联sdk中中文字符的发送，必须使用utf-8格式。
参考：
http://iot.open.qq.com/wiki/index.html#!QA/QA_FileCoding.md

TXMsg.h
//callback: 用于确认消息是否送达了QQ物联后台服务器
typedef void (*on_send_text_msg_ret)(unsigned int cookie, int err_code);

/**
* 接口说明：向手机QQ发送文本消息
* 参数说明：
* msg_id 动态消息ID，请到配置平台进行注册，没有注册过的ID无法送达手机QQ
* text 要发送的文本
* ret_callback 发送结果回调
* cookie 由sdk内部分配唯一值，并会在发送结果回调时回传，用于唯一标识当前调用
* to_targetids 指定发给某些target
* to_targetids_count 指定发给某些target的count，填0表示发送给所有的绑定者
*/
SDK_API void tx_send_text_msg(int msg_id, char *text, on_send_text_msg_ret ret_callback, unsigned int *cookie, unsigned long long* to_targetids, unsigned int to_targetids_count);

/**
* 接口说明：向手机QQ发送结构化消息，每条消息都会有唯一的 cookie, tx_send_msg_notify 用于了解发送状态
* msg：结构化消息
* notify：进度，结果回调
* cookie：返回任务cookie
*/
SDK_API void tx_send_structuring_msg(const structuring_msg *msg, tx_send_msg_notify *notify, unsigned int *cookie);

TXFileTransfer.h

/**
* 初始化传文件
* notify : 回调
* path_recv_file : 接收文件的目录
*/
SDK_API int tx_init_file_transfer(tx_file_transfer_notify notify, char * path_recv_file);

tx_init_file_transfer的目的：
1）手机QQ向QQ设备发送的普通文件、音频文件