Net


概述

网络相关接口。网络操作均为异步操作,所有函数执行均无返回值,需要事件中处理相关网络事件。需要注意的是,UDP和TCP使用相似的调用流程,只是没有真正的连接。


常量

网络事件

当收到msg.NET_EVENT消息时,消息内容中的"event"为以下内容:

  • Net.ERROR
  • Net.READY
  • Net.CONN_OK
  • Net.CONN_FAIL
  • Net.CONN_CLOSE
  • Net.SEND_OK
  • Net.SEND_FAIL
  • Net.RECV
常量 说明 消息内容
Net.ERROR 发生错误
Net.READY 网络准备就绪
Net.CONN_OK 连接服务器成功 id:连接id
Net.CONN_FAIL 连接服务器失败 id:连接id
Net.CONN_CLOSE 连接服务器关闭 id:连接id
Net.SEND_OK 发送成功 id:连接id
Net.SEND_FAIL 发送失败 id:连接id
Net.RECV 收到数据 id:连接id
data:收到的数据,类型为bytes

函数

init

网络初始化。

  • Net.init([ap [,username [,password]]])
参数 必选 类型 说明
ap false String 运营商的AP名称,最多32字节,忽略则使用CMNET
username false String 用户名,最多32字节
passwrd false String 密码,最多32字节
return null 无返回值

connect

连接服务器。模块可以启动4个连接。

  • Net.connect(id, addr, port [, mode])
参数 必选 类型 说明
id true int 连接id,范围为0-3
addr true String 服务器IP或域名,最多64字节
port true int 服务器端口,范围为1-65535
mode false String 连接模式,只能用"tcp"和"udp"
return null 无返回值

close

关闭连接。

  • Net.close(id)
参数 必选 类型 说明
id true int 连接id,范围为0-3
return null 无返回值

send

发送数据,数据长度最大为1K。

  • Net.send(id, data_string | data_bytes)
参数 必选 类型 说明
id true int 连接id,范围为0-3
data_string true String 发送的数据,用于发送字符串
data_bytes true bytes 发送的数据,用于发送字节流
return null 无返回值

syncTime

同步网络时间到盒子,需在网络就绪以后调用。设置特定时间请看Box.getTime

  • Net.syncTime()
参数 必选 类型 说明
return boolean true表示成功,false表示失败

csq

获取网络信号强度,需在网络就绪以后调用

  • Net.csq()
参数 必选 类型 说明
return int 99表示无信号,0-31表示有信号,值越大信号越好,一般值在15以上通讯会比较正常。

updateFW

从网络上更新固件,固件必须放在http服务器上。进入更新模式后会停掉当前的网络功能,更新成功或失败都会重启盒子。

  • Net.updateFW(url, crc)
参数 必选 类型 说明
url true String 固件的url
crc true int 更新文件的校验码
return null 无返回值

updateJS

从网络上更新脚本,脚本必须放在http服务器上。进入更新模式后会停掉当前的网络功能,更新成功或失败都会重启盒子。

  • Net.updateJS(url, crc)
参数 必选 类型 说明
url true String 脚本的url
crc true int 更新文件的校验码
return null 无返回值