2.5.42. TAPOp_WriteCommonData

Writes to the data block that is common to all the clients connected to the server.

Syntax

#include “tapop.h”

extern TAPOp_Error TAPOp_WriteCommonData(unsigned8 connectId, unsigned32 *commonBlk, unsigned8 deselect);

where:

connectId

Connection ID, as returned by TAPOp_OpenConnection.

commonBlk

Four words of common data, with a meaning definedby the client.

deselect

If 0, the connection to this TAP controller remains selected, so excluding access by other TAP controller connections. Otherwise, the connection is deselected, giving other connections a chance to perform operations.

Returns

The function returns:

TAPOp_NoError

No error.

TAPOp_UnableToSelect

Connection could not be made.

TAPOp_NoSuchConnection

The connectId was not recognized.

TAPOp_RPC_Connection_Fail

The RPC connection was lost while processing this request.

Usage

The call attempts to select the connection. If this cannot be done (for example, because another TAP controller is being accessed), the call fails with a TAPOp_UnableToSelect error.

To safely write to the common data block, use an atomic Read-Modify-Write sequence. You can make a call of TAPOp_ReadCommonData and TAPOp_WriteCommonData atomic by setting the deselect parameter of the TAPOp_ReadCommonData call to zero.

See also

These TAPOp API functions provide similar or related functionality:

Copyright © 1998-2002 ARM Limited. All rights reserved.ARM DUI 0154B
Non-Confidential