module ti.uia.events.UIAMessage

index URL

UIA Message Events

*       C synopsis

*  Individual elements

The UIAMessage module defines events that allow tooling to monitor messages between tasks and CPUs. more ... ]

C synopsis

target-domain

sourced in ti/uia/events/UIAMessage.h

#include <ti/uia/events/UIAMessage.h>

Constants

extern const Log_Event 

extern const Log_Event 

extern const Log_Event 

extern const Log_Event 

 

DETAILS

The UIAMessage module defines events that allow tooling to monitor messages between tasks and CPUs.

The generation of UIAMessage events is controlled by a module's diagnostics mask, which is described in details in xdc.runtime.Diags. UIAMessage info events are generated only when the Diags.INFO bit is set in the module's diagnostics mask.


Example 1: The following example shows how to turn on and off logging of STATUS events and INFO events from the application source code. See the Diags_setMask() function for details on specifying the control string.

  // turn on logging of STATUS events (S) and INFO events (F)
  // in the module
  Diags_setMask("my.pkg.Mod+SF");
 
  // turn off logging of STATUS events and INFO events in the module
  Diags_setMask("my.pkg.Mod-SF");

 

config UIAMessage_msgReceived  // module-wide

index URL

Message Received event

C synopsis

target-domain

extern const Log_Event UIAMessage_msgReceived;

 

VALUES

NumBytes — length of the message in bytes

Flags — any flags associated with the message

MsgId — the message ID for the message

Destination ProcID — the procID for the message destination

Reply ProcID — the procID that the reply will be sent to

Source ProcID — the procID of the message sender

HeapId — the HeapID associated with the message

DETAILS

  #include <xdc/runtime/Log.h>
  #include <ti/uia/events/UIAMessage.h>
  ...
  Log_write7(UIAMessage_msgReceived, numBytes,flags,msgId,destProcId,replyProcId,srcProcId,heapId);
  ...
  "Msg Received [NumBytes]0x32 [Flags]0xF [MsgId]0x8357 [Dest(ProcID)]0x2 [Reply(ProcID)]0x3 [Src(ProcID)]0x1 [HeapId]0x56"
 

EXAMPLE

The following C code shows how to log a msgReceived event

 

config UIAMessage_msgSent  // module-wide

index URL

Message Sent event

C synopsis

target-domain

extern const Log_Event UIAMessage_msgSent;

 

VALUES

NumBytes — length of the message in bytes

Flags — any flags associated with the message

MsgId — the message ID for the message

Destination ProcID — the procID for the message destination

Reply ProcID — the procID that the reply will be sent to

Source ProcID — the procID of the message sender

HeapId — the HeapID associated with the message

DETAILS

  #include <xdc/runtime/Log.h>
  #include <ti/uia/events/UIAMessage.h>
  ...
  Log_write7(UIAMessage_msgSent, numBytes,flags,msgId,destProcId,replyProcId,srcProcId,heapId);
  ...
  "Msg Sent [NumBytes]0x32 [Flags]0xF [MsgId]0x8357 [Dest(ProcID)]0x2 [Reply(ProcID)]0x3 [Src(ProcID)]0x1 [HeapId]0x56"
 

EXAMPLE

The following C code shows how to log a msgSent event

 

config UIAMessage_replyReceived  // module-wide

index URL

Reply Received event

C synopsis

target-domain

extern const Log_Event UIAMessage_replyReceived;

 

VALUES

MsgId — the message ID for the message

ReplyId — the reply's message ID

NumBytes — length of the message in bytes

Sender ProcID — the procID that the reply will be sent to

Destination ProcID — the procID for the message destination

DETAILS

  #include <xdc/runtime/Log.h>
  #include <ti/uia/events/UIAMessage.h>
  ...
  Log_write5(UIAMessage_replyReceived,msgId,replyId,numBytes,senderProcId,destProcId);
  ...
  "Msg Sent [MsgId]0x8357 [NumBytes]0x32 [Flags]0xF [Dest(ProcID)]0x2 [Reply(ProcID)]0x3 [Src(ProcID)]0x1 [HeapId]0x56"
 

EXAMPLE

The following C code shows how to log a msgSent event

 

config UIAMessage_replySent  // module-wide

index URL

Reply Sent event

C synopsis

target-domain

extern const Log_Event UIAMessage_replySent;

 

VALUES

NumBytes — length of the message in bytes

Flags — any flags associated with the message

MsgId — the message ID for the message

Destination ProcID — the procID for the message destination

Reply ProcID — the procID that the reply will be sent to

Source ProcID — the procID of the message sender

HeapId — the HeapID associated with the message

DETAILS

  #include <xdc/runtime/Log.h>
  #include <ti/uia/events/UIAMessage.h>
  ...
  Log_write7(UIAMessage_replySent, numBytes,flags,msgId,destProcId,replyProcId,srcProcId,heapId);
  ...
  "Reply Sent [NumBytes]0x32 [Flags]0xF [MsgId]0x8357 [Dest(ProcID)]0x2 [Reply(ProcID)]0x3 [Src(ProcID)]0x1 [HeapId]0x56"
 
     

EXAMPLE

The following C code shows how to log a msgSent event

 

generated on Wed, 14 Mar 2012 16:46:04 GMT