In House ECU Software Logistics

Overview

This document is the introduction for the in-house ECU software [AppLogisticsData.json] setup.

Author

Shan Deng

Date

Nov 01, 2021

Version

7.4.0

Instruction

For all In-House ECUs, ECU tracker will read detail software information from the software zip file while building the software from ECU tracker.

  1. After adding a new software into ECU tracker, the [Built] field should be marked as [False], which allow ECU tracker to call the Jenkins build job of the ECU Release Candidate to build the software.

  2. In the software zip, a JSON file named [appLogisticsData.json] shall be included, which will allow ECU tracker to read detail information of the software(s) into the database.

Note

Each software zip should have one [appLogisticsData.json] file which can include multiple software entries.

_images/software_zip_file_list.png

Field Structure

The following fields are used in software logistics JSON file.

Field Single

Field Multiple

Required

Description

VER_MAJOR

Required

The Major version number

VER_MINOR

Required

The Minor version number

JENKINS_BUILDNUM

The build number of the Jenkins job

BUILD_DATE

The time of the Jenkins job

BUILDER_ID

Required

BUILD_TIME

VER_SUBMINOR

VERS_SUBMINOR

Required

The Subminor version number of each

RCNum

Required

The RC number of building

PROJECT_ID

Required

OWNER

APPLICATION_TYPE

The zip app type

APPLICATION_TYPES

APPLICATION_TYPES

Required

[ComponentTypes].

COMPONENT_NUMBER

COMPONENT_NUMBERS

Required

The component number of each

PART_NUMBER

PART_NUMBERS

Required

The software part number of each

FLASHING_LEVEL

FLASHING_LEVELS

Required

[FlashingLevels].

START_STRING

START_STRINGS

Required

The software start string of each

DESCRIPTION

DESCRIPTIONS

The description of each

GIT_HASH_10

autogen

Software Version Format

Note

SoftwareVersion = {VER_MAJOR:02}.{VER_MINOR}.RC{RCNum}.{VER(s)_SUBMINOR}.{BUILDER_ID}

The software version will be redefined and update to the database based on the JSON logistics file.

Single Software Format

To define a single software component (one Hex file) example

_images/software_applogisticsdata_single.png

Check the result software updates in the ECU Tracker.

_images/software_component_single.png

Multiple Software Format

To define multiple software components (one Hex per component) example.

_images/software_applogisticsdata_multiple.png

Check the result software update in the ECU Tracker.

_images/software_component_list.png
ComponentTypes

Component type options

All

Full package in one file

APP

Main application

APP2

Second application

APP3

Third Application

BL

Bootloader

BL2

Second Bootloader

BLU

Bootloader Updater

CAL

Calibra**tion

CAL2

Second Calibration

CAL3

Third Calibration

ODX

Diagnostic Type

err

Bad Choice

FlashingLevels

Flashing level options

ADB

Android Processes (NON OTA) including fastboot

JTAG

JTAG

Lvl1

Compliant No Seed and Key

Lvl2

Compliant Default Seed and Key

Lvl3

Compliant Full Security

NotC

Non-Compliant Bootloader

Read

Version can be Read but not Flashed

SWOTA

OTA Android or QNX process zip files (NOT FOR UDS/HEX files)

ODX

Diagnostic Type

err

Not filled correctly

None

None