UDS 诊断 - RequestFileTransfer（请求文件传输）（0x38）服务

最新推荐文章于 2024-11-19 21:03:24 发布

Quincy企鹅

最新推荐文章于 2024-11-19 21:03:24 发布

阅读量3.4k

点赞数 35

分类专栏：汽车测试文章标签：功能测试模块测试 UDS 诊断

本文链接：https://blog.csdn.net/weixin_45033239/article/details/142330954

版权

汽车测试专栏收录该内容

32 篇文章

订阅专栏

UDS 诊断服务系列文章目录

一、服务说明

客户端利用 requestFileTransfer（请求文件传输）服务从客户端向服务器或从服务器向客户端（下载或上传）传输文件数据。另外，此项服务可以检索文件系统的相关信息。

其旨在作为 RequestDownload 和 RequestUpload 服务的替代方案，以便在服务器利用系统存储数据时能够支持数据上传和下载功能。配置文件系统的下载或上传程序时，应使用 RequestFileTransfer 服务代替 RequestDownload 或 RequestUpload 服务。实际的数据传输和数据传输终止可以利用 TransferData 和 RequestTransferExit 服务执行，使用方法捅 RequestDownload 或 RequestUpload。这项服务还包括文件删除功能或服务器的文件系统索引功能。对于这种用例，TransferData 和 RequestTransferExit 服务不适用。

服务器收到 RequestFileTransfer 消息后，应在其发送肯定响应消息之前才去必要行动接收或传输数据。

二、请求消息

1. 请求消息定义

字节	参数名称	Cvt	字节值
#1	requestFileTransfer（请求文件传输）请求 SID	M	0x38
#2	modeOfOperation（运行模式）	M	0x01 - 0x05
#3 #4	filePathAndNameLength[ byte#1(MSB) byte#2(LSB) ]	M M	0x00 - 0xFF 0x00 - 0xFF
#5 … #5+n-1	filePathAndName = [ byte#1(MSB) … byte#n ]	M … C1	0x00 - 0xFF … 0x00 - 0xFF
#5+n	dataFormatIdentifier（数据格式标识符）	C2	0x00 - 0xFF
#5+n+1	fileSizeParameterLength（文件大小参数长度）	C2	0x00 - 0xFF
#5+n+2 … #5+n+2+k-1	fileSizeUnCompressed = [ byte#1(MSB) … byte#k ]	C2 … C2,3	0x00 - 0xFF … 0x00 - 0xFF
#5+n+2+k … #5+n+1+2k	fileSizeCompressed = [ byte#1(MSB) … byte#k ]	C2 … C2,3	0x00 - 0xFF … 0x00 - 0xFF

C1：消息参数长度（字节数）由 filePathAndNameLength 参数决定。

C2：是否使用这些参数取决于 modeOfOperation 参数。

C3：消息参数长度（字节数）由 fileSizeParameterLength 决定。

2. 请求消息数据参数定义

定义
modeOfOperation（运行模式）此数据参数定义了 filePathAndName（文件路径和名称）参数中所示的文件或目录该应用的运行方式。
filePathAndNameLength（文件路径和名称长度）定义了 filePath（文件路径）参数的长度字节。
filePathAndName（文件路径和名称）定义了服务器的文件系统位置，在此处，可以依据 modeOfOperation（运行模式）参数添加，删除，替代或读取文件。另外，此参数还包含作为部分文件路径应添加，删除，替代或读取的文件的文件名。如果 modeOfOperation 参数等于 0x05（readDIr），则此参数指示要读取的目录。参数的每一字节应采用 ASCII 格式编码。
dataFormatIdentifier（数据格式标识符）此数据参数是一个单字节值，每个半字节均单独编码。搞笑半字节指定 ”compressionMethod（压缩法）“，低效半字节指定 ”encryptingMethod（加密法）“。字节值 0x00 不得使用压缩法或加密法。 0x00 以外的字节值由车辆制造商规定。如果 modeOfOperation 参数等于 0x02（DeleteFile）或 0x05（readDir），则请求消息中不得包含此参数。
fileSizeParameterLength（文件大小参数长度）定义了 fileSizeUnCompressed（文件大小未压缩）和 fileSizeCompressed（文件大小压缩）参数的长度字节。如果 modeOfOperation 参数等于 0x02（DeleteFile）、0x04（ReadFile）或 0x05（readDir），则请求消息中不得包含此参数。
fileSizeUnCompressed（文件大小未压缩）定义了未压缩文件的字节大小。如果 modeOfOperation 参数等于 0x02（DeleteFile）、0x04（ReadFile）或 0x05（readDir），则请求消息中不得包含此参数。
fileSizeCompressed（文件大小压缩）定义了未压缩文件的字节大小。如果传输的文件为未压缩文件，则参数的所有字节应设置为 fileSizeUnCompressed 参数中的大小。如果 modeOfOperation 参数等于 0x02（DeleteFile）、0x04（ReadFile）或 0x05（readDir），则请求消息中不得包含此参数。

三、肯定响应消息

1. 肯定响应消息定义

字节	参数名称	Cvt	字节值
#1	RequestFileTransfer（请求文件传输）响应SID	S	0x78
#2	modeOfOperation（运行模式）	M	0x01 - 0x05
#3	LengthFormatIdentifier（长度格式标识符）	C1	0x00 - 0xFF
#4 … #4+(m-1)	maxNumberOfBlockLength[] = [ byte#1(MSB) … byte#m ]	C1,2 … C1,2	0x00 - 0xFF … 0x00 - 0xFF
#4+m	dataFormatIdentifier（数据格式标识符）	C1	0x00 - 0xFF
#4+m+1 #4+m+2	fileSizeOrDirInfoParameterLength[ byte#1(MSB) byte#2(LSB)]	C1 C1	0x00 - 0xFF 0x00 - 0xFF
#4+m+3 … #4+m+3+k-1	fileSizeUncompressedOrDirInfoLength = [ byte#1(MSB) … byte#k]	C1,3 … C2,3	0x00 - 0xFF … 0x00 - 0xFF
#4+m+3+k … #4+m+3+2k-1	fileSizeCompressed = [ byte#1(MSB) … byte#k]	C1,3 … C2,3	0x00 - 0xFF … 0x00 - 0xFF

C1：是否使用这些参数取决于 modeOfOperation 参数。

C2：消息参数长度（字节数）由 fileSizeOrDirInfoParameterLength 参数决定。

C3：消息参数长度（字节数）由 LengthFormatIdentifier 参数决定。

2. 肯定响应消息数据参数的定义

定义
modeOfOperation（运行模式）此参数是请求值的回响。
lengthFormatIdentifier（长度格式标识符）定义了 maxNumberOfBlockLength（最大信息组长度）参数的长度（字节数）。如果 modeOfOperation 参数等于 0x02（DeleteFile），则响应消息中不得包含此参数。
maxNumberOfBlockLength（最大信息组长度）上传数据时，requestFileTransfer（请求文件传输）肯定响应消息利用此参数通知客户端其发出的每条 transferData（传输数据）请求消息中应包含多少数据字节（maxNumberOfBlockLength）或服务器发出的 TransferData 肯定响应包含了多少数据字节。此长度反应了完整的消息长度，包括 TransferData 请求消息或肯定响应消息中出现的服务器标识符和数据参数。该参数允许客户端在开始向服务器传输数据之前适应服务器的接收缓冲大小或在上传数据时指出每条 TransferData 肯定响应中的数据字节大小。服务器接收的 TransferData 请求长度须与其报告的 maxNumberOfBlockLength 长度相等。TransferData 请求长度与 maxNumberOfBlockLength 间的允许公差（如有）可以视特定服务器而定。注：指定信息组内的最后一天 TransferData 请求可能要比 maxNumberOfBlockLength 短。服务器不得写入 TransferData 消息（压缩格式或未压缩格式）中未存储的其他数据字节（如填充字节），因为这会对写入后续 TransferData 请求数据的内存地址造成影响。如果 modeOfOperation 参数等于 0x02（DeleteFile），则响应消息中不得包含此参数。
dataFormatIdentifier（数据格式标识符）此参数是请求值的回响。如果 modeOfOperation 参数等于 0x02（DeleteFile），则响应消息中不得包含此参数。如果 modeOfOperation 参数等于 0x05（ReadDir），则参数值应等于 0x00。
fileSizeOrDirInfoParameterLength（文件大小或目录信息参数长度）定义了 fileSizeUncompressedOrDirInfoLength（文件大小未压缩或目录信息长度）和 fileSizeCompressed（文件大小压缩）参数的长度字节。如果 modeOfOperation 参数等于 0x01（AddFile）、0x02（DeleteFile）或 0x03（ReplaceFile），则响应消息中不得包含此参数。
fileSizeUncompressedOrDirInfoLength（文件大小未压缩或目录信息长度）定义了待上传的未压缩文件的字节大小或待读取的目录信息长度字节。如果 modeOfOperation 参数等于 0x01（AddFile）、0x02（DeleteFile）或 0x03（ReplaceFile），则响应消息中不得包含此参数。
fileSizeCompressed（文件大小压缩）定义了压缩文件的字节大小。如果 modeOfOperation 参数等于 0x01（AddFile）、0x02（DeleteFile）、0x03（ReplaceFile）或 0x05（ReadDir），则响应消息中不得包含此参数。

四、 modeOfOperation（运行模式）值的定义

下表为 modeOfOperation 参数值的定义。

字节值	说明
0x00	保留
0x01	AddFile（添加文件）该值应用于添加 filePathAndName（文件路径和名称）参数中规定的文件（下载）。
0x02	DeleteFile（删除文件）该值应用于删除 filePathAndName 参数中规定的文件。
0x03	ReplaceFile（替换文件）该值应用于替换 filePathAndName 参数中规定的文件（下载）。如果文件未存储在该位置，则应添加文件。
0x04	ReadFile（读取文件）该值应用于读取 filePathAndName 参数规定的位置处的文件（上传）。
0x05	ReadDir（读取目录）该值应用于读取 FilePathAndName 参数规定的目录。该值意味着请求未包含文件名。
0x06 - 0xFF	保留

五、受支持的 NRC

NRC	说明
0x13	消息不正确或格式无效
0x22	条件不正确在下载或上传数据过程中如果服务器接收到此项服务请求，或者，如果不满足执行此项服务的其他条件，则 NRC 会被返回。
0x31	请求超过限值下属情况下，应返回此 NRC： - 特定 dataFormatIdentifier 无效； - 特定 modeOfOperation 无效； - 特定 fileSizeParameterLength 无效； - 特定 filePathAndN阿么Length 无效； - 特定 fileSizeUncompressed 无效； - 特定 fileSizeCompressed 无效； - 特定 filePathAndName 无效。
0x33	安全访问被拒绝如果接收到此项服务请求时服务器比较安全（针对支持 SecurityAccess 服务的服务器），则此 NRC 会被退回。
0x70	不接受上传下载该 NRC 表示由于某些故障条件无法下载到服务器内存。

下图为 0x38 服务 NRC 的处理。

0x38 服务 NRC 的处理

图例

1 最小长度：5 字节（SI + modeOfOperation + filePathAndNameLength + filePathAndName_byte#1）

2 消息参数的有效性检查取决于 modeOfOperation 参数。

3 最大长度可以利用 fileSizeParameterLength 和 filePathAndNameLength 计算。

六、示例

1. 假设

本小节说明了信息流举例的适用条件。

注：本示例仅限于 requestFileTransfer 和 requestFileTransfer 肯定响应的说明。本文中的 TransferData 和 RequestTransferExit 应用与 RequestDownload 和 RequestUpload 过程中应用这些服务的原理相同，因此，描述下载/上传序列的示例同样适用。

下表定义了 RequestFileTransfer（请求文件传输）值。

数据参数名称	数据参数值	数据参数说明
modeOfOperation（运行模式）	0x01	AddFile（添加文件）
filePathAndNameLength（文件路径和名称长度）	0x001E	filePathAndName 参数的长度为 30。
filePathAndName（文件路径和名称）	“D:\mapdata\europe\germany1.yxz”	路径包括文件名。
dataFormatIdentifier（数据格式标识符）	0x11	compressionMethod = 0x1X； encryptionMethod = 0xX1
fileSizeUnCompressed（文件大小未压缩）	0xC350
fileSizeUncompressed（文件大小未压缩）	0xC350	50 千字节
fileSizeCompressed（文件大小压缩）	0x7530	30 千字节
fileSizeParameterLength（文件大小参数长度）	0x02	两个文件大小参数的长度均为 2 字节。

2. 请求文件传输

req  38 
	 01 - modeOfOperation
	 00 1E - filePathAndNameLength
	 44 3A 5C 6D 61 70 64 61 74 61 ... 7A - filePathAndName(30 bytes)
	 11 - dataFormatIdentifier
	 02 - fileSizeParameterLength
	 C3 50 - fileSizeUnCompressed
	 75 30 - fileSizeCompressed
resp 78 
	 01 - modeOfOperation
	 02 - lengthFormatIdentifier
	 C3 50 - maxNumberOfBlockLength
	 11 - dataFormatIdentifier