rtw.pil.RtIOStreamApplicationFramework - Configure target-side communications

Syntax

applicationFramework = rtw.pil.RtIOStreamApplicationFramework(componentArgs)

Description

Constructor	Description
RtIOStreamApplicationFramework	Specify target-specific libraries and source files that are required to build the executable.

Constructor Argument
componentArgs	A `rtw.connectivity.ComponentArgs` object.

Constructor syntax:

applicationFramework = rtw.pil.RtIOStreamApplicationFramework(componentArgs)

You must create a subclass of rtw.pil.RtIOStreamApplicationFramework. The purpose of this class is to specify target-specific libraries and source files that are required to build the executable for the PIL application. These libraries and source files must include the device drivers that implement the target-side of the rtiostream communications channel. See also rtiostream_wrapper.

The class provides an RTW.BuildInfo object containing PIL-specific files (including a PIL main) that will be combined with the PIL component libraries, by the rtw.connectivity.MakefileBuilder, to create the PIL application. You must make a subclass and add source files, libraries, include paths and preprocessor macro definitions that are required to implement the rtiostream target communications interface to the RTW.BuildInfo object (access via getBuildInfo method).

The software uses only the following data in the RTW.BuildInfo object:

Source file names returned by getSourceFiles
Source file paths returned by getSourcePaths
Include file names returned by getIncludeFiles
Include file paths returned by getIncludePaths
Libraries
Preprocessor macro definitions returned by getDefines
Linker options returned by getLinkFlags

The software ignores any other data, for example, template makefile (TMF) tokens and compiler options.

For methods that belong to rtw.pil.RtIOStreamApplicationFramework, see the following table.

Method	Syntax and Description
`getComponentArgs`	`componentArgs = obj.getComponentArgs`
`getComponentArgs`	Returns the `rtw.connectivity.ComponentArgs` object associated with this object.
`getBuildInfo`	`buildInfo = obj.getBuildInfo`
`getBuildInfo`	Returns the `RTW.BuildInfo` object associated with this object.
`addPILMain`	`obj.addPILMain(type)`
	To build the PIL application you must specify a `main.c` file. Use the `addPILMain` method to add one of the two provided files to the application framework. Use the `type` argument to specify `'target'` or `'host'`, depending on which one of the following example PIL `main.c` files you want to use. 1) To specify a `main.c` adapted for on-target PIL and suitable for most PIL implementations, enter: obj.addPILMain(‘target') 2) To specify a `main.c` adapted for host-based PIL, for example, as used in the `mypil` host example, enter: obj.addPILMain(‘host')