Add a Cisco FND compatible TPD header to TPD firmware images + Spec

[manojnacsl]

Add Cisco FND TPD header helper script + Cisco FND TPD Firmware format spec

add_tpdheader.py

$ python3 add_tpdheader.py -h
usage: add_tpdheader.py [-h] input_file output_file config_file
Add Cisco FND compatible header to TPD firmware image
positional arguments:
   input_file Input TPD binary file
   output_file Output binary file with TPD header
   config_file JSON configuration file
options:
   -h, --help show this help message and exit
Eg:
$ python3 add_tpdheader.py <input-image> <output-image> <json-config-file>

tpd_config.json

{
"major": "7",
"minor": "1",
"build": "2",
"name": "CsmpAgent_Linux",
"hwid": "OPENCSMP",
"sub_hwid": "0",
"branch": "osal",
"commit": "048841d",
"date": "Mar 15 2025",
"kernelrev": "WISUN1.0"
}

Files:

• tools/add_tpdheader.py
• tools/tpd_config.json
• docs/Cisco_FND_TPD_FirmwareFormat_Spec.pdf

[manojnacsl]

The three enhancement asks (Py3.x support, Input/Output files as params, JSON for TPD configuration) have been added via Commit 19d0907
Relevant documentation updates to the spec file will follow...

[manojnacsl]

Committed an updated TPD firmware format specification via Commit bd25a6b

[manojnacsl]

Please review/approve to conclude this PR. Thanks.

[ismilak]

Please review/approve to conclude this PR. Thanks.

The new add_tpdheader.py has been tested with EFR32 wisun platform. The entire scenario with the new image works fine.
Successfully loaded 6.4.0 EFR32 sample image: