mpiSqNodeDigitalInPtr

Declaration

int32_t mpiSqNodeDigitalInPtr(MPISqNode   sqNode,
                           int32_t        bit,
                           int32_t        *mask,
                           int32_t        **ptr);

 

Required Header: stdmpi.h

Change History: Added in 03.04.00.

Description

mpiSqNodeDigitalInPtr gets a controller memory pointer and mask of a digital input (bit on the SynqNet node sqNode) and writes them to the locations pointed to by ptr and mask. The memory pointer and mask obtained by this function can be used when setting up the data recorder or user limits.

sqNode a handle to a SynqNet node object.
bit an index to a node's digital input bit.
*mask a pointer to a bitwise mask that corresponds to the specified bit.
**ptr a pointer to a controller address that contains the digital input bit.
Return Values
MPIMessageOK
MPIMessageaARG_INVALID

Sample Code

The sample code below shows how to set up the data recorder to record bit 5 on node 1.

int32_t mask;
int32_t * pointer;
mpiSqNodeDigitalInPtr( sqNode1, 5, &mask, &pointer );


void * points[MPIRecorderADDRESS_COUNT_MAX];
points[0] = pointer;
int32_t pointCount = 1;
mpiRecorderRecordConfig(recorder,
                        MPIRecorderRecordTypePOINT,
                        pointCount,
                        points );

See Also

mpiSqNodeDigitalOutPtr | mpiSqNodeAnalogInPtr | mpiSqNodeAnalogOutPtr | MPIMotorLimitConfig | mpiRecorderRecordConfig