今天我们就用全球通Air795UG开发板，来给大家讲解一下国际卡APN配置。

1、APN基础知识

APN（Access Point Name）—— 是一种网络接入技术，终端模组在接入到网络时必须配置该参数，该参数决定了模组以何种方式接入网络；用户在上网时，针对不同的APN，核心网网元GGSN/P-GW将会把用户转接代理到不同的网络。

1.1  什么情况下需要配置APN

• 如果是专网卡，首先咨询SIM卡供应商APN参数，然后在main.lua尽可能靠前的位置调用接口进行设置。

• 如果是公网卡，不需要用户主动设置APN，软件自动去网络端查询APN进行设置。

1.2  如何区分专网卡和公网卡

根据使用的网络类型来分，SIM卡可以分为公网卡和专网卡两种。可按照如下顺序判断确认：

• 咨询SIM卡供应商；

• 如果APN有账号、或者有密码、或者有加密类型，则可以认为是专网卡。

如果使用专网卡，需要先将访问的域名或IP加入专网卡白名单。以下是相关应用中，模组会访问的域名或IP服务器：

1.3 国内与国外APN配置差异

在国内，三大运营商的公网卡大多支持即插即用，模组可以自动获取APN设置。而在海外，大多数运营商都需要手动配置APN，这也是许多国内设备出海时遇到联网问题的主要原因。

需要特别注意的是：
绝对不要在国内测试好后直接发到国外使用，必须进行本地化测试。

2、Air795UG国际卡APN配置示例

使用Air795UG开发板，演示LuatOS切换SIM卡及设置国际卡APN的流程。

2.1 相关硬件准备

• Air795UG开发板：

• 支持数据传输的USB数据线；

• 具备国际漫游功能的SIM卡；

• Win10及其以上PC电脑。

2.2 API接口说明

LuatOS提供了便捷的API接口，可以帮助我们快速配置APN。

• mobile.apnTableInit()

  初始化自定义APN列表，主要用于海外SIM卡，无返回值。

• mobile.apnTableAdd(mcc, mnc, ip_type, protocol, apn_name, user_name, password)

  往自定义APN列表添加一条APN信息，主要用于海外SIM卡，相关参数说明如下表所示。

2.3 示例代码说明

国际卡APN配置示例代码如下图示。

2.4 示例功能验证：

Air795UG开发板通过LuaTools烧录内核固件和demo脚本代码，烧录成功后开机运行，即可查看国际卡APN配置结果。

如下图示：