File Access

File Access

The file access interface allows access to the cameras file system.

It provides access to the cameras user set files, LUT files and a user definable file.

Usage of the file access features and registers should not be attempted directly. Instead access the file system through the file access interface of the host application.

There are three user set files (UserSetDefault, UserSet0, and UserSet1). The user set files are treated differently than the other files in the system. When uploaded these files modify the user set setting within the camera. If the user set file is from an older version of the camera or a different model, the user sets within the file are converted to the appropriate user sets for the new firmware. The file is then replaced with the updated user set file. If the file contains user sets that are not appropriate for the firmware version on the camera, they are ignored and discarded. If the file has been modified in any way, the file is discarded and regenerated. UserSetDefault is read-only and cannot be modified.

The UserFile1 is a user definable file.

The SerialPort0 is a file that can be transferred via the serial port.

While a file is open within the file access interface, the camera is not able to start acquisition. Also, the FileAccessExecute command is disabled when the camera is in acquisition mode. Care should be taken to not leave any file open within the camera's file system as it disables the start acquisition register without any feedback as to why.

Summary Table

Name Interface Access Visibility Description
File Selector IEnumeration RW Guru Selects which file is being operated on. This must be set before performing any file operations.
File Operation Selector IEnumeration RW Guru Sets operation to execute on the selected file when the execute command is given.
File Write To Flash IBoolean Guru
File Operation Execute ICommand WO Guru This is a command that executes the selected file operation on the selected file.
File Open Mode IEnumeration RW Guru The mode of the file when it is opened. The file can be opened for reading, writting or both. This must be set before opening the file.
File Access Buffer IRegister RW Guru Defines the intermediate access buffer that allows the exchange of data between the device file storage and the application.
File Access Offset IInteger RW Guru Controls the Offset of the mapping between the device file storage and the FileAccessBuffer.
File Access Length IInteger RW Guru Controls the Length of the mapping between the device file storage and the FileAccessBuffer.
File Operation Status IEnumeration RO Guru Represents the file operation execution status.
File Operation Result IInteger RO Guru Represents the file operation result. For Read or Write operations, the number of successfully read/written bytes is returned.
File Size IInteger RO Guru Represents the size of the selected file in bytes.
File System Command IEnumeration RW Guru Specifies the low level file system command to execute.
File System Command Execute ICommand WO Guru This is a command that executes the selected file system command.
File System Command Result IStringReg

File Access Features


File Selector

Selects which file is being operated on. This must be set before performing any file operations.

Property Value
Name FileSelector
Interface IEnumeration
Access RW
Visibility Guru

Enumeration Values
UserSetDefault
UserSet0
UserSet1
UserFile1
InjectedImage
SerialPort0

File Operation Selector

Sets operation to execute on the selected file when the execute command is given.

Property Value
Name FileOperationSelector
Interface IEnumeration
Access RW
Visibility Guru

Enumeration Values
Open
Close
Read
Write
Delete

File Write To Flash

Property Value
Name FileWriteToFlash
Interface IBoolean
Access
Visibility Guru

File Operation Execute

This is a command that executes the selected file operation on the selected file.

Property Value
Name FileOperationExecute
Interface ICommand
Access WO
Visibility Guru

File Open Mode

The mode of the file when it is opened. The file can be opened for reading, writting or both. This must be set before opening the file.

Property Value
Name FileOpenMode
Interface IEnumeration
Access RW
Visibility Guru

Enumeration Values
Read
Write
ReadWrite

File Access Buffer

Defines the intermediate access buffer that allows the exchange of data between the device file storage and the application.

Property Value
Name FileAccessBuffer
Interface IRegister
Access RW
Visibility Guru

File Access Offset

Controls the Offset of the mapping between the device file storage and the FileAccessBuffer.

Property Value
Name FileAccessOffset
Interface IInteger
Access RW
Unit B
Visibility Guru

File Access Length

Controls the Length of the mapping between the device file storage and the FileAccessBuffer.

Property Value
Name FileAccessLength
Interface IInteger
Access RW
Unit B
Visibility Guru

File Operation Status

Represents the file operation execution status.

Property Value
Name FileOperationStatus
Interface IEnumeration
Access RO
Visibility Guru

Enumeration Values
Success
Failure
Overflow

File Operation Result

Represents the file operation result. For Read or Write operations, the number of successfully read/written bytes is returned.

Property Value
Name FileOperationResult
Interface IInteger
Access RO
Unit
Visibility Guru

File Size

Represents the size of the selected file in bytes.

Property Value
Name FileSize
Interface IInteger
Access RO
Unit B
Visibility Guru

File System Command

Specifies the low level file system command to execute.

Property Value
Name FileSystemCommand
Interface IEnumeration
Access RW
Visibility Guru

Enumeration Values
NoCommand
SaveDdrToFlash

File System Command Execute

This is a command that executes the selected file system command.

Property Value
Name FileSystemCommandExecute
Interface ICommand
Access WO
Visibility Guru

File System Command Result

Property Value
Name FileSystemCommandResult
Interface IStringReg
Access
Visibility