域格移芯 cat1模块YM310 X09 - FTP服务使用说明

模块内文件控制

（注意：文件只能在根目录下操作）

AT指令（加粗字体）	指令解析
AT+FSCREATE=“/test.txt”	跟目录下创建文件
OK
AT+FSLS=“/“	显示跟目录列表
testdir\
test.txt
OK
AT+FSWRITE=”/test.txt”,0,10,10	写文件，参数：文件名，0开头开始写；1从文件末尾开始写，要写数据的字节数，写文件持续时间单位：秒
>1234567890	当出现“>“后，输入写入的数据：1234567890
OK
AT+FSREAD=”/test.txt”,0,10,10	读取文件内容,参数：文件名，0开头开始读；1从文件末尾开始读，要读数据的字节数，读文件持续时间单位：秒
1234567890
OK
AT+FSMEM	获取模块文件系统可用空间大小
+FSMEM: 1304000 byte	模块各不相同，请以自己模块可用内存为准
OK
AT+FSFLSIZE=“/test.txt”	获取文件大小
+FSFLSIZE: 10	10个字节数
OK
AT+FSDEL=“/test.txt”	删除文件
OK

FTP下载文件到模块

FTPGET 只能将下载文件内容读取出来不能保存到模块文件内

FTPEXTGETT 可以下载文件，保存下载数据到文件中，输出下载的数据到串口，流式获取数据

FTPGET 命令使用方法：

序号	AT指令（加粗字体）/返回数据	指令解析/返回解析
1	AT+CEREG?	查询网络注册状态
	+CEREG: 0,1	<n>=0，表示禁用 URC，上报<stat>=1，标识已经注册网络，而且是本地网络
2	AT+SAPBR=3,1,“CONTYPE”,“GPRS”	设置 FTP 功能的承载类型
	OK
3	AT+SAPBR=3,1,“APN”,“”	模块注册网络后会从网络自动获取<apn>并激活一个 PDP 上下文，用于 RNDIS 上网使用。此<apn>可以通过 AT+CGDCONT?来查询。这里输入 AT+SAPBR=3,<cid>,“APN”,“” 即可，模块内部会按照自动获取的<apn>来设置 APN
	OK
4	AT+SAPBR=1,1	激活该承载的 GPRS PDP 上下文
	OK
5	AT+SAPBR=2,1	查询下承载的状态
	+SAPBR: 1,1,“10.44.36.7”	第一个参数 1 表示 cid，第二个参数 1 表示已经连接，第三个参数表示模块获取的 IP 地址
	OK
6	AT+FTPCID=1
	OK
7	AT+FTPSERV=“122.51.209.56”	设置FTP服务器 IP
	OK
8	AT+FTPUN=“yuge”	设置用户名
	OK
9	AT+FTPPW=“yuge”	设置密码
	OK
10	AT+FTPGETPATH=“/”	正常是根目录下，如没有就在/USER/FTP下面
	OK
11	AT+FTPLIST=1
	OK
	+FTPLIST: 1,1
12	AT+FTPLIST=2,1460	查询FTP服务器目录下文件
	+FTPLIST: 2,1460
	……	FTP服务器根目录下的文件
13	AT+FTPQUIT	退出 FTPLIST 会话，才能开始后续的会话。退出 FTPLIST 会话的方法有两种，一是等待+FTPLIST:1,0 上报，二是主动退出 FTPLIST 会话
	OK	这里采用的是主动退出 FTPLIST 会话
	+FTPLIST: 1,86
14	AT+FTPGETNAME=“512B.txt”	设置下载文件的名称
	OK
15	AT+FTPGET=1	开始 FTP 下载会话
	OK
	+FTPGET: 1,1	这个是 URC 上报，表示有数据了
16	AT+FTPGET=2,20	读入 20 个数据
	+FTPGET: 2, 20	确认读到20个数据
	…….	数据内容
	OK
	+FTPGET: 1,0	等一段时间会提示 FTP 下载会话结
17	AT+FTPREST=6	如果 FTP 连接或会话意外关闭，还可以断点续传。从断掉的点开始下载
	OK
18	AT+FTPGET=1
	OK
	+FTPGET: 1,1
19	AT+FTPQUIT	也可以在提示 +FTPGET: 1,0 前主动用AT+FTPQUIT 退出当前 FTP 会
	OK
	+FTPGET: 1,86

FTPEXTGETT命令使用方法：

序号	AT指令（加粗字体）/返回数据	指令解析/返回解析
1	AT+CEREG?	查询网络注册状态
	+CEREG: 0,1	<n>=0，表示禁用 URC，上报<stat>=1，标识已经注册网络，而且是本地网络
2	AT+SAPBR=3,1,“CONTYPE”,“GPRS”	设置 FTP 功能的承载类型
	OK
3	AT+SAPBR=3,1,“APN”,“”	模块注册网络后会从网络自动获取<apn>并激活一个 PDP 上下文，用于 RNDIS 上网使用。此<apn>可以通过 AT+CGDCONT?来查询。这里输入 AT+SAPBR=3,<cid>,“APN”,“” 即可，模块内部会按照自动获取的<apn>来设置 APN
	OK
4	AT+SAPBR=1,1	激活该承载的 GPRS PDP 上下文
	OK
5	AT+SAPBR=2,1	查询下承载的状态
	+SAPBR: 1,1,“10.44.36.7”	第一个参数 1 表示 cid，第二个参数 1 表示已经连接，第三个参数表示模块获取的 IP 地址
	OK
6	AT+FTPCID=1
	OK
7	AT+FTPSERV=“122.51.209.56”	设置FTP服务器 IP
	OK
8	AT+FTPUN=“yuge”	设置用户名
	OK
9	AT+FTPPW=“yuge”	设置密码
	OK
10	AT+FTPGETNAME=“512B.txt”	设置下载文件的名字（请注意：FTPEXTGET 命令只支持小于 300K 的文件的下载）
	OK
11	AT+FTPGETPATH=“/”	正常是根目录下，如没有就在/USER/FTP下面
	OK
12	AT+FTPEXTGET=1	开始 FTP 下载参数：0是关闭，1是下载，2保存下载数据到文件中，3是输出下载的数据到串口，4是流式获取数据
	OK
	+FTPEXTGET: 1,0	下载完成
13	AT+FTPEXTGET?	查询下载了多少字节
	+FTPEXTGET: 1,512	下载完成，下载字节数
	OK
14	AT+FTPEXTGET=2,hello	保存的文件名为 hello
	+FTPEXTGET: 2,512
	OK
15	AT+FSLS=“/”	查询保存的文件，系统默认会保存到这个路径下
	hello
	OK
16	AT+FTPEXTGET=3,0,512	显示下载文件长度，512表示显示512个字节
	+FTPEXTGET: 3,512
	…….	下载文件内容
	OK
17	AT+FTPEXTGET=0	设置 FTPEXTGET 模式关闭
	OK
18	AT+FTPEXTGET=4	流式获取数据
	OK
	+FTPEXTGET: 4,512	有数据上报
19	AT+FTPEXTGET=4,512	读数据
	+FTPEXTGET: 4,512
	……	读取的数据内容
	OK

FTPGETTOFS 命令使用方法：

序号	AT指令（加粗字体）/返回数据	指令解析/返回解析
1	AT+CEREG?	查询网络注册状态
	+CEREG: 0,1	<n>=0，表示禁用 URC，上报<stat>=1，标识已经注册网络，而且是本地网络
2	AT+SAPBR=3,1,“CONTYPE”,“GPRS”	设置 FTP 功能的承载类型
	OK
3	AT+SAPBR=3,1,“APN”,“”	模块注册网络后会从网络自动获取<apn>并激活一个 PDP 上下文，用于 RNDIS 上网使用。此<apn>可以通过 AT+CGDCONT?来查询。这里输入 AT+SAPBR=3,<cid>,“APN”,“” 即可，模块内部会按照自动获取的<apn>来设置 APN
	OK
4	AT+SAPBR=1,1	激活该承载的 GPRS PDP 上下文
	OK
5	AT+SAPBR=2,1	查询下承载的状态
	+SAPBR: 1,1,“10.44.36.7”	第一个参数 1 表示 cid，第二个参数 1 表示已经连接，第三个参数表示模块获取的 IP 地址
	OK
6	AT+FTPCID=1
	OK
7	AT+FTPSERV=“122.51.209.56”	设置FTP服务器 IP
	OK
8	AT+FTPUN=“yuge”	设置用户名
	OK
9	AT+FTPPW=“yuge”	设置密码
	OK
10	AT+FTPGETNAME=“TEST.mp3”	设置下载文件的名字（请注意：FTPEXTGET 命令只支持小于 300K 的文件的下载）
	OK
11	AT+FTPGETPATH=“/”	正常是根目录下，如没有就在/USER/FTP下面
	OK
12	AT+FTPGETTOFS=0,“TEST-1.mp3”	开始下载，并存于本地 ROM 中。如果第一个参数为 1，则保存于 SD 卡中。不管保存在本地还是 SD 卡，都只能指定文件名，不能指定路径，因为存放的路径是固定的这种下载方式支持自动断点续传
	OK
13	AT+FTPGETTOFS?	查询下载情况
	+FTPGETTOFS: 1,245900,207715	已下载 245900 字节,207715 字节已被存入文件系统（这里是用例，实际情况得根据模块剩余空间大小来）
	OK
	+FTPGETTOFS: 0,245900	（URC）下载成功，总共下载了多少字节。可用文件系统命令对文件进行操作
14	AT+FSLS=C:/	查询保存的文件
	hello	模块内文件
	TEST-1.mp3	模块内文件
	OK
15	AT+CAUDPLAY=1,“C:/TEST-1.mp3”	播放保存的文件
	OK
	+CAUDPLAY: 1,600	播放结束

模块上传文件到FTP

FTPPUT 上传文件只能覆盖写入内容

FTPEXTPUT 上传文件可以续写内容

FTPPUT 命令使用方法：

序号	AT指令（加粗字体）/返回数据	指令解析/返回解析
1	AT+CEREG?	查询网络注册状态
	+CEREG: 0,1	<n>=0，表示禁用 URC，上报<stat>=1，标识已经注册网络，而且是本地网络
2	AT+SAPBR=3,1,“CONTYPE”,“GPRS”	设置 FTP 功能的承载类型
	OK
3	AT+SAPBR=3,1,“APN”,“”	模块注册网络后会从网络自动获取<apn>并激活一个 PDP 上下文，用于 RNDIS 上网使用。此<apn>可以通过 AT+CGDCONT?来查询。这里输入 AT+SAPBR=3,<cid>,“APN”,“” 即可，模块内部会按照自动获取的<apn>来设置 APN
	OK
4	AT+SAPBR=1,1	激活该承载的 GPRS PDP 上下文
	OK
5	AT+SAPBR=2,1	查询下承载的状态
	+SAPBR: 1,1,“10.44.36.7”	第一个参数 1 表示 cid，第二个参数 1 表示已经连接，第三个参数表示模块获取的 IP 地址
	OK
6	AT+FTPCID=1
	OK
7	AT+FTPSERV=“122.51.209.56”	设置FTP服务器 IP
	OK
8	AT+FTPUN=“yuge”	设置用户名
	OK
9	AT+FTPPW=“yuge”	设置密码
	OK
10	AT+FTPPUTNAME=“1222.txt”	设置上传文件的名称
	OK
11	AT+FTPPUTPATH=“/”	设置上传文件的路径
	OK
12	AT+FTPPUT=1	设置密码
	OK	这是 URC 上报，表示可以上传数据了，单次上传的最大长度为 1360
	+FTPPUT:1,1,1360
13	AT+FTPPUT=2,10	输入上传文件内容10个字符
	+FTPPUT: 2,10
	……	输入 10 个字符后，会返回 OK，表示输入结束，已经上传
	OK
	+FTPPUT: 1,0
14	AT+FTPQUIT	也可以在提示 +FTPPUT: 1,0 之前用AT+FTPQUIT 主动结束会话
	OK
	+FTPPUT: 1,86

FTPEXTPUT 使用方法：

序号	AT指令（加粗字体）/返回数据	指令解析/返回解析
1	AT+CEREG?	查询网络注册状态
	+CEREG: 0,1	<n>=0，表示禁用 URC，上报<stat>=1，标识已经注册网络，而且是本地网络
2	AT+SAPBR=3,1,“CONTYPE”,“GPRS”	设置 FTP 功能的承载类型
	OK
3	AT+SAPBR=3,1,“APN”,“”	模块注册网络后会从网络自动获取<apn>并激活一个 PDP 上下文，用于 RNDIS 上网使用。此<apn>可以通过 AT+CGDCONT?来查询。这里输入 AT+SAPBR=3,<cid>,“APN”,“” 即可，模块内部会按照自动获取的<apn>来设置 APN
	OK
4	AT+SAPBR=1,1	激活该承载的 GPRS PDP 上下文
	OK
5	AT+SAPBR=2,1	查询下承载的状态
	+SAPBR: 1,1,“10.44.36.7”	第一个参数 1 表示 cid，第二个参数 1 表示已经连接，第三个参数表示模块获取的 IP 地址
	OK
6	AT+FTPCID=1
	OK
7	AT+FTPSERV=“122.51.209.56”	设置FTP服务器 IP
	OK
8	AT+FTPUN=“yuge”	设置用户名
	OK
9	AT+FTPPW=“yuge”	设置密码
	OK
10	AT+FTPPUTPATH=“/”	设置上传文件的路径
	OK
11	AT+FTPPUTNAME=“1222.txt”	设置上传文件的名称
	OK
12	AT+FTPEXTPUT=1
	OK
13	AT+FTPEXTPUT=2,0,5,10000	将文件数据从串口输入到模块 RAM。第 2 个参数是 offset，第 3 个参数是数据长度，第 4 个参数是超时时间 10s
	+FTPEXTPUT: 0,5
	…….	这里输入 5 个字符：12345
	OK
14	AT+FTPEXTPUT=2,5,7,10000	这次 offset 是 5，长度为 7
	+FTPEXTPUT: 5,7
	…….	这里输入 7 个字符：67890AB
	OK
15	AT+FTPPUT=1	将 RAM 中的文件传到 FTP 服务器
	OK
	+FTPPUT: 1,0	等一段时间会提示 FTP 上传会话结束。此时查看服务器/1222.txt，看到的的内容是：1234567890AB
16	AT+FTPEXTPUT=0	改为普通的 FTP PUT 模式
	OK

FTPFILEPUT 命令使用方法：

序号	AT指令（加粗字体）/返回数据	指令解析/返回解析
1	AT+CEREG?	查询网络注册状态
	+CEREG: 0,1	<n>=0，表示禁用 URC，上报<stat>=1，标识已经注册网络，而且是本地网络
2	AT+SAPBR=3,1,“CONTYPE”,“GPRS”	设置 FTP 功能的承载类型
	OK
3	AT+SAPBR=3,1,“APN”,“”	模块注册网络后会从网络自动获取<apn>并激活一个 PDP 上下文，用于 RNDIS 上网使用。此<apn>可以通过 AT+CGDCONT?来查询。这里输入 AT+SAPBR=3,<cid>,“APN”,“” 即可，模块内部会按照自动获取的<apn>来设置 APN
	OK
4	AT+SAPBR=1,1	激活该承载的 GPRS PDP 上下文
	OK
5	AT+SAPBR=2,1	查询下承载的状态
	+SAPBR: 1,1,“10.44.36.7”	第一个参数 1 表示 cid，第二个参数 1 表示已经连接，第三个参数表示模块获取的 IP 地址
	OK
6	AT+FTPCID=1
	OK
7	AT+FTPSERV=“122.51.209.56”	设置FTP服务器 IP
	OK
8	AT+FTPUN=“yuge”	设置用户名
	OK
9	AT+FTPPW=“yuge”	设置密码
	OK
10	AT+FTPPUTPATH=“/”	设置上传文件的路径
	OK
11	AT+FTPPUTNAME=“TEST_80.txt”	传到服务器后保存的文件名
	OK
12	AT+FTPFILEPUT=1,“C:/TEST-1.txt”	将 C:\TEST-1.txt加载到内存
	OK
13	AT+FTPPUT=1	开始上传
	OK
	+FTPPUT: 1,0	上传结束
14	AT+FTPFILEPUT=0	结束 FTPFILEPUT 模式
	OK

FTP 远程创建/删除目录或文件：

序号	AT指令（加粗字体）/返回数据	指令解析/返回解析
1	AT+CEREG?	查询网络注册状态
	+CEREG: 0,1	<n>=0，表示禁用 URC，上报<stat>=1，标识已经注册网络，而且是本地网络
2	AT+SAPBR=3,1,“CONTYPE”,“GPRS”	设置 FTP 功能的承载类型
	OK
3	AT+SAPBR=3,1,“APN”,“”	模块注册网络后会从网络自动获取<apn>并激活一个 PDP 上下文，用于 RNDIS 上网使用。此<apn>可以通过 AT+CGDCONT?来查询。这里输入 AT+SAPBR=3,<cid>,“APN”,“” 即可，模块内部会按照自动获取的<apn>来设置 APN
	OK
4	AT+SAPBR=1,1	激活该承载的 GPRS PDP 上下文
	OK
5	AT+SAPBR=2,1	查询下承载的状态
	+SAPBR: 1,1,“10.44.36.7”	第一个参数 1 表示 cid，第二个参数 1 表示已经连接，第三个参数表示模块获取的 IP 地址
	OK
6	AT+FTPCID=1
	OK
7	AT+FTPSERV=“122.51.209.56”	设置FTP服务器 IP
	OK
8	AT+FTPUN=“yuge”	设置用户名
	OK
9	AT+FTPGETPATH=“/test”	设置要创建的文件目录
	OK
10	AT+FTPMKD	创建目录
	OK
	+FTPMKD: 1,0
11	AT+FTPRMD	删除目录
	OK
	+FTPRMD: 1,0
12	AT+FTPGETNAME=“HI.txt”	在设置的目录下创建HI.txt文件
	OK
13	AT+FTPDELE	删除HI.txt文件
	OK
	+FTPDELE: 1,0

< 回到YM310 X09资料大全