Index: firmware/App/Modes/ModeService.h
===================================================================
diff -u -rb64c49fdcf2b6d95e61e63f8e258c4e600935bbd -r7d4711edd7b40cd3e29f43e766f79a8a09586fe9
--- firmware/App/Modes/ModeService.h	(.../ModeService.h)	(revision b64c49fdcf2b6d95e61e63f8e258c4e600935bbd)
+++ firmware/App/Modes/ModeService.h	(.../ModeService.h)	(revision 7d4711edd7b40cd3e29f43e766f79a8a09586fe9)
@@ -1,28 +1,45 @@
 /**************************************************************************
- *
- *  Copyright (c) 2019-2020 Diality Inc. - All Rights Reserved.
- *
- *  THIS CODE MAY NOT BE COPIED OR REPRODUCED IN ANY FORM, IN PART OR IN
- *  WHOLE, WITHOUT THE EXPLICIT PERMISSION OF THE COPYRIGHT OWNER.
- *
- *  @file ModeService.h
- *
- *  @date 19-Sep-2019
- *  @author S. Nash
- *
- *  @brief Header file for Service Mode.
- *
- **************************************************************************/
+*
+* Copyright (c) 2019-2024 Diality Inc. - All Rights Reserved.
+*
+* THIS CODE MAY NOT BE COPIED OR REPRODUCED IN ANY FORM, IN PART OR IN
+* WHOLE, WITHOUT THE EXPLICIT PERMISSION OF THE COPYRIGHT OWNER.
+*
+* @file    ModeService.h
+*
+* @author  (last)      Michael Garthwaite
+* @date    (last)      28-Jul-2022
+*
+* @author  (original)  Dara Navaei
+* @date    (original)  05-Nov-2019
+*
+***************************************************************************/
 
 #ifndef __MODE_SERVICE_H__
 #define __MODE_SERVICE_H__
 
 #include "DGCommon.h"
+#include "DGDefs.h"
+#include "ModeFault.h"
 
-// ********** private function prototypes **********
+/**
+ *  @defgroup DGServiceMode DGServiceMode
+ *  @brief Service mode module. Manages service mode functions via a state machine.
+ *
+ *  @addtogroup DGServiceMode
+ *  @{
+ */
 
+// ********** public definitions **********
+
+// ********** public function prototypes **********
+
 void initServiceMode( void );          // initialize this module
-void transitionToServiceMode( void );  // prepares for transition to service mode
-void execServiceMode( void );          // execute the service mode state machine (call from OperationModes)
+U32  transitionToServiceMode( void );  // prepares for transition to service mode
+U32  execServiceMode( void );          // execute the service mode state machine (call from OperationModes)
 
+DG_SERVICE_STATE_T getCurrentServiceState( void );  // get the current state of the service mode.
+
+/**@}*/
+
 #endif