如何在SDL中调用C语言函数

如何在SDL中调用C语言函数摘

要:从实际工作出发,提出了在SDL中调用C语言函数的必要性,并给出了SDL语言中使用C语言数据类型、公共变量以及调用C语言函数的方法。这种方法具有很强的实用性,大大提高了工作效率,加快了实时多任务系统多任务系统应用软件的开发。此方法实际应用于第三代移动通信系统TD-SCDMATD-SCDMA高层信令信令的开发,收到了良好效果。关键词:进程

SDL

实时多任务系统

TD-SCDMA

C语言函数

数据类型

公共变量

SDL(SpecificationandDescriptionLanguage)是CCITT推荐的规范描述语言。经过ITU-T的发展和标准化,定义在蓝皮书Z.100建议中。1988年推出第一个正式版,以后每四年进行一次增补更新。作为国际标准化的正式语言,用来规范描述实时系统。目前SDL-2000是SDL最新版本。作为SDL相关技术Z.120建议——消息序列图MSC(MessageSequenceCharts)和Z.105建议——抽象语法符号ASN.1(AbstractSyntaxNotationOne)和SDL一起形成一个完整的描述语言。本文中介绍的SDL软件由TelelogicTauAB公司提供。在协议软件的开发流程中,SDL应用在系统规范描述和设计阶段。它完全独立于硬件实现和操作系统。TelelogicTau公司提供的SDL软件不仅可以用于规范描述和设计,它还可以把SDL的描述和设计直接生成标准的C代码;用户也可以直接在SDL描述和设计中嵌入C代码,从而完成部分功能。经SDL描述产生的C代码(包括嵌入的C代码)可以直接与多种嵌入式(或非嵌入式)实时多任务操作系统(RTOS)集成,如NUCLUES、pSOS、Solaris、Vrtx、OSE等。集成后的代码可以直接在目标板上运行,从而方便用户进行协议软件的开发。虽然SDL软件具有很强的开发功能,但是在重庆邮电学院信科公司的TD-SCDMA系统高层信令的二三层开发中,也遇到了许多问题,主要有:(1)由于TD-SCDMA系统的高层信令是由几个部门共同负责的,除了二三层以外还有MMI和物理层控制部分的软件,不可能将各个部门统一使用SDL软件共同完成系统的信令开发工作。每个部门最终提供的应该是标准的C语言源代码源代码,最后在实时操作系统上集成。利用SDL软件生成的C源代码,不便于和其它部分的代码相互集成。(2)高层二三层信令是一个很复杂的系统,各个进程之间需要大量的数据交换,而SDL要求所有进程间的数据交流必须通过信号来完成(虽然可以使用SDL的VIEW功能,但使用不方便)。在系统启动后,很多数据需要进行通信,系统资源将被白白浪费在通信上面。但是SDL的测试功能特别强大,可以从不同角度对SDL描述进行测试,发现错误及时返回进行修改。如果没有SDL的TTCN测试,所有设计结果在硬件平台上测试将困难重重,即使可以对硬件平台运行结果进行跟踪,也始终没有TTCN测试结果MSC图方便。并且SDL可以对系统任何部分独立测试。在SDL设计结果和RTOS系统集成之前,基本保证了SDL设计阶段的正确性,减少了繁琐的板级代码调试,从而可在较短时间内将SDL设计结果移植到硬件工作平台,提高了工作效率。为了SDL软件的设计结果既可以被SDL软件的TTCN测试又可以直接和其它C语言源代码集成,必须解决一个问题——如何在SDL中调用C语言函数。实现模式SDL内核对SDL进程的管理采用了消息驱动事件的方法,SDL内核对SDL进程的调度是根据消息队列中的消息来进行的。如图1,表明了SDL进程、SDL内核和SDL信号队列的关系。

SDL图形描述转换成C源代码,没有系统(system)和功能块(block)的概念,只有进程和通信,它们由SDL内核程序管理和协调。在各个进程间没有全局变量,所有的数据交换都要通过信号来传递。一个进程要发送信号到另外一个进程,需要先发送到SDL信号队列中等待SDL内核程序的处理。在实时多任务系统的编程中,最关心的是状态的划分和在什么状态下收到什么信号以及做何种处理。所以在SDL中,应该利用标准C语言源代码对数据、信号定义并对收到的信号进行处理。要求这部分代码既能在SDL中进行测试又可以在实时操作系统中使用。在整个开发过程中,始终坚持这样一个原则,利用SDL来划分通信模块,在协议中规定的原语尽量用信号来传递,而非标准的信息则使用公共变量,进程的代码利用C语言来实现；最后利用TTCN进行全面的面的测试。在TD-SCDMA信令设计中证实这种设想可行。图2就是TD-SCDMA系统部分高层软件的开发模式图。

在开发的初始阶段,根据TD-SCDMA系统协议TSM,考虑将系统划分成多少个进程,各进程间需要哪些信号及全局变量数据,然后定义数据类型、编写C语言源代码。所有C源代码是按照在什么状态下接收什么信号,处理以后发送什么信号格式来完成。这样编写的代码既可以在RTOS中应用,又可以满足SDL的要求,方便TTCN的测试。如图2利用标准C完成的源代码可以和SDL相互集成,并且进行TTCN测试;同时又可以和RTOS系统集成,在实际硬件环境中运行。完成的C语言源代码,经过TTCN测试后,保证了信号处理的正确性。在软件开发后期,只需根据协议变换作适当的程序修改和C语言源代码的移植即可。在SDL的说明文档中,提到了怎样将C语言函数应用于SDL系统;但是这种方法经过多次实验效果均不理想,即使能够实现也是受到诸多限制。所以舍弃了SDL提供的方法,最终找到了一种切实可行的方法,方法如3小节描述。实现过程C源代码不能直接在SDL中使用。首先应该利用sdth2sdl.exe软件将C语言的头文件转换成SDL的文本描述(PR描述),如图3。然后在SDL的Organizer界面中,将文本描述转换成图形描述方式,它以SDL的SUN文件形式存在。最后在设计的SDL系统中利用use关键字声明即可。具体如下:(1)利用sdth2sdl.exe程序转换C语言头文件。sdth2sdl.exe是TelelogicTauAB公司提供的可执行文件。在使用该文件时,需要操作系统装有MSC7.00或是MSVC++编译器(不能是BorlandC编译器)。sdth2sdl.exe自动调用标准C的编译器,进行C语法检查,再将C部分代码转化成SDL的PR格式。sdth2sdl.exe只检查头文件的数据类型、数据定义以及函数的声明。在该过程中,不检查具体C语言函数的语法。实际上,C语言函数不能直接转换成SDL的图形描述或文本描述方式。为了方便使用sdth2sdl工具,sdth2sdl是一个可以带参数的DOS程序,格式为:sdth2sdl

[参数选项]

要转换的C语言头文件它的参数选项如表1。在实际应用中,最常用的参数选项有n、s、I三个参数选项。(2)将SDL的PR文件转换成GR方式。利用SDTH2SDL程序生成一个以PR为扩展名的SDLPackage文件。在SDL的Organizer界面的Generate菜单中有“ConverttoGR...”选项,利用SDL的ConverttoGR对话框完成PR文件到GR格式的转换。生成的SDLPackage文件的名字是SDLPR描述内部指定的名字。(3)在SDL系统中声明。在SDL进程中,不能直接使用C语言的数据类型、变量定义和函数,上面生成的是SDLPackage文件,需要在system中利用SDL关键字use加以声明。格式为usepackage文件名。这样可以在SDL进程中任意使用C语言头文件的函数、数据类型及变量。虽然这些定义在SDL中都可以使用,但是它们还必须遵守SDL调用C变量和函数的规则。①变量调用由于SDL可以调用C语言函数,基本上系统所有的处理由C语言函数来完成。所以在SDL和C源代码所用的公共变量很少,仅仅只有一些SDL专用的数据,例如控制SDL的分支等。调用格式为:变量赋值:CallSet_变量名去变量值:CallGet_变量名②数据类型引用虽然整个系统的任务在C源代码中完成,但是在进行信号处理时,SDL需要保存信号到变量中(SDL描述要求),信号类型在C语言中定义。C语言数据类型转换成SDL数据类型时,保持了原来的数据类型名字,在SDL中只要按照SDL规则定义数据即可。③函数调用C语言函数的调用和变量调用、数据类型引用基本相同,需要注意的是函数的参数。调用格式:Call函数名字(函数需要的实参)由于C语言编写的C函数中可以使用全局变量,大大方便了C语言在SDL中的应用,需要处理的公共数据可以不以SDL信号方式进行传递。例如在TD-SCDMA高层信令的设计中,小区信息以及系统消息是很多进程都需要使用的,就可以作为全局变量使用。举例说明下面的例子是在空闲状态下收到来自物理层的测量报告IdleNcellMeasInd信号和发送到物理层进行小区BSIC解读的BsicDecodeReq请求信号。将分以下几个步骤来说明:(1)C语言头文件trr.h的编写所有在SDL中调用到的数据类型、全局变量和函数必须在C语言头文件中声明,只有声明过的才能在SDL中调用或引用。在头文件中可以使用任何标准C语法。在下面的头文件中,由于篇幅关系,没有给出详细的下级数据类型的定义。#ifndef__TRR__#define__TRR__typedefstructMessageHeader}

int

header；

/*实时操作系统的数据头，不同的RTOS的T_MsgHeaher定义不相同*/{T_MessageHeader；typedefstructt_IdleNcellMeasIndTag}

int

numMeas；

/*邻近小区数*/

NcellList

ncellList；

/*邻近小区标识表*/

intrscpLevelList[MAX_NCELL]；

/*邻近小区功率测量结果*/{T_IdleNcellMeasInd；typedefstructh_t_IdleNcellMeasInd}

T_MessageHeadersignalHeader；

/*实时多任务系统头标识*/

T_IdleNcellMeasIndIdleNcellMeasInd；

/*邻近小区测量数据*/{H_T_IdleNcellMeasInd；typedefstructt_BsicDecodeReqTag}

NcellNccDecode

ncc；

/*邻近小区BSIC数据*/{T_BsicDecodeReq；typedefstructh_t_BsicDecodeReq}

T_MsgHeader

signalHeader；

T_BsicDecodeReq

BsicDecodeReq；{H_T_BsicDecodeReq；externH_T_IdleNcellMeasInd

s_trr_IdleNcellMeasInd；

/*接收处理的变量*/externH_T_BsicDecodeReq

s_trr_BsicDecodeReq；

/*需要发送的变量*/inttrr03_01IdleNcellMeasInd(H_T_IdleNcellMeasInd*p)；

/*收到测量的处理程序*//*#include″trr.c″*/#endif在trr.h中,使用sdth2sdl时应该将#include“trr.c”屏蔽,不需要将trr.c文件编译和转换成SDL的文本描述。但在生成SDL的TTCN或Simulator、Validator的可执行文件时,需要将C语言屏蔽符/**/去掉。这样在生成可执行文件时,SDL将trr.c定义的内容和SDL描述直接汇合编译连接在一起。(2)C语言函数trr.c的编写在C语言头文件中声明的全局变量和函数实体都是在C源代码中定义的。在trr.c文件中定义s_trr_IdleNcellMeasInd、s_trr_BsicDecodeReq全局变量和inttrr03_01IdleNcellMeasInd()函数。C语言函数不直接转换成SDL描述,可以支持标准C语言的所有使用方法。#include“trr.h”H_T_IdleNcellMeasInds_trr_IdleNcellMeasInd；

/*定义接收信号的变量*/H_T_BsicDecodeReq

s_trr_BsicDecodeReq；

/*定义发送信号的变量*/inttrr03_01IdleNcellMeasInd(H_T_IdleNcellMeasInd*p)}

inttempCount；

intrscp[MAX_NCELL]；

s_trr_BsicDecodeReq.signalHeader=p->signalHeader；

rscp[tempCount]=p->IdleNcellMeasInd.RscpLev-

elList[tempCount]；

/*保存测量*/

s_trr_BsicDecodeReq.BsicDecodeReq.ncc.numMeas=10；for(tempCount=0；tempCount}

s_trr_BsicDecodeReq.BsicDecodeReq.ncc.frequency

NUM_NCELLS]=tempCount；

s_trr_BsicDecodeReq.BsicDecodeReq.ncc.syncCode

[NUM_NCELLS]=tempCount；

s_trr_BsicDecodeReq.BsicDecodeReq.ncc.syncDiff

[NUM_NCELLS]=tempCount；{returnTRR_IDL；

/*#defineTRR_IDL1*/{

/*函数的返回值表明是否需要发送BsicDecodeReq信号*/在该例子中,函数返回值决定了是否需要发送BsicDecodeReq信号到物理层。利用这种方法可以确定SDL描述的分支处理。(3)sdth2sdl的使用编写完成trr.h文件后,就可以将trr.h文件转换成SDL的文本描述,在DOS系统提示符下执行下列命令:sdth2sdl-ntrr-sc：td_scdmaprtsm_trr.pr-o″-Ic：bc5include-Ic：tdscdmatrrinclude″trr.h在编译过程中,如果C语言源代码编写不正确,将有错误提示。必须根据提示修正所有的错误(每个头文件的最后一行必须是空行),直到生成正确的tsm_rr.pr文件。在tsm_rr.pr文件中指明