User Manual

Table Of Contents
SARA-R4 series-AT commands manual
UBX-17003787 - R16
17File System
Page 202 of 401
17.7Partial download file +UDWNBLOCK
+UDWNBLOCK
SARA-R410M-02B SARA-R410M-52B SARA-R410M-63B SARA-R410M-73B SARA-R410M-83B
SARA-R412M
Modules
SARA-N4
Syntax PIN required Settings saved Can be aborted Response time Error referenceAttributes
full No No No - +CME Error
17.7.1Description
Stores (writes) a file to the file system:
The stream of bytes can be entered after the '>' prompt has been provided to the user. The file transfer is
terminated exactly when <size> bytes have been sent entered and either "OK" final result code or an error
result code is returned. The feed process cannot be interrupted i.e. the command mode is re-entered once
the user has provided the declared the number of bytes.
If the file already exists, the data will be appended to the file already stored in the file system.
If the data transfer stops, after 20 s the command is stopped and the "+CME ERROR: FFS TIMEOUT" error
result code (if +CMEE=2) is returned.
If the module shuts down during the file storing, all bytes of the file will be deleted.
If an error occurs during the file writing, the transfer is aborted and it is up to the user to delete the file.
Differently from +UDWNFILE AT command, this command allows the user to write only a portion of the
file, indicating the offset and amount of bytes.
17.7.2Syntax
Type Syntax Response Example
Set AT+UDWNBLOCK=<filename>,
<offset>,<size>,<filesize>[,<tag>]
>
<text>
OK AT+UDWNBLOCK="filename",0,36,
500,"USER"
>
The 36 downloaded bytes of the file!
OK
17.7.3Defined values
Parameter Type Description
<filename> String Filename. For file system filename and data size limits, see File system limits.
<offset> Number Offset in bytes from the beginning of the file.
<size> Number Number of bytes to be written starting from the <offset>.
<filesize> Number The size of the file to be written
<tag> String The optional parameter <tag> specifies a different application file type. FILE TAGS
table lists the allowed <tag> strings.
17.7.4Notes
The <tag> parameter is supported only for "USER".
17.8File system limits
17.8.1Allowed characters in filenames
A filename cannot contain the following characters: / * : % | " < > ?
17.8.2Limits
Here below are listed the maximum file name length, the maximum data size of the file system and the
maximum number of files for the u-blox cellular modules.
Maximum file name length: