FB_VN_WriteMemory
This FB writes data to consecutive memory locations on the camera. Requires an open control channel (e.g. by calling FB_VN_GevCameraControl.OpenCamera() before)
Syntax
Definition:
FUNCTION_BLOCK FB_VN_WriteMemory
VAR_INPUT
nAddress : GVCP_REGISTER_ADDRESS;
nLength : UINT;
pData : PVOID;
bWrite : BOOL;
nTimeout : TIME;
END_VAR
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrorId : UDINT;
nBytesWritten : UINT;
END_VAR
VAR
oidITcVnGevImageProvider : OTCID;
END_VAR
Inputs
Name |
Type |
Default |
Description |
---|---|---|---|
nAddress |
|
The address of the first byte to write to the camera (must be 32-bit aligned) | |
nLength |
UINT |
|
The number of bytes to write, starting at nAddress (must be a multiple of 4, not more than 536) |
pData |
PVOID |
|
Pointer to the data that should be written to the camera (must have a size of at least nLength bytes!) |
bWrite |
BOOL |
|
Writing the memory is triggered by a rising edge at this input. |
nTimeout |
TIME |
VISION_ADS_TIMEOUT |
Indicates the time before the function is cancelled. |
Outputs
Name |
Type |
Description |
---|---|---|
bBusy |
BOOL |
This output remains TRUE until the function block has executed a command, but at the longest for the duration supplied to the 'nTimeout' input. While bBusy = TRUE, no new command will be accepted at the inputs. |
bError |
BOOL |
This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in ‘nErrorId’. If the function block has a timeout error, 'bError' is TRUE and 'nErrorId' is 1861 (hexadecimal 0x745). Is reset to FALSE by the execution of a command at the inputs. |
nErrorId |
UDINT |
Contains the ADS error code or the command-specific error code of the last executed command. Is reset to 0 by the execution of a command at the inputs. |
nBytesWritten |
UINT |
The number of bytes that have been successfully written to the camera. |
Weiterführende Informationen
Offener Kamera-Control-Channel nötig! Um diesen Funktionsblock benutzen zu können, muss der Control Channel der GigE Vision Kamera offen sein. Zudem können einige Kamera-Parameter nur geändert werden, wenn die Bild-Akquisition gestoppt ist. Daher wird empfohlen, die Kamera zuvor in den State TCVN_CS_OPENED zu bringen. |
Parameter
nAddress
Die Register-Adresse identifiziert das zu adressierende Register der Kamera. Sie ist vom Typ GVCP_REGISTER_ADDRESS
, welcher ein Alias auf den Typ UDINT
ist. Damit haben alle Register-Adressen eine Größe von 4 Bytes. Die Register-Adresse eines Kamera-Parameters können Sie an entsprechender Stelle im Konfigurationsbaum der GigE Vision Kamera Instanz nachsehen:
Required License
TC3 Vision Base
System Requirements
Development environment | Target platform | PLC libraries to include |
---|---|---|
TwinCAT V3.1.4024.59 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |