
%-----------------------G992_2 HWE---------------------------

The batch files for the G992_2 hardware engine (HWE)
can be found under the test (\test\G992_2\hwengine) subdirectory.


Currently, there are batch files for the following tests:
   (i)   hwtrain.bat (transceiver training with channel)
   (ii)  hwghs.bat      (handshake)
   (iii) hwretrain.bat  (fast retrain)
   (iv)  hwtrain_ec.bat (transceiver training with channel and with echo)
   (v)   hwshowtime.bat    (showtime)

Also in the test subdirectory are the modified compiler.h files
needed to run each test:
   compNORM.h  (for training and for handshake and for showtime)
   compFR.h    (for fast retrain only)
   compEC.h    (for training with echo  only-- currently need to #define TEST_EC --
         mptrain_ec.txt defines ECHO on, but it is not activated in HWE)

After running a batch file from the (\test\G992_2\HW) subdirectory,
in an MS DOS window, a log file (with the same name as the batch file,
but with a .log extension) is created in the test subdirectory:
   (i)   hwtrain.log (transceiver training with channel)
   (ii)  hwghs.log      (handshake)
   (iii) hwretrain.log  (fast retrain)
   (iv)  hwtrain_ec.bat (transceiver training with channel and with echo)
   (v)   hwshowtime.bat    (showtime)

The G992_2 HWE test batch files:
(1) select correct compiler.h file
(2) change directory to the build directory
    (\build\g992_2\modem) where ModemHWE.dsw is located.
(3) deletes extant executable file for G992_2 HWE (\Debug\HWExec.exe)
    and project dependencies.
(4) start VC++:
    (a) sets the project settings:
   * Executable: \build\G992_2\modem\Debug\HWExec.exe
   * Working Directory: \testvec\G992_2\input\HW
   * Program Command Line Arguments;
   (i)   Full Train with channel analysis
      txcnfgl0.txt tx_out.bin train.bin  rxcnfga0.txt mptrain2.txt
   (ii)  Fast Retrain with channel analysis
      txcnfgl0.txt tx_out.bin hndshk.bin rxcnfga0.txt mpretrain2.txt
   (iii) handshake
      txcnfgl0.txt tx_out.bin fr_vec.bin rxcnfga0.txt mpghs2.txt
   (iv)  Full Train with channel analysis and echo
      txcnfgl0.txt tx_out.bin train.bin  rxcnfga0.txt mptrainec2.txt

   (b) Project Dependencies:
      HWEngineLib
      IridiaDLL
      ZephyrDLL
      MdmTasksLite
      strymon_cpe
      Platform
(5) Delete pre-existing output files (trail.txt and tx_out.bin)
(6) Execute HWExec.exe

The input files needed for the command line arguments in
the G992_2 HWE are located under the testvec subdirectory
(testvec\G992_2\input\HW):
   txs_in.bin     (dummy Tx input file)
   train.bin      (Rx input data for training)
   fr_vec.bin     (Rx input data for fast retrain)
   hndshk.bin     (Rx input data for handshake)
   mptrain2.txt      (test option flag file for training with channel on)
   mpretrain2.txt    (test option flag file for fast retrain)
   mpghs2.txt     (test option flag file for handshake)
   mptrainec2.txt    (test option flag file for training with echo and channel on)
   txcnfgl0.txt
   rxcnfga0.txt
The output files which are generated include:
for transceiver training,
   tx_out.bin  (Tx output data for transceiver training)
   trail.txt
   rx_out.bin  (dummy Rx output file)
   tx_echo.bin    (Tx echo output data for transceiver training with added echo)

(7) Performs a file comparison with the trail file generated
from step (5) and the trail file in (\testvec\G992_2\TEST\hw),
as well as a file comparison with the binary tx output file
generated from step (5) and the binary tx output file in
(\testvec\G992_2\TEST\hw).
Note, for training with echo, the trail file generated from step (5) is compared
with the trail file, \testvec\G992_2\train\trail_ec.txt,
and the binary tx output with added echo is compared with .
\testvec\G992_2\train\tx_echo.bin.

Here, \TEST denotes a directory name for a specific test, e.g.
   (i)   \TEST = \train, for training
   (ii)  \TEST = \retrain, for fast retrain
   (iii) \TEST = \hndshk, for handshake.
   (iv)  \TEST = \showtime, for showtime
(8) Change back to the test directory (\test\G992_2\HW),


