commit	80e2c88f27ac3de911ca12a64e061526401a5be5	[log] [tgz]
author	EWYan <yanerweiwei@gmail.com>	Sat Apr 16 12:19:14 2022 +0800
committer	EWYan <yanerweiwei@gmail.com>	Sat Apr 16 12:19:14 2022 +0800
tree	65a79d3e8981e6f005dde2ec48947a645e9106d8
parent	1bed6512a0dd9017b5d23d5fdf3bb10ebdad9666 [diff]
parent	71b3f17b2bbf7b1798bfda202b854fc23ffe4a43 [diff]

tree: 65a79d3e8981e6f005dde2ec48947a645e9106d8

README.md

vbf-tool

try to imple vbf-tool by rust

VBF file format

ref. https://mk4-wiki.denkdose.de/artikel/vbf/start

The VBF format contains a readable part in ASCII format and a machine part in binary format.

Header

vbf_version = 2.6;

header {
    //**********************************************************
    //*
    //*                  Volvo Car Corporation
    //*
    //*     This file is generated by VBF CONVERT ver. 5.10.0
    //*
    //*                        DO NOT EDIT !
    //*
    //**********************************************************

    // Volvo software part number
       sw_part_number = "8894084567";

    // Software Version: 
       sw_version = "A";

    // Volvo software part type: Executable
       sw_part_type = EXE;

    // Data format identifier: 0x00 = Uncompressed, 0x10 = Compressed
       data_format_identifier = 0x00;

    // ECU Address: 
       ecu_address = 0x1234;

    // Erase information
    //         start,     length
       erase = { { 0x0cc00000, 0x0004ef15 },
                 { 0xffffe800, 0x0000002c }
               }; 

    // Start address of the hash table
       verification_block_start = 0xFFFFE800;

    // Length of the hash table
       verification_block_length = 0x0000002C;

    // Root hash value
       verification_block_root_hash = 0x3E263C8F66129C46B39D59E5964D7F3254FFA272AD3A3E70FC57ED95D73E1234;

    // Blocks sorted
    // Blocks grouped
    // Blocks:   2
    // Bytes:    323476

    file_checksum = 0x6A8DB4CC;
}

Payload: The binary part (payload) the VBF begins directly after the last ASCII character of the description part (the }). The following data are to be interpreted as bytes in big endian.

Offset	LENGTH	BYTES	DATETYPE	FUNCTION	SAMPLE
0x0000	4 Bytes	DWORD	DATA_START	Start address on the target system	0x000004F4
0x0003	4 Bytes	DWORD	DATA_LENGTH	Length of the following block
0x0007	x Bytes	BYTE	DATA	data of the block
0x0007 + DATA_LENGTH	2 Bytes	WORD	DATA_CRC	CRC-16 CCITT checksum of the DATA

VBT(verification block table)
The verification block table, encoded with big endian, shall have the following format:
- Verification Block Table Format Identifier. [ size 16 bits]
- Number of data blocks. [ size 16bits]
- StartAddress [ size 32 bits] , Length [ size 32 bits], Hash value. Every data blocks shall be defined, except the block table itself. The size of the hash is dependent of the hash function used and is specified elsewhere. The Length is the unprocessed length
- The data blocks shall be sorted according to the order the data blocks are being programmed to the ECU.
- SHA-256 hash function is used, i.e. each hash value is 256 bits.

VBB scripts

the description of vbf file parameters.

usage example

$ vbf-tool ./vbb_script.json