告別繁瑣的網絡配置！只需5分鐘，輕松完成國際卡APN設置，瞬間突破地域限制，隨時隨地接入國際網絡，工作旅行兩不誤。

APN是設備連接到運營商網絡的“身份證”——當設備插入SIM卡并注冊到運營商網絡時，網絡側會檢查設備發送的APN信息，從而確定為設備提供哪種類型的網絡連接和服務質量等級。

一、APN基礎知識

APN（Access Point Name）—— 是一種網絡接入技術，終端模組在接入到網絡時必須配置該參數，該參數決定了模組以何種方式接入網絡；用戶在上網時，針對不同的APN，核心網網元GGSN/P-GW將會把用戶轉接代理到不同的網絡。

在LuatOS開發中，如需通過模組設置APN，所設置的APN要與SIM卡開卡時配置的APN一致。

1.1 什么情況下需要配置APN

如果是專網卡，首先咨詢SIM卡供應商APN參數，然后在main.lua盡可能靠前的位置調用接口進行設置。

如果是公網卡，不需要用戶主動設置APN，軟件自動去網絡端查詢APN進行設置。

1.2 如何區分專網卡和公網卡

根據使用的網絡類型來分，SIM卡可以分為公網卡和專網卡兩種?？砂凑杖缦马樞蚺袛啻_認：

咨詢SIM卡供應商；

如果APN有賬號、或者有密碼、或者有加密類型，則可以認為是專網卡。

如果使用專網卡，需要先將訪問的域名或IP加入專網卡白名單。以下是相關應用中，模組會訪問的域名或IP服務器：

1.3 國內與國外APN配置差異

在國內，三大運營商的公網卡大多支持即插即用，模組可以自動獲取APN設置。而在海外，大多數運營商都需要手動配置APN，這也是許多國內設備出海時遇到聯網問題的主要原因。

需要特別注意的是：絕對不要在國內測試好后直接發到國外使用，必須進行本地化測試。

二、Air795UG國際卡APN配置示例

Air795UG是全球通模組，支持全球主流運營商主流頻段，支持4G/2G雙模，支持雙卡單待，支持LuatOS開發。

全球通Air795UG最新資料下載：https://docs.openluat.com/air795ug/product/shouce/

2.1 相關硬件準備

Air795UG開發板：

支持數據傳輸的USB數據線；

具備國際漫游功能的SIM卡；

Win10及其以上PC電腦。

2.2 API接口說明

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

最新API說明詳見：

https://docs.openluat.com/osapi/core/mobile/

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配置結果。

如下圖示：

今天的內容就分享到這里了~

審核編輯 黃宇