SWRA751 September 2022
Description:
This command gets all internal details and version numbers of the loaded patches.
All reserved bits and bytes must be 0.
PTCR = Patch trap control register
The following fields contain a unique identification for the patch package and its correlation to the base software version that runs on the device, regardless of whether it is a ROM or a FLASH version:
The value of PTCR is set by the post patch load handler, at the end of patch load. Only the enabled patch functions (a bit mask of 12 lowest bits) must be 1, according to the patch package contents.
Command Parameters:
HCI_VS_Read_Patch_Version (0xFF22) None.
Return Parameter | Size (bytes) | Value | Parameter Description |
---|---|---|---|
Status | 1 | 0x00 0x01-0xFF |
Command succeeded. Command failed. |
Enabled Mask | 6 | 0–1 | Bit mask of active patch traps. Every bit holds the value of the corresponding patch of only) the possible 12 traps. The value is read from the PTCR (Patch Trap Control Register). For every bit: 0 = Patch disabled; 1 = Patch enabled. |
ReleaseMajor | 1 | For example, in a patch for software version 3.16, you will get 0x03. | Main release major number. The upper byte of the base software version to which the patch package refers. |
ReleaseMinor | 1 | For example, in a patch for software version 3.16, you will get 0x10. | Main release minor number. The lower byte of the base software version to which the patch package refers. |
PackageID | 1 | For example, in patch package 2, you will get 0x02. | Patch trap package ID. Unique number for the patch package. A patch package contains up to 12 different patch traps. |
Build Number | 1 | For example, in patch package 2 in release (build no.) 4, you will get 0x04. | Patch trap package build number.
Unique number for patch package build number. This is a serial number in the patch package. |