--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/bluetooth/btcomm/src/btcommutil.h	Fri Jan 15 08:13:17 2010 +0200
@@ -0,0 +1,63 @@
+// Copyright (c) 1999-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "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:
+//
+
+#ifndef BTCOMMUTIL_H__
+#define BTCOMMUTIL_H__
+
+_LIT(KBTCommPanicName, "BTComm Panic");
+
+enum TBTCommPanic
+	{
+	EBTCommBadEventForThisState, // we should have never received this event in this state
+	EBTCommPortBufferTerminatorCharNoOtherThanExpected,
+	EBTCommPortBufferTerminatedCharsFoundBogus,
+	EBTCommPortReaderPotentialLossOfIncomingData,
+	EBTCommOpenStateWriteToClientPossibleLossOfData,
+	EBTCommCloseWhileWaitingForSockServHandle,
+	EBTCommESockSessionAttachNotDone,
+	EBTCommPortStateOutOfBounds
+	};
+	
+/**
+Panics raised by state machine default behaviour are multiplied by this
+factor.  The less signifigant digits are then available to carry a state
+index, allowing more information when fixing defects.
+
+For example, a bad event passed to the BTComm state machine may raise panic
+'BTComm Panic 1008' if it occurs in the 'Connecting' state.
+*/
+const TInt KStatePanicMultiplier = 10000;
+
+/**
+A delimiter to prevent a panic code of 0 creating ambigious panics.
+Without this panic code 0 in state 8 and panic code 8 (not in the state 
+machine) would be identical.
+*/
+const TInt KStatePanicDelimiter = 1000; // '1' is the delimiter
+
+/**
+If for any reason the current state cannot be found, this value is placed
+in the state field of a panic.
+*/
+const TInt KUnknownState = KStatePanicDelimiter - 1;
+
+class BTCommUtil
+	{
+public:
+	static void Panic(TBTCommPanic aPanic);
+	static void Panic(TBTCommPanic aPanic, TInt aState);
+	};
+
+#endif