mpiSqNodeDigitalOutPtr

Declaration

long mpiSqNodeDigitalOutPtr(MPISqNode   sqNode,
                            long        bit,
                            long        *mask,
                            long        **ptr);

 

Required Header: stdmpi.h

Change History: Added in 03.04.00.

Description

mpiSqNodeDigitalOutPtr gets a controller memory pointer and mask of a digital output (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 output 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.

long mask;
long * pointer;
mpiSqNodeDigitalOutPtr( sqNode1, 5, &mask, &pointer );


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

See Also

mpiSqNodeDigitalInPtr | mpiSqNodeAnalogInPtr | mpiSqNodeAnalogOutPtr | MPIMotorLimitConfig | mpiRecorderRecordConfig