; --------------------------------------------------------------------------------
; @Title: TRACE32 Remote API - README
; @Description: Readme file for TRACE32 Remote API
; @Author: MOB
; @Copyright: (C) 1989-2020 Lauterbach GmbH, licensed for use with TRACE32(R) only
; --------------------------------------------------------------------------------
; $Id: readme.txt 146693 2022-04-07 16:08:37Z hlohn $

TRACE32 Remote-API



t32apicmd:     This demo sends a single, user specified command to PowerView and
               displays any AREA message.
               Usage:  t32apicmd [node=<name_or_IP>] [port=<num>] <cmd>

t32apinotify:  This demo receives notifications from PowerView. PowerView is
               configured accordingly via remote connection. Whether the user has
               started PowerView for accessing real hardware or in simulator mode
               is also detected.
               Syntax:  t32apinotify [node=<name_or_IP>] [port=<num>]

t32fdxhost:    Host of the FDX feature demontration. See demo/<arch>/fdx for
               the target implementation of FDX. The FDX demos can be executed
               in the TRACE32 instruction set simulator.
               Usage (example with PowerPC Simulator):
               1. Start TRACE32 PowerPC simulator with API enabled
               2. In TRACE32, execute
                     CD.RUN demo/powerpc/fdx/fdx.cmm
               3. from command shell, run t32fdxhost (t32fdxhost <host> [port=<n>])
               4. In TRACE32, execute "GO" (start application in simulator).


If you compile the applications with support for Remote-API via TCP, 
the executables are prefixed with "tcp_"; so:
  tcp_t32apicmd
  tcp_t32apimenu
  tcp_t32apinotify
  tcp_t32fdxhost



Build instructions
------------------

Windows, Visual Studio
^^^^^^^^^^^^^^^^^^^^^^
Start a "Native Tools Command Prompt" from the Windows "Start" menu.
Change directory to ...\demo\api\capi\test
Then execute
   nmake
to compile the applications.

To compile and link the applications with Remote-API via TCP, execute
   nmake NETTCP=1

To compile a version with debug information, add a DEBUG=1 to the command line. E.g.:
   nmake DEBUG=1
   nmake DEBUG=1 NETTCP=1

Linux, GCC
^^^^^^^^^^
Start a command shell.
Change directory to .../demo/api/capi/test
Execute
  make
to compile the applications

To compile and link the applications with Remote-API via TCP, execute
   make NETTCP=1

To compile a version with debug information, add a DEBUG=1 to the command line. E.g.:
   nmake DEBUG=1
   nmake DEBUG=1 NETTCP=1