Runtime Integration

Overview

This page discuses the first step in an overall STRIDE integration effort. Here we incorporate the STRIDE Runtime in your target application build without tests. In the second and last step, we add the STRIDE Build Tools to the mix and hook up the test-running harnessing.

After building the target with the STRIDE Runtime in place, we will run stride from a remote host computer to verify connectivity and runtime operation.

Recommendations

The STRIDE target environment offers lots of flexibility to accommodate different target scenarios. For an initial target integration, we recommend that you pursue the simplest STRIDE configuration that will yield results. Once this configuration is successfully integrated you can make adjustments as desired.

Integrating STRIDE Into Your Target Build

To add the STRIDE runtime to your build process, the following changes must be made:

• Secure a PAL targeted to your target operating system
• Configure the PAL I/O parameters to conform the your target hardware
• Add steps to your target build process to include the STRIDE runtime source files
• Edit your target application's source code to start the runtime and I/O thread(s)

Securing a PAL

The Platform Abstraction Layer (PAL) provides the glue between the STRIDE runtime and services offered by your OS. It is the only piece of the runtime that is customized between operating systems.

Fully tested PALs are provided for Linux and Windows, included as palIO.c and palOS.c in their respective SDKs. Other PALs are also available or under development. Please contact S2 for availability.

Configuring I/O parameters

If your target will communicate with the host computer via the default of TCP/IP port 8000, you can skip this step.

Otherwise, refer to palcfg.h for a list of configuration parameters.

For complete information, refer to the Platform Abstraction Layer page and the PAL Specification document.

Including the STRIDE Runtime Sources

The STRIDE runtime sources are distributed in source form. The source files are available as a stand-alone package and are also included with each flavor of SDK package.

The runtime sources are supplied in three directories:

GRS

Generic RTOS Services

Runtime

STRIDE runtime

SLAP

Simplified Link-layer Application Protocol

If you are using an S2-supplied PAL, files in each of these directories should be included in your target build.

If you are using an S2-supplied PAL, additional required sources can be found in the SDK's src directory:

• PAL implementation
  • palcfg.h
  • palIO.c
  • palOS.c

• Convenience functions (these wrap low-level STRIDE runtime calls)
  • stride.c
  • stride.h

The SDKs inlclude the runtime sources by building them into a library that is then linked with the target application.

Target Source Changes

Your target source must be edited to include code that initializes and uninitializes the runtime. The code is typically added to your main() function, but the only requirement is that the initialization takes place before the host computer connects and the uninitialization occurs before the process terminates.

Example startup code:

#ifdef WIN32
#include <windows.h>
#include <tchar.h>
#else
#include <stdlib.h>
#include <unistd.h>
#endif
/* STRIDE runtime includes */
#include <stride.h>

int main(int argc, char **argv)
{
   ...

/* initialize the STRIDE subsytem using default I/O */
   strideIO_t io = {strideDEFAULT};
/* for C++ use
   strideIO_t io = {strideIO_t::strideDEFAULT};
*/
    
   if (strideInit(&io) != srTRUE) {
       return -1;
   }

   /* target application code here */
   ...

/* this call blocks until a SIGTERM is received, omit if not needed */
   strideExWaitForExit();

/* terminate all STRIDE threads and uninitialize STRIDE subsystem */
   strideUninit();
   return 0;   
 }

Testing the Runtime Integration

Once the instrumented target is successfully built, start the target application. On a separate host computer, connected to the target via TCP/IP (or serial port if so configured), run stride as follows (substitute the --device option argument as needed):

stride --diagnostics --device TCP:[device_address]:8000

By specifying --diagnostics without also specifying a database, we instruct stride to test for connectivity with the target.

If all is well, the following will be output to the host window (the reported runtime version may be different than that shown):

Connecting to device...
  runtime version: 4.1.01
Disconnecting from device...