// Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of the License "Eclipse Public License v1.0"

// which accompanies this distribution, and is available

// at the URL "http://www.eclipse.org/legal/epl-v10.html".

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

// e32test\nkernsa\nkutils.h

// 

//

#ifndef __NKUTILS_H__

#define __NKUTILS_H__

#include <nk_priv.h>

#include <nktest/utils.h>

#ifndef __SMP__

class NThreadGroup;

#endif

enum TExitCallBackInstance

	{

	EInContext=0,

	EBeforeFree=1,

	EAfterFree=2,

	};

typedef TInt NRequestStatus;

typedef void (*TExitFunc)(TAny*, NThread*, TInt);

extern NThread* CreateThread(const char* aName, NThreadFunction aFunc, TInt aPri, const TAny* aParams, TInt aPSize, TBool aResume, TInt aTimeslice, TExitFunc aExitFunc=0, TAny* aExitParam=0, TUint32 aCpuAffinity=0, NThreadGroup* aGroup=0);

extern NThread* CreateThreadSignalOnExit(const char* aName, NThreadFunction aFunc, TInt aPri, const TAny* aParams, TInt aPSize, TInt aTimeslice, NFastSemaphore* aExitSem, TUint32 aCpuAffinity, NThreadGroup* aGroup=0);

extern NThread* CreateUnresumedThreadSignalOnExit(const char* aName, NThreadFunction aFunc, TInt aPri, const TAny* aParams, TInt aPSize, TInt aTimeslice, NFastSemaphore* aExitSem, TUint32 aCpuAffinity, NThreadGroup* aGroup=0);

extern void CreateThreadAndWaitForExit(const char* aName, NThreadFunction aFunc, TInt aPri, const TAny* aParams, TInt aPSize, TInt aTimeslice, TUint32 aCpuAffinity=0, NThreadGroup* aGroup=0);

extern TDfcQue* CreateDfcQ(const char* aName, TInt aPri, TUint32 aCpuAffinity=0, NThreadGroup* aGroup=0);

extern void DestroyDfcQ(TDfcQue* aQ);

extern void FMWaitFull(NFastMutex* aMutex);

extern void FMSignalFull(NFastMutex* aMutex);

extern TInt WaitWithTimeout(NFastSemaphore* aS, TUint32 aTimeout);

extern "C" TInt __timer_period();

extern "C" TInt __microseconds_to_timeslice_ticks(TInt us);

extern "C" TInt __fast_counter_to_timeslice_ticks(TUint64 aFCdelta);

const TInt KStackSize = 4096;

const TInt KTimeslice = 20000;	// microseconds

const TUint32 KMinTimeout = 1;

#ifdef __SMP__

const TInt KSmallTimeslice = 500;

#else

const TInt KSmallTimeslice = 2;

#endif

extern void WaitForRequest(NRequestStatus& aStatus);

extern void RequestComplete(NThread* aThread, NRequestStatus*& aStatus, TInt aValue);

extern void InitBTraceHandler();

extern void DumpBTraceBuffer();

extern void StartBTrace();

extern void StopBTrace();

extern "C" void CheckPoint();

#define __CHECKPOINT()	CheckPoint()

#endif