is_SetStarterFirmware


GigE	GigE

Syntax

INT is_SetStarterFirmware (HIDS hDev, const CHAR* pcFilepath, UINT uFilepathLen)

Description

Using is_SetStarterFirmware(), you can update the starter firmware of a connected camera. This is also possible from within the IDS Camera Manager.

The starter firmware determines the start-up behaviour of the GigE uEye camera. We recommend that you do not update the starter firmware unless an older firmware version causes start-up problems. If you have questions on the current starter firmware, please contact the machine vision consulting.

Input parameters

hDev	DevID \| IS_USE_DEVICE_ID DevID = internal device ID of the camera from the UEYE_CAMERA_INFO structure (see also is_GetCameraList())
pcFilepath	Pointer to a null-terminated ASCII string that contains the full file path.
uFilepathLen	Length of the file path (in bytes).

The is_SetStarterFirmware() function does not accept a camera handle in the hDev parameter. In the call, please use the internal device ID as described below.

Return values

IS_BAD_STRUCTURE_SIZE	An internal structure has an incorrect size.
IS_CANT_OPEN_DEVICE	An attempt to initialize or select the camera failed (no camera connected or initialization error).
IS_INVALID_PARAMETER	One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode.
IS_IO_REQUEST_FAILED	An IO request from the uEye driver failed. Possibly the versions of the ueye_api.dll (API) and the driver file (ueye_usb.sys or ueye_eth.sys) do not match.
IS_NOT_SUPPORTED	The camera model used here does not support this function or setting.
IS_SUCCESS	Function executed successfully

Related functions

•is_GetCameraList()

•is_GetDuration()

•is_InitCamera()

Example

// Prepare the data parameter.

const CHAR kFilepath[]= "c:\\ids\\firmware.fw";

// Prepare the handle parameter. Mark the given device id with IS_USE_DEVICE_ID.

HIDS hDev = (HIDS)( dwDeviceID | IS_USE_DEVICE_ID);

INT nRet = is_SetStarterFirmware( hDev, kFilepath, sizeof(kFilepath));

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!
For technical questions please contact your local distributor or use the support form on our website.