FreeCalypso > hg > freecalypso-citrine
diff gpf/inc/pco_const.h @ 0:75a11d740a02
initial import of gsm-fw from freecalypso-sw rev 1033:5ab737ac3ad7
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Thu, 09 Jun 2016 00:02:41 +0000 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/gpf/inc/pco_const.h Thu Jun 09 00:02:41 2016 +0000 @@ -0,0 +1,540 @@ +/* ++----------------------------------------------------------------------------- +| 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_*/