background image

                                                                                                                                             

UMTS/HSPA  Module  Series 

                                                                                          WCDMA  UGxx  FILE  AT  Commands  Manual

 

 

WCDMA_UGxx_FILE_AT_Commands_Manual                      Confidential / Released                    18 / 19   

 
 

 

4

 

Appendix  A  Summary  of  <err>  Code 

 

The result of the final error code 

is “+CME ERROR: <err>”. <err> indicates an error relating to the ME or 

Network.  The  operation  is  similar  to  Error  result  code.  It  will  be  returned  when  some  definition  error 

happens. The <err> codes listed here are just related to UGxx module of the File. 

 

Table 1: Summary of Error Code 

<err> 

Meaning 

400   

invalid input value       

401 

larger than the size of the file 

402 

read zero bytes 

403 

drive full 

405 

file not found 

406 

invalid file name 

407 

file already exists 

409 

fail to write the file 

410 

fail to open the file 

411 

fail to read the file 

413  

reach the max number of file allowed to be opened 

414 

the file read-only 

416 

invalid file descriptor 

417 

fail to list the file 

418 

fail to delete the file 

419 

fail to get disk info   

Quectel 

Confidential

Summary of Contents for WCDMA UG FILE Series

Page 1: ...WCDMA UGxx FILE AT Commands Manual UMTS HSPA Module Series Rev WCDMA_UGxx_FILE_AT_Commands_Manual_V1 3 Date 2016 05 05 www quectel com ...

Page 2: ...OMERS THE INFORMATION PROVIDED IS BASED UPON CUSTOMERS REQUIREMENTS QUECTEL MAKES EVERY EFFORT TO ENSURE THE QUALITY OF THE INFORMATION IT MAKES AVAILABLE QUECTEL DOES NOT MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN AND DOES NOT ACCEPT ANY LIABILITY FOR ANY INJURY LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR RELIANCE UPON THE INFORMATION ALL INFORMATION SUPPLIED HEREIN IS SUBJECT ...

Page 3: ...leased 2 19 About the Document History Revision Date Author Description 1 0 2014 12 10 Jonathan WEN Initial 1 1 2015 03 02 Bonnie ZHAO Changed the document name from UG95 to UGxx 1 2 2015 04 01 Bonnie ZHAO Updated applicable modules 1 3 2016 05 05 Sophie ZHU Changed filename into file_name Quectel Confidential ...

Page 4: ... to the Storage 8 2 5 AT QFDWL Download the File from the Storage 10 2 6 AT QFOPEN Open the File 11 2 7 AT QFREAD Read the File 12 2 8 AT QFWRITE Write the File 12 2 9 AT QFSEEK Seek the File 13 2 10 AT QFPOSITION Get the Offset of the File Pointer 14 2 11 AT QFTUCAT Truncate the File from the File Pointer 14 2 12 AT QFCLOSE Close the File 15 3 Example 16 3 1 Upload and Download Files 16 3 1 1 Upl...

Page 5: ...UMTS HSPA Module Series WCDMA UGxx FILE AT Commands Manual WCDMA_UGxx_FILE_AT_Commands_Manual Confidential Released 4 19 Table Index TABLE 1 SUMMARY OF ERROR CODE 18 Quectel Confidential ...

Page 6: ... file can be written or read at any time and any location until the file is closed by AT QFCLOSE When the file is opened by command AT QFOPEN you can set the file as overwrite mode or read only mode or others by the parameter mode For more information about mode see Section 2 6 After the file is opened a file_handle is assigned to this file Then you can operate this file via this file_handle After...

Page 7: ...LDS 524288 524288 OK AT QFLDS Get the Space Information of the Storage Test Command AT QFLDS Response OK Write Command AT QFLDS name_pattern Response QFLDS free_size total_size OK or CME ERROR err Execution Command AT QFLDS Response QFLDS free_size total_size OK name_pattern Pattern RAM RAM files in the random storage free_size The size of the free space in name_pattern total_size The total size o...

Page 8: ... QFLST List Files Test Command AT QFLST Response OK Write Command AT QFLST name_pattern Response QFLST file_name file_size QFLST file_name file_size OK or CME ERROR err Execution Command AT QFLST Response Return the information of the RAM files QFLST file_name file_size QFLST file_name file_size OK or CME ERROR err name_pattern The file to be listed RAM All the files in RAM RAM file_name The speci...

Page 9: ...ansmission mode The data uploaded reaches the file_size The time without any data inputted reaches timeout When the data is transmitted the DTR PIN AT D1 should be set is pulled high or the valid is inputted 3 To prevent the from being misinterpreted as data it should comply to the following sequence Do not input any character within T1 time 1 second before inputting Input during 1s and no other c...

Page 10: ...odule outputs CONNECT 3 MCU sends 1K bytes data and then the module will respond with an A OK Write Command AT QFUPL file_name file_size timeout ackmode Response CONNECT TA switches to the transparent access mode and the binary data of file can be inputted When the total size of the inputted data reaches file_size unit byte TA will return to command mode and reply the following codes QFUPL upload_...

Page 11: ...on bitwise XOR AT QFDWL Download the File from the Storage Test Command AT QFDWL Response QFDWL file_name OK Write Command AT QFDWL file_name Response CONNECT TA switches to data mode and the bin data of the file will be outputted When the file is read over TA will return to command mode and reply the following codes QFDWL download_size checksum OK or CME ERROR err file_name The name of the file t...

Page 12: ...ode Response QFOPEN file_handle OK or CME ERROR err file_name The file to be operated The max length is 80 bytes RAM file_name The operated file in the RAM file_handle The handle of the file The data type is 4 bytes mode The open mode of the file Default is 0 0 If the file does not exist it will be created if the file exists it will be directly opened And both of them can be read and written 1 If ...

Page 13: ...e Command AT QFREAD file_handle length Response CONNECT read_length TA switches to data mode When the total size of the data reaches length unit byte TA will return to command mode display the result and then reply the following codes OK or CME ERROR err file_handle The handle of the file to be operated length The length of the file to be read out and the default is the file length read_length The...

Page 14: ...he default length is 10K The range of this parameter is same with the free_size of the AT QFUPL timeout The time of waiting data to be inputted to USB UART Default is 5s written_length The actual written length total_length The total length of the file err The error code from the module see the Appendix A AT QFSEEK Seek the File Test Command AT QFSEEK Response QFSEEK file_handle offset position OK...

Page 15: ...h is relevant to the file handle Parameter 2 11 AT QFTUCAT Truncate the File from the File Pointer AT QFTUCAT will truncate all the data behind the position that the file pointer indicates err The error code from the module see the Appendix A AT QFPOSITION Get the Offset of the File Pointer Test Command AT QFPOSITION Response QFPOSITION file_handle OK Write Command AT QFPOSITION file_handle Respon...

Page 16: ... unless open the file again with AT QFOPEN Parameter OK Write Command AT QFTUCAT file_handle Response OK or CME ERROR err file_handle The handle of the operated file err The error code from the module see the Appendix A AT QFCLOSE Close the File Test Command AT QFCLOSE Response QFCLOSE file_handle OK Write Command AT QFCLOSE file_handle Response OK or CME ERROR err file_handle The handle of the op...

Page 17: ... 1 1 2 ACK Mode The ACK mode can make the data transmission more reliable When transmitting the large file without hardware flow control the ACK mode is used to prevent the data from being lost About the ACK mode please refer to the details of AT QFUPL AT QFUPL RAM test txt 3000 5 1 Upload the text file RAM test txt to RAM CONNECT input file bin data of 1024bytes A After receiving 1024bytes data t...

Page 18: ... Write and Read the File 3 2 1 Write and Read RAM File AT QFLDS RAM Query the space information of RAM QFLDS 524288 524288 OK AT QFOPEN RAM 1 0 Open the file in the RAM QFOPEN 3000 OK AT QFWRITE 3000 10 Write 10 bytes to the file CONNECT Write Data QFWRITE 10 10 The actual written bytes and the size of the file are returned OK AT QFSEEK 3000 0 0 Set the file pointer to the beginning of the file OK...

Page 19: ...ns The err codes listed here are just related to UGxx module of the File Table 1 Summary of Error Code err Meaning 400 invalid input value 401 larger than the size of the file 402 read zero bytes 403 drive full 405 file not found 406 invalid file name 407 file already exists 409 fail to write the file 410 fail to open the file 411 fail to read the file 413 reach the max number of file allowed to b...

Page 20: ... Series WCDMA UGxx FILE AT Commands Manual WCDMA_UGxx_FILE_AT_Commands_Manual Confidential Released 19 19 420 no space 421 time out 423 file too large 425 invalid parameter 426 file already opened Quectel Confidential ...

Reviews: