CN109408050B - 用于轨道车辆的设备应用程序接口的代码生成方法及装置 - Google Patents

Abstract

本发明提供一种用于轨道车辆的设备应用程序接口的代码生成方法及装置。本发明提供的代码生成方法包括确定数据流文件的格式；该数据流文件包括：至少一个设备在MVB上的第一端口参数以及每个设备的第一通信参数；根据该数据流文件的格式，从该数据流文件中获取待生成代码的设备的通信表单；根据该待生成代码的设备的通信表单，生成该待生成代码的设备的应用程序接口代码。该方法通过对数据流文件进行解析，从数据流文件中获取生成代码所需的关键信息，根据这些关键信息自动生成代码文件，而不需要人工进行代码编程，提高了代码生成效率。

Description

用于轨道车辆的设备应用程序接口的代码生成方法及装置

技术领域

本发明涉及轨道交通技术，尤其涉及一种用于轨道车辆的设备应用程序接口的代码生成方法及装置。

背景技术

目前，基于多功能车辆总线(Multifunction Vehicle Bus，简称MVB)的列车网络控制系统(Train Control and Management System，简称TCMS)已广泛应用于各种轨道车辆中。其中，TCMS由若干设备组成，各设备之间、各设备与车辆其他子系统设备之间通过MVB进行通信。

在实际应用中，每个设备在MVB上具有对应的端口，每个设备的端口具有对应的应用程序接口，该每个设备可通过访问该应用程序接口，与该应用程序接口对应的其它设备进行通信。每个设备在访问应用程序接口之前，需运行该每个设备对应的接口代码，进行应用程序接口配置。不同的设备可具有不同的接口代码，而同一个设备对应的不同项目可具有不同的代码。

目前，各设备的接口代码由人工进行编程，其效率低下。

发明内容

本发明提供一种用于轨道车辆的设备应用程序接口的代码生成方法及装置，以提高设备应用程序接口代码的生成效率。

本发明提供一种用于轨道车辆的设备应用程序接口的代码生成方法，包括：

确定数据流文件的格式；该数据流文件包括：至少一个设备在MVB上的第一端口参数以及每个设备的第一通信参数；

根据该数据流文件的格式，从该数据流文件中获取待生成代码的设备的通信表单；该待生成代码的设备的通信表单包括该每个设备的第二通信参数；

根据该待生成代码的设备的通信表单，生成该待生成代码的设备的应用程序接口代码。

具体的，该确定数据流文件的格式，包括：

加载预设的格式配置文件，获取该数据流文件的格式；该数据流文件包括网络描述文档和接口文档；该格式配置文件包括：该网络描述文档和该接口文档在该数据流文件中的位置；

该根据该数据流文件的格式，从该数据流文件中获取待生成代码的设备的通信表单，包括：

根据该网络描述文档在该数据流文件中的位置，从该数据流文件中获取该网络描述文档；该网络描述文档包括：该至少一个设备在MVB上的第一端口参数；从该网络描述文档中获取该待生成代码的设备的第二端口参数；

根据该接口文档在该数据流文件中的位置，从该数据流文件中获取该接口文档，该接口文档包括：该每个设备的第一通信参数；从该接口文档，结合该待生成代码的设备的第二端口参数中获取该待生成代码的设备的通信表单。

具体的，该从该网络描述文档中获取该待生成代码的设备的第二端口参数，包括：

根据该网络描述文档中多个端口的第一端口参数，对该多个端口进行排序；

根据该排序的结果，以及预设的初始地址，计算该多个端口的首地址；

根据该每个设备在MVB上的第一端口参数以及该多个端口的首地址，获取该待生成代码的设备的第二端口参数。

该待生成代码的设备的第二端口参数包括端口号、端口首地址、源设备名、宿设备名、端口大小、特征周期、源宿类型。

可选的，该从该接口文档，结合该待生成代码的设备的第二端口参数中获取该待生成代码的设备的通信表单，包括：

根据该每个设备的第一通信参数与该待生成代码的设备的第二端口参数，进行端口匹配，获得相匹配的所有端口号；

根据该相匹配的所有端口号，与该待生成代码的设备的第二端口参数，生成该待生成代码的设备的第一端口数据表单；

将该第一通信参数中的变量名进行解析得到接口变量，将该接口变量添加到该待生成代码的设备的第一端口数据表单中，生成该待生成代码的设备的第二端口数据表单；

根据该待生成代码的设备的第二端口数据表单和该接口文档，获取得到该待生成代码的设备的通信表单。

具体的，该待生成代码的设备的第二通信参数包括：

通信序号、字节偏移、位偏移、数据类型、信号名称、描述信息、端口号、接口变量名、源设备名、源宿类型、端口首地址。

可选的，该待生成代码的设备的第二通信参数还包括：单位、变量范围、标记、通用。

本发明还可提供一种代码生成装置，包括：

确定模块，用于确定数据流文件的格式；该数据流文件包括：至少一个设备在MVB上的第一端口参数以及每个设备的第一通信参数；

获取模块，用于根据该数据流文件的格式，从该数据流文件中获取待生成代码的设备的通信表单；该待生成代码的设备的通信表单包括该待生成代码的设备的第二通信参数；

生成模块，用于根据该待生成代码的设备的通信表单，生成该待生成代码的设备的应用程序接口代码。

可选的，该获取模块包括：

第一获取单元，用于根据该网络描述文档在该数据流文件中的位置，从该数据流文件中获取该网络描述文档；该网络描述文档包括：该至少一个设备在MVB上的第一端口参数；从该网络描述文档中获取该待生成代码的设备的第二端口参数；

第二获取单元，用于根据该接口文档在该数据流文件中的位置，从该数据流文件中获取该接口文档，该接口文档包括：该每个设备的第一通信参数；从该接口文档，结合该待生成代码的设备的第二端口参数中获取该待生成代码的设备的通信表单。

可选的，该第一获取单元包括：

排序子单元，用于根据该网络描述文档中多个端口的第一端口参数，对该多个端口进行排序；

计算子单元，用于根据该排序的结果，以及预设的初始地址，计算该多个端口的首地址；

第一获取子单元，用于根据该每个设备在MVB上的第一端口参数以及该多个端口的首地址，获取该待生成代码的设备的第二端口参数。

可选的，该第二获取单元包括：

匹配子单元，用于根据该接口文档中每个设备的第一通信参数，将该第一通信参数中的端口地址与该待生成代码的设备的第二端口参数中的端口号匹配，获得相匹配的所有端口号；

第一生成子单元，用于根据该相匹配的所有端口号，与该待生成代码的设备的第二端口参数，生成该待生成代码的设备的第一端口数据表单；

第二生成子单元，用于将该第一通信参数中的变量名进行解析得到接口变量，将该接口变量添加到该待生成代码的设备的第一端口数据表单中，生成该待生成代码的设备的第二端口数据表单；

第二获取子单元，用于根据该待生成代码的设备的第二端口数据表单和该接口文档，获取该待生成代码的设备的通信表单。

本发明提供一种用于轨道车辆的设备应用程序接口的代码生成方法及装置，其中，该方法包括确定数据流文件的格式；该数据流文件包括：至少一个设备在MVB上的第一端口参数以及每个设备的第一通信参数；根据该数据流文件的格式，从该数据流文件中获取待生成代码的设备的通信表单；根据该待生成代码的设备的通信表单，生成该待生成代码的设备的API接口代码。该方法通过对数据流文件进行解析，从数据流文件中获取生成代码所需的关键信息，并根据这些关键信息自动生成代码文件，提高了生成设备应用程序接口代码的效率。

附图说明

为了更清楚地说明本发明实施例或现有技术中的技术方案，下面将对实施例或现有技术描述中所需要使用的附图做一简单地介绍，显而易见地，下面描述中的附图是本发明的一些实施例，对于本领域普通技术人员来讲，在不付出创造性劳动性的前提下，还可以根据这些附图获得其他的附图。

图1为本发明提供的用于轨道车辆的设备应用程序接口的代码生成方法实施例一的流程图；

图2为本发明提供的用于轨道车辆的设备应用程序接口的代码生成方法实施例二的流程图；

图3为本发明提供的用于轨道车辆的设备应用程序接口的代码生成方法实施例三的流程图；

图4为本发明提供的代码生成装置实施例一的结构示意图；

图5为本发明提供的代码生成装置实施例二的结构示意图；

图6为本发明提供的代码生成装置实施例三的结构示意图；

图7为本发明提供的计算机设备的结构示意图。

具体实施方式

为使本发明实施例的目的、技术方案和优点更加清楚，下面将结合本发明实施例中的附图，对本发明实施例中的技术方案进行清楚、完整地描述，显然，所描述的实施例是本发明一部分实施例，而不是全部的实施例。基于本发明中的实施例，本领域普通技术人员在没有做出创造性劳动前提下所获得的所有其他实施例，都属于本发明保护的范围。

图1为本发明提供的用于轨道车辆的设备应用程序接口的代码生成方法实施例一的流程图。该用于轨道车辆的设备应用程序接口的代码生成方法可由一可以执行程序代码的处理器执行，如计算机设备。如图1所示，本实施例的方法可以包括：

步骤101、确定数据流文件的格式；该数据流文件包括：至少一个设备在MVB上的第一端口参数以及每个设备的第一通信参数。

在基于MVB的轨道车辆中，各个设备之间的通信需要按照一定的接口规范进行，这些接口规范通常被记录在数据流文件中。该数据流文件可以为一种自然语言编写的电子表格，例如Excel文件，其中记载了至少一个设备在MVB上的第一端口参数以及每个设备的第一通信参数。

可选的，该第一端口参数可以包括设备的端口信息、设备信息以及设备所在系统的信息，例如，该端口信息可以包括：端口序号、端口地址、源设备名、宿设备名、F-Code、特征周期、地址描述。其中，F-Code表示请求的类别和期望相应的从帧的大小；特征周期表示端口间隔多长时间进行一次通讯。如下表1所示：

以表1中端口序号为1的端口进行说明，其端口地址为0xF，该端口所对应的源设备为CCU，该端口所对应的宿设备为ALL，也就是所有子系统的设备。该端口的F-Code为3，特征周期为256，其端口地址是CCU到所有MVB设备的端口地址。特别地，源设备名或宿设备名如RIOM:1的形式时，该设备名中的“：”后的数字，表示设备号。

该设备信息可以包括：设备序号、设备名、设备位置、设备地址、设备所属系统、设备说明。其中，设备地址通常用1-2位十六进制数字表示接入MVB的一个设备的地址。如下表2所示：

设备序号	设备名	设备位置	设备地址	设备所属系统	设备说明
						1	CCU	Car1	0x01	CCU	中央控制单元
2	ALL	Car1-8	——	ALL	所有子系统
						3	RIOM:1	Car1	0x11	RIOM	远程输入输出机箱1
4	RIOM:2	Car2	0x12	RIOM	远程输入输出机箱2
						5	RIOM:3	Car3	0x13	RIOM	远程输入输出机箱3
6	RIOM:4	Car4	0x14	RIOM	远程输入输出机箱4
						7	BCU:1	Car1	0x41	BCU	制动控制单元1
8	BCU:4	Car4	0x42	BCU	制动控制单元2
						9	BCU:5	Car5	0x43	BCU	制动控制单元3
10	BCU:8	Car8	0x44	BCU	制动控制单元4

以表2中设备序号为1的设备进行说明，该设备名为CCU，其设备位置为Car1，也就是该设备位于1车厢内，设备地址为0x01，该设备属于CCU系统，该设备为中央控制单元。

该系统信息可以包括：系统序号、系统代号、系统缩写、系统名称、系统全称，其中，系统全称为可选项。如下表3所示：

系统序号	系统代号	系统缩写	系统名称	系统全称
					1	ALL	AL	所有子系统	——
2	CCU	CT	中央控制单元	——
					3	RIOM	RM	远程输入输出单元	——
4	BCU	BR	制动系统	——

该第一通信参数可以包括设备之间的接口定义信息，该接口定义信息逐行记录在数据流文件中。例如，第一设备和第二设备之间的接口定义信息，按照第一设备到第二设备的接口定义信息、以及第二设备到第一设备的接口定义信息分别进行记录。

可选的，该接口定义信息可以包括：接口序号、端口地址、字节偏移、位偏移、数据类型、变量名、信号名、接口描述、单位、变量范围、标记、通用。其中，字节偏移是指是指端口中的数据按照字节从左往右按字节排列时所处位置的序号，从0开始到端口最后一个字节为止；位偏移用于确定字节中的位在其所属字节中的位置；变量名为通过该接口所发送的通信数据中所携带的参数变量的名称；标记是用于特殊用途的标志，比如E代表这是一个记入数据记录的变量；通用表示在其他列中无法描述的特征，比如这是与一个特殊模拟量采集的值，可能标为“AI”。

CCU设备到所有子系统设备的接口定义信息如下表4所示：

以接口序号为1的接口定义信息进行说明，该接口定义信息为设备CCU向所有子系统设备发送通信数据的定义信息，该通信数据通过端口地址0xF发送，其中端口地址0xF的字节偏移和位偏移均为0。该通信数据中携带的变量参数为CTAL_CCULfSign_U16，其数据类型为UNSIGNED16，也就是16位无符号整型。该通信数据传输的信号为CCU设备的生命信号。同样的，其他设备之间也具有如表4所示格式的接口定义信息。

确定数据流文件的格式，也就是确定该第一端口参数和该第一通信参数在数据流文件中的位置，以便于在后续步骤中，按照该第一端口参数和该第一通信参数在数据流文件中的位置从数据流文件中读取该第一端口参数和该第一通信参数。

步骤102、根据该数据流文件的格式，从该数据流文件中获取待生成代码的设备的通信表单；该通信表单包括该待生成代码的设备的第二通信参数。

具体的，在进行应用程序代码生成之前，需要确定需要生成代码的设备，该设备可以为车辆中的中央控制单元、显示屏，也可以为其他设备，在应用中可以根据实际需要选择。

根据步骤101中确定的数据流文件的格式，从数据流文件中读取第一端口参数和第一通信参数，在读取第一端口参数时，还可对其进行校验，以保证参数的正确性。例如，根据在第一端口参数中，根据待生成代码的设备，读取与其相关的端口信息，根据端口信息中的源设备名，在第一端口参数的设备信息中查询其中是否存在该设备名，并查找该设备名所属的系统，在根据该所述的系统，在第一端口信息的系统信息中，查询是否注册了对应的系统代号和系统的缩写。

按照预设的规则对该第一端口参数和该第一通信参数进行解析，获取待生成代码的设备的通信表单。该待生成代码的设备通信表单中包括了从该第一端口参数和该第一通信参数中读取或解析得到的该待生成代码的设备第二通信参数。如下表5所示：

该待生成代码的设备的通信表单中的第二通信参数可以包括：通信序号、字节偏移、位偏移、数据类型、信号名、接口描述，以及解析获得的端口号、接口变量名、源设备名、源宿类型、端口首地址。该第二通信参数还可以包括单位、范围、标记、通用，上表5中未作示例，在应用中可根据实际需要添加。

步骤103、根据该待生成代码的设备的通信表单，生成该待生成代码的设备的应用程序接口代码。

根据待生成代码的设备的需求，从通信表单中选取相应的关键信息，生成文本类型的计算机代码。

具体的，从待生成代码的设备的通信表单中选取生成代码所需的关键信息，例如，对于需要生成ST代码的设备，选取：接口变量名、端口首地址、字节偏移、位偏移、数据类型、信号名、接口描述；对于需要生成.h或.c文件的设备，选取：端口号、字节偏移、位偏移、接口变量名、源宿类型。根据需要生成文件的类型将该关键信息进行整理、计算、添加固定语法字符，最终生成应用程序接口代码文件。该应用程序接口代码文件作为设备上运行的程序代码中的一部分，可以使得设备之间按照该接口代码进行通信。

示例的，输出ST代码时，可以将端口首地址、字节偏移、位偏移相加得到变量地址。以下为输出的ST代码示例：

其中，RM1CT_GWVersion_U8是软件程序中可以使用的全局变量变量名，AT％I1.0是变量地址，AT％I对应接收区，AT％Q对应输出区，1.0是计算得到的地址，USINT是无符号8位数据类型。

示例的，输出.h文件时，例如对于车辆中的显示屏设备，采用C++进行编程，生成.h文件。软件应用程序接口提供了取端口数据的函数。可以根据数据类型选择定义函数，例如定义函数getUnsignedInt、getUnsignedChar、getUnsignedBool。以下为输出的.h文件示例：

其中，this->CTAL_CCULfSign_U16定义了一个全局变量名，crrcMvb->getUnsignedInt(0xF,0)使用的是应用程序接口函数，0xF和0是函数的参数，即端口号和字节偏移。

可选的，在步骤103中，除了生成应用程序接口代码文件之外，还可根据该待生成代码的设备的通信表单生成接口配置文件，该接口配置文件可以直接被加载在对应的设备上，用于使得该设备按照该接口配置文件中的配置运行。

本实施例提供的用于轨道车辆的设备应用程序接口的代码生成方法，包括确定数据流文件的格式；该数据流文件包括：至少一个设备在MVB上的第一端口参数以及每个设备的第一通信参数；根据该数据流文件的格式，从该数据流文件中获取每个设备的通信表单；根据该通信表单，生成该每个设备的应用程序接口代码。该方法通过对数据流文件进行解析，从数据流文件中获取生成代码所需的关键信息，根据这些关键信息自动生成代码文件，而不需要人工进行代码编程，提高了代码生成效率。

在上述实施例一的基础上，本发明还可提供一种用于轨道车辆的设备应用程序接口的代码生成方法。图2为本发明提供的用于轨道车辆的设备应用程序接口的代码生成方法实施例二的流程图。如图2所示，在图1所示方法的基础上，步骤101中确定数据流文件的格式可以包括：

步骤201、加载预设的格式配置文件，获取数据流文件的格式；该数据流文件包括网络描述文档和接口文档；该格式配置文件包括：该网络描述文档和该接口文档在该数据流文件中的位置。

具体的，数据流文件中的第一端口参数可以记录在网络描述文档中，数据流文件中的第一通信参数可以记录在接口文档中，该网络描述文档和该接口文档位于同一个数据流文件的不同标签页中。该第一端口参数可以包括设备的端口信息、设备信息以及设备所在系统的信息，具体可以为端口清单、设备清单和系统清单，该端口清单、设备清单和系统清单均位于不同的标签页内。

该第一通信参数可以包括设备之间的接口定义信息，具体可以为接口定义清单。第一设备和第二设备之间的接口定义信息，按照第一设备到第二设备、以及第二设备到第一设备分别记录在不同的标签页中。例如接口定义清单标签页依次为CCU->ALL、RIOM->CCU、CCU->RIOM、BCU-CCU，分别表示CCU设备到所有子系统的接口定义信息，RIOM设备到CCU设备的接口定义信息，CCU设备到RIOM设备的接口定义信息，BCU设备到CCU设备的接口定义信息。

预设的格式配置文件中记录了网络描述文档和接口文档在数据流文件中的位置，可以包括：系统清单标签页号、设备清单标签页号、端口清单标签页号、接口定义清单标签页起始页号。示例的，该预设的格式配置文件可以为一个文本文件，内容为“1,2,3,4”，使用“,”分隔数字，分别表示系统清单标签页号为1，设备清单标签页号为2，MVB端口清单标签页号为3，数据定义标签页起始页号为4。通过加载该预设的格式配置文件，即可获取该数据流文件的格式，也就是网络描述文档和接口文档在数据流文件中的位置。

上述步骤102中根据该数据流文件的格式，从该数据流文件中获取每个设备的通信表单可以包括：

步骤202、根据该网络描述文档在该数据流文件中的位置，从该数据流文件中获取该网络描述文档；从该网络描述文档中获取该待生成代码的设备的第二端口参数。

根据上述预设的格式配置文件，获得网络描述文档在该数据流文件中的位置，也就是获得端口清单、设备清单和系统清单在数据流文件中的位置，从该数据流文件的相应位置读取该端口清单、该设备清单和该系统清单。对该端口清单、该设备清单和该系统清单进行解析，得到待生成代码的设备的第二端口参数。具体的，可以将端口清单中的端口地址进行解析得到端口号，并计算各个端口的首地址。

可选的，第二端口参数可以包括：端口号、源设备名、宿设备名、端口大小、特征周期、源宿类型、端口首地址。

步骤203、根据该接口文档在该数据流文件中的位置，从该数据流文件中获取该接口文档；从该接口文档，结合该待生成代码的设备的第二端口参数中获取该待生成代码的设备的通信表单。

根据上述预设的格式配置文件，获得接口文档在该数据流文件中的位置，并从该数据流文件的相应位置逐行读取该接口文档，也就是读取接口定义清单，对该接口定义清单进行解析，具体的，可以将接口定义清单中的端口地址和变量名进行解析，获得解析后的端口号和接口变量名。

从上述解析的结果以及该待生成代码的设备的第二端口参数中获取该待生成代码的设备的通信表单，该通信表单中包括第二通信参数。具体的，该第二通信参数可以包括：通信序号、字节偏移、位偏移、数据类型、信号名、接口描述、单位、变量范围、标记、通用，以及解析后的端口号、接口变量名、源设备名、源宿类型、端口首地址。

在具体的实现中，该步骤中对接口定义清单可以通过一次性读取和解析的方式来实现。此外，还可以通过读取一行解析一行，直到数据流文件最后一个标签页的方式，也就是说，在接口定义清单中每读取一行数据，就对其进行解析，获得解析后的端口号和接口变量名，之后再将该解析后的结果与该待生成代码的设备的第二端口参数中相对应的行结合，获得该行对应的部分通信表单，将所有行解析完成后，由每一行所形成的部分通信表单形成该待生成代码的设备的通信表单。也可以为其他方式，本发明对此不做限定。

本实施例提供的用于轨道车辆的设备应用程序接口的代码生成方法，在图1所示方法的基础上还可包括，加载预设的格式配置文件，获取数据流文件的格式；该数据流文件包括网络描述文档和接口文档；该格式配置文件包括：该网络描述文档和该接口文档在该数据流文件中的位置；根据该网络描述文档在该数据流文件中的位置，从该数据流文件中获取该网络描述文档；从该网络描述文档中获取该待生成代码的设备的第二端口参数：根据该接口文档在该数据流文件中的位置，从该数据流文件中获取该接口文档；从该接口文档和该待生成代码的设备的第二端口参数中获取该待生成代码的设备的通信表单。该方法通过格式配置文件记录数据流文件的格式，在数据流文件改变时只需修改相应的格式配置文件即可获得正确的数据流文件。同时，通过解析数据流文件中的网络描述文档和接口文档获得生成代码所需的通信表单，提高了代码生成效率。

在上述实施例二的基础上，本发明还可提供一种用于轨道车辆的设备应用程序接口的代码生成方法。图3为本发明提供的用于轨道车辆的设备应用程序接口的代码生成方法实施例三的流程图。如图3所示，在图2所示方法的基础上，步骤202中的从该网络描述文档中获取该待生成代码的设备的第二端口参数，可以包括：

步骤301、根据该网络描述文档中多个端口的第一端口参数，对该多个端口进行排序。

具体的，确定该多个端口相对于待生成代码的设备的源宿类型，也就是确定该设备为该多个端口的源设备或宿设备。例如若该设备为某端口的源设备，则该端口相对于该设备的源宿类型为Q，若该设备为某端口的宿设备，则该端口相对于该设备的源宿类型为I。将该多个端口按照其源宿类型分为两类，最后分别对两类端口按照端口号从小到大的顺序进行排序。

步骤302、根据该排序的结果，以及预设的初始地址，计算该多个端口的首地址。

具体的，预设的初始地址可以为0，按照排序的结果以及端口大小依次计算每个端口的首地址，端口首地址以字节为单位。

步骤303、根据该每个设备在MVB上的第一端口参数以及该多个端口的首地址，获取该待生成代码的设备在MVB上的第二端口参数。

从第一端口参数中读取信息，并在对应的行添加上述计算得到的端口首地址，获得待生成代码的设备的第二端口参数，该第二端口参数可以包括端口号、源设备名、宿设备名、端口大小、特征周期、源宿类型、端口首地址。如下表6所示：

端口号	源设备名	宿设备名	端口大小	特征周期	源宿类型	端口首地址
							0x110	RIOM:1	CCU	4	64	I	0
0x120	RIOM:2	CCU	4	64	I	32
							0x130	RIOM:3	CCU	4	64	I	64
0x140	RIOM:4	CCU	4	64	I	96
							0x410	BCU:1	CCU	4	256	I	128
0x420	BCU:4	CCU	4	256	I	160
							0x430	BCU:5	CCU	4	256	I	192
0x440	BCU:8	CCU	4	256	I	224
							0xF	CCU	ALL	3	256	Q	0
0x118	CCU	RIOM:1	4	64	Q	16
							0x128	CCU	RIOM:2	4	64	Q	48
0x138	CCU	RIOM:3	4	64	Q	80
							0x148	CCU	RIOM:4	4	64	Q	112
0x408	CCU	BCU	4	64	Q	144

上表中将端口号按照其相对于设备CCU的源宿类型分为I和Q两类，分别对两类端口按照端口号从小到大的顺序进行排序。排序后，按照预设的初始地址为0，结合端口大小，计算每个端口的首地址。

步骤203中的从该接口文档，结合该待生成代码的设备的第二端口参数中获取该待生成代码的设备的通信表单可以包括：

步骤304、根据该每个设备的第一通信参数与该待生成代码的设备的第二端口参数，进行端口匹配，获得相匹配的所有端口号。

接口文档中的第一通信参数中的端口地址可以是列举的一个或多个端口号，也可以是含有通配符的缩写形式。具体的，第一通信参数中的端口地址可以是使用“,”分隔的列举的一个或多个端口号，也可以是含有通配符“i”的缩写形式。如果是列举型端口地址，则根据分隔符逐一读取，与第二端口参数中的端口号匹配，查找出能够匹配的所有端口号；如果是通配符型端口地址，将端口地址字符串中除通配符之外的字符与第二端口参数中的端口号逐一匹配，查找出能够匹配的所有端口号，也就是端口列表。如下表7所示：

以上端口地址中存在列举型端口地址以及通配符型端口地址，将各个端口地址，分别按照上述方法与表6所示的第二端口参数中的端口号匹配，查找出能够匹配的所有端口号。

步骤305、根据该相匹配的所有端口号，与该待生成代码的设备的第二端口参数，生成该待生成代码的设备的第一端口数据表单；

根据上述匹配出的所有端口号逐一在该待生成代码的设备的第二端口参数中查找其对应的源设备名、源宿类型和端口首地址，并提取设备名中包含的设备号信息，从而构成第一端口数据表单，第一端口数据表单可以为一个数组。其中，提取设备名中包含的设备号信息，可以包括：当端口为源类型时，提取宿设备名中的设备号；当端口为宿类型时，提取源设备名中的设备号。如下表8所示：

端口号	源宿类型	端口首地址	源设备名	宿设备名	设备号
						0xF	Q	0	CCU	ALL	0
0x110	I	0	RIOM:1	CCU	1
						0x120	I	32	RIOM:2	CCU	2
0x130	I	64	RIOM:3	CCU	3
						0x140	I	96	RIOM:4	CCU	4
0x118	Q	16	CCU	RIOM:1	1
						0x148	Q	160	CCU	RIOM:4	4
0x410	I	128	BCU:1	CCU	1
						0x420	I	160	BCU:4	CCU	4
0x430	I	192	BCU:5	CCU	5
						0x440	I	224	BCU:8	CCU	8

根据上述表7得到的端口列表中的所有端口号，结合表6所示的第二端口参数中的其他信息，构成该待生成代码的设备的第一端口数据表单，其中，设备号为源设备名中携带的设备号信息。该第一端口数据表单为临时文件，在后续步骤生成设备的应用程序接口代码之后，可以选择手动进行清除。

步骤306、将该第一通信参数中的变量名进行解析得到接口变量，将该接口变量添加到该待生成代码的设备的第一端口数据表单中，生成该待生成代码的设备的第二端口数据表单；

第一通信参数中的变量名可以是一个具体字符串，也可以是含有通配符的字符串，例如变量名可以是含有通配符“i”的字符串。如果第一通信参数中的端口地址表示多个端口，则相对应的变量名必须是含有通配符的字符串。将变量名中的通配符替换成步骤305中所提取到的设备号，得到具体的接口变量名，将其添加到第一端口数据表单中，生成第二端口数据表单。这样，也就将接口文档解析为不包含通配符和列举形式的具体数据。如下表9所示：

将表4所示接口定义清单中的变量名中的通配符“i”替换为表9中的设备号，得到接口变量名，将其他设备之间的接口定义清单按照同样的方法解析，将获得的接口变量名添加到表8所示的第一端口数据表单，构成该第二端口数据表单。该第二端口数据表单为临时文件，在后续步骤生成设备的应用程序接口代码之后，可以选择手动进行清除。

步骤307、根据该待生成代码的设备的第二端口数据表单和该接口文档，获取该待生成代码的设备的通信表单。

从接口文档中读取的字节偏移、位偏移、数据类型、信号名、接口描述、单位、变量范围、标记、通用，以及该待生成代码的设备的第二端口数据表单中的端口号、接口变量名、源设备名、源宿类型、端口首地址，构成了该待生成代码的设备的第二通信参数，也就是生成了由第二通信参数构成的该待生成代码的设备的通信表单。该通信表单可以为一张数据库表单。该通信表单为临时文件，在后续步骤生成设备的应用程序接口代码之后，可以选择手动进行清除。

示例的，将上述从接口文档中读取的信息以及对应的表9中的第二端口数据表单中的信息结合，即构成了上述表5所示的通信表单。

以上步骤304-307中，从该接口文档，结合该待生成代码的设备的第二端口参数中获取该待生成代码的设备的通信表单的具体实现，还可以是通过读取一行解析一行，直到数据流文件最后一个标签页的方式，也就是说，每读取一行第一通信参数，就按照上述步骤304-307对其进行解析，获得该行对应的部分通信表单，将所有行按照上述步骤解析完成后，由每一行所形成的部分通信表单形成该待生成代码的设备的通信表单。

本实施例提供的用于轨道车辆的设备应用程序接口的代码生成方法，在图2所示方法的基础上，包括根据该网络描述文档中多个端口的第一端口参数，对该多个端口进行排序；根据该排序的结果，以及预设的初始地址，计算该多个端口的首地址；根据该每个设备在MVB上的第一端口参数以及该多个端口的首地址，获取该待生成代码的设备的第二端口参数；根据该接口文档中每个设备的第一通信参数，将该第一通信参数中的端口地址与该待生成代码的设备的第二端口参数中的端口号匹配，获得相匹配的所有端口号；根据该相匹配的所有端口号，与该待生成代码的设备的第二端口参数，生成该待生成代码的设备的第一端口数据表单；将该第一通信参数中的变量名进行解析得到接口变量，将该接口变量添加到该待生成代码的设备的第一端口数据表单中，生成该待生成代码的设备的第二端口数据表单；根据该待生成代码的设备的第二端口数据表单和该接口文档，获取该待生成代码的设备的通信表单。该方法通过解析数据流文件中的网络描述文档和接口文档，可以直接生成设备的应用程序接口代码，而无需人工进行代码的编程和检查，同时减少了人工编写时难免的失误导致的定义错误，提高了代码生成的效率和准确度。

同时，采用该方法输出的用于不同设备的代码，各个设备的代码均直接来源于同一个数据流文件，使用相同的变量名，这样能保证设备接口之间的准确性和一致性，增强了代码可读性，提高了系统接口验证和调试的工作效率。

下面以具体的示例来说本发明提供的方法对效率的提高效果。以某个典型的六辆编组的地铁车辆的网络控制系统为例，它的MVB通信网络包含5873个需要分别在车辆的中央控制单元设备、数据记录单元设备、显示屏设备的程序中进行定义的接口数据，如果人工编写一个平均耗时为10秒，则需要约49小时，使用本发明的方法实际用时为11分21秒，由此可见，该方法大大提高了应用程序接口代码的生成效率。

本发明还可提供一种代码生成装置，图4为本发明提供的代码生成装置实施例一的结构示意图。如图4所示，该代码生成装置包括：

确定模块41，用于确定数据流文件的格式；该数据流文件包括：至少一个设备在MVB上的第一端口参数以及每个设备的第一通信参数；

获取模块42，用于根据该数据流文件的格式，从该数据流文件中获取待生成代码的设备的通信表单；该待生成代码的设备的通信表单包括该待生成代码的设备的第二通信参数；

生成模块43，用于根据该待生成代码的设备的通信表单，生成该待生成代码的设备的应用程序接口代码。

本实施例的装置可以用于执行图1所示方法实施例的技术方案，其实现原理和技术效果类似，此处不再赘述。

在图4所示的实施例的基础上，本发明还可提供一种代码生成装置。图5为本发明提供的代码生成装置实施例二的结构示意图。如图5所示，在图4所示实施例的基础上，获取模块42可以包括：

第一获取单元51，用于根据该网络描述文档在该数据流文件中的位置，从该数据流文件中获取该网络描述文档；该网络描述文档包括：该至少一个设备在MVB上的第一端口参数；从该网络描述文档中获取该待生成代码的设备的第二端口参数；

第二获取单元52，用于根据该接口文档在该数据流文件中的位置，从该数据流文件中获取该接口文档，该接口文档包括：该每个设备的第一通信参数；从该接口文档，结合该待生成代码的设备的第二端口参数中获取该待生成代码的设备的通信表单。

本实施例的装置可以用于执行图2所示方法实施例的技术方案，其实现原理和技术效果类似，此处不再赘述。

在图5所示的实施例的基础上，本发明还可提供一种代码生成装置。图6为本发明提供的代码生成装置实施例三的结构示意图。如图6所示，在图5所示实施例的基础上，第一获取单元51可以包括：

排序子单元61，用于根据该网络描述文档中多个端口的第一端口参数，对该多个端口进行排序；

计算子单元62，用于根据该排序的结果，以及预设的初始地址，计算该多个端口的首地址；

第一获取子单元63，用于根据该每个设备在MVB上的第一端口参数以及该多个端口的首地址，获取该待生成代码的设备的第二端口参数。

第二获取单元52可以包括：

匹配子单元64，用于根据该接口文档中每个设备的第一通信参数，将该第一通信参数中的端口地址与该待生成代码的设备的第二端口参数中的端口号匹配，获得相匹配的所有端口号；

第一生成子单元65，用于根据该相匹配的所有端口号，与该待生成代码的设备的第二端口参数，生成该待生成代码的设备的第一端口数据表单；

第二生成子单元66，用于将该第一通信参数中的变量名进行解析得到接口变量，将该接口变量添加到该待生成代码的设备的第一端口数据表单中，生成该待生成代码的设备的第二端口数据表单；

第二获取子单元67，用于根据该待生成代码的设备的第二端口数据表单和该接口文档，获取该待生成代码的设备的通信表单。

本实施例的装置，可以用于执行图3所示方法实施例的技术方案，其实现原理和技术效果类似，此处不再赘述。

图7为本发明提供的计算机设备的结构示意图。如图7所示，本实施例的计算机设备70包括：存储器71和处理器72。其中，存储器71与处理器72连接。

存储器71，用于存储程序指令。

处理器72，用于在程序指令被执行时，执行上述图1-图3中任一所述的用于轨道车辆的设备应用程序接口的代码生成方法，其具体实现及有益效果，可参见上述，在此不再赘述。

本发明实施例还提供一种计算机可读存储介质，其上存储有计算机程序，该计算机程序可被上述图7所述的处理器72执行实现图1-图3中任一所述的用于轨道车辆的设备应用程序接口的代码生成方法，其具体实现及有益效果，可参见上述，在此不再赘述。

本领域普通技术人员可以理解：实现上述各方法实施例的全部或部分步骤可以通过程序指令相关的硬件来完成。前述的程序可以存储于一计算机可读取存储介质中。该程序在执行时，执行包括上述各方法实施例的步骤；而前述的存储介质包括：ROM、RAM、磁碟或者光盘等各种可以存储程序代码的介质。

最后应说明的是：以上各实施例仅用以说明本发明的技术方案，而非对其限制；尽管参照前述各实施例对本发明进行了详细的说明，本领域的普通技术人员应当理解：其依然可以对前述各实施例所记载的技术方案进行修改，或者对其中部分或者全部技术特征进行等同替换；而这些修改或者替换，并不使相应技术方案的本质脱离本发明各实施例技术方案的范围。

Claims (7)

1.一种用于轨道车辆的设备应用程序接口的代码生成方法，其特征在于，包括：

确定数据流文件的格式；所述数据流文件包括：至少一个设备在MVB上的第一端口参数以及每个设备的第一通信参数；

根据所述数据流文件的格式，从所述数据流文件中获取待生成代码的设备的通信表单；所述待生成代码的设备的通信表单包括所述待生成代码的设备的第二通信参数；

根据所述待生成代码的设备的通信表单，生成所述待生成代码的设备的应用程序接口代码；

所述确定数据流文件的格式，包括：

加载预设的格式配置文件，获取所述数据流文件的格式；所述数据流文件包括网络描述文档和接口文档；所述格式配置文件包括：所述网络描述文档和所述接口文档在所述数据流文件中的位置；

所述网络描述文档包括：所述至少一个设备在MVB上的第一端口参数；

所述接口文档包括：所述每个设备的第一通信参数；

所述根据所述数据流文件的格式，从所述数据流文件中获取所述待生成代码的设备的通信表单，包括：

根据所述网络描述文档在所述数据流文件中的位置，从所述数据流文件中获取所述网络描述文档；从所述网络描述文档中获取所述待生成代码的设备的第二端口参数；

根据所述接口文档在所述数据流文件中的位置，从所述数据流文件中获取所述接口文档；从所述接口文档，结合所述待生成代码的设备的第二端口参数中获取所述待生成代码的设备的通信表单；

所述从所述网络描述文档中获取所述待生成代码的设备的第二端口参数，包括：

根据所述网络描述文档中多个端口的第一端口参数，对所述多个端口进行排序；

根据所述排序的结果，以及预设的初始地址，计算所述多个端口的首地址；

根据所述每个设备在MVB上的第一端口参数以及所述多个端口的首地址，获取所述待生成代码的设备的第二端口参数。

2.根据权利要求1所述的方法，其特征在于，所述待生成代码的设备的第二端口参数包括：端口号、端口首地址、源设备名、宿设备名、端口大小、特征周期、源宿类型。

3.根据权利要求1所述的方法，其特征在于，所述从所述接口文档，结合所述待生成代码的设备的第二端口参数中获取所述待生成代码的设备的通信表单，包括：

根据所述每个设备的第一通信参数与所述待生成代码的设备的第二端口参数，进行端口匹配，获得相匹配的所有端口号；

根据所述相匹配的所有端口号以及所述待生成代码的设备的第二端口参数，生成所述待生成代码的设备的第一端口数据表单；

将所述第一通信参数中的变量名进行解析得到接口变量，将所述接口变量添加到所述待生成代码的设备的第一端口数据表单中，生成所述待生成代码的设备的第二端口数据表单；

根据所述待生成代码的设备的第二端口数据表单和所述接口文档，获取所述待生成代码的设备的通信表单。

4.根据权利要求3所述的方法，其特征在于，所述待生成代码的设备的第二通信参数包括：

通信序号、字节偏移、位偏移、数据类型、信号名称、接口描述、端口号、接口变量名、源设备名、源宿类型、端口首地址。

5.根据权利要求4所述的方法，其特征在于，所述待生成代码的第二通信参数还包括：

单位、变量范围、标记、通用。

6.一种代码生成装置，其特征在于，包括：

确定模块，用于确定数据流文件的格式；所述数据流文件包括：至少一个设备在MVB上的第一端口参数以及每个设备的第一通信参数；

获取模块，用于根据所述数据流文件的格式，从所述数据流文件中获取待生成代码的设备的通信表单；所述待生成代码的设备的通信表单包括所述待生成代码的设备的第二通信参数；

生成模块，用于根据所述待生成代码的设备的通信表单，生成所述待生成代码的设备的应用程序接口代码；

所述确定模块，具体用于加载预设的格式配置文件，获取所述数据流文件的格式；所述数据流文件包括网络描述文档和接口文档；所述格式配置文件包括：所述网络描述文档和所述接口文档在所述数据流文件中的位置；

所述网络描述文档包括：所述至少一个设备在MVB上的第一端口参数；

所述接口文档包括：所述每个设备的第一通信参数；

所述获取模块包括：

第一获取单元，用于根据所述网络描述文档在所述数据流文件中的位置，从所述数据流文件中获取所述网络描述文档；从所述网络描述文档中获取所述待生成代码的设备的第二端口参数；

第二获取单元，用于根据所述接口文档在所述数据流文件中的位置，从所述数据流文件中获取所述接口文档，所述接口文档包括：所述每个设备的第一通信参数；从所述接口文档，结合所述待生成代码的设备的第二端口参数中获取所述待生成代码的设备的通信表单；

所述第一获取单元包括：

排序子单元，用于根据所述网络描述文档中多个端口的第一端口参数，对所述多个端口进行排序；

计算子单元，用于根据所述排序的结果，以及预设的初始地址，计算所述多个端口的首地址；

第一获取子单元，用于根据所述每个设备在MVB上的第一端口参数以及所述多个端口的首地址，获取所述待生成代码的设备的第二端口参数。

7.根据权利要求6所述的装置，其特征在于，所述第二获取单元包括：

匹配子单元，用于根据所述接口文档中每个设备的第一通信参数，将所述第一通信参数中的端口地址与所述待生成代码的设备的第二端口参数中的端口号匹配，获得相匹配的所有端口号；

第一生成子单元，用于根据所述相匹配的所有端口号，与所述待生成代码的设备的第二端口参数，生成所述待生成代码的设备的第一端口数据表单；

第二生成子单元，用于将所述第一通信参数中的变量名进行解析得到接口变量，将所述接口变量添加到所述待生成代码的设备的第一端口数据表单中，生成所述待生成代码的设备的第二端口数据表单；

第二获取子单元，用于根据所述待生成代码的设备的第二端口数据表单和所述接口文档，获取所述待生成代码的设备的通信表单。

Images