Start » Filter Reference » GigE Vision » GigEVision_UploadFile

GigEVision_UploadFile


Module: GenICam

Uploads a file to a GigEVision device using the File Access Control interface.

Name Type Description
Input value
inAddress GevAddress GigE Vision Device identifying address (IP, MAC or Serial Number)
Input value
inFileName String Name of the file to write to
Input value
inBuffer ByteBuffer Content of the file that will be uploaded

Description

This filter is intended for cooperation with a GigE Vision® compliant devices. Its purpose is to upload a file into the device using the GenICam File Access Control interface. The device must be implementing the File Control Access interface as specified by the GenICam Standard Function Naming Convention (SFNC) standard for the filter to work.

Device address (inAddress port) is a textual definition of either IP, MAC or serial number. Use Device Manager (click "..." button in filter properties) to select the appropriate address of a connected device. For information on address type meaning and selecting device address see Device manager section in user manual.

The inFileName input specifies the name of the file to be overwritten. Available file names can be determined by examining the allowed values of the FileSelector parameter in the device parameters tree.

The entire file is overwritten with data from the inBuffer input. This filter will first attempt to perform a "Delete" operation on the file, then it will upload the entire data from the inBuffer input ByteBuffer, starting from the zero offset.

This filter does not maintain the connection with the device. When there are no other active GigE Vision filters connected with the same device, the connection will be closed after the filter execution is finished.

For general information about working with GigE Vision devices, please refer to the following article.

Hints

  • Interactively select a camera available in your network by defining the inAddress input.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Empty file name on input of GigEVision_UploadFile.

Complexity Level

This filter is available on Advanced Complexity Level.

Disabled in Lite Edition

This filter is disabled in Lite Edition. It is available only in full, Aurora Vision Studio Professional version.

See Also

  • Application Notes - set of documents about connecting devices or establishing communication with Aurora Vision Studio.