work on docu

bsl/csl/interfaces/pin.h

@@ -73,38 +73,39 @@ typedef enum
 	veryFast	/*!< set pin's speed to **Very Fast** */
 }pinSpeed_t;
 
+/*! Enum to enable ordisable pin interrupt */
 typedef enum 
 {
-	disabled,
+	disabled,	/*!< Interrupt disabled */
-	enabled 
+	enabled		/*!< Interrupt enabled */ 
 }pinInterrupt_t;
 
+/*! Pin configuration typedef struct*/
 typedef struct 
 {
-	pinMode_t md; 
+	pinMode_t md;			/*!< Pin mode */
-	pinStage_t st;
+	pinStage_t st;			/*!< Pin logic state */
-	pinPullUpDown_t pud;
+	pinPullUpDown_t pud;	/*!< Pin pullup pulldown status */
-	pinSpeed_t sp;
+	pinSpeed_t sp;			/*!< Pin busspeed */
-	pinInterrupt_t intr; 
+	pinInterrupt_t intr;	/*!< Pin interrupt enable state */
 }pinConfiguration_t;
 
-
+/*! Typedef enum of all possible pin errors */
-typedef enum 
+typedef enum {
-{
+	notValidMode,			/*!< Mode is either not valid orsupported by **Hardwaware** */
-	notValidMode,
+	UnvalidAlternate,		/*!< Alternateive mode is unvalid */
-	UnvalidAlternate,
+	OutOfRangeAlternate,	/*!<  */
-	OutOfRangeAlternate,
+	NotValidSpeed,			/*!< The choosen bus speed is not supported */
-	NotValidSpeed, 
+	notValidOut,			/*!<  */
-	notValidOut,
+	OutOfRange,				/*!<  */
-	OutOfRange,
+	NotDeclared,			/*!<  */
-	NotDeclared, 
+	NotReachable,			/*!<  */
-	NotReachable, 
+	NoPullUpDown,			/*!< Pull-Up mode is not supported by **HARDWARE"" */
-	NoPullUpDown, 
+	NotAnalog,				/*!< Analog mode is not supported by **HARDWARE** */
-	NotAnalog, 
+	NotDigital,				/*!< Digital mode is not supported by **HARDWARE** */
-	NotDigital, 
+	Blocked,				/*!<  */
-	Bocked, 
+	AlreadyUsed,			/*!<  */
-	AlreadyUsed,
+	NotGpio					/*!< This given pin is not a GPIO **HARDWARE** */
-	NotGpio
 }pinErrors_t;
 
 /**