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()