SIM800 Series_FS_Application _V1.01
Document Title SIM800 Series_FS_Application Version 1.01 Date Status Document Control ID Release SIM800 Series_FS_ Application _V1.01 General s SIMCom offers this infmation as a service to its customers, to suppt application and engineering effts that use the products designed by SIMCom. The infmation provided is based upon requirements specifically provided to SIMCom by the customers. SIMCom has not undertaken any independent search f additional relevant infmation, including any infmation that may be in the customer s possession. Furtherme, system validation of this product designed by SIMCom within a larger electronic system remains the responsibility of the customer the customer s system integrat. All specifications supplied herein are subject to change. Copyright This document contains proprietary technical infmation which is the property of Shanghai SIMCom Wireless Solutions Ltd, copying of this document and giving it to others and the using communication of the contents thereof, are fbidden without express authity. Offenders are liable to the payment of damages. All rights reserved in the event of grant of a patent the registration of a utility model design. All specification supplied herein are subject to change without notice at any time. Copyright Shanghai SIMCom Wireless Solutions Ltd. 2014 SIM800 Series_FS_Application _V1.01 2
Contents 1. FS Introduction...5 1.1 Features...5 2. AT Commands...6 2.1 AT+FSCREATE Create File...6 2.2 AT+ FSREAD Read File...6 2.3 AT+FSWRITE Write File...7 2.4 AT+FSDEL Delete File...8 2.5 AT+FSLS List Directies/Files...8 2.6 AT+FSFLSIZE Get File Size...9 2.7 AT+FSMEM Get the Size of Available Memy...9 2.8 AT+FSRENAME Rename File...10 2.9 AT+FSDRIVE Get Drive...10 2.10 AT+FSMKDIR Make New Directy...11 2.11 AT+FSRMDIR Delete Directy...11 3 Examples...13 Appendix...15 A Related Documents...15 B Terms and Abbreviations...15 SIM800 Series_FS_Application _V1.01 3
Version Histy Date Version What is new Auth 2013-10-31 1.00 New version Yong.lu 1.01 Chapter 2.2,Modify the parameter description of AT+FSREAD Chapter 2.7,Add AT+FSMEM Chapter 2.8,Add AT+FSRENAME Chapter 2.9,Add AT+FSDRIVE Chapter 2.10,Add AT+FSMKDIR Chapter 2.11,Add AT+FSRMDIR Yong.lu Scope This document presents the AT commands of FS operation and application examples. This document can apply to SIM800 series modules, including SIM800L, SIM800H, SIM800 and SIM800-WB64. SIM800 Series_FS_Application _V1.01 4
1. FS Introduction This chapter introduces the FS application features. 1.1 Features Local stage space is mapped to the drive which can get by AT+FSDRIVE=0, the system will create User directy in local drive after first boot, and stage space of SD card is mapped to the drive which can get by AT+FSDRIVE=1. As PCM interface and SD card interface is multiplexing function, shown as below table. At the first time to use SD card, customer must execute AT+SD2PCM=0 and AT&W, then reboot the module by AT command PWRKEY pin. PCM and SD card multiplexing function: Pin name Pin number Mode 0(default) Mode 1 Mode 2 Mode 3 PCMCLK 29 PCMCLK DISP_RSTB MC3CM0 GPIO18 PCMOUT 30 PCMOUT DISP_DI MC3DA3 GPIO19 PCMSYNC 65 PCMSYNC DISP_CEB MC3CK GPIO20 PCMIN 66 PCMIN DISP_DA MC3DA2 GPIO21 GPIO2 27 GPIO2 DISP_A0DA MC3DA0 - GPIO3 28 GPIO3 DISP_CLK MC3DA1 - SIM800 Series_FS_Application _V1.01 5
2. AT Commands SIM800 series FS AT command overview. Command AT+FSCREATE AT+FSREAD AT+FSWRITE AT+FSDEL AT+FSLS AT+FSFLSIZE AT+FSMEM AT+FSRENAME AT+FSDRIVE AT+FSMKDIR AT+FSRMDIR Description Create file Read file Write file Delete file List directies/files Get file size Get the size of available memy Rename file Get drive Make new directy Delete directy 2.1 AT+FSCREATE Create File AT+FSCREATE Create File AT+FSCREATE =? AT+FSCREATE =<filename> <filename> String without double quotes, the length of the file name should be less than equal to 64 characters 2.2 AT+ FSREAD Read File AT+FSREAD Read File SIM800 Series_FS_Application _V1.01 6
AT+FSREAD=? AT+FSREAD=<f ilename>,<mode >,<filesize>,<posi tion> <data> <filename> String without double quotes, the file should have already existed. The length of the file name should be less than equal to 64 characters <mode> 0 Read data at the beginning of the file 1 Read data at the <position> of the file <filesize> The size of the file that you want to read, the size should be less than equal to 10240.If the <filesize> is me than the file real size, the <filesize> will be set to the file real size <position> The starting position that will be read in the file. The <position> should be less than the file size <data> The data which is read will be putted out by UART pt When <mode> is 0, <position> is invalid. 2.3 AT+FSWRITE Write File AT+FSWRITE Write File AT+FSWRITE=? AT+FSWRITE= <filename>,<mo de>,<filesize>,<i nputtime> > TimeOut SIM800 Series_FS_Application _V1.01 7
<filename> String without double quotes, the file should have already existed. The length of the file name should be less than equal to 64 characters. <mode> 0 Write data at the beginning of the file 1 Write data at the end of the file <filesize> The size of the file that you want to write, the size should be less than equal to 10240. <inputtime> User should write file in the <inputtime> period, otherwise the operation of writing to the file fails. Unit is second. 2.4 AT+FSDEL Delete File AT+FSDEL Delete File AT+FSDEL=? AT+FSDEL=<fil ename> <filename> String without double quotes, the file should have already existed. The length of the file name should be less than equal to 64 characters 2.5 AT+FSLS List Directies/Files AT+FSLS List Directies/Files AT+FSLS=? AT+FSLS=<filep ath> <list of subdirecties/files> SIM800 Series_FS_Application _V1.01 8
<filepath> String without double quotes, directy f selection. The length of the directy name should be less than equal to 64 characters. The string fmat such as C:\,the directy must have \ If the last character of the result string is \, this means that it is a directy, otherwise, it is a file. 2.6 AT+FSFLSIZE Get File Size AT+FSFLSIZE Get File Size AT+FSFLSIZE =? AT+FSFLSIZE= <filename> +FSFLSIZE: <n> <filename> String without double quotes, the file should have already existed. The length of the file name should be less than equal to 64 characters <n> The file size 2.7 AT+FSMEM Get the Size of Available Memy AT+ FSMEM Get the Size of Available Memy AT+FSMEM =? Execution Command AT+FSMEM If SD card exist: +FSMEM: <local_drive>:<local_size>bytes, <sd_drive>:<sd_size>bytes SIM800 Series_FS_Application _V1.01 9
If SD card doesn t exist: +FSMEM: <local_drive>:<local_size>bytes <local_drive> Local drive <sd_drive> SD card drive <local_size> The free space of local stage <sd_size> The free space of SD card <local_drive> is got by AT+FSDRIVE=0 <sd_drive> is got by AT+FSDRIVE=1. 2.8 AT+FSRENAME Rename File AT+FSRENAME Rename File AT+FSRENAM E =? AT+FSRENAM E=<old_name>,< new_name> <old_name> Old name of specified file, string without double quotes, the file should have already existed. The length of the file name should be less than equal to 64 characters <new_name> New name of specified file, string without double quotes. The length of the file name should be less than equal to 64 characters The file name must be full path name. 2.9 AT+FSDRIVE Get Drive AT+FSDRIVE Get Drive AT+FSDRIVE +FSDRIVE: (0-1) SIM800 Series_FS_Application _V1.01 10
=? AT+FSDRIVE=< n> +FSDRIVE: <drive> <n> 0 Local drive 1 SD card drive <drive> A-G 2.10 AT+FSMKDIR Make New Directy AT+FSMKDIR Make New Directy AT+FSMKDIR =? AT+FSMKDIR= <dir_name> <dir_name> String without double quotes. The length of the dir name should be less than equal to 64 characters. 2.11 AT+FSRMDIR Delete Directy AT+FSRMDIR Delete Directy AT+FSRMDIR=? SIM800 Series_FS_Application _V1.01 11
AT+FSRMDIR= <dir_name> <dir_name> String without double quotes, the dir should have already existed. The length of the dir name should be less than equal to 64 characters SIM800 Series_FS_Application _V1.01 12
3 Examples In the "Grammar" columns of following tables, input of AT commands are in black, module return values are in blue. Grammar AT+SD2PCM=0 AT&W AT+CFUN=1,1 AT+FSDRIVE=1 +FSDRIVE: E Description SD mode is valid In this example, reboot the module by AT command, customer can reboot the module by PWRKEY pin instead of AT command Get SD card drive AT+FSLS=E:\ Images\ Audio\ AT+FSCREATE=E:\test.txt AT+FSLS=E:\ Images\ Audio\ test.txt Create test.txt AT+FSFLSIZE=E:\test.txt +FSFLSIZE: 20 AT+FSREAD=E:\test.txt,0,100,1 asdfghjkloiytedftttg AT+FSWRITE=E:\test.txt,0,2,10 > Write cc at the beginning of the file SIM800 Series_FS_Application _V1.01 13
AT+FSREAD=E:\test.txt,0,100,0 ccdfghjkloiytedftttg AT+FSREAD=E:\test.txt,1,100,2 dfghjkloiytedftttg AT+FSMEM +FSMEM: C:1024bytes,E:49152bytes The first two characters is cc The offset of reading position is 2 AT+FSLS=E:\ test1.txt AT+FSMKDIR=E:\media AT+FSRENAME=E:\test1.txt,E:\test2.txt AT+FSLS=E:\ test2.txt media\ AT+FSRMDIR=E:\media AT+FSLS=E:\ test2.txt Make media directy Rename test1.txt Delete media directy SIM800 Series_FS_Application _V1.01 14
Appendix A Related Documents SN Document name Remark [1] SIM800 Series_AT Command Manual B Terms and Abbreviations Abbreviation Description SIM800 Series_FS_Application _V1.01 15
Contact us: Shanghai SIMCom Wireless Solutions Co.,Ltd. Address: Building A, SIM Technology Building, No. 633, Jinzhong Road, Shanghai, P. R. China 200335 Tel: +86 21 3252 3300 Fax: +86 21 3252 3020 URL: www.sim.com/wm SIM800 Series_FS_Application _V1.01 16