Readme-Streamport.txt
1Tracealyzer Stream Port for TCP/IP (Win32 example)
2Percepio AB
3www.percepio.com
4-------------------------------------------------
5
6This directory contains a "stream port" for the Tracealyzer recorder library,
7i.e., the I/O code needed for streaming a Tracealyzer RTOS trace over specific
8interface. The stream port is defined by a set of macros in trcStreamPort.h,
9found in the "include" directory.
10
11This particular stream port is for streaming over TCP/IP on Windows, intended
12for the FreeRTOS Windows port (WIN32-MSVC). To try it:
13
141. Open the WIN32-MSVC demo project found in the FreeRTOS demo folder. You
15need will Visual Studio, but there are free versions (Express or Community).
16
172. Make sure the project includes a recent version or the recorder library
18(v3.1.x).
19
203. Make sure the recorder library is configured for streaming mode (see
21trcConfig.h).
22
234. Make sure the project's include paths contains trcStreamPort.h found in
24this include folder (and not any other stream port), and the related code
25in this folder.
26
275. Build and start the Win32 demo application. It should begin waiting for
28a connection.
29
306. In Tracealyzer, open File -> Settings... -> Streaming Trace Settings.
31Specify target connection: TCP, host: 127.0.0.1 (i.e. localhost) and port 8888.
32
337. In Tracealyzer, now open File -> Connect to Target System... and there
34click "Start Recording". Now you should see a live CPU load graph and some
35counters. Let it record for a few seconds, then click "Stop Recording" and then "View Trace".
36
37See also http://percepio.com/2016/10/05/rtos-tracing.
38