|
|
| (101 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| == Overview ==
| | #REDIRECT [[STRIDE Off-Target Environment]] |
| The STRIDE SDK is provided to be used primarily as an off-target evaluation or development sandbox. This allows you to use STRIDE in a small, controlled environment without needing to make changes to your target build. In addition, the SDK Makefile can serve as an example of the steps needed to add STRIDE instrumentation to your target build.
| |
| | |
| Each SDK package has identical functionality, but targets a specific operating system. The SDK contains the following items:
| |
| | |
| * STRIDE runtime source
| |
| * PAL source for interface with the Target OS
| |
| * Makefile to build STRIDE runtime library, test and sample applications
| |
| * Compiler setting file for target processor
| |
| | |
| == Evaluation Steps ==
| |
| To simplify the evalution, we recommend using a single Windows or Linux computer for both the target and host systems. Host and target code will run in separate processes and communicate via TCP/IP, thus simulating an embedded target with host computer configuration. All code and techniques used in the sandbox evaluation are directly transferrable to a production environment.
| |
| | |
| The recommended evaluation steps are as follows:
| |
| | |
| # Build the STRIDE runtime library
| |
| # Build and connect to the target app with only the runtime
| |
| # Build and test the target app with S2 diagnostic tests
| |
| # Build and test the target app with the TestIntro sample
| |
| | |
| ==Building the STRIDE Runtime Library==
| |
| '''Note:''' all Makefiles must be run with [http://www.gnu.org/software/make/ gnu make]. For SDKs targeting OS's where this is not the standard make utility, an executable is supplied in the SDK's bin directory.
| |
| | |
| ===Linux===
| |
| The Makefile assumes a gnu toolchain. (Other toolchains can be used; see the comments in the Makefile.)
| |
| # cd to <tt>~/stride/SDK/Linux/src</tt>
| |
| # Build the library
| |
| #: <source lang="bash">make library</source>
| |
| # The file <tt>~/stride/SDK/Linux/out/lib/libstride.a</tt> will be produced
| |
| | |
| ===Windows===
| |
| The Makefile assumes a Visual Studio toolchain. (Other toolchains can be used; see the comments in the Makefile.)
| |
| | |
| # If using Microsoft Visual Studio, open a Visual Studio command prompt to ensure that the compiler and linker are on your PATH.<ref>You can get a VS command prompt via the Start menu. Choose: Start -> All Programs -> Microsoft Visual Studio 200X -> Visual Studio Tools -> Visual Studio 200X Command Prompt</ref>
| |
| # cd to <tt>stride\SDK\Windows\src</tt>
| |
| # build the library using the supplied gnu make. (You will get Makefile errors if you use the default make.)
| |
| #:<source lang="dos">..\bin\make library</source> | |
| # The file <tt>stride\SDK\Windows\out\lib\stride.lib</tt> will be produced
| |
| | |
| == Building the TargetApp ==
| |
| This step builds the first version of an instrumented target application. This application links with the STRIDE runtime library and adds the S2 diagnostic tests.
| |
| | |
| This step requires an installation of the STRIDE build tools. If not installed, please see [[Package_Installation#Build_Tools|Package Installation]] for more information.
| |
| | |
| ===Linux===
| |
| # cd to <tt>~/stride/SDK/Linux/src</tt>
| |
| # Build the test app
| |
| #: <source lang="bash">make testapp</source>
| |
| # The file <tt>~/stride/SDK/Linux/out/bin/TestApp</tt> will be produced
| |
| # Note also that the STRIDE database file <tt>~/stride/SDK/Linux/out/TestApp.sidb</tt> is also produced
| |
|
| |
| ===Windows===
| |
| | |
| # If using Microsoft Visual Studio, open a Visual Studio command prompt to ensure that the compiler and linker are on your PATH.
| |
| # cd to <tt>stride\SDK\Windows\src</tt>
| |
| # build the test app using the supplied gnu make. (You will get Makefile errors if you use the default make.)
| |
| #:<source lang="dos">..\bin\make testapp</source>
| |
| # The file <tt>stride\SDK\Windows\out\bin\TestApp.exe</tt> will be produced
| |
| # Note also that the STRIDE database file <tt>stride\SDK\Linux\out\TestApp.sidb</tt> is also produced
| |
| | |
| [[SDK Target Application Details]]
| |
| | |
| === Verifying Host to Target Connectivity ===
| |
| | |
| === Adding Diagnostic Tests ===
| |
| | |
| === Adding Sample Tests ===
| |
| | |
| == Makefile Targets ==
| |
| | |
| ;all
| |
| : Builds the ''library'' target
| |
| ;library
| |
| : Builds STRIDE runtime, producing stride.lib
| |
| ;clean
| |
| : Deletes intermediate and target files
| |
| ;testapp
| |
| : Builds an instrumented test application, TestApp.exe, using sources found in the sample_src directory
| |
| | |
| ;database
| |
| :
| |
| ;im
| |
| :
| |
| ;daemon
| |
| :
| |
| | |
| ==Instrumenting Multiple Processes==
| |
| | |
| | |
| ===Notes===
| |
| <references/>
| |
| [[Category:Deployment]]
| |