User guide

Dialogic

DSI Development Package for Linux - Release Notes Release 6.2.3

2.3.2 Usage Instructions

Prebuilt binaries for all examples are supplied within the Development

Package. These can easily be rebuilt (to produce 32bit binaries by default or

64bit binaries by using the 64bit flag) using the makeall file as follows.

makeall.sh clean

makeall.sh

makeall.sh clean

makeall.sh 64bit

2.3.3 Running UPD samples

From within the UPD RUN directory select the directory for the concerned

sample, and then the configuration type (M3UA, MTP or M2PA) and CONFIG,

CONFIG_1 or CONFIG_2.

For M3UA and M2PA configurations – in the config.txt file change the IP

addresses to match the local and remote systems.

For MTP configurations – ensure the board type, codefile and board interface

task are correct for the host system within the config.txt and system.txt files.

From within the same directory run gctload and then the sample itself -

unless it is started (‘forked’) within system.txt.

For detailed information on running each sample, refer to the relevant UPD

sample user guide.

Note: The development package contains the latest version of the

configuration files which may differ from those given in the user guides.

2.4 Reading number of pending messages

The ability to read back the number of outstanding messages queued on a

message queue has been added. This can be achieved using a command line

option for gctload or programmatically using a new function

GCT_pending_msgs() contained within gctlib.

To use gctload the user should run a second instance of gctload using the –t3

option as follows, this will list the number of queued messages on each local

message queue:

gctload – t3

LOCAL 0x10: 5 messages queued.

LOCAL 0x20: 0 messages queued.

Alternatively the function GCT_pending_msgs can be used to

programmatically return the number of messages currently queued on a

single named local message queue. The function prototype is:

int GCT_pending_msgs(unsigned int module_id)

The function returns a positive integer indicating the number of messages

currently queued on message queue, module_id or a negative integer on

error.