logo资料库

A7600 Series_FTP(S)_Application Note_V1.00.pdf

第1页 / 共18页
第2页 / 共18页
第3页 / 共18页
第4页 / 共18页
第5页 / 共18页
第6页 / 共18页
第7页 / 共18页
第8页 / 共18页
资料共18页,剩余部分请下载后查看
About Document
Version History
Scope
Contents
1 Introduction
1.1 Purpose of the document
1.2 Related documents
1.3 Conventions and abbreviations
1.4 The process of Using FTP(S) AT Commands
1.5 Error Handling
1.5.1 Executing FTP(S) AT Commands Fails
1.5.2 PDP Activation Fails
1.5.3 Error Response of FTP(S) Server
2 AT Commands for FTP(S)
3 FTP(S) Examples
3.1 FTP Function
3.1.1 Download a file from FTP server to module/Upload a file to FTP server from module
3.1.2 Download a file from FTP server to serial port/Upload a file from serial port to FTP server
3.1.3 Directory Operations
3.2 FTPS Function
3.2.1 Download a file from FTPS server to module/Upload a file to FTPS server from module
3.2.2 Download a file from FTPS server to serial port/Upload a file from serial port to FTPS server
3.2.3 Directory Operations
4 Appendix
4.1 Summary of Error Codes
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
分享到:
收藏