2.5.9. ARMTAP_ClockARM

Clock an ARM processor core a specified number of times.

Note

This function is deprecated. The first use by a connection causes a warning message to appear in the Multi-ICE server log window. It might not be supported in future releases. Typically, you can use the nClks parameter of another ARMTAP API function for the same effect.

Syntax

#include “tapop.h”

extern TAPOp_Error ARMTAP_ClockARM(unsigned8 connectId, unsigned8 nClks, unsigned8 deselect);

where:

connectId

Connection ID, as returned by TAPOp_OpenConnection.

nClks

The number of ARM processor core clocks to generate:

0 <= nClks <= 31

deselect

If 0, the connection to this TAP controller remainsselected. This excludes access to this TAP controller from other Multi-ICE server connections. Otherwise, the connection is deselected, giving other connections a chance to perform operations.

Return

The function returns:

TAPOp_NoError

No error.

TAPOp_UnableToSelect

Connection could not be made.

TAPOp_NoSuchConnection

The connectId was not recognized.

TAPOp_BadParameter

Failed because:

  • nClks > 31.

TAPOp_InBadTAPState

The TAP controller was reset or is not in Select-DR-Scan.

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.

This function writes INTEST into the IR as it has to go through either the DR or IR states to get to Run-Test/Idle. It is usually more efficient to call one of the ARMTAP_AccessDR functions that combines DCLKs with the DR access. The TAP controller must be in Select-DR-Scan state before the function is used, and is left in this state after the function has been performed.

If another connection on the same Multi-ICE server resets the TAP controllers by calling TAPOp_AnySequence_W, or TAPOp_AnySequence_RW, or TAPOp_TestResetSignal, all subsequent calls to ARMTAP_ClockARM are rejected with the error TAPOp_InBadTAPState until the reset is acknowledged. See TAPOp_AnySequence_W for more details.

See also

These TAPOp API functions provide similar or related functionality:

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