@[TOC]

socket

模块功能：数据链路激活、SOCKET管理(创建、连接、数据收发、状态维护)

socket.isReady()

SOCKET 是否有可用

参数

无

返回值

可用true,不可用false

例子

无

socket.tcp(ssl, cert, tCoreExtPara)

创建基于TCP的socket对象

参数

|名称|传入值类型|释义| |-|-|-| |ssl|bool|可选参数，默认为nil 是否为ssl连接，true表示是，其余表示否| |cert|table|可选参数，默认为nil ssl连接需要的证书配置，只有ssl参数为true时，此参数才有意义，cert格式如下：
{
caCert = "ca.crt", --CA证书文件(Base64编码 X.509格式)，如果存在此参数，则表示客户端会对服务器的证书进行校验；不存在则不校验
clientCert = "client.crt", --客户端证书文件(Base64编码 X.509格式)，服务器对客户端的证书进行校验时会用到此参数
clientKey = "client.key", --客户端私钥文件(Base64编码 X.509格式)
clientPassword = "123456", --客户端证书文件密码[可选]
}| |tCoreExtPara|table|可选参数，默认为nil 建立链接扩展参数，4G链接和ch395链接所需扩展参数不一样|

返回值

client，创建成功返回socket客户端对象；创建失败返回nil

例子

c = socket.tcp()
c = socket.tcp(true)
c = socket.tcp(true, {caCert="ca.crt"})
c = socket.tcp(true, {caCert="ca.crt", clientCert="client.crt", clientKey="client.key"})
c = socket.tcp(true, {caCert="ca.crt", clientCert="client.crt", clientKey="client.key", clientPassword="123456"})

socket.udp()

创建基于UDP的socket对象

参数

无

返回值

client，创建成功返回socket客户端对象；创建失败返回nil

例子
```
c = socket.udp()
```

socket.setTcpResendPara(retryCnt, retryMaxTimeout)

设置TCP层自动重传的参数

参数

|名称|传入值类型|释义| |-|-|-| |retryCnt|number|可选参数，默认为4 重传次数；取值范围0到12| |retryMaxTimeout|number|可选参数，默认为16 限制每次重传允许的最大超时时间(单位秒)，取值范围1到16|

返回值

nil

例子

setTcpResendPara(3,8)
setTcpResendPara(4,16)

socket.setDnsParsePara(retryCnt, retryTimeoutMulti)

设置域名解析参数

注意：0027以及之后的core版本才支持此功能

参数

|名称|传入值类型|释义| |-|-|-| |retryCnt|number|可选参数，默认为4 重传次数；取值范围1到8| |retryTimeoutMulti|number|可选参数，默认为4 重传超时时间倍数，取值范围1到5
第n次重传超时时间的计算方式为：第n次的重传超时基数*retryTimeoutMulti，单位为秒
重传超时基数表为{1, 1, 2, 4, 4, 4, 4, 4}
第1次重传超时时间为：1*retryTimeoutMulti 秒
第2次重传超时时间为：1*retryTimeoutMulti 秒
第3次重传超时时间为：2*retryTimeoutMulti 秒
...........................................
第8次重传超时时间为：8*retryTimeoutMulti 秒|

返回值

nil

例子
```
socket.setDnsParsePara(8,5)
```

socket.printStatus()

打印所有socket的状态

参数

无

返回值

无

例子
```
socket.printStatus()
```

socket.setLowPower(tm)

设置数据传输后，允许进入休眠状态的延时时长

3024版本以及之后的版本才支持此功能
此功能设置的参数，设置成功后，掉电会自动保存

参数

|名称|传入值类型|释义| |-|-|-| |tm|number|数据传输后，允许进入休眠状态的延时时长，单位为秒，取值范围1到20
注意：此时间越短，允许进入休眠状态越快，功耗越低；但是在某些网络环境中，此时间越短，可能会造成数据传输不稳定
建议在可以接受的功耗范围内，此值设置的越大越好
如果没有设置此参数，此延时时长是和基站的配置有关，一般来说是10秒左右|

返回值

nil

例子
```
socket.setLowPower(5)
```

socket.md 4.0 KB Permalink Verlauf Originalformat