A7600 Series_
FTP(S)_Application Note
LTE Module
SIMCom Wireless Solutions Limited
Building B, SIM Technology Building, No.633, Jinzhong Road
Changning District, Shanghai P.R. China
Tel: 86-21-31575100
support@simcom.com
www.simcom.com
A7600 Series_FTS(S)_Application Note_V1.00
A7600 Series_FTP(S)_Application Note
1.00
2020.6.19
Released
Document Title:
Version:
Date:
Status:
GENERAL NOTES
SIMCOM OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS, TO SUPPORT
APPLICATION AND ENGINEERING EFFORTS THAT USE THE PRODUCTS DESIGNED BY SIMCOM.
THE INFORMATION PROVIDED IS BASED UPON REQUIREMENTS SPECIFICALLY PROVIDED TO
SIMCOM BY THE CUSTOMERS. SIMCOM 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 PRODUCT
DESIGNED BY SIMCOM 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 SIMCOM WIRELESS SOLUTIONS LIMITED COPYING, TO OTHERS AND USING THIS DOCUMENT,
ARE FORBIDDEN WITHOUT EXPRESS AUTHORITY BY SIMCOM. OFFENDERS ARE LIABLE TO THE
PAYMENT OF INDEMNIFICATIONS. ALL RIGHTS RESERVED BY SIMCOM IN THE PROPRIETARY
TECHNICAL INFORMATION ,INCLUDING BUT NOT LIMITED TO REGISTRATION GRANTING OF A
PATENT , A UTILITY MODEL OR DESIGN. ALL SPECIFICATION SUPPLIED HEREIN ARE SUBJECT TO
CHANGE WITHOUT NOTICE AT ANY TIME.
SIMCom Wireless Solutions Limited
Building B, SIM Technology Building, No.633 Jinzhong Road, Changning District, Shanghai P.R. China
Tel: +86 21 31575100
Email: simcom@simcom.com
For more information, please visit:
https://www.simcom.com/download/list-863-en.html
For technical support, or to report documentation errors, please visit:
https://www.simcom.com/ask/ or email to: support@simcom.com
Copyright © 2020 SIMCom Wireless Solutions Limited All Rights Reserved.
www.simcom.com 1 / 18
A7600 Series_FTS(S)_Application Note_V1.00
About Document
Version History
Revision Date
V1.00
2020.06.19
Scope
Chapter
Description
New version
This document presents the AT Command Set for SIMCom A7600 Series, including A7600XX-XXXX,
A5360E, and A7670X.
www.simcom.com 2 / 18
A7600 Series_FTS(S)_Application Note_V1.00
Contents
About Document .................................................................................................................... 2
Version History ...................................................................................................................................... 2
Scope .................................................................................................................................................... 2
1.5.1
1.5.2
1.5.3
Contents ................................................................................................................................. 3
Introduction ...................................................................................................................... 4
1
1.1 Purpose of the document ................................................................................................................. 4
1.2 Related documents .......................................................................................................................... 4
1.3 Conventions and abbreviations ....................................................................................................... 4
1.4 The process of Using FTP(S) AT Commands .................................................................................. 5
1.5 Error Handling.................................................................................................................................. 6
Executing FTP(S) AT Commands Fails ............................................................................ 6
PDP Activation Fails ......................................................................................................... 6
Error Response of FTP(S) Server .................................................................................... 6
2 AT Commands for FTP(S) ............................................................................................... 7
3 FTP(S) Examples ............................................................................................................. 8
FTP Function .............................................................................................................................. 8
Download a file from FTP server to module/Upload a file to FTP server from module ..... 9
Download a file from FTP server to serial port/Upload a file from serial port to FTP server
10
Directory Operations ...................................................................................................... 11
FTPS Function .......................................................................................................................... 12
Download a file from FTPS server to module/Upload a file to FTPS server from module
12
Download a file from FTPS server to serial port/Upload a file from serial port to FTPS
3.1.1
3.1.2
3.1.3
3.1
3.2
3.2.1
3.2.2
server 13
3.2.3
Directory Operations ...................................................................................................... 15
4 Appendix ........................................................................................................................ 17
4.1 Summary of Error Codes .......................................................................................................... 17
www.simcom.com 3 / 18
A7600 Series_FTS(S)_Application Note_V1.00
1
Introduction
1.1 Purpose of the document
Based on module AT command manual, this document will introduce FTP(S) application process.
Developers could understand and develop application quickly and efficiently based on this document.
1.2 Related documents
[1] A7600 Series_AT Command Manual
1.3 Conventions and abbreviations
In this document, the GSM engines are referred to as following term:
ME (Mobile Equipment);
MS (Mobile Station);
TA (Terminal Adapter);
DCE (Data Communication Equipment) or facsimile DCE (FAX modem, FAX board);
In application, controlling device controls the GSM engine by sending AT Command via its serial interface.
The controlling device at the other end of the serial line is referred to as following term:
TE (Terminal Equipment);
DTE (Data Terminal Equipment) or plainly "the application" which is running on an embedded system;
Other Conventions:
PDP(Packet Data Protocol);
FTP(File Transfer Protocol);
SSL(Secure Sockets Layer);
TLS(Transport Layer Security);
www.simcom.com 4 / 18
A7600 Series_FTS(S)_Application Note_V1.00
1.4 The process of Using FTP(S) AT Commands
Power on the module
Check the status of SIM card or
Reboot the module
SIM Card Status:
Execute AT+CPIN?,if response is
+CPIN:READY,means SIM Card Status is
normal.Reboot the module or check SIM
card status if AT+CPIN? Fails to identify
SIM card in 20s.
Phone functionality:
Execute AT+CFUN? to query the level of
functionality in the ME.If
is not
equal to 1,please execute AT+CFUN = 1 to
make ME come to full funtionality and
onlinemode
Signal quality:
Execute AT+CSQ to query signal quality.If
rssi is equal to 99,please check SIM card
status or reboot the module.
CS Service:
If of AT+CREG? equal to 1,it means
that the module has registered on CS
domain service.Reboot the module if it
fails to registered on CS domain.
PS Serivce:
If of AT+CGREG? equals to 1,it
means that the module has registered on
PS domain service.
UE system information:
If is “NO SERVICE”,it
means network status has some problem.
PDP Context:
1.Configure PDP Context by
AT+CGDCONT=,,
2.Activate the PDP Context by
AT+CGACT=,[]
3.Query IP address of the PDP context by
AT+CGACT?
AT+CFTPSSTART:
AT+CFTPSSTART also can activate the PDP
Context.But It can not customize PDP
activation parameters.
AT+CFTPSSLCFG:
Login to the FTPS server,you should use
AT+CFTPSSLCFG to select the SSL
context.Before using AT+CFTPSSLCFG,you
should use AT+CSSLCFG to configure SSL
context.
AT+CFTPSLOGIN:
You can change the parameter
to login a FTP server/FTPS
server.
Query SIM card status by AT+CPIN?
+CPIN: READY
Query the ME functionality by
AT+CFUN?
+CFUN: 1
Query signal quality by AT+CSQ
+CSQ: ,,0 <= rssi <= 31
Query CS service by AT+CREG?
+CREG: 0,1
Query PS service by AT+CGREG?
+CGREG: 0,1
Query UE information by AT+CPSI?
NO SERVICE
Configure the PDP context by
AT+CGDCONT
Active the PDP context by
AT+CGACT=,[] and
AT+CGACT?
PDP ACTIVE FAIL
AT+CFTPSSTART
(PDP active and initialize
FTP(S) service)
FTP or FTPS?
FTPS
AT+CFTPSSLCFG
(Set the SSL context id for
FTPS session)
FTP
AT+CFTPSLOGIN
(Login to a FTP(S) server)
Select operation
FTP(S) Operation:
For details,please refer to A7600
Series_AT Command Manual and A7600
Series_FTP(S)_Application Note
Download file from FTP(S) server
Directory operations
Upload file to FTP(S) server
AT+CFTPSTYPE
(Set the transfer type on
FTP(S) server)
AT+CFTPSLIST
(List the items in the directory
on FTP(S) server)
AT+CFTPSTYPE
(Set the transfer type on
FTP(S) server)
AT+CFTPSGET
(Get a file from FTP(S)
server to serial port)
AT+CFTPSGETFILE
(Download a file from
FTP(S) server to module)
AT+CFTPSMKD
(Create a new directory on
FTP(S) server)
AT+CFTPSPUT
(Put a file to FTP(S) server
through serial port)
AT+CFTPSPUTFILE
(Upload a file from
module to FTP(S) server)
AT+CFTPSRMD
(Delete a directory on FTP(S)
server)
AT+CFTPSPWD
(Get the current directory on
FTP(S) server)
AT+CFTPSCWD
(Change the current directory
on FTP(S) server)
AT+CFTPSLOGOUT
(Logout a FTP(S) server)
AT+CFTPSSTOP
(PDP deactive and stop
FTP(S) service)
AT+CFTPSSIZE
(Get the file size on FTP(S)
server)
www.simcom.com 5 / 18
A7600 Series_FTS(S)_Application Note_V1.00
1.5 Error Handling
1.5.1 Executing FTP(S) AT Commands Fails
When executing FTP(S) AT commands, if ERROR response is received from the module, please check
whether the U(SIM) card is inserted and whether it is +CPIN: READY returned when executing
AT+CPIN?.
1.5.2 PDP Activation Fails
If it is failed to activate a PDP context with AT+CGACT command, please check the following
configurations:
1. Query the PS domain status by AT+CGREG? and make sure the PS domain has been registered.
2. Query the PDP context parameters by AT+CGDCONT? and make sure the APN of the specified PDP
context has been set.
3. Make sure the specified PDP context ID is neither used by PPP nor activated by AT+CGACT
command.
If all above configurations are correct, but activating the PDP context by AT+CGACT command still fails,
please reboot the module to resolve this issue. After rebooting the module, please check the
configurations mentioned above for at least.
1.5.3 Error Response of FTP(S) Server
When the CFTPSXXX: is not 0, it indicates an error code replied from FTP(S) server.
For example, if is 1, ssl configure may be wrong. If is 17,the file or directory may
not exist. For more details, please refer to A7600 Series_AT Command Manual _V1.01.08.
www.simcom.com 6 / 18
A7600 Series_FTS(S)_Application Note_V1.00
2 AT Commands for FTP(S)
Command
AT+CFTPSSTART
AT+CFTPSSTOP
AT+CFTPSLOGIN
AT+CFTPSLOGOUT
AT+CFTPSLIST
AT+CFTPSMKD
AT+CFTPSRMD
AT+CFTPSCWD
AT+CFTPSPWD
AT+CFTPSDELE
AT+CFTPSGETFILE
AT+CFTPSPUTFILE
AT+CFTPSGET
AT+CFTPSPUT
AT+CFTPSSIZE
AT+CFTPSSINGLEIP
AT+CFTPSTYPE
AT+CFTPSSLCFG
For more detailed information, please refer to A7600 Series_AT Command Manual.
Description
Start FTP(S) service
Stop FTP(S) Service
Login to a FTP(S)server
Logout a FTP(S) server
List the items in the directory on FTP(S) server
Create a new directory on FTP(S) server
Delete a directory on FTP(S) server
Change the current directory on FTP(S) server
Get the current directory on FTP(S) server
Delete a file on FTP(S) server
Download a file from FTP(S) server to module
Upload a file from module to FTP(S) server
Get a file from FTP(S) server to serial port
Put a file to FTP(S) server through serial port
Get the file size on FTP(S) server
Set FTP(S) data socket address type
Set the transfer type on FTP(S) server
Set the SSL context id for FTPS session
www.simcom.com 7 / 18