谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

Putal TCP/IP MMS AT COMMAND

Revision 2.10 Nov. 1 , 2008

Putal

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

Document Name

Putal TCP/IP MMS AT COMMAND

Doc Id:

Putal_TCP/IP_MMS_AT_V2.10

General Notes

Putal offers this information as a service to its customers, to support application and engineering efforts that use Putal products. The information provided is based upon requirements specifically provided to Putal by the customers. Putal has not undertaken any independent search for additional relevant information, including any information that may be in the customer’s possession. Furthermore, system validation of this Putal product within a larger electronic system remains the responsibility of the customer or the customer’s system integrator. All specifications supplied herein are subject to change.

Copyright

This document contains proprietary technical information which is the property of Putal Limited., copying of the document and giving it to others and the using or communication of the contents thereof, are forbidden without express authority. Offenders are liable to the payment of damages. All rights reserved in the events of grant of patent or the registration of a utility model or design. All specification supplied herein are subject to change without notice at any time.

Copyright © Putal Limited. 2008

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

Contents

Revision History........................................................................................................................................................4 1. Overview...............................................................................................................................................................5 2．AT COMMAND FOR TCP/IP............................................................................................................................6

2.1 AT^CIPSTART.........................................................................................................................................6 2.2 AT+CIPSEND..........................................................................................................................................6 2.3 AT^CIPCLOSE.........................................................................................................................................7 2.4 AT+CGATT (标准AT指令)....................................................................................................................7 2.5 AT^CIPSTATUS.......................................................................................................................................7 3 AT COMMAND for MMS..................................................................................................................................8

3.1 AT^UPLOADFILE...................................................................................................................................8 3.2 AT^MMSSEND........................................................................................................................................8 3.3 AT+EMMSEXE （标准MMS指令）..................................................................................................9 4．Typical Application............................................................................................................................................10

4.1 Call..........................................................................................................................................................10 4.2 Send English SMS（TXT MODE）......................................................................................................10 4.3 Send Chinese SMS（PDU MODE）........................................................................................................10 4.4 Send MMS Picture..................................................................................................................................11 4.5 TCP/IP Application.................................................................................................................................13 4.6 参考操作模块流程................................................................................................................................14

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

Revision History

V1.00 Sep 20 , 2008 V2.00 Oct 25 , 2008 1，2008

Comments First release

1. add MMS AT command

2. add SMS,MMS typical application

1．AT^UPLOADFILE 上传图片限制为50k

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

1. Overview

序号 命令

TCP/IP AT COMMAND MMS AT COMMAND

功能描述

连接到服务器

发送数据到服务器 关闭TCP/IP连接 关闭移动场景 查询状态

上传MMS图片数据到模块 发送MMS图片

清空MMS邮箱各文件夹内容

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

2．AT COMMAND FOR TCP/IP

2.1 AT^CIPSTART

AT^CIPSTART 建立TCP连接或注册UDP端口号

Execute command Response

AT^CIPSTART=“TCP”，“IP 命令正确返回OK Address”，“PORT” 错误返回ERROR Parameter: 对TCP连接： AT^CIPSTART = “TCP”，“IP Address”，“Port”

命令正确返回OK，错误返回ERROR 连接成功返回CONNECT OK

失败先返回STATE状态码，后再返回CONNECT FAIL 如：

AT^CIPSTART=TCP, 121.32.16.103,2020 ↙ 连接到服务器 AT^CIPSEND=hello,Putal ↙ 发送字符hello,PutalAT^CIPCLOSE ↙ 关闭连接 AT+CGATT= 0 关闭移动场景

状态说明

0 ---IP CLOSE 连接关闭 1 ---CONNECT OK 连接成功 2 ---WAITING CONNECT 等待连接

AT^CIPSTART 只有在IP CLOSE 状态下才可以进行连接的建立。 2.2 AT+CIPSEND AT^CIPSEND 发送数据 Execute command

AT^CIPSEND=写入需要发送的数据，按“ENTER”键开始发送 Reference

Response

此命令用来发送可变长度的数据 连接未建立，返回ERROR

如果数据发送成功，返回SEND OK 如果数据发送失败，返回SEND FAIL

如：AT^CIPSEND=ABCDEFG (发送字符串：ABCDEFG) Note:

1。每次传送的数据字节数<= 512bytes.

2．只有在CONNECT OK的状态下才可发送数据，否则返回ERROR。

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

当服务器向模块发送数据时，模块端接收数据时均以字符：+CIPC：开头。如服务器发送abcdef。则模块端将显示为： +CIPC：abcdef

特别注意：服务器向模块单次发送的字符上限为：128字节

2.3 AT^CIPCLOSE

AT^CIPCLOSE 关闭TCP或UDP连接 Execute command Response AT^CIPCLSOE 关闭成功返回CLOSE OK

关闭失败返回CLOSE FAIL

Reference 注：

1. 在TCP/UDP CONNECT OK状态下可以主动关闭连接。2. 如果连接成功后，由于服务器端关闭连接等各种原因，导致无法发送数据而需重新连接服务器时，请先执行一次AT^CIPCLOSE和 AT+CGATT=0指令，以彻底关闭前一次连接参数。

2.4 AT+CGATT (标准AT指令)

AT+CGATT 关闭移动场景 Execute command Response AT+CGATT=0 关闭成功返回 OK

关闭失败返回ERROR

2.5 AT^CIPSTATUS

AT^CIPSTATUS 查询当前TCP/IP状态 Execute command Response AT^CIPSTATUS 命令正确返回当前TCP/IP状态。

命令错误返回ERROR。

状态说明

0 ---IP CLOSE 连接关闭 1 ---CONNECT OK 连接成功 2 ---WAITING CONNECT 等待连接

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

3 AT COMMAND for MMS

3.1 AT^UPLOADFILE

AT^UPLOADFILE 上传图片文件文本数据

Execute command Response

上传成功，返回：UPLOAD FILE OK。 text data，上传失败，返回：UPLOAD FILE FAIL。 parameter

上传前，先用其它的转换工具软件将图片（bmp,jpg等图片格式）转成txt格式的文本文件，并将这个文本文件内容分成若干段，每段长度不超过400个字符（200字节），一次上传一段，直到将整个文件上传完毕。模块内部会自动把这个文本文件在图片存储区还原成相应的图片文件。

支持图片格式：bmp，jpg，jpeg，gif，wbmp，png。 最大图片大小：50k

单次上传字符数：不超过400个，且必须是偶数个。

picture text data：图片文本文件分割后的某一段。（字符数范围：0～400）。

offset control parameter：

-3：表明该段数据是该图片的第一段，即重新建立一个新图片（如果之前已存在图片，自动删除之）。 -1：表明该段数据将追加到前面图片数据的末尾，（默认方式,即offset control parameter为空时，就认为是“-1”） 其它正数参数：表示将从指定参数偏移处开始改写。

这样，模块内部的图片存储区只可能存在0个或1个图片文件。

错误代码UPLOAD FILE FAIL：（-1～-6） -1,解析命令串出错,参数太长 -2,文件名为空，（现不用） -3，创建文件错误

-4，输入数据必须为偶数字节 -5，文件太大 -6，文件写入失败 3.2 AT^MMSSEND

AT^MMSSEND 将图片存储区的的图片通过彩信发到指定的号码

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

Execute command Response

AT^MMSSEND=phone number 发送成功，返回：SEND MMS OK。

发送失败，返回：SEND MMS FAIL:错误代码。

Reference mobilephone number：MMS发送的目标号码。

将模块内部图片存储区的图片发送到指令的号码。 错误代码SEND MMS FAIL：（-1～-10） -1---WAP/MMS未开启 -2---已发的彩信太多 -3 ---文件数据为空

-4 ---超过允许的最大文件大小 -5 ---不允许建立文件

-6 ---获得图片文件的长宽失败 -7 ---缩放文件失败

-8 ---没有剩余空间存放文件 -9 ---\

-10--发送彩信失败 如：

AT^MMSSEND=13560384345

SEND MMS OK 或 SEND MMS FAIL：-3

注意：

为确保发送彩信时，在执行AT^MMSSEND指令前，建议执行一下AT+CKPD=“EE”指令，以提出其他功能，为发彩信腾出尽可能多的内存空间。否则有可能导致重启现象。 3.3 AT+EMMSEXE （标准MMS指令）

AT+EMMSEXE 删除MMS邮箱各文件夹的MMS Execute command Response

AT+EMMSEXE= 0，成功，返回： OK <folderID> 失败，返回： FAIL Reference folderID 1(0x01)Delete all msg in inbox

2(0x02)Delete all msg in outbox 4(0x04)Delete all msg in Sent 8(0x08)Delete all msg in Drafts

如：删除MMS发件箱里所有的信息 AT+EMMSEXE=0,4 +EMMSEXE:0 OK

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

4．Typical Application

4.1 Call

操作内容：

1． 拨打电话 13560384345 2． 挂断通话

AT指令实现如下：

ATD13560384345； 呼叫 （注意事项：一定要记得加上分号“；”） ……..

ATH 挂断通话

4.2 Send English SMS（TXT MODE）

操作内容：

1．向13560384345发送英文短信“abcdefg”

TEXT格式发送短信息首先将短信息格式设为TEXT模式 ： AT+CMGF=1

发送AT+CMGS= YYY [ENTER] ;其中 YYY 为对方手机号码 收到[>]响应后再发送 [待发送英文字符][ctrl-Z]

AT指令实现如下： AT+CMGF = 1 --------将短信息设置到TEXT MODE。 AT+CMGS="13560384345" [ENTER] >abcdefg <ctrl+z>

4.3 Send Chinese SMS（PDU MODE）

操作内容：

1． 向13560384345发送中文短信“你好”

PDU格式发送短信息首先将短信息格式设为PDU模式 ： AT+CMGF=0

发送AT+CMGS= YYY [CR] ;其中 YYY 为TPDU的十进制长度 收到[>][SP]响应后再发送 [TPDU][ctrl-Z] [TPDU]:发送规约数据单元: TYPE 11 MR 00

DA 0D91683165304843F5 ; 13560384345 PID 00 DCS F4 VP 01

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

UDL XX ; XX 不大于 8C

DD ; XX字节的用户数据,用户数据中最后一个字节为前面XX-1个字节的按位累加和。

TPDU 中用户数据前的PDU规约头的长度是15字节 TPDU 前的服务中心地址[SCA]的长度是9字节。 用户数据最长可用到140字节。发中文是 pdu 格式为 80 dcs=80

以下例子 发送到 13560384345 报文是 "你好" 译码为 044F60597D 04 长度 数据 4F60597D是“你好”的unicode编码，按照内存的编码格式倒过来了 at 命令 AT+CMGS=019 {*解释：15(规约为15)+4你好（8个字节）=019} 返回 > 发送0011000D91683165304843F5000801044F60597D发送符 {*解释： 前面两个00照写; 11为TYPE;

00为MR, 0D91683165304843F5为DA; 00为PID; 08为DCS; 01为VP; 04 为长度；

4F60597D 为UDL的内容，就是中文信息部分“你好”}

AT指令实现如下： AT+CMGF=0 OK

AT+CMGS=019

> 0011000D91683165304843F5000801044F60597D [ctrl+z] +CMGS: 45 OK

4.4 Send MMS Picture

操作内容：通过MMS将JPG格式图片picture01.jpg 发送到13560384345。

首先需要将该图片转换成txt格式的文本文件picture.txt，每段400个字符，共13段，内容如下：

ffd8ffe000104a46494600010101007800780000ffe1001645786966000049492a0008000000000000000000ffdb004300080606070605080707070909080a0c140d0c0b0b0c1912130f141d1a1f1e1d1a1c1c20242e2720222c231c1c2837292c30313434341f27393d38323c2e333432ffdb0043010909090c0b0c180d0d1832211c213232323232323232323232323232323232323232323232323232323232323232323232323232323232323232323232323232ffc000110800540070030122000211010311

01ffc4001f0000010501010101010100000000000000000102030405060708090a0bffc400b5100002010303020403050504040000017d01020300041105122131410613516107227114328191a1082342b1c11552d1f02433627282090a161718191a25262728292a3435363738393a434445464748494a535455565758595a636465666768696a737475767778797a838485868788898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b7b8b9bac2c3c4c5c6c7c8c9cad2d3d4d5d6d7d8d9dae1e2e3

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

e4e5e6e7e8e9eaf1f2f3f4f5f6f7f8f9faffc4001f0100030101010101010101010000000000000102030405060708090

a0bffc400b51100020102040403040705040400010277000102031104052131061241510761711322328108144291a1b1c109233352f0156272d10a162434e125f11718191a262728292a35363738393a434445464748494a535455565758595a636465666768696a737475767778797a82838485868788898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b7b8b9bac2c3c4

c5c6c7c8c9cad2d3d4d5d6d7d8d9dae2e3e4e5e6e7e8e9eaf2f3f4f5f6f7f8f9faffda000c03010002110311003f00c4d3b4e000f96ba3b5b3031c52da5b000715b105bf4e2918b6320b5f6abf1dbe31c558b6b5924fb91e40e092401f4e4d4b77a75c3c2022c61d7246645f43ef4b5136225bf3daa75838e95cebe9dae64fef6d140033ba44ef524561a8f9444d79689267e521e3231f4a56279ded63a1f27da8f2c572725beaa24dbf6fd376819de5a300ff005ad8b0bc82dad156e2ead44a40dfb264033cfa1f

71458a8c9b7668d4f2c5218862990dd473f31b0653d194820fe558faf788acf4fb6963172a6e00c796b9247afd29ad4bb13de5e2ac862830cfddbb2d568e18e63fbd7694fb9e3f2ae0c78cd2191c3c4f827236e0923de987c7922bfee84807a61456ae36d8cd293dcf4436a8170a8147b0aa735a67b562787fc6526b1a94560b000ee09dec781819ed5d8c9102bd39a8b35b89e8645ac1d2b5618b1505bc781d2af463150d9426a5a72dff00879a22aa7374bf7871f76b93bcd1c594889f678242e3236c7dbf2af4

0b7cc9a7c916de04e8d9faf18a9d6d944832547ca3818f53446766572dd1e7d6569c92da7c6001cee8783fa55d782251bbec16cdce388867f957a0ac70f96dbd907ca7a95f4fad5782c92391a52e8b11dbb09603f879fd6b6534fa19ca335657b9e757312904ff0066a9f64b707fa543696934922c7fd9af0444122492d540ce3d6bd6b65b9500dc443fe042b9bbe11c3a73dd49c85540c9137cc3048e067dea1cdb5eea348c395de52332ca1fb258aaf1c48c3818ea335e5de20b8ddab5e1cf26535e9eb70b73a3

b5dc11c891b4a0b073961d17fa5792ea4527d5750f31c2edf31864e32474150afd7734567b1cecef990f27a0fe42a30c73492b7ef5b3edfca98a6b55b0d9d9fc391bbc528dfdc8243fa015ebe7915e4bf0cd77788276feedb37fe842bd641e0d4c8c67b95221c55b8fb56126bb6207fac3f829a993c41640706427fddacd824765a72eed3271e93464fe75792170d13ac36d212a46257c639ea3839ac6f0fde47aa68fa8adbcc21742a77c89bb6e39ced0726af5a477d3c21d35bb71b3e5e74ff2c83d7a33669a8d

eccd0d41f6ac7cb6b643fe067ff89a62d8cd1ccd2a241b8e300938079cf6aa8ed711e3cef1246bea4470aff3cd53b8bfb75c87f15a8ff766817f90ad6e975fcc871b9b846a03fe7d17f0635cf78a9bfb3b4a9af6e61fb4676a3c70a1c92cdd7bf154a4d4f4f5396f14dd311ce16e971ff8ead51b8d534c690e756bd901e3fd74b83f8000547359e83704d6a43a7bc973e17bd67b696dc2c8db12542ac40e738fcf91c578aeaed9bfba3ff4d1bf9d7b3c57f69e55e436e1a49278cac4bf687919bea1ba7e15e1ba89

b85bb9d275292ef3b9597041fa51bc9b45c55958a329fde37d69a0f34391bdb919cd38ac4200e270643ff2cc29e3f1ab19ddfc30ff009095fc9e902afe6d9fe95ea4b20c578bf832e9ed9ef1d2528084048e3d6bb48f56bc041492423fdb231fad4cb73392d4c8592a7497dcfe75cf47773ed3f3c79c747f9715b5e0a906a5ad9379796a896ea5fca271bdb381827b0eb52c763a2d459b43d0230aa7edd72c39c1250753d3d303f1ae66e757d62fe52d3bdc4cc780cf1f6fcabb1d4a7825ba679356d3215030a24b

b507159725d68b19fde788b4d1ff005cdcb9fd2945e80bcce7164d51b9104c3e8a16a616dac4c320483fde9d47e99cd6b36b7e1887efeb9bff00eb9dbb1aacde30f0cc05c466f6e4edc82a8aa18fa73fceaae514bfb335460434b1a83eb313fa0cd44da35fc9f7a58c67938663579bc7de1f52e3fb36f9c03f2fce8091efe9fad5593e216940feeb4295bfdfba23f90a2ec020f0fdd03b96ed636072acbbb2a7b106b727b28b5ab2f2353644be036c77ab10f9bd0383d6b9993e2328188741b51fefc8cd5564f88b

a8b7faad334e4fac45bfad166c650d6b4bd4f42bbf22ea1b745627cb952252920f5071fa565b5c3b280c2127d440a0ff002ad3d4fc5dabeb96a2d2f1e116e18308e28f68c8e95918cf5c53d40dad145cc88ed1cc542903038fcbb56daade8ff97b9ff1543591a2b6c89fdcd6d2cdef4364b3284a0f5e6a85fc645b7dd5750dc0230c3f1a7abfd2a40c0fe1486610b727a06fd2945b3e402c47fbc0815bcd212bd6b3a676dcc0b123de9dc66e68565a3ae2269ede6b8938669972abec0115e8361a3c124422b7895b

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

dd235cfe1815e29e6104ee008ad7d1bc4da8e8b3a4d6378f195390ac78ff00eb7e149a607a76a9e1cd3aea0682ead54

3767db8653ec6bcb2ff004afb05f4b6d248098cf071d41e41ae8b50f891a95f82d2c703487ab124f35cccb7b3ea13b5cdc3ee91fa9c6285740823b28e43f78fe54d92de1849055891f8559b6eb4fb98bcc5c8c6e140ccb90c7d1136fe3518f7a99a36ce08e734ab0b96c6da606ae967109cfad68ef159768a624c355af331de864b33949c8a9549a28a4c052c40aaaea19f27345140c86785

02061d6aae28a298c9046188fe95a50c48b1a003b679a28a0448bc74a764edcd1452021910139ef4d42538078f7a28a7d0435ee644e98aad25ecc4e3701f414514219fffd9

AT指令实现如下：

AT^UPLOADFILE = ,-3 建立新的图片文件

AT^UPLOADFILE=ffd8ffe000104a46494600010101007800780000ffe1001645786966000049492a00080000000 00000000000ffdb004300080606070605080707070909080a0c140d0c0b0b0c1912130f141d1a1f1e1d1a1c1c20242e2720222c231c1c2837292c30313434341f27393d38323c2e333432ffdb0043010909090c0b0c180d0d1832211c213232323232323232323232323232323232323232323232323232323232323232323232323232323232323232323232323232ffc000110800540070030122000211010311 UPLOAD FILE OK

（offset control parameter为空，默认为“-1”，该段数据追加到新建空文件的末尾）

AT^UPLOADFILE=…………. UPLOAD FILE OK

AT^UPLOADFILE=…………. UPLOAD FILE OK

…………………………………

AT^UPLOADFILE=02061d6aae28a298c9046188fe95a50c48b1a003b679a28a0448bc74a764edcd1452021910139ef4d42538078f7a28a7d0435ee644e98aad25ecc4e3701f414514219fffd9 UPLOAD FILE OK

(上传最后一行图片数据)

AT+CKPD="EE" ----------确保模块退出其他功能页面，准备发彩信。 AT^MMSSEND=13560384345 SEND MMS OK

（图片成功发送到13560384345）

4.5 TCP/IP Application

操作内容：

1． 连接到服务器（IP：121.32.16.103 PORT：2020）， 2． 发送数据“hello,Putal” 3． 断开与服务器的连接。 AT指令实现如下：

AT^CIPSTART=TCP, 121.32.16.103,2020 ↙ 连接到服务器 AT^CIPSEND=hello,Putal ↙ 发送字符数据 AT^CIPCLOSE ↙ 关闭连接

AT+CGATT= 0 关闭移动场景

注意：如果连接成功后，由于信号变弱或网络服务器关闭等各种原因，导致无法发送数据而需重新连接服务器时，请先执行一次AT^CIPCLOSE 和AT+CGATT=0指令，以彻底关闭前一次连接参数。

谱泰通信GSM-GPRS模块TCP-IP,彩信功能AT指令集及实例介绍Putal_TCP_IP_MMS_AT_COMMAND_v2.1

4.6 参考操作模块流程

操作内容： 开机后，外部控制器对模块的操作流程

完！

本文来源：https://www.bwwdw.com/article/9ng1.html