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