3. AT指令入门：语法、基础指令与错误码解析

AT指令，说白了就是咱们和蜂窝模组对话的“普通话”。模组再聪明，也得听懂人话才能干活。我刚开始做物联网项目时，觉得AT指令就是发几个字符串，没啥技术含量。结果第一次调4G模组，连个网络都注册不上，折腾了两天才发现是AT指令格式写错了……嗯，从那以后我再也不敢小看这几行字符了。

3.1 AT指令的语法规则

AT指令的格式其实很简单，但细节决定成败。咱们先看标准格式：

AT<command>=<参数1>,<参数2>,...<CR>

每个指令都以 AT 开头，以回车符 \r（即 <CR>）结束。模组收到后，会返回响应，格式通常是：

<CR><LF><响应内容><CR><LF>
OK 或 ERROR

我个人习惯把AT指令分成三类，这样好记：

3.2 基础AT指令详解

下面这三个指令，是调试蜂窝模组时最常用的。我建议你先把它们刻在脑子里。

3.2.1 AT+CSQ —— 信号质量查询

这个指令用来获取当前环境的信号强度。返回值格式：

+CSQ: <rssi>,<ber>

其中 rssi 是信号强度指示，范围 0~31，值越大信号越好；ber 是误码率。我一般这样判断：

3.2.2 AT+CGATT —— 网络附着状态

这个指令用来查询或控制模组是否附着到GPRS/ LTE网络。说白了，就是问模组：“你连上基站了吗？”

// 查询当前附着状态
AT+CGATT?
+CGATT: 1
OK

// 手动触发附着
AT+CGATT=1
OK

返回值 1 表示已附着，0 表示未附着。我见过不少新手，发完 AT+CGATT=1 后立刻就去发网络数据，结果失败。为什么？因为附着需要时间，一般 3~10 秒。你得轮询 AT+CGATT? 直到返回 1，再继续下一步。

3.2.3 AT+CGDCONT —— PDP上下文定义

这个指令用来配置APN（接入点名称）。没有它，模组就不知道走哪条路去互联网。格式如下：

AT+CGDCONT=<cid>,<PDP_type>,<APN>,<IP_addr>,<d_comp>,<h_comp>

实际项目中，我们一般只填前三个参数：

// 中国移动公网APN
AT+CGDCONT=1,"IP","cmnet"

// 中国联通公网APN
AT+CGDCONT=1,"IP","3gnet"

// 中国电信公网APN
AT+CGDCONT=1,"IP","ctnet"

这里 cid 是上下文ID，一般用 1；PDP_type 几乎都是 "IP"（IPv4）；APN 由运营商提供。如果你用的是私有APN（比如企业专网），运营商会给一个特定的APN字符串，别搞混了。

3.3 常见错误码解析

模组返回 ERROR 时，别慌。它其实在告诉你哪里出了问题。我整理了一份高频错误码对照表：

为什么会返回 +CME ERROR 而不是 +CMS ERROR？其实 +CME ERROR 是GSM/UMTS/LTE相关的通用错误，+CMS ERROR 专指短信服务错误。我一般先看错误前缀，就能缩小排查范围。

3.4 本章知识体系

下面这张图，把AT指令的调用流程和常见错误排查路径串起来了。你照着这个逻辑走，基本不会卡壳。

这张图的核心逻辑很简单：发指令 → 判断返回 → OK就继续，ERROR就查表。我建议你在调试时，把这张图打印出来贴在工位上。遇到问题，按图索骥，比瞎试快得多。