AT指令文档 4G

1 变更记录变更记录 版本 变更人 章节 内容 时间 LC6365S 1 00 02 mxw 3 7 添加复位时主动上报指令 dsrst 2014 12 11 LC6365S 1 00 02 mxw 4 8 非法 mac 可能会导致部分商用手机 无法连接到热点 2014 12 12 LC6365W 1 00 02 mxw 4 16 设置设备 ID 指令 2014 12 24 LC6365W 1 00 02 mxw 4 4 数据透传指令 2014 12 24 LC6365W 1 00 02 Mxw 3 7 终端异常上报 2015 1 1 LC6365W 1 00 02 Mxw 4 11 12 WIFI 可支持 SSID 和密码限制字符 2015 3 11 1 1 1 2 引言引言 该文档为 1761 MIFI 设备上使用 AT 指令完成网络通信功能的使用说明文档 并对其中一 些与 WIFI 控制功能相关的 AT 指令做了说明 3 SOCKET 使用步骤使用步骤 3 1 创建创建 socket at dstt at dstt 1 创建第一路 socket at dstt 2 创建第二路 socket 3 2 连接服务器连接服务器 at dipstart at dipstart 1 1 10 0 0 172 80 一路 socket 连接服务器 at dipstart 2 1 80 二路 socket 连接服务器 3 3 数据发送数据发送 at dipsend at dipsend 1 10 一路 socket 发送十六进制数据 发送长度 10 at dipsend 2 16 二路 socket 发送十六进制数据 发送长度 16 1 模块收到 at dipsend 指令后 会显示输出提示符 提示用户输入待发送数据 待 发送数据必须用十六进制 HEX 表示 待发送数据以 r n 为结尾 例如 待发送数据为 1234 实际输入内容是 31323334 r n 发送长度的为 8 31323334 紧跟 r n 为本次发送数据内容结 束标记 2 若模块输出提示符 后面的输入内容不是待发送数据内容 是其他 AT 指令或待 发送数据内容长度与 dipsend 中设置的长度不一致 终端会提示 send error 终止本次内容发 送 10S 内无指定长度数据输入将返回 send timeout 3 使用 at dipsend 发送数据时 必须确保输出提示符 后面输入的是待发送数据而 非其他内容 否则模块会以无效输入为由丢失 后的数据内容 4 发生 timeout 错误时 将以 SEND TIMEOUT way 格式提示给用户 5 最大发送长度为 1024 个原始字节 2048 HEX 3 4 数据接收数据接收 DIPD way len 十六进制十六进制 HEX 模块在收到服务器下发的数据时会上报给用户 上报格式为 DIPD way len HEX 内容 r n hex 内容以 r n 作为结束标记 其中 way 代表哪一路 socket len 代表 hex 内容字节 的长度 不包括 r n DIPD 2 100 3200021001011E0220050500663162306339363839626461656164616463373534386138383831 626337316688C240543D50 r n 如上表示 第二路 socket 接收到 50 字节长度数据 输出到通道上的内容为 100 字节十六进制数据 1 最大接收长度为 1024 个原始字节 2048 HEX 3 5 关闭关闭 socket at dipclose 出现通信异常时需要用户主动关闭当前 socket 关闭指令如下 at dipclose 1 关闭第一路 socket 连接 at dipclose 2 关闭第二路 socket 连接 3 6 查询查询 socket 状态状态 at dipstatus at DIPSTATUS 1 查询 1 路 socket 状态 at DIPSTATUS 2 查询 2 路 socket 状态 返回 error 说明输入参数错误或链路没激活 可能没有 sim 卡 sim 卡透支 sim 卡错 误 无网络信号等错误 正常返回格式 DIPSTATUS way status status 说明 返回 0 PDP 未激活 返回 1 网络正常 但 socket 不存在 返回 3 说明 sock 存在 只有 socket 存在才可以连接服务器 返回 5 已连接服务器 可正常收发数据 返回 6 socket 关闭状态 需要重新创建 socket 关闭状态下也可以直接连接服务器 连接时会自动创建新 socket 举例 DIPSTATUS 1 1 网络正常 但第一路 socket 还不存在 DIPSTATUS 2 5 第二路 socket 已连接到服务器 可收发数据 3 7 状态主动上报 状态主动上报 socket 断开 终端重启断开 终端重启 异常 异常 1 当有 socket 连接或断开服务器时 终端会主动上报该路 socket 状态 例如 第一路 socket 连接到服务器会主动上报 DIPCONNECTED 1 1 如果第一路 socket 断开会主动上报 DIPCONNECTED 1 0 2 模块重启时 主动上报 dsrst 指令 3 模块异常时 主动上报指令 DEXCEPTINFO 0 0 TD DOS unknown 3 8 其他其他说明说明 1 域名解析 at ddnsgip 需要激活 pdp 例如查询百度 2 AT DWLCTRL1 开启 关闭 wifi 芯片以及查询当前状态 3 AT ICSSSID 查询 修改 wifi 芯片 SSID 设置完毕后需要重启 at dsrst 4 AT ICSPWD 查询 修改 wifi 芯片加密类型与密码 设置完毕需重启 at dsrst 5 抓取 aep tcpip 模块的平台 trace log 需要勾选 gal aep 并勾选 os 下所有选项 4 AT 指令指令指令表指令表 4 1 AT DSTT Set command AT DSTT Start task part of initialization for TCPIP plug in will finished by this command Response OK Operation failed ERROR Parameter integer type create socket way 1 create socket way 2 Test command AT DSTT Response DSTT OK Parameter see set command Example at dstt 1 创建第一路 socket Reference 4 2 AT DIPSTART Set command AT DIPSTART The TCP linking will be created over the channel which has sent this command Response OK Operation failed ERROR Parameter socket way 1 First way 2 Second way integer type 1 TCP linking IP or domain name of other end port ID of other end Test command AT DIPSTART Response DIPSTART 1 2 1 2 ip addr or domain name port OK Parameter see set command Example at dipstart 1 1 10 0 0 172 80 使用 ip 地址连接服务器 at dipstart 2 1 80 使用域名地址连接服务器 Reference 4 3 AT DIPSEND Set command AT DIPSEND Send data switch the status of channel before changing IP you must close TCP linking or UDP port firstly then re link TCP or re open UDP port If data channel received valid stop string the channel will be switched to command status and report string NO CARRIER Response OK channel will be switch to data status NO CARRIER soket or PDP disconnected Operation failed ERROR Parameter socket way maybe 1 or 2 length of data to be sent Test command AT DIPSEND Response DTIPSEND OK Parameter see set command Example at dipsend 1 10 socket 1 发送 10 个字节数据 at dipsend 2 24 socket 2 发送 24 个字节数据 Reference 发送数据内容为十六进制数据 长度必须为偶数字节 否则发送错 误 4 4 AT DIPTRAN Set command AT DIPTRAN Transmit data between APK and OBD Response OK ERROR 1 socket error 2 No APK connection Parameter the length of transmit data the transmit data Example AT DIPTRAN 10 0123456789 透传 10 个字节数据 Reference 1 透传数据指OBD设备与移动特制APK通过通信模块进行数据直 接传输 2 透传数据的最大长度为 2048 字节 透传数据的格式为 HEX 否 则透传数据会被截取 3 透传数据的真实内容小于设定的长度时 只透传真实内容长度 数据 4 同时只支持与 1 个 APK 通信 其他 APK 无法同时连接上 只有 断开当前连接 其他 APK 才可以进行连接 5 透传机制详见透传功能简述 数据透传功能简述 doc 4 5 AT DIPCLOSE Set command AT DIPCLOSE Close TCP linking or the register UDP port or stop detecting port of server Response OK Operation failed ERROR Parameter 1 close TCP connection 2 close TCP connection Test command AT DIPCLOSE Response DIPCLOSE 1 2 OK Parameter see set command Example at dipclose 1 关闭 tcp socket 1 Reference 4 6 AT DIPSTATUS Set command AT DIPSTATUS query Socket status Response DIPSTATUS OK ERROR Operation failed no network no sim sim error intger type 1 socket not exist 3 socket create ok 5 connect server ok 6 socket closed Parameter the way of socket maybe 1 or 2 Response DIPSTATUS OK Parameter see set command Example AT DIPSTATUS 1 查询第一路 socket 状态 AT DIPSTATUS 2 查询第二路 socket 状态 Reference 无 4 7 AT DDNSGIP Set command AT DDNSGIP Parsing domain name get IP Response DDNSGIP OK Operation failed ERROR Parameter domain name string IP address string ie Test command AT DDNSGIP Response DDNSGIP OK Parameter see set command Example AT DDNSGIP 查询百度的 ip 地址 Reference 4 8 AT DWLCTRL1 Set command AT DWLCTRL1 0 或 1 Open or close wifi IC Response OK Operation failed ERROR Parameter oper intger type 0 close wifi IC 1 open wifi IC Read command AT DWLCTRL1 Response DWLCTRL1 oper OK Operation failed ERROR Parameter oper intger type 0 the wlan is close 1 the wlan is open Test command AT DWLCTRL1 Response DWLCTRL1 0 1 OK Parameter see set command Example AT DWLCTRL1 1 开启 WIFI 芯片 Reference 用于查询 WLAN 状态 开启 关闭 WLAN 指令 4 9 AT DWLMAC Set command AT DWLMAC mac ad dr Set wifi mac address Response OK Operation failed ERROR Parameter mac addr such as B0 48 8A 11 22 65 Read command AT DWLMAC Response DWLMAC mac addr OK Operation failed ERROR Parameter mac addr such as B0 48 8A 11 22 65 Test command AT DWLMAC Response ERROR Parameter see set command Example AT DWLMAC B0 48 8A 11 22 65 Reference 用于查询 设置 WIFI 芯片的 MAC 地址 部分商用手机在连接热点 时会判断 MAC 地址是否有效 对于随机输入的非法 MAC 可能会导 致部分商用手机无法连接到热点 4 10 AT ICSSSID Set command AT ICSSSID Status query Response OK Operation failed ERROR Parameter ssid the base64 string 待修改的 SSID 为 BASE64 编码格式 Read command AT ICSSSID Response ICSSSID ssid OK Operation failed ERROR Parameter ssid 为 base64 编码 Test command AT ICSSSID Response OK Parameter Example At icsssid IFdpRmnmjozkuK3lrp0tMTIyMzc Reference 1 用于查询 修改 SSID 2 原始字符 转 base64 编码前 不可以包含的字符 0 close Read command AT DWLADV 查询当前 WIFI 的广播状态 1 标示开启广播 0 标示关闭广播 DWLADV 1 OK Operation failed ERROR Test command AT DWLADV Response DWLADV 0 1 OK Example At DWLADV 1 开启 SSID 广播 Reference 开启或关闭 SSID 功能需要重启模块才可生效 4 18 AT DWLTXPOWER Set command AT DWLTXPO WER mode val ue 修改 WIFI 发射功率 Response OK Operation failed ERROR Parameter mode 0 1 2 BNG 模式 0 B 模式 1 N 模式 2 G 模式 value 对应发射功率索引 不同模式需要设置的发射功率参数个数不相同 B 模式需要提供 6 个 value N 模式需要 5 个 value G 模式需要 2 个 value Read command AT DWLTXPO WER 读取 WIFI 的发射功率 DWLTXPOWER v1 v2 v3 v12 OK Operation failed ERROR Test command AT DWLTXPO WER Response DWLTXPOWER mode v1 v2 v3 OK Example At DWLTXPOWER 0 12 34 56 12 35 34 设置 B 模式下发生功率 At DWLTXPOWER 1 12 34 56 12 35 设置 N 模式下发生功率 At DWLTXPOWER 2 12 34 设置 G 模式下发生功率 Reference 1 WIFI 的发射功率设置依赖于不同 channel 和不同模式 设置发射功率时 需参考如下对照表 2 B 模式对应 10 11 12 13 14 15 位 N 模式对应 16 17 18 19 1A 位 G 模式依赖 N 模式 对应 1B 位 3 B 模式和 N 模式设置发射功率取值范围为 0 63 G 模式的取值范围 为 0 15 4 所设置值增加 1 对应增加 0 5DB 的发射功率 5 1B 位的高四位标示 20M 和 40 之间的发射功率差值 低四位标示与 模式之间的差值 高四位一般默认为 也就是 20M 与 40M 频率使用 相同的发射功率 6 修改发射功耗后 需要重启 WIFI 芯片后才可以生效 AT DWLCTRL1 0 不是重启 MIFI 设备 发射功率参照表 BytesBytes ContentsContents DescriptionDescription DefaultDefault SW RFSW RF ReservedReserved 10h10h 11b TX 11b TX Power Index Power Index Absolute Value Absolute Value Power Index for Ch 1 2 Range 0 63 Power Index for Ch 1 2 Range 0 63 2Dh2Dh 11h11h Power Index for Ch 3 4 5 Range 0 63 Power Index for Ch 3 4 5 Range 0 63 2Dh2Dh 12h12h Power Index for Ch 6 7 8 Range 0 63 Power Index for Ch 6 7 8 Range 0 63 2Dh2Dh 13h13h Power Index for Ch 9 10 11 Range 0 63 Power Index for Ch 9 10 11 Range 0 63 2Dh2Dh 14h14h Power Index forPower Index for Ch 12 13 Range 0 63 Ch 12 13 Range 0 63 2Dh2Dh 15h15h Power Index for Ch 14 Range 0 63 Power Index for Ch 14 Range 0 63 2Dh2Dh 16h16h 11n TX Power 11n TX Power IndexIndex Absolute Value Absolute Value Power Index for Ch 1 2 Range 0 63 Power Index for Ch 1 2 Range 0 63 2Dh2Dh 17h17h Power Index for Ch 3 4 5 Range 0 63 Power Index for Ch 3 4 5 Range 0 63 2Dh2Dh 18h18h Power Index for Ch 6 7 8 Range 0 63 Power Index for Ch 6 7 8 Range 0 63 2Dh2Dh 19h19h Power Index for Ch 9 10 11 Range 0 63 Power Index for Ch 9 10 11 Range 0 63 2Dh2Dh 1Ah1Ah Power Index for Ch 12 13 14 Range 0 63 Power Index for Ch 12 13 14 Range 0 63 2Dh2Dh 1Bh1Bh 功率差距功率差距 Power Index Difference between BW20Power Index Difference between BW20 1S and 1S and BW40BW40 1S 1S Bit 7 4 Path A 2G Offset Range Bit 7 4 Path A 2G Offset Range 8 7 8 7 11n11n 模式下模式下 20M20M 和和 40M40M 的差值 一般设置为的差值 一般设置为 0 0 Power Index Difference Power Index Difference between OFDMbetween OFDM 1Tx and 1Tx and BW40BW40 1S 1S Bit 3 0 Path A 2G Offset Range Bit 3 0 Path A 2G Offset Range 8 7 8 7 11g11g 和和 11n11n 的差值 的差值 我们一般设为我们一般设为 2 2 保证 保证 11g11g 与与 11n11n 相同相同 channelchannel 的情形下 的情形下 powerpower 大大 1dB1dB 24h24h 参考代码中的配置 ifdef CONFIG FROM CONFIG FILE extern unsigned char eeprom data 8189es 512 0 x29 0 x81 0 x03 0 x6C 0 x0B 0 x00 0 x00 0 x00 0 x00 0 x0C 0 x00 0 x00 0 x00 0 x00 0 x00 0 x00 0 x28 0 x28 0 x25 0 x25 0 x24 0 x24 0 x2C 0 x2C 0 x28 0 x28 0 x28 0 x02 0 xFF 0 xFF 0 xFF 0 xFF 如果我们要将 11b 的 channel 1 降低 1dB 此表调整为 0 x26 0 x28 0 x25 0 x25 0 x24 0 x24 0 x2C 0 x2C 0 x28 0 x28 0 x28 0 x02 0 xFF 0 xFF 0 xFF 0 xFF 调整后 11b 的 channel 1 2 都降低 1db 如果我们要将 11n 的 channel3 降低 1db 此表调整为 0 x28 0 x28 0 x25 0 x25 0 x24 0 x24 0 x2C 0 x2A 0 x28 0 x28 0 x28 0 x02 0 xFF 0 xFF 0 xFF 0 xFF 调整后 11n 的 channel 3 4 5 都降