sal模组联网接口

tos_sal_module_register

  1. int tos_sal_module_register(sal_module_t *module);
  • 功能描述

注册一个联网模组

  • 参数解释

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

  • 返回值

0，返回成功。

-1，返回失败。

tos_sal_module_init

  1. int tos_sal_module_init(void);
  • 功能描述

初始化模组

  • 参数解释

无

  • 返回值

0，返回成功。

-1，返回失败。

tos_sal_module_parse_domain

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. int tos_sal_module_close(int sock);
  • 功能描述

关闭与远端的连接

  • 参数解释

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

  • 返回值

0，返回成功。

-1，返回失败。