Index

A

actor classes, C++ 25

actor timers 19, 87

adding new files to the C TargetRTS 66

adding new files to the TargetRTS 52

application command line arguments 102

arguments 49

availability of Perl on compilation host 61

B

before starting the port 25

building the new TargetRTS 111, 119

C

C source and header files, creating and editing 8

C TargetRTS

adding new files 66

configuration definitions 55

implementing timer services 77

run-time semantics 66

C TargetRTS configuration definitions 55

C++ Actor Classes 25

C_HelloWorld within ObjecTime, activating 10

C_HelloWorld, compiling and running for your target 10

Classes

RTCondVar

extending the Mutex 51

RTDebuggerInput 51

RTDiagStream 51

RTIOController 52

RTIOMonitor 52

RTMain 49

target-specific methods 49

RTMutex 50

protecting shared resources 50

RTSyncObject 51

RTTcpSocket 51

RTThread

supporting multi-threading 50

RTThread Constructor 50

RTThread constructor 50

code changes to TargetRTS classes 110, 119

common overrides required for a new target 49, 62

common problems and pitfalls 99

compile and run 11

compile and run hello.c for your target 4

compile and run the C_HelloWorld model for your target 10

compile the TargetRTS for your target 10

compiler optimizations 99

compiling and running hello.c for your target 4

compiling and running the C_HelloWorld model for your target 10

config makefile 39

config makefile, creating a 7

configuration makefile 108, 117

COUNT 46, 55

CRSL Compliance Tests 95

D

Debug phase 13

Debug run-time testing 13

Debugger 47

Debugger statistics 46

Debugging 28

Default makefile 36

DEFER_IN_ACTOR 46

definitions, platform-specific 45

directories, creating and editing 6

disabling TargetRTS features for performance 97

E

enqueueing external events 75

entryPoint function 50

environment setup 3

environment variable setup script, creating an 7

environment variables, creating target-specific 3

environment variables, noting the value of existing 3

example platform names used by the TargetRTS 32

exiting application 102

external events, enqueueing 75

EXTERNAL_LAYER 46

F

File main.cc 52

FiveStates update 95

floating point operations 28

functions

entryPoint 50

gethostbyname() reentrancy 102

Main 49, 62

RSLCancelTimer 76

RSLDequeueTimer 76

RSLGetFirstTimeout 76

RSLGetTimerServiceActor 77

RSLRegisterExternalInterface 74

RSLRegisterMessageSignallingInterface 75

RSLRegisterTimerServices 77

RSLThreadMap 67

RTOS supplies main() 101

targetShutdown 50

targetStartup 49

G

generated code

compilation supported by makefiles 34

gethostbyname() reentrancy 102

H

hello.c, compiling and running for your target 4

HelloWorld update 95

I

Implementaion

platform-specific 46, 55

implementing timer services in the C TargetRTS 77

install all required target OS software on the host and target 3

INTEGER_POSTFIX 46

Integrated IPC and timers 18

Integrated timers 18

L

libset

makefiles 39

name, components of 5, 33

platform name, part of 31

libset makefile 39, 106, 114

libset makefile, creating the 8

libset name 5, 33

libset name, choosing a 5

linking problems 99

local timers 18, 77

LOG_MESSAGE 46

M

Main function 49, 62

mainloop 66

makefile fragments 59

makefiles 34

config, template 39

libset,template 39

sequencing of 35

target 38

TargetRTS, changes 36

typical target, template 38

makefiles, creating 106, 114

makefiles, creating and editing 7

MANIFEST.c file 66

MANIFEST.cpp File 52

MANIFEST.cpp file 52, 66

memory management 62

message priority 68

message processing 72

message queues 69

Method RTTimespec::getclock() 50

modify $RTS_HOME\target\<TargetName>\RTTarget.h 13

modifying the error parser 91

multi-threaded C TargetRTS 70

multi-threaded C TargetRTS message processing 73

multi-threaded libraries, creating 15

multi-threaded mode

support for 50

multi-threaded RTOS interface 62

Mutex

methods to protect shared resources 50

N

names, choosing 4

new configuration, creating a 11

new error parser, creating a 91

new files, adding to the C TargetRTS 66

new files, adding to the TargetRTS 52

O

OBJECT_DECODE 47

OBJECT_ENCODE 47

ObjecTime -How to Contact

Support Hotline, Fax, E-mail iv

ObjecTime support, what to do before calling 28

OS capabilities 25

OS knowledge and experience 25

OTRTSDEBUG 47

P

PATH variable 33

Performance update 95

Perl scripts, creating and editing 7

Perl scripts, making copies of 7

Perl, availability on a compilation host 61

Perl, if the compilation platform does not have 16

phases of a port 31

platform

example names 32

two-part name

target and libset 5, 27, 31

platform name, choosing a 5, 31, 105, 113

platform name, determining the 5

platform-specific

definitions 45

implementation 46, 55

platform-specific implementation 48, 61

platform-specific include files, creating 9

platform-specific source files, creating 8

port, major steps for implementing the 31

porting the error parser phase 16

porting the TargetRTS 31

porting the TargetRTS for C 3, 55

porting the TargetRTS for C++ 45

porting timers phase 17

problems and pitfalls with target TCP/IP interfaces 102

problems and pitfalls with target toolchains 99

problems and pitfalls with TargetRTS/RTOS interaction 100

R

Real-time clock 101

regenerating make dependencies 52, 66

reusing an existing error parser 91

RSLCancelTimer 76

RSLDequeueTimer 76

RSLGetFirstTimeout 76

RSLGetTimerServiceActor 77

RSLRegisterExternalInterface 74

RSLRegisterMessageSignallingInterface 75

RSLRegisterTimerServices 77

RSLThreadMap 67

RTOS supplies main() function 101

RTREAL_INCLUDED 47

RTTarget.h, creating 8

RTThread.c contents 63

Run-to-completion 74

S

Select() statement 102

setting the compiler vendor in the libset.mk file 91

setup script

TargetRTS compilation to the platform 7, 33

setup script, creating a 7, 33, 105, 113

signal handlers 101

simple model execution phase 3

simple non-ObjecTime program on target 27

single-threaded C TargetRTS 69

single-threaded C TargetRTS message processing 72

standard input/output functionality 28

synchronization primitives 100

system include files 100

T

target

name, components of 32

platform name, part of 31

target compiler optimizations 97

Target makefile 38

target makefile 38, 108, 116

target makefile, creating the 8

target name 32

target name and target base name, choosing a 4

Target Observability phase 13

Target Observability run-time testing 14

Target Observability startup and shutdown 62

target operating system optimizations 97

TargetRTS

adding new files 52

constants/macros and their default values 46, 55

example platform names used by the 32

libraries

compilation supported by makefiles 34

porting it to a new platform 31

porting the 31

specific performance enhancements 98

testing 95

tuning 97

TargetRTS classes, code changes to 110, 119

TargetRTS configuration definitions 45, 109, 117

TargetRTS features, disabling for performance 97

TargetRTS for C

porting the 3

testing 95

TargetRTS for C++

porting the 45

testing 95

TargetRTS makefiles 34, 36

targetShutdown function 50

target-specific environment variables, creating 3

targetStartup function 49

tasks, processes, and threads 66

TCP/IP functionality 28

testing the TargetRTS 95

testing the TargetRTS for C 95

testing the TargetRTS for C++ 95

thread creation 100

threaded phase 15

threaded phase run-time testing 16

threads configuration, editing the 11

Tool chain functionality 25

Training 28

tuning the TargetRTS 97

U

USE_THREADS 46