Running HelloWorld App in vxWorks-7 Simulator

Windows Host / Downloadable Kernel Modules

Introduction

This tutorial will give you a quick view of the steps needed to get an RDM application running in the Wind River vxWorks-7 simulator. The concepts addressed here are:

  • Defining a docroot using the rdm_rdmAllocTFS() command. In order to place the database in a known position on the target device, we will provide the docroot location in the call to allocate the embedded TFS. See line 94 in the HelloWorld.c source file.

Building the vxWorks Kernel Image

Wind River vxWorks-7 comes with a prebuilt Source Build (vsb_vxsim_windows) and a prebuilt kernel image. However, to run the RDM examples, we will need to build a different vxWorks kernel image with the additional components defined. The additional components we are defining for our simulator are:

        -c INCLUDE_HRFS \
        -c INCLUDE_HRFS_FORMAT \
        -c INCLUDE_RAM_DISK \
        -c INCLUDE_RAM_DISK_FORMAT_HRFS \
        -c INCLUDE_DEBUG_AGENT_START \
        -c INCLUDE_POSIX_PTHREAD_SCHEDULER \
        -p NUM_FILES=255 \
        -p HRFS_DEFAULT_MAX_FILES=255 \
        -p RTP_FD_NUM_MAX=255 \
        -p RAM_DISK_SIZE=0x8000000

Steps

  1. Change to the WindRiver install directory and execute the wrenv command to start a WindRiver command environment:
    2. C:\WindRiver> wrenv -p vxworks-7
  2. Change to the target/vxworks7-x86_64_simwindows directory in the RDM install directory and execute the following command:
    3. C:\Raima\RDM\15.1\target\vxworks7-x86_64_simwindows> sh setup.sh --vsb --vip

    This command will create a new source build and kernel image we will use in the following steps.

Creating a HelloWorld Project

The following steps will create a HelloWorld downloadable kernel module project that will run on the vxWorks simulator.

Steps

  1. Copy the HelloWorld.sdl schema file to the target/vxworks7-x86_64_simwindows directory:
  2. Start the WorkBench environment and set the workspace to the target/vxworks7-x86_64_simwindows directory in the RDM install directory:

  3. Create a Downloadable Kernel Module Project named HelloWorld in the current workspace:

  4. Set the project context to the vsb_vxsim_windows project:

  5. Copy the HelloWorld.c source file to the target/vxworks7-x86_64_simwindows/HelloWorld directory in the RDM install directory.
  6. In a command prompt, change into the target/vxworks7-x86_64_simwindows/HelloWorld directory and run the following command:
    7. C:\Raima\RDM\15.1\target\vxworks7-x86_64_simwindows\HelloWorld> rdm-compile --catalog --c-structs ..\HelloWorld.sdl
  7. In the WorkBench environment, delete the dkm.c file from the newly created project and refresh the screen. The list of files in the project should look like this:

  8. In the Build Properties for HelloWorld, add the RDM include path to the Paths tab:

  9. In the Build Properties for HelloWorld, add the RDM library path and required libraries to the Libraries tab:

    10. The library order is important! The dependent libraries and helper libraries must always follow after an included library in the list above. For example, rdmbase is dependent on rdmpsp. For a list of libraries and their dependencies, see RDM Libraries.

  10. Build the HelloWorld project

Running the HelloWorld App in the Simulator

Steps

  1. Select New Connection:

  2. In the New Connection dialog, select VxWorks Simulator and browse to the Kernel Image we created previously in this workspace (vip_x86_64_simwindows\default\vxWorks) and press Finish to connect to the simulator.

  3. Right click on the HelloWorld project and select Run/Debug Kernel Task:

  4. Provide main_HelloWorld as the entry point for the Kernel Task. For this example

  5. Press OK and the HelloWorld DKM will be downloaded to the running VxWorks simulator and will execute. The result of this program execution and be seen on the VxWorks Simulator console.