ReadMemory

This FB reads consecutive memory locations from the camera. Requires an open control channel (e.g. by calling FB_VN_GevCameraControl.OpenCamera() before)

Syntax

Constructor:

ReadMemory(
    OTCID oidITcVnGevImageProvider
)

Execute main:

FB_Main()

FB_Main(
    GVCP_REGISTER_ADDRESS nAddress,
    USHORT                nLength,
    PVOID                 pBuffer,
    bool                  bRead
)

FB_Main(
    bool bRead
)

ReadMemory 1: Inputs

Name

Type

Default

Description

nAddress

GVCP_REGISTER_ADDRESS

 

The address of the first byte to read from the camera (must be 32-bit aligned)

nLength

USHORT

 

The number of bytes to read, starting with nAddress (must be a multiple of 4, not more than 536)

pBuffer

PVOID

 

Pointer to the buffer where the read memory content is written to (The buffer must have a size of at least nLength bytes!)

bRead

bool

 

Reading the memory is triggered by a rising edge at this input.

nTimeout

unsigned int

VISION_ADS_TIMEOUT

Indicates the time before the function is cancelled.

ReadMemory 2: 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

ULONG

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.

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1. 4024.44 or later

PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision