CORDET Framework - C2 Implementation
CrFwOutStreamUserPar.h File Reference

User-modifiable parameters for the OutStream components (see CrFwOutStream.h). More...

Go to the source code of this file.

Macros

#define CR_FW_NOF_OUTSTREAM   7
 The number of OutStream components in the application. More...
 
#define CR_FW_OUTSTREAM_PQSIZE   {3,3,3,3,5,5,5}
 The sizes of the packet queues in the OutStream component. More...
 
#define CR_FW_OUTSTREAM_DEST   {1,2,3,4,5,6,7}
 The destinations of the OutStream components. More...
 
#define CR_FW_OUTSTREAM_NOF_GROUPS   {1,2,1,1,1,1,1}
 The number of groups of the OutStream components. More...
 
#define CR_FW_OUTSTREAM_PCKTHANDOVER
 The functions implementing the packet hand-over operations of the OutStream components. More...
 
#define CR_FW_OUTSTREAM_INITCHECK
 The functions implementing the Initialization Check of the OutStream components. More...
 
#define CR_FW_OUTSTREAM_INITACTION
 The functions implementing the Initialization Action of the OutStream components. More...
 
#define CR_FW_OUTSTREAM_CONFIGCHECK
 The functions implementing the Configuration Check of the OutStream components. More...
 
#define CR_FW_OUTSTREAM_CONFIGACTION
 The functions implementing the Configuration Action of the OutStream components. More...
 
#define CR_FW_OUTSTREAM_SHUTDOWNACTION
 The functions implementing the Shutdown Action of the OutStream components. More...
 

Detailed Description

User-modifiable parameters for the OutStream components (see CrFwOutStream.h).

This file defines all the user-modifiable parameters for the OutStream. Users will normally have to modify this file as part of framework instantiation process.

The parameters defined in this file determine the configuration of the OutStream Components. The value of these parameters cannot be changed dynamically.

The default values defined in this file are those used for the testing of the CORDET Framework.

Author
Vaclav Cechticky vacla.nosp@m.v.ce.nosp@m.chtic.nosp@m.ky@p.nosp@m.np-so.nosp@m.ftwa.nosp@m.re.co.nosp@m.m
Alessandro Pasetti paset.nosp@m.ti@p.nosp@m.np-so.nosp@m.ftwa.nosp@m.re.co.nosp@m.m

This file is part of the CORDET Framework.

This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.

For information on alternative licensing, please contact P&P Software GmbH.

Definition in file CrFwOutStreamUserPar.h.

Macro Definition Documentation

#define CR_FW_NOF_OUTSTREAM   7

The number of OutStream components in the application.

Normally, an application should instantiate one OutStream component for each destination to which a report or a command may be sent. The value of this constant must be smaller than the range of the CrFwCounterU1_t integer type.

Definition at line 46 of file CrFwOutStreamUserPar.h.

#define CR_FW_OUTSTREAM_CONFIGACTION
Value:
void CrFwOutStreamDefConfigAction(FwPrDesc_t prDesc)
Default configuration action for an OutStream.
void CrFwServerSocketConfigAction(FwPrDesc_t prDesc)
Configuration action for the server socket.
void CrFwOutStreamStubConfigAction(FwPrDesc_t prDesc)
Dummy implementation of a configuration action for an OutStream.
void CrFwClientSocketConfigAction(FwPrDesc_t prDesc)
Configuration action for the client socket.

The functions implementing the Configuration Action of the OutStream components.

The OutStream components are derived from the Base Component and they therefore inherit its Reset Procedure (see CrFwResetProc.h). The reset procedure must be configured with two actions: the Configuration Action and the Configuration Check. This constant defines the functions implementing the Configuration Actions for the the OutStream components. The items in the array must be function pointers of type: FwPrAction_t.

Function CrFwOutStreamDefConfigAction can be used as a default implementation for this function. This function resets the internal data structures for the OutStream. An application-specific Configuration Action should therefore include a call to this function.

Definition at line 190 of file CrFwOutStreamUserPar.h.

#define CR_FW_OUTSTREAM_CONFIGCHECK
Value:
void CrFwBaseCmpDefConfigCheck(FwPrDesc_t prDesc)
Function which performs the default Configuration Check of the CRP.
Definition: CrFwResetProc.c:33
void CrFwServerSocketConfigCheck(FwPrDesc_t prDesc)
Configuration check for the server socket.
void CrFwOutStreamStubDummyCheck(FwPrDesc_t prDesc)
Dummy implementation of an initialization or configuration check for an OutStream.
void CrFwOutStreamSocketConfigCheck(FwPrDesc_t prDesc)
Configuration check for the socket-based OutStream.

The functions implementing the Configuration Check of the OutStream components.

The OutStream components are derived from the Base Component and they therefore inherit its Reset Procedure (see CrFwResetProc.h). The reset procedure must be configured with two actions: the Configuration Action and the Configuration Check. This constant defines the functions implementing the Configuration Checks for the the OutStream components. The items in the array must be function pointers of type: FwPrAction_t. Function CrFwBaseCmpDefConfigCheck can be used as a default implementation for this function.

Definition at line 165 of file CrFwOutStreamUserPar.h.

#define CR_FW_OUTSTREAM_DEST   {1,2,3,4,5,6,7}

The destinations of the OutStream components.

The destination of an OutStream is the middleware node to which the OutStream sends its packet. Each OutStream has one (and only one) destination associated to it. A destination is defined by a non-negative integer. This array defines the destination of the i-th OutStream.

The destinations defined in this file are those used for the test cases of CrFwOutStreamTestCases.h.

Definition at line 73 of file CrFwOutStreamUserPar.h.

#define CR_FW_OUTSTREAM_INITACTION
Value:
void CrFwServerSocketInitAction(FwPrDesc_t prDesc)
Initialization action for the server socket.
void CrFwOutStreamSocketInitAction(FwPrDesc_t prDesc)
Initialization action for the socket-based OutStream.
void CrFwOutStreamDefInitAction(FwPrDesc_t prDesc)
Default initialization action for an OutStream.
void CrFwOutStreamStubInitAction(FwPrDesc_t prDesc)
Dummy implementation of a configuration action for an OutStream.
void CrFwClientSocketInitAction(FwPrDesc_t prDesc)
Initialization action for the client socket.

The functions implementing the Initialization Action of the OutStream components.

The OutStream components are derived from the Base Component and they therefore inherit its Initialization Procedure (see CrFwInitProc.h). The initialization procedure must be configured with two actions: the Initialization Action and the Initialization Check. This constant defines the functions implementing the Initialization Actions for the the OutStream components. The items in the array must be function pointers of type: FwPrAction_t.

Function CrFwOutStreamDefInitAction can be used as a default implementation for this function. This function initializes the internal data structures for the OutStream. An application-specific Initialization Action should therefore include a call to this function.

Definition at line 144 of file CrFwOutStreamUserPar.h.

#define CR_FW_OUTSTREAM_INITCHECK
Value:
void CrFwClientSocketInitCheck(FwPrDesc_t prDesc)
Initialization check for the client socket.
void CrFwBaseCmpDefInitCheck(FwPrDesc_t prDesc)
Function which performs the default Initialization Check of the CIP.
Definition: CrFwInitProc.c:36
void CrFwOutStreamStubDummyCheck(FwPrDesc_t prDesc)
Dummy implementation of an initialization or configuration check for an OutStream.
void CrFwServerSocketInitCheck(FwPrDesc_t prDesc)
Initialization check for the server socket.
void CrFwOutStreamSocketInitCheck(FwPrDesc_t prDesc)
Initialization check for the socket-based OutStream.

The functions implementing the Initialization Check of the OutStream components.

The OutStream components are derived from the Base Component and they therefore inherit its Initialization Procedure (see CrFwInitProc.h). The initialization procedure must be configured with two actions: the Initialization Action and the Initiation Check. This constant defines the functions implementing the Initialization Checks for the the OutStream components. The items in the array must be function pointers of type: FwPrAction_t. Function CrFwBaseCmpDefInitCheck can be used as a default implementation for this function.

Definition at line 119 of file CrFwOutStreamUserPar.h.

#define CR_FW_OUTSTREAM_NOF_GROUPS   {1,2,1,1,1,1,1}

The number of groups of the OutStream components.

The number of groups must be a positive integer. This array defines the number of groups of the i-th OutStream.

The number of groups defined in this file are those used for the test cases of CrFwOutStreamTestCases.h.

Definition at line 83 of file CrFwOutStreamUserPar.h.

#define CR_FW_OUTSTREAM_PCKTHANDOVER
Value:
CrFwBool_t CrFwClientSocketPcktHandover(CrFwPckt_t pckt)
Function implementing the hand-over operation for the client socket.
CrFwBool_t CrFwServerSocketPcktHandover(CrFwPckt_t pckt)
Function implementing the hand-over operation for the server socket.
CrFwBool_t CrFwOutStreamStubPcktHandover(CrFwPckt_t pckt)
Stub function implementing the hand-over operation for the OutStream.
CrFwBool_t CrFwOutStreamSocketPcktHandover(CrFwPckt_t pckt)
Function implementing the hand-over operation for the socket-based OutStream.

The functions implementing the packet hand-over operations of the OutStream components.

Each OutStream component needs to be able to hand-over a packet to the middleware. The function implementing this packet hand-over operation is one of the adaptation points of the framework. This array defines the packet hand-over operations for the OutStream. The items in the arrays must be function pointers of type: CrFwPcktHandover_t. No default is defined at framework level for this function.

The packet handover functions defined in this file are those used for the test cases of CrFwOutStreamTestCases.h.

Definition at line 98 of file CrFwOutStreamUserPar.h.

#define CR_FW_OUTSTREAM_PQSIZE   {3,3,3,3,5,5,5}

The sizes of the packet queues in the OutStream component.

Each OutStream has one packet queue. This constant defines the size of the packet queue of the i-th OutStream. The size of the packet queue represents the maximum number of packets which may remain pending in the packet queue. The size of a packet queue must be a positive integer (i.e. it is not legal to define a zero-size packet queue).

The packet sizes defined in this file are those used for the test cases of CrFwOutStreamTestCases.h.

Definition at line 60 of file CrFwOutStreamUserPar.h.

#define CR_FW_OUTSTREAM_SHUTDOWNACTION
Value:
void CrFwClientSocketShutdownAction(FwSmDesc_t smDesc)
Shutdown action for the client socket.
void CrFwOutStreamSocketShutdownAction(FwSmDesc_t smDesc)
Shutdown action for the socket-based OutStream.
void CrFwOutStreamDefShutdownAction(FwSmDesc_t smDesc)
Default shutdown action for an OutStream.
void CrFwOutStreamStubShutdown(FwSmDesc_t smDesc)
Stub function implementing the shutdown operation for an OutStream.
void CrFwServerSocketShutdownAction(FwSmDesc_t smDesc)
Shutdown action for the server socket.

The functions implementing the Shutdown Action of the OutStream components.

The OutStream components are derived from the Base Component and they therefore inherit its Shutdown Action (see CrFwBaseCmp.h). This constant defines the shutdown functions for the the OutStream components. The items in the array must be function pointers of type: FwSmAction_t.

Function CrFwOutStreamDefShutdownAction can be used as a default implementation for this function. This function releases the memory resources used by the OutStream. An application-specific Shutdown Action should therefore include a call to this function.

Definition at line 212 of file CrFwOutStreamUserPar.h.

P&P Software GmbH, Copyright 2012-2013, All Rights Reserved