TgCloudUtil.h 文件参考

浏览该文件的源代码.

枚举
enum	TEMPTYPE
	温度单位 更多...
enum	EPROPACTION
	对保存在云端的设备属性的操作 更多...

函数
int	MKEVTDATA_Temperatur (TEMPTYPE type, float temper, char *obuf, int size)
	生成 ECEVENT_TEMPERATURE_H/ECEVENT_TEMPERATURE_L 事件的额外参数
struct tgJSON *	MKEVTDAT_Temperatur (TEMPTYPE type, float temper)
	返回json对象表示的温度事件参数.
int	MKEVTDATA_Humidity (int humid, char *obuf, int size)
	生成 ECEVENT_HUMIDITY_H/ECEVENT_HUMIDITY_L 事件的额外参数
struct tgJSON *	MKEVTDAT_Humidity (int humid)
	返回json对象表示的湿度参数
struct tgJSON *	MKEVTDAT_SitPoseSens (int sens)
	ECEVENT_SITPOSE 事件参数
int	MKEVTDATA_Feeding (int nServings, char *obuf, int size)
	生成喂食事件的数据
int	TcuSendFeedingEvent (int isManually, int nServing, void *pic, int pic_len)
	上报喂食事件
void	TcuReportSignal (time_t t, int sig_lvl)
	报告信号强度
int	TcuCalcMd5 (const char *path_or_data, long len, unsigned char digest[16])
int	TcuCalcSha256 (const char *path_or_data, long len, unsigned char digest[32])
TG_PUBLIC int	TcuUpdateProperties (EPROPACTION act, struct tgJSON *jprops, int verNo)
	编辑保存在云端的属性值.
TG_PUBLIC int	TcuUpdatePropertiesS (EPROPACTION act, const char *sprops, int verNo)
	编辑保存在云端的属性值.
TG_PUBLIC int	TcuGetProperties (struct tgJSON *jprops, int *verNo, struct tgJSON **ppJData)
	获取保存在云端的属性.
TG_PUBLIC int	TcuGetPropertiesS (const char *sprops, int *verNo, char **ppJData)
	获取保存在云端的属性.
void	qrInit ()
	注册qrcode功能.
TG_PUBLIC int	TcuUploadCustomDataS (const char *scene, time_t, const char *str)
	按分类上传用户自定义数据.

枚举类型说明

TEMPTYPE

enum TEMPTYPE

温度单位

枚举值
TEMP_C	Celcius
TEMP_F	Farenheit

在文件 TgCloudUtil.h 第 15 行定义.

EPROPACTION

enum EPROPACTION

对保存在云端的设备属性的操作

枚举值
PROPACT_UPDATE	1	更新属性
PROPACT_DELETE	2	删除属性

在文件 TgCloudUtil.h 第 74 行定义.

函数说明

MKEVTDATA_Temperatur()

int MKEVTDATA_Temperatur	(	TEMPTYPE	type,
		float	temper,
		char *	obuf,
		int	size )

生成 ECEVENT_TEMPERATURE_H/ECEVENT_TEMPERATURE_L 事件的额外参数

参数

type	温度单位
temper	温度
obuf	输出的json格式字符串缓冲区
size	输入时, size 为缓冲区大小

返回

json字符串长度+1。如果大于等于size, 意味obuf缓冲区不足，要重新分配大小至少为返回值的空间并再次调用

参见

MKEVTDAT_Temperatur

MKEVTDAT_Temperatur()

struct tgJSON * MKEVTDAT_Temperatur	(	TEMPTYPE	type,
		float	temper )

返回json对象表示的温度事件参数.

参见

MKEVTDATA_Temperatur

MKEVTDATA_Humidity()

int MKEVTDATA_Humidity	(	int	humid,
		char *	obuf,
		int	size )

生成 ECEVENT_HUMIDITY_H/ECEVENT_HUMIDITY_L 事件的额外参数

参数

humid	湿度: 0~100
obuf	输出的json格式字符串缓冲区
size	输入时, size 为缓冲区大小

返回

json字符串长度+1。如果大于等于size, 意味obuf缓冲区不足，要重新分配大小至少为返回值的空间并再次调用

参见

MKEVTDAT_Humidity

MKEVTDAT_Humidity()

struct tgJSON * MKEVTDAT_Humidity

(

int

humid

)

返回json对象表示的湿度参数

参数

humid

湿度: 0~100

MKEVTDAT_SitPoseSens()

struct tgJSON * MKEVTDAT_SitPoseSens

(

int

sens

)

ECEVENT_SITPOSE 事件参数

参数

sens	坐姿检测灵敏度参数。0(最灵敏)|1|2(最准确)

TcuSendFeedingEvent()

int TcuSendFeedingEvent	(	int	isManually,
		int	nServing,
		void *	pic,
		int	pic_len )

上报喂食事件

参数

isManually	手动还是自动喂食
nServing	喂食份数
pic	图片
pic_len	图片长度

返回

<0: 错误码

TcuUpdateProperties()

TG_PUBLIC int TcuUpdateProperties	(	EPROPACTION	act,
		struct tgJSON *	jprops,
		int	verNo )

编辑保存在云端的属性值.

参数

act	动作
jprops	要更新或删除的属性，不为能NULL. 删除时属性值被忽略. jprops由本接口释放
verNo	版本号

返回

0:ok; !=0:错误码

参见

https://tange-ai.feishu.cn/docx/YTqwdQl1MoVytBxQjBmctBitn5f

TcuUpdatePropertiesS()

TG_PUBLIC int TcuUpdatePropertiesS	(	EPROPACTION	act,
		const char *	sprops,
		int	verNo )

编辑保存在云端的属性值.

参数

sprops	属性的json格式字符串, 不能为NULL. 删除时属性值被忽略.
verNo	版本号

返回

0:ok; !=0:错误码

注解

应用想使用自己的json工具时使用本接口.

参见

https://tange-ai.feishu.cn/docx/YTqwdQl1MoVytBxQjBmctBitn5f

TcuGetProperties()

TG_PUBLIC int TcuGetProperties	(	struct tgJSON *	jprops,
		int *	verNo,
		struct tgJSON **	ppJData )

获取保存在云端的属性.

参数

jprops	要获取的属性. NULL为全部属性. jprops由本接口释放
verNo	版本号. 输入时为要获取的版本号,-1 为最新版本; 输出时为返回的版本号
ppJData	返回属性值. 要调用 tgJSON_Delete() 释放

返回

0:ok; !=0:错误码

参见

https://tange-ai.feishu.cn/docx/YTqwdQl1MoVytBxQjBmctBitn5f

TcuGetPropertiesS()

TG_PUBLIC int TcuGetPropertiesS	(	const char *	sprops,
		int *	verNo,
		char **	ppJData )

获取保存在云端的属性.

参数

sprops	要获取的属性的json字符串表示. NULL为全部属性.
verNo	版本号. 输入时为要获取的版本号,-1 为最新版本; 输出时为返回的版本号
ppJData	返回的json格式表示的属性值.

返回

0:ok; !=0:错误码

注解

应用想使用自己的json工具时使用本接口.

qrInit()

void qrInit

(

)

注册qrcode功能.

注解

从rev354开始, qrcode功能作为外部模块存在, 不再默认可用. 开发者需要在使用前注册。
此改为是为了减小不需要此功能的应用的代码体积，同时统一库的发布内容.

TcuUploadCustomDataS()

TG_PUBLIC int TcuUploadCustomDataS	(	const char *	scene,
		time_t	,
		const char *	str )

按分类上传用户自定义数据.

参数

scene	分类. App端用分类进行检索. 水质数据使用 "water_quality"
str	用户数据, 自定义的字符串, 平台不解析.

返回

0:ok; <0:错误码