跳转至

link - 数据链路激活(创建、连接、状态维护)

适用范围

层面 说明
运行环境 LuatOS-Air 脚本框架,展锐 8910 平台(Air724UG / Air722UG / Air795UG / Air720UH 等)
前提条件 需 SIM 卡与数据链路(PPP);外挂 CH395 / W5500 / ESP8266 时走对应的 socket 库
不适用 Air780E 及以后跑 LuatOS 的 Cat.1 模组;这些模组的同名库在 osapi 里是另一套接口,不能照抄

link.setAuthApn(prot, apn, user, pwd)

设置专网卡APN(注意:在main.lua中,尽可能靠前的位置调用此接口)

第一次设置成功之后,软件会自动重启,因为重启后才能生效

参数

名称 传入值类型 释义
prot number 可选参数,默认为0 加密方式,0:不加密,1:PAP,2:CHAP
apn string 可选参数,默认为"" apn名称
user string 可选参数,默认为"" apn用户名
pwd string 可选参数,默认为"" apn密码

返回值

nil

例子

c = link.setAuthApn(2,"MYAPN","MYNAME","MYPASSWORD")

link.openNetwork(mode, para)

打开链路层网络类型

注意:设置网络类型后,并不会关机保存,下次开机会自动恢复为默认的link.CELLULAR类型

参数

名称 传入值类型 释义
mode number 可选参数,默认为link.CELLULAR 取值如下:
link.CELLULAR:蜂窝模组数据网络
link.CH395:CH395以太网络
link.ESP8266:ESP8266WIFI网络
para table 可选参数,默认为nil 取值如下:
当mode为link.CELLULAR时,参数para无意义,可以直接传入nil
当mode为link.CH395,para为table类型,表示以太网的配置参数,参数结构如下:
para= {
mode = 1, --1表示客户端;2表示服务器;默认为1
intPin = pio.P0_22, --以太网芯片中断通知引脚
rstPin = pio.P0_23, --复位以太网芯片引脚
spiCs = pio.P0_23, --spi片选
serverAddr = "192.168.1.112", --做服务器应用时,本机的地址
serverPort = 1888, --做服务器应用时,本机的端口
serverGateway = "192.168.1.1", --做服务器应用时,本机的网关地址
powerFunc=function(state) end --控制以太网模块的供电开关函数,ret为true开启供电,false关闭供电
spi = {spi.SPI_1,0,0,8,800000}, --SPI通道参数,id,cpha,cpol,dataBits,clock,默认spi.SPI_1,0,0,8,800000
}

返回值

true/false,执行成功返回true,失败返回false。

例子

-- 设置为蜂窝数据网络:
c = link.setNetwork(link.CELLULAR, para)
-- 设置为CH395以太网络:
link.setNetwork(link.CH395, para)
-- 设置为ESP8266WIFI网络:
link.setNetwork(link.ESP8266, para)

link.closeNetWork()

关闭链路层网络类型

注意:关闭链路层网络类型,不会改变链路层网络类型,需要打开链路层网络类型配置才能切换。

参数

无

返回值

true/false,执行成功返回true,失败返回false。

例子

-- 关闭链路层网络类型:
link.closeNetWork()

link.getNetwork()

获取链路层网络类型

参数

无

返回值

network,number类型,取值如下:
link.CELLULAR:蜂窝模组数据网络
link.CH395:CH395以太网络
link.ESP8266:ESP8266WIFI网络

例子

-- 获取数据网络类型:
mode = link.getNetwork()

搜索