usecBusyWait(9DKI)

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | EXTENDED DESCRIPTION | Allowed Calling Contexts | ATTRIBUTES | SEE ALSO

NAME

usecBusyWait- precise busy wait service

SYNOPSIS

#include <dki/dki.h>

void usecBusyWait(unsigned int micro);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

FEATURES

DKI

DESCRIPTION

Provides precise busy wait services.

EXTENDED DESCRIPTION

Device drivers may use precise busy wait services to wait for a very short time.

---

Note -

Busy wait means that the caller waits without releasing the CPU, as if executing a busy loop.

---

This service may be used by a driver to comply with a specific timing of its device (accessing a serial ROM), or to wait until a command has executed on the device before starting another one (resetting a device).

usecBusyWait waits for at least micro microseconds before returning.

micro must be in the range of 1 and 1000. Behavior is unpredictable for values out of that range.

Allowed Calling Contexts

The following table specifies the contexts in which a caller is allowed to invoke each service:

Services	Base level	DKI thread	Interrupt	Blocking
usecBusyWait	+	+	+	-

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

svDkiThreadCall(9DKI)

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | EXTENDED DESCRIPTION | Allowed Calling Contexts | ATTRIBUTES | SEE ALSO