view gpf/INC/pco_const.h @ 12:da79bf85bd73

README added
author Space Falcon <falcon@ivan.Harhan.ORG>
date Tue, 02 Jun 2015 00:29:51 +0000
parents 509db1a7b7b8
children
line wrap: on
line source

/* 
+----------------------------------------------------------------------------- 
|  Project :  PCO2
|  Modul   :  inc\pco_const.h
+----------------------------------------------------------------------------- 
|  Copyright 2002 Texas Instruments Berlin, AG 
|                 All rights reserved. 
| 
|                 This file is confidential and a trade secret of Texas 
|                 Instruments Berlin, AG 
|                 The receipt of or possession of this file does not convey 
|                 any rights to reproduce or disclose its contents or to 
|                 manufacture, use, or sell anything it may describe, in 
|                 whole, or in part, without the specific written consent of 
|                 Texas Instruments Berlin, AG. 
+----------------------------------------------------------------------------- 
|  Purpose :  This header provides defines for all the messages send
|             between pco components
+----------------------------------------------------------------------------- 
*/ 


#ifndef _PCO_CONST_H_
#define _PCO_CONST_H_

/*==== INCLUDES ==================================================*/
#include "ipcapi.h"

/*==== GENERAL CONSTANTS ==================================================*/
enum T_PCOSTATUS {PCO_RUNNING,PCO_STOPPED,PCO_LOGFILE};

#define PCO_SEND_TIMEOUT    10000

#define PCO_TTYPE_UNKNOWN   0
#define PCO_TTYPE_MS        1 // milliseconds since reset
#define PCO_TTYPE_HMSM      2 // current time of day in ms
#define PCO_TTYPE_FRAME     3 // frame number since reset

#define CTRL_MSG_MAX_SIZE   MSG_MAX_SIZE /* from ipc */
#define CTRL_DATA_MAX_SIZE  CTRL_MSG_MAX_SIZE-sizeof(MSG_HEADER)

#define DATA_MSG_MAX_SIZE   65535
#define DATA_MSG_DEF_SIZE   2300

#define MAX_QNAME_LEN     50
#define MAX_PATH_LEN      2300
#define MAX_ENTITY_NLEN   5

#define MAX_PRIM_NAME     30

#define PCO_DEF_SRV_NAME  "PCOS"

#ifdef _DEBUG
#define PCO_CFG_PATH "../../cfg/"
#else
#define PCO_CFG_PATH "../cfg/"
#endif

#ifdef _WIN32
#define DEF_CCDDATA_PATH  "ccddata_dll.dll"
#endif


#define PCO_MAX_TRACECLASS  32
const char PCO_TC_NAME[PCO_MAX_TRACECLASS][MAX_PRIM_NAME]=
{
  "FUNCTION TRACE",
  "EVENT TRACE",
  "PRIMITIVE TRACE",
  "STATE TRACE",
  "SYSTEM TRACE",
  "INTERRUPT-SIGNAL TRACE",
  "ERROR TRACE",
  "CCD TRACE",
  "TIMER TRACE",
  "PROFILER TRACE",
  
  "<TRACE>",
  "<TRACE>",
  "<TRACE>",
  "<TRACE>",

  "USER1 TRACE",
  "USER2 TRACE",
  "USER3 TRACE",
  "USER4 TRACE",
  "USER5 TRACE",
  "USER6 TRACE",
  "USER7 TRACE",
  "USER8 TRACE",

  "<TRACE>",
  "<TRACE>",
  "<TRACE>",
  "<TRACE>",
  "<TRACE>",
  "<TRACE>",
  "<TRACE>",
  "<TRACE>",
  "<TRACE>",
  "<TRACE>"
};

/*==== PCO CONTROL MESSAGES ==================================================*/
#define MSG_ID( Group, Code )     (((Group) << 8) + ((Code) & 0xFF))

#define PCO_SRV_GROUP   0x1E
#define PCO_VIEW_GROUP  0x1F



#define PCO_CONNECT      		MSG_ID(PCO_SRV_GROUP,0x01) /* L3SRV_CONNECT */
/*
data:
char[]		name of CMS-queue in which the viewer wants to receive traces/primitives
          (zero terminated)

purpose:
sent from viewer to server to establish connection, server adds client to its list
*/

#define PCO_DISCONNECT     	MSG_ID(PCO_SRV_GROUP,0x02) /* L3SRV_DISCONNECT */
/*
data:

purpose:
sent from viewer to server to disconnect, server removes client from its list
*/

#define PCO_SUBSCRIBE     	MSG_ID(PCO_SRV_GROUP,0x03) /* L3SRV_SUBSCRIBE */
/*
data:
char[]		mobile ID (may be empty) (zero terminated)

purpose:
sent from viewer to server to receive live data of a dedicated mobile
*/


#define PCO_UNSUBSCRIBE     	MSG_ID(PCO_SRV_GROUP,0x04) /* L3SRV_UNSUBSCRIBE */
/*
data:

purpose:
sent from viewer to server to stop receiving of live data
*/


/* MSG_ID(PCO_SRV_GROUP,0x05) L3SRV_ENABLE_LOGGING */



#define PCO_OPEN_LOGFILE     MSG_ID(PCO_SRV_GROUP,0x06) /* L3SRV_LOAD_LOG_FILE */
/*
data:
char[]		name of sessionfile with full path or just a session name (zero terminated)
LONG		  first entry to be sent
LONG		  last entry to be sent

purpose:
sent from viewer to server to receive logged data of a specified session
sent from controller to open a session logfile -> new state of server: PCO_LOGFILE. 
*/


#define PCO_COPY_LOGFILE     MSG_ID(PCO_SRV_GROUP,0x07) /* L3SRV_COPY_LOG_FILE */
/*
data:
char[]		name of source sessionfile with full path (zero terminated)
char[]		name of destination sessionfile with full path (zero terminated)
LONG		  first entry to be copied
LONG		  last entry to be copied

purpose:
sent from viewer to server to make it copy a specified session into another
sessionsfile while applying the filter currently set
*/


#define PCO_SET_FILTER MSG_ID(PCO_SRV_GROUP,0x08)  /* L3SRV_SET_SERVER_FILTER */
/*
data:
char[] list   ... zero separated entity names ("\0\0"==end)
                  e.g.: "MM\0RR\0SS\0\0" or "+"MM\0RR\0\0"
                  - first entity=="+" -> only this entities will be forwarded
                  - default: specified entities will not be forwarded
prim_trace    ... optional parameter to disable/enable general forwarding of
                  primitives/traces:
                  0 .. fowarding of everything (default)
                  1 .. no primitives
                  2 .. no traces

purpose:
sent from viewer to server to set the entity filter for this viewer
*/


/* MSG_ID(PCO_SRV_GROUP,0x09) L3SRV_SET_MOBILE_FILTER */

/* MSG_ID(PCO_SRV_GROUP,0x0A) L3SRV_GET_MOBILE_FILTER */


#define PCO_EXIT		MSG_ID(PCO_SRV_GROUP,0x0B) /* L3SRV_EXIT */
/*
data:

purpose:
sent to server to make it exit, server will send this message 
to all connected viewers before exiting
*/


/* MSG_ID(PCO_SRV_GROUP,0x0C) L3SRV_LOG_FILE */



#define PCO_DATA		MSG_ID(PCO_SRV_GROUP,0x0D) /* L3SRV_DATA */
/*
data:
  rawdata ... depends on server type

purpose:   
sent from some servers to viewers (others send data without header)
contains rawdata which has to be interpreted depending on server type
*/


/* MSG_ID(PCO_SRV_GROUP,0x0E) L3SRV_FILTER */


#define PCO_CONNECTED		MSG_ID(PCO_SRV_GROUP,0x0F) /* L3SRV_CONNECTED */
/*
data:
  byte ... server type id (see server types)

purpose:   
sent from server to viewer to inform about an established connection and 
to tell its type
*/


#define PCO_OK		MSG_ID(PCO_SRV_GROUP,0x10) /* L3SRV_OK */
/*
data:
U16 	ID of message which will be confirmed by this PCO_OK

purpose:
sent by a receiver to the sender to confirm receiving and correct interpretation of a control message
*/


#define PCO_ERROR	MSG_ID(PCO_SRV_GROUP,0x11) /* L3SRV_ERROR */
/*
data:
U16  	ID of message which has produced the error
byte  error code (see error codes)

purpose:
sent by a receiver to the sender to inform about an error a received control message has raised
*/



#define PCO_STOP_TESTSESSION 	MSG_ID(PCO_SRV_GROUP,0x12)
/*
data:

purpose:   
sent to the server to stop a running testsession
*/

#define PCO_START_TESTSESSION   MSG_ID(PCO_SRV_GROUP,0x13)
/*
data:
Char[]	session name (zero terminated)
USHORT  (optional)
        0 .. don't create dbg-files
        1 .. create dbg-files

purpose:
sent to the server to start a new testsession
*/

#define PCO_CLOSE_LOGFILE		MSG_ID(PCO_SRV_GROUP,0x14)
/*
data:

purpose:
sent to server to disable logfile-mode -> new state PCO_STOPPED. 
*/

#define PCO_GET_LOGFILE_DATA	MSG_ID(PCO_SRV_GROUP,0x15)
/*
data:
ULONG	  start index
ULONG 	end index

purpose:
sent to server (which has to be in PCO_LOGFILE state) to make 
him forwarding all logged data from the current session 
file (which matches the index constraints) to the sender 
(has to be a connected viewer). 
*/

#define PCO_SEND_PRIM		    MSG_ID(PCO_SRV_GROUP,0x16)
/*
data:
char[] 	receiver (zero terminated)
char[]	text (zero terminated)

purpose:
to request server to send a CONFIG-primitive to TST, not supported by all servers (knowledge of FRAME is necessary)
*/


#define PCO_STATUS		MSG_ID(PCO_SRV_GROUP,0x17)
/*
data:
<none>         .. if sent from controller to server

T_PCOSTATUS	.. current status of server (see T_PCOSTATUS)
Char[]	.. name of testsession (can be empty, zero terminated)

purpose:
sent from controller to server to request its current status,
sent from server to controller to publish its current status
*/

#define PCO_GET_TESTSESSIONS MSG_ID(PCO_SRV_GROUP,0x18)
/*
data:

purpose:
sent from controller to server to acquire a list of available session names (which are stored in current server testsession directory)
*/

#define PCO_TESTSESSIONS MSG_ID(PCO_SRV_GROUP,0x19)
/*
data:
char[] 	.. zero separated testsession names ("\0\0"==end)
USHORT  .. 1 - more messages will follow
           0 - last messages with testsessions

purpose:
reply to PCO_GET_TESTSESSIONS
*/


#define PCO_SET_SESSIONPATH MSG_ID(PCO_SRV_GROUP,0x1A)
/*
data:
char[]  .. zero terminated path-string
USHORT  .. 1 - store new path in ini-file
           0 - don't store new path
           (optional, default is 0)

purpose:
sent to server to set new session path
*/

#define PCO_DISTRIB_LOGFILE MSG_ID(PCO_SRV_GROUP,0x1B)
/*
data:
LONG		  first entry to be sent
LONG		  last entry to be sent

purpose:
sent to server (in logfile mode) to make him send logged data to all clients
*/

#define PCO_GET_SESSIONPATH MSG_ID(PCO_SRV_GROUP,0x1C)
/*
data:

purpose:
sent to server to get its current session path
*/

#define PCO_SESSIONPATH MSG_ID(PCO_SRV_GROUP,0x1D)
/*
data:
char[]  .. zero terminated path-string

purpose:
sent from server as reply to PCO_GET_SESSIONPATH
*/

#define PCO_SET_TIME_STAMP_PERIOD MSG_ID(PCO_SRV_GROUP,0x1E)
/*
data:
UINT  .. new value for time stamp period
                       0 ... no time stamps
                       >0 .. period in minutes

purpose:
sent to server to set new time stamp period value
*/

#define PCO_RENAME_LOGFILE MSG_ID(PCO_SRV_GROUP,0x1F)
/*
data:
char[]		original name of sessionfile (evtl. with full path, zero terminated)
char[]		new name of sessionfile (evtl. with full path, zero terminated)

purpose:
sent to server to make it rename a session logfile
*/

#define PCO_GET_LOGFILE_INFO  MSG_ID(PCO_SRV_GROUP,0x20) 
/*
data:
Char[]	name of sessionfile with full path or just a session name (zero terminated)

purpose:
sent to server to request info's (e.g. count of entries) about the specified logfile 
*/

#define PCO_LOGFILE_INFO  MSG_ID(PCO_SRV_GROUP,0x21) 
/*
data:
LONG		  count of entries in logfile specified in last PCO_GET_LOGFILE_INFO
Char[]	  optional name of ccddata-file used during logging (zero terminated)
ULONG     optional str2ind version
Char[]	  optional name of str2ind-table-file used during logging (zero terminated)

purpose:
sent from server to a sender of PCO_GET_LOGFILE_INFO 
*/


#define PCO_TO_FRONT MSG_ID(PCO_VIEW_GROUP,0x01) /* L3VWR_TO_FRONT */
/*
data:

purpose:
sent from GUI-controller to server to indicate activation of ctrl window
sent from server to all viewers to indicate activation of ctrl window
sent from server back to controller to indicate activation of viewers
*/

#define PCO_SYNCHRONIZE MSG_ID(PCO_VIEW_GROUP,0x05) 
/*
data:
ULONG	  time in ms

purpose:
sent from a viewer A to server to indicate change in the view to a new time stamp
sent from server to all viewers except A to synchronize them with A
*/

#define PCO_LOGFILE_COMPLETE MSG_ID(PCO_VIEW_GROUP,0x06) 
/*
data:

purpose:
sent from server to a viewers after complete forwarding of a requested logfile
*/

#define PCO_INIFILE_CHANGED MSG_ID(PCO_VIEW_GROUP,0x07) 
/*
data:

purpose:
sent from viewer to server and then to all other viewers after an ini-file change
which should be handled immediatly by all viewers
*/

#define PCO_CLEAN MSG_ID(PCO_VIEW_GROUP,0x08) 
/*
data:

purpose:
sent from viewer to server and then to all other viewers to inform them that the user
has cleaned the viewer content
*/

#define PCO_STOP_LOGFILE 	MSG_ID(PCO_SRV_GROUP,0x22)
/*
data:
Char[]	queue name (zero terminated)

purpose:   
sent to the server to stop logging into the logfile connected with given queue 
*/

#define PCO_START_LOGFILE   MSG_ID(PCO_SRV_GROUP,0x23)
/*
data:
Char[]	logfile name (zero terminated)
Char[]	queue name (zero terminated)

purpose:
sent to the server to start logging all data which will be received in the given queue
(the queue will be created by the server)
*/

#define PCO_LOAD_CCDDATA  MSG_ID(PCO_SRV_GROUP,0x24) 
/*
data:
Char[]	name of ccddata-file to be loaded (zero terminated)

purpose:
sent to server to command it to load the specified ccddata-DLL
*/


/*==== PCO ERROR CODES ==================================================*/

#define PCO_ERR_NONE                  0x00

#define PCO_ERR_TOO_MANY_VIEWERS      0x01
#define PCO_ERR_ALREADY_CONNECTED     0x02
#define PCO_ERR_ALREADY_SUBSCRIBED    0x03
#define PCO_ERR_NOT_CONNECTED         0x04
#define PCO_ERR_NOT_SUBSCRIBED        0x05
#define PCO_ERR_FILE_OPEN_ERROR       0x06
//0x07: log file not for this viewer
#define PCO_ERR_FILE_READ_ERROR       0x08
#define PCO_ERR_FILE_WRITE_ERROR      0x09

#define PCO_ERR_TSESSION_NOT_RUNNING  0x10
#define PCO_ERR_TSESSION_RUNNING      0x11
#define PCO_ERR_TSFILE_OPEN           0x12
#define PCO_ERR_TSFILE_NOT_OPEN       0x14
#define PCO_ERR_WRONG_FILE_TYPE       0x15
#define PCO_ERR_TSFILE_TOO_NEW        0x16
#define PCO_ERR_TOO_MANY_LOGGERS      0x17
#define PCO_ERR_QUEUE_OPEN_ERROR      0x18
#define PCO_ERR_LOGGER_NOT_FOUND      0x19

#define PCO_ERR_TST_NOT_AVAILABLE     0x20

/*==== PCO SERVER TYPES ==================================================*/

#define PCO_STYPE_NONE      0x00
#define PCO_STYPE_PCOS      0x23
#define PCO_STYPE_L3SRV     0x1E


#endif /*_PCO_CONST_H_*/