sal模组联网接口

tos_sal_module_register

int tos_sal_module_register(sal_module_t *module);

• 功能描述

注册一个联网模组

• 参数解释

IN/OUT参数名描述[in]module联网模组句柄

• 返回值

0，返回成功。

-1，返回失败。

tos_sal_module_init

int tos_sal_module_init(void);

• 功能描述

初始化模组

• 参数解释

无

• 返回值

0，返回成功。

-1，返回失败。

tos_sal_module_parse_domain

int tos_sal_module_parse_domain(const char *host_name, char *host_ip);

• 功能描述

域名解析，将一个域名转换为IP地址。

• 参数解释

IN/OUT参数名描述[in]host_name待解析的域名[out]host_ip解析后的IP地址

• 返回值

0，返回成功。

-1，返回失败。

tos_sal_module_connect

int tos_sal_module_connect(const char *ip, const char *port, sal_proto_t proto);

• 功能描述

向远端发起连接

• 参数解释

IN/OUT参数名描述[in]ipIP地址[in]port端口[in]protoTCP/UDP协议

• 返回值

成功，则返回连接的socket id。

失败，返回-1。

tos_sal_module_send

int tos_sal_module_send(int sock, const void *buf, size_t len);

• 功能描述

向远端发送数据（TCP协议栈）

• 参数解释

IN/OUT参数名描述[in]socksocket id(由tos_sal_module_connect获取)[in]buf发送的数据起始地址[in]len发送的数据长度

• 返回值发送的数据长度。

tos_sal_module_recv

int tos_sal_module_recv(int sock, void *buf, size_t len);

• 功能描述

从远端读取数据（TCP协议栈）

• 参数解释

IN/OUT参数名描述[in]socksocket id（由tos_sal_module_connect获取）[out]buf接收数据buffer[in]len接收数据buffer长度

• 返回值实际接收到的数据长度。

tos_sal_module_recv_timeout

int tos_sal_module_recv_timeout(int sock, void *buf, size_t len, uint32_t timeout);

• 功能描述

从远端接收数据（TCP协议栈）

• 参数解释

IN/OUT参数名描述[in]socksocket id（由tos_sal_module_connect获取）[in]buf数据起始地址[in]len数据长度[in]timeout超时参数

• 返回值实际接收到的数据长度。

tos_sal_module_sendto

int tos_sal_module_sendto(int sock, char *ip, char *port, void *buf, size_t len);

• 功能描述

向远端发送数据（UDP协议栈）

• 参数解释

IN/OUT参数名描述[in]socksocket id（由tos_sal_module_connect获取）[in]ipIP地址[in]port端口[in]buf待发送数据起始地址[in]len待发送数据长度

• 返回值发送的数据长度。

tos_sal_module_recvfrom

int tos_sal_module_recvfrom(int sock, char *ip, char *port, void *buf, size_t len);

• 功能描述

从远端接收数据（UDP协议栈）

• 参数解释

IN/OUT参数名描述[in]socksocket id（由tos_sal_module_connect获取）[in]ipIP地址[in]port端口[in]buf接收数据buffer起始地址[in]len接收数据buffer长度

• 返回值实际接收到的数据长度。

tos_sal_module_close

int tos_sal_module_close(int sock);

• 功能描述

关闭与远端的连接

• 参数解释

IN/OUT参数名描述[in]socksocket id（由tos_sal_module_connect获取）

• 返回值

0，返回成功。

-1，返回失败。