/*-----------------------------------------------------------------------------
 *      Name:         framework.c
 *      Purpose:      Test framework entry point
 *----------------------------------------------------------------------------
 *      Copyright(c) KEIL - An ARM Company
 *----------------------------------------------------------------------------*/
#include "cmsis_dv.h" 
#include "DV_Framework.h"

/*=======0=========1=========2=========3=========4=========5=========6=========7=========8=========9=========0=========1====*/
/**
\defgroup framework_funcs Framework Functions
\brief Functions in the Framework software component
\details

@{
*/

/*=======0=========1=========2=========3=========4=========5=========6=========7=========8=========9=========0=========1====*/
/**
\brief Close the debug session.
\details
Debug session dead end - debug script should close session here. This function is called by \ref cmsis_dv.
*/
void closeDebug(void);
void __attribute__((noinline)) closeDebug(void){
  __NOP();
  // Test completed
}


/*=======0=========1=========2=========3=========4=========5=========6=========7=========8=========9=========0=========1====*/
/**
\brief This is the entry point of the test framework.
\details
Program flow:
  -# Hardware is first initialized if Init callback function is provided
  -# Test report statistics is initialized
  -# Test report headers are written to the standard output
  -# All defined test cases are executed:
      - Test case statistics is initialized
      - Test case report header is written to the standard output
      - Test case is executed
      - Test case results are written to the standard output
      - Test case report footer is written to the standard output
      - Test case is closed
  -# Test report footer is written to the standard output
  -# Debug session ends in dead loop
*/
void cmsis_dv (void __attribute__((unused)) *argument) {
  const char *fn;
  uint32_t tc, no;
  
  /* Init test suite */
  if (ts.Init) {
    ts.Init();                            /* Init hardware                    */
  }

  ritf.Init ();                           /* Init test report                 */
  ritf.Open (ts.ReportTitle,              /* Write test report title          */
             ts.Date,                     /* Write compilation date           */
             ts.Time,                     /* Write compilation time           */
             ts.FileName);                /* Write module file name           */

  /* Execute all test cases */
  for (tc = 0; tc < ts.NumOfTC; tc++) {
    no = ts.TCBaseNum+tc;                 /* Test case number                 */
    fn = ts.TC[tc].TFName;                /* Test function name string        */
    ritf.Open_TC (no, fn);                /* Open test case #(Base + TC)      */
    if (ts.TC[tc].en) 
      ts.TC[tc].TestFunc();               /* Execute test case if enabled     */
    ritf.Close_TC ();                     /* Close test case                  */
  }
  ritf.Close ();                          /* Close test report                */

  closeDebug();                           /* Close debug session              */
}

/**
@}
*/ 
// end of group framework_funcs