Using the µVision Socket Interface  Application Note 198
Control and monitor µVision via the built-in TCP/IP interface
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
UVSC-Tester

The UVSC-Tester is a Windows Client application written in Visual C++ with MFC. This Client example includes the UVSC-Tester source code (adaptable to your application needs) and uses the UVSC.DLL to communicate with uVision via the UVSOCK Interface (UVSOCK.h).

The tester implements most features of the UVSOCK Interface (UVSOCK.h) and can be used as the basis for a Client application or as an aid to understand the interface.

The UVSC-Tester is split into several sections from which the Client is communicating with uVision.

  • The top part contains various dialogs with commands that get send to the UVSOCK Interface (UVSOCK.h).
    • Connection: commands to establish the connection to uVision.
    • General: general commands to control uVision and to retrieve error, verion, and license information.
    • Project: project configuration related commands and build build commands.
    • Debug Control: commands to start and stop the debugger, set breakpoints and step through the code while debugging.
    • Debug Information: commands to retrieve information while debugging.
    • Real-Time Agent: view Real-Time Agent messages from the target.
    • Performance: commands to test the memory read/write speed.
  • The bottom part is a Messages window showing all outgoing and incoming messages, including their raw data. Messages are color-coded:
    • Green: Successful Request / Response response
    • Red: Failed Request / Response response
    • White: Asynchronous response
    • Orange: Information only
    • Blue: Commands
tester_main.png
UVSC-Tester (Client application)

Use the UVSC-Tester in the following way:

  • Copy the UVSC-DLLs to the installation folder \UV4 to guarantee compatibility with the uVision executable.
  • Start uVision and Enable UVSOCK in uVision. Close the loaded project. uVision must not be started before the UVSC-Tester. uVision automatically tries to find a connection on the specified server port if the UVSC-Tester setting uVision Auto-start is disabled. Thus, uVision can be started after the UVSC-Tester or after any other Client.
  • Start the UVSC_Tester.exe from the application note folder \bin. Adjust the uVision Port to the value set in uVision. Disable uVision Auto-start.
  • Wait for the Client to connect to uVision. Messages are displayed in the Message window.
  • Switch to the Project tab and click on Load Project. Select a project and continue testing. You can enter commands via the UVSC-Tester or work in uVision directly.
Note
  • The UVSC-DLLs must not be included in your distributed application, unless your application is guaranteed to be used only with the specific version of the development tools from which the DLL was taken.