ntp模块的API接口实现, 提供获取utc时间的能力更多...

#include "ntp_private.h"
#include "core_string.h"
#include "core_log.h"
#include "core_global.h"
#include "core_mqtt.h"

aiot_ntp_api.c 的引用(Include)关系图:

函数
static void	_core_ntp_exec_inc (ntp_handle_t *ntp_handle)

static void	_core_ntp_exec_dec (ntp_handle_t *ntp_handle)

static void	_ntp_recv_handler (void handle, const aiot_mqtt_recv_t packet, void *userdata)

static int32_t	_ntp_operate_topic_map (ntp_handle_t *ntp_handle, aiot_mqtt_option_t option)

static void	_ntp_core_mqtt_process_handler (void context, aiot_mqtt_event_t event, core_mqtt_event_t *core_event)

static int32_t	_ntp_core_mqtt_operate_process_handler (ntp_handle_t *ntp_handle, core_mqtt_option_t option)

void *	aiot_ntp_init (void)
	创建ntp会话实例, 并以默认值配置会话参数更多...

int32_t	aiot_ntp_setopt (void handle, aiot_ntp_option_t option, void data)
	配置ntp会话更多...

int32_t	aiot_ntp_deinit (void **handle)
	结束ntp会话, 销毁实例并回收资源更多...

int32_t	aiot_ntp_send_request (void *handle)
	向ntp服务器发送ntp消息请求更多...

详细描述

ntp模块的API接口实现, 提供获取utc时间的能力

版权所有: Copyright (C) 2015-2020 Alibaba Group Holding Limited

函数说明

static void _core_ntp_exec_inc ( ntp_handle_t * ntp_handle )

static

static void _core_ntp_exec_dec ( ntp_handle_t * ntp_handle )

static

static void _ntp_recv_handler	(	void *	handle,
		const aiot_mqtt_recv_t *	packet,
		void *	userdata
	)

static

static int32_t _ntp_operate_topic_map	(	ntp_handle_t *	ntp_handle,
		aiot_mqtt_option_t	option
	)

static

函数调用图:

static void _ntp_core_mqtt_process_handler	(	void *	context,
		aiot_mqtt_event_t *	event,
		core_mqtt_event_t *	core_event
	)

static

static int32_t _ntp_core_mqtt_operate_process_handler	(	ntp_handle_t *	ntp_handle,
		core_mqtt_option_t	option
	)

static

函数调用图:

void* aiot_ntp_init ( void )

创建ntp会话实例, 并以默认值配置会话参数

返回: void *

返回值

非NULL	ntp实例的句柄
NULL	初始化失败, 一般是内存分配失败导致

函数调用图:

int32_t aiot_ntp_setopt	(	void *	handle,
		aiot_ntp_option_t	option,
		void *	data
	)

配置ntp会话

常见的配置项如下

AIOT_NTPOPT_MQTT_HANDLE: 已建立连接的MQTT会话句柄
AIOT_NTPOPT_TIME_ZONE: 时区设置, SDK会将收到的UTC时间按配置的时区进行转换
AIOT_NTPOPT_RECV_HANDLER: 时间数据接收回调函数, SDK将UTC时间转换完成后, 通过此回调函数输出

参数

[in]	handle	ntp会话句柄
[in]	option	配置选项, 更多信息请参考aiot_ntp_option_t
[in]	data	配置选项数据, 更多信息请参考aiot_ntp_option_t

返回: int32_t

返回值

<STATE_SUCCESS	参数配置失败
>=STATE_SUCCESS	参数配置成功

函数调用图:

int32_t aiot_ntp_deinit ( void ** handle )

结束ntp会话, 销毁实例并回收资源

参数

[in] handle 指向ntp会话句柄的指针

返回: int32_t

返回值

<STATE_SUCCESS	执行失败
>=STATE_SUCCESS	执行成功

函数调用图:

int32_t aiot_ntp_send_request ( void * handle )

向ntp服务器发送ntp消息请求

发送NTP请求, 然后SDK会调用通过 aiot_ntp_setopt 配置的 AIOT_NTPOPT_RECV_HANDLER 回调函数, 通知用户当前的时间

参数

handle ntp会话句柄

返回: int32_t

返回值

<STATE_SUCCESS	请求发送失败
>=STATE_SUCCESS	请求发送成功

函数调用图: