dm_geocom_api_request_setup_download Subroutine

public pure subroutine dm_geocom_api_request_setup_download(request, device_type, file_type, file_name, block_size)

Request of FTR_SetupDownload procedure. Creates request for setting up a file download.

The function has to be called before FTR_Download. If the file type is GEOCOM_FTR_FILE_UNKNOWN, an additional file path is required.

The argument device_type must be one of the following:

• GEOCOM_FTR_DEVICE_INTERNAL – Internal memory (path /ata1a/).
• GEOCOM_FTR_DEVICE_PCPARD – CF Card (path /ata0a/).

The argument file_type is usually GEOCOM_FTR_FILE_IMAGES. The maximum value for block_size is GEOCOM_FTR_MAX_BLOCKSIZE.

The instrument returns the following responses:

• grc – GeoCOM return code.
• nblocks – Number of blocks required to upload the file.

Property	Values
Instruments	TM30/TS30
ASCII request	%R1Q,23303:<device_type>,<file_type>,<file_name>,<block_size>
ASCII response	%R1P,0,0:<grc>,<nblocks>

Arguments

Type	Intent	Optional	Attributes		Name
type(request_type),	intent(out)			::	request	Prepared request.
integer,	intent(in)			::	device_type	Device type (GEOCOM_FTR_DEVICETYPE).
integer,	intent(in)			::	file_type	File type (GEOCOM_FTR_FILETYPE).
character(len=*),	intent(in)			::	file_name	File name with extension.
integer,	intent(in)			::	block_size	Block size.