 |
 |
|---|---|
GigE |
GigE |
Syntax
INT is_SetStarterFirmware (HIDS hDev, const CHAR* pcFilepath, UINT uFilepathLen)
Description
|
This function is obsolete and should not be used anymore. We recommend to use the is_InitCamera() function with the IS_ALLOW_STARTER_FW_UPLOAD parameter instead. |
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 |
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 |
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));
