types

type BinaryVersion struct {
	Length   uint16 `offset:"byte:0,endian:be"`               // Length of the structure
	Type     uint8  `offset:"byte:2"`                         // Type identifier
	Version  uint8  `offset:"byte:3"`                         // Version number
	Reserved uint32 `offset:"byte:4,endian:be,reserved:true"` // Reserved field
}

type Boot2Header struct {
	Magic    uint32 `offset:"byte:0,endian:be"`                // Magic value
	Version  uint32 `offset:"byte:4,endian:be"`                // Boot2 version
	Size     uint32 `offset:"byte:8,endian:be"`                // Size of Boot2 section
	Reserved uint32 `offset:"byte:12,endian:be,reserved:true"` // Reserved field
}

type BootVersion struct {
	MajorVersion uint16 // offset 0x0.16-0x0.31
	MinorVersion uint16 // offset 0x0.0-0x0.15
	SubVersion   uint16 // offset 0x4.16-0x4.31
	Reserved     uint16 // offset 0x4.0-0x4.15
}

type CRCAlgorithm uint8

type CRCType uint8

type CRDumpMaskData struct {
	Version  uint32    `offset:"0x0,endian:be"` // Version of the mask data format
	MaskSize uint32    `offset:"0x4,endian:be"` // Size of the mask data
	Reserved [8]uint32 `offset:"0x8,endian:be"` // Reserved

}

type CRDumpMaskDataJSON struct {
	Version  uint32 `json:"version"`
	MaskSize uint32 `json:"mask_size"`
	DataSize int    `json:"data_size"`
}

type CertChain struct {
	ChainLength uint32    `offset:"0x0,endian:be"`     // Number of certificates in chain
	Reserved    [12]uint8 `offset:"0x4,reserved:true"` // Reserved
}

type CertificateChains struct {
	Version    uint32   `offset:"0x0,endian:be"`     // Version
	ChainCount uint32   `offset:"0x4,endian:be"`     // Number of chains
	Reserved   [8]uint8 `offset:"0x8,reserved:true"` // Reserved
}

type DBGFwIni struct {
	CompressionMethod uint32 `offset:"0x0,endian:be"` // 0=Uncompressed, 1=Zlib, 2=LZMA
	UncompressedSize  uint32 `offset:"0x4,endian:be"` // Size when uncompressed
	CompressedSize    uint32 `offset:"0x8,endian:be"` // Size of compressed data
	Reserved          uint32 `offset:"0xc,endian:be"` // Reserved

}

type DBGFwParams struct {
	CompressionMethod uint32 `offset:"0x0,endian:be"` // 0=Uncompressed, 1=Zlib, 2=LZMA
	UncompressedSize  uint32 `offset:"0x4,endian:be"` // Size when uncompressed
	CompressedSize    uint32 `offset:"0x8,endian:be"` // Size of compressed data
	Reserved          uint32 `offset:"0xc,endian:be"` // Reserved

}

type DTOCEntryJSON struct {
	Type             uint16 `json:"type"`
	Size             uint32 `json:"size"`
	ParamStartOffset uint32 `json:"param_start_offset"`
	ParamEndOffset   uint32 `json:"param_end_offset"`
	DataStartOffset  uint32 `json:"data_start_offset"`
	DataEndOffset    uint32 `json:"data_end_offset"`
	CRC              uint16 `json:"crc"`
}

type DTOCHeaderJSON struct {
	IdentifierLo      uint32 `json:"identifier_lo"`
	IdentifierHi      uint32 `json:"identifier_hi"`
	Version           uint8  `json:"version"`
	Reserved0         uint8  `json:"reserved0"`
	Reserved1         uint16 `json:"reserved1"`
	Reserved2         uint32 `json:"reserved2"`
	Reserved3         uint32 `json:"reserved3"`
	Reserved4         uint32 `json:"reserved4"`
	NextHeaderPointer uint32 `json:"next_header_pointer"`
	NextHeaderSize    uint32 `json:"next_header_size"`
	CRC               uint32 `json:"crc"`
}

type DTOCJSON struct {
	Header  DTOCHeaderJSON  `json:"header"`
	Entries []DTOCEntryJSON `json:"entries"`
}

type DevInfo struct {
	Signature0   uint32    `offset:"byte:0,endian:be" json:"signature0"`     // "mDevInfo"
	Signature1   uint32    `offset:"byte:4,endian:be" json:"signature1"`     // "#B.."
	Signature2   uint32    `offset:"byte:8,endian:be" json:"signature2"`     // "baca"
	Signature3   uint32    `offset:"byte:12,endian:be" json:"signature3"`    // "fe00"
	MinorVersion uint8     `offset:"byte:16" json:"minor_version"`           // offset 0x10
	MajorVersion uint16    `offset:"byte:17,endian:be" json:"major_version"` // offset 0x11
	Reserved1    uint8     `offset:"byte:19,reserved:true" json:"reserved1"` // offset 0x13
	Reserved2    [12]byte  `offset:"byte:20,reserved:true" json:"reserved2"` // offset 0x14-0x1f
	Guids        UidEntry  `offset:"byte:32" json:"guids"`                   // offset 0x20 - GUID allocation info
	Macs         UidEntry  `offset:"byte:48" json:"macs"`                    // offset 0x30 - MAC allocation info
	Reserved3    [444]byte `offset:"byte:64,reserved:true" json:"reserved3"` // offset 0x40 - padding to 0x1fc
	CRC          uint32    `offset:"byte:508,endian:be" json:"crc"`          // offset 0x1fc - CRC32 field (lower 16 bits contain CRC16)

	// The firmware has a 4-byte CRC trailer after this structure at offset 0x200
	// This field is not part of the binary structure but is used for JSON marshaling
	TrailerCRC uint16 `offset:"-" json:"original_crc,omitempty"` // CRC after the struct (from ITOC)
}

type DevInfoJSON struct {
	Signature0   uint32    `json:"signature0"`
	Signature1   uint32    `json:"signature1"`
	Signature2   uint32    `json:"signature2"`
	Signature3   uint32    `json:"signature3"`
	MinorVersion uint8     `json:"minor_version"`
	MajorVersion uint16    `json:"major_version"`
	Reserved1    uint8     `json:"reserved1"`
	Reserved2    []byte    `json:"reserved2"`
	Guids        GuidsJSON `json:"guids"`
	Macs         MacsJSON  `json:"macs"`
	Reserved3    []byte    `json:"reserved3"`
	Reserved4    uint16    `json:"reserved4"`
	CRC          uint16    `json:"crc"`
	OriginalCRC  uint16    `json:"original_crc"`
}

type DeviceInfoExtended struct {
	Signature     uint32          // offset 0x0
	MinorVersion  uint16          // offset 0x4.0-0x4.15
	MajorVersion  uint16          // offset 0x4.16-0x4.31
	Reserved1     [24]uint8       // offset 0x8-0x20
	GUIDs         Guids           // offset 0x20-0x120
	Reserved2     [48]uint8       // offset 0x120-0x150
	VSD           [208]uint8      // offset 0x150-0x220
	OperationKeys [4]OperationKey // offset 0x220-0x260
	Reserved3     [416]uint8      // offset 0x260-0x400
}

type DigitalCertPtr struct {
	CertType   uint32    `offset:"0x0,endian:be"`     // Certificate type
	CertOffset uint32    `offset:"0x4,endian:be"`     // Offset to certificate
	CertSize   uint32    `offset:"0x8,endian:be"`     // Certificate size
	Reserved   [28]uint8 `offset:"0xc,reserved:true"` // Reserved (28 bytes to make total 40)
}

type DigitalCertPtrJSON struct {
	CertType   uint32 `json:"cert_type"`
	CertOffset string `json:"cert_offset"`
	CertSize   uint32 `json:"cert_size"`
}

type DigitalCertRW struct {
	CertType    uint32      `offset:"0x0,endian:be"`      // Certificate type
	CertSize    uint32      `offset:"0x4,endian:be"`      // Certificate size
	ValidFrom   uint64      `offset:"0x8,endian:be"`      // Validity start timestamp
	ValidTo     uint64      `offset:"0x10,endian:be"`     // Validity end timestamp
	Reserved    [32]uint8   `offset:"0x18,reserved:true"` // Reserved
	Certificate [4096]uint8 `offset:"0x38"`               // Certificate data (up to 4K)
}

type DigitalCertRWJSON struct {
	CertType       uint32 `json:"cert_type"`
	CertSize       uint32 `json:"cert_size"`
	ValidFrom      uint64 `json:"valid_from"`
	ValidTo        uint64 `json:"valid_to"`
	ActualCertSize int    `json:"actual_cert_size"`
	CertPreview    string `json:"cert_preview,omitempty"`
}

type FS3ITOCEntry struct {
	// Per cibfw_itoc_entry_{pack,unpack} offsets
	// size: offset=8 bits, len=22; type: offset=0, len=8
	SizeDwords uint32 `offset:"bit:8,len:22,endian:be"`
	Type       uint8  `offset:"bit:0,len:8,endian:be"`

	// param0: offset=34,len=30; flags at 33 and 32
	Param0       uint32 `offset:"bit:34,len:30,endian:be"`
	CacheLineCRC bool   `offset:"bit:33,endian:be"`
	ZippedImage  bool   `offset:"bit:32,endian:be"`

	// param1: offset=64, 4 bytes
	Param1 uint32 `offset:"bit:64,len:32,endian:be"`

	// flash_addr: offset=161,len=29; relative_addr: offset=160,len=1
	FlashAddrDwords uint32 `offset:"bit:161,len:29,endian:be"`
	RelativeAddr    bool   `offset:"bit:160,endian:be"`

	// section_crc: offset=208,len=16; no_crc: offset=207,len=1; device_data: offset=206,len=1
	SectionCRC uint16 `offset:"bit:208,len:16,endian:be"`
	NoCRC      bool   `offset:"bit:207,endian:be"`
	DeviceData bool   `offset:"bit:206,endian:be"`

	// itoc_entry_crc: offset=240,len=16
	ITOCEntryCRC uint16 `offset:"bit:240,len:16,endian:be"`
}

type FS3ITOCHeader struct {
	Signature0 uint32 `offset:"byte:0,endian:be"`        // 0x0: should be ITOC signature ("ITOC")
	Signature1 uint32 `offset:"byte:4,endian:be"`        // 0x4: 0x04081516
	Signature2 uint32 `offset:"byte:8,endian:be"`        // 0x8: 0x2342cafa
	Signature3 uint32 `offset:"byte:12,endian:be"`       // 0xC: 0xbacafe00
	Version    uint8  `offset:"bit:152,len:8,endian:be"` // per cibfw_itoc_header_unpack: offset=152 bits
	// 0x11..0x1B reserved
	ITOCEntryCRC uint16 `offset:"byte:28,endian:be"` // 0x1C: CRC over header (except itself)
}

type FS4BootVersionStruct struct {
	MinorVersion       uint8 `offset:"bit:0,len:8,endian:be"`  // offset 0x0, bits 0-7
	MajorVersion       uint8 `offset:"bit:8,len:8,endian:be"`  // offset 0x0, bits 8-15
	Reserved           uint8 `offset:"bit:16,len:8,endian:be"` // offset 0x0, bits 16-23
	ImageFormatVersion uint8 `offset:"bit:24,len:8,endian:be"` // offset 0x0, bits 24-31
}

type FS4ComponentAuthenticationConfiguration struct {
	AuthType         uint8  `offset:"bit:0,len:8,endian:be"`  // bits 0-7: 0-FW_BURN_NONE, 1-SHA256, 2-SHA512, 3-RSA2048, 4-RSA4096
	Reserved1        uint32 `offset:"bit:8,len:17,endian:be"` // bits 8-24: reserved
	CRTokenEn        uint8  `offset:"bit:25,len:1,endian:be"` // bit 25: challenge-response token enable
	BTCTokenEn       uint8  `offset:"bit:26,len:1,endian:be"` // bit 26: back to commissioning token enable
	FRCEn            uint8  `offset:"bit:27,len:1,endian:be"` // bit 27: factory re-configuration enable
	MLNXNVConfigEn   uint8  `offset:"bit:28,len:1,endian:be"` // bit 28: MLNX nvconfig enable
	VendorNVConfigEn uint8  `offset:"bit:29,len:1,endian:be"` // bit 29: vendor nvconfig enable
	CSTokenEn        uint8  `offset:"bit:30,len:1,endian:be"` // bit 30: CS token enable
	FWEn             uint8  `offset:"bit:31,len:1,endian:be"` // bit 31: firmware enable
}

type FS4FilePublicKeys struct {
	ComponentAuthConfig FS4ComponentAuthenticationConfiguration `offset:"0x0"`            // offset 0x0
	Reserved1           [8]uint8                                `offset:"0x4"`            // padding
	KeypairExp          uint32                                  `offset:"0xc,endian:be"`  // offset 0xc: usually 65537
	KeypairUUID         [4]uint32                               `offset:"0x10,endian:be"` // offset 0x10-0x1c: UUID
	Key                 [64]uint32                              `offset:"0x20,endian:be"` // offset 0x20-0x11c: 2048-bit key
}

type FS4FilePublicKeys2 struct {
	ComponentAuthConfig FS4ComponentAuthenticationConfiguration `offset:"0x0"`            // offset 0x0
	Reserved1           [8]uint8                                `offset:"0x4"`            // padding
	KeypairExp          uint32                                  `offset:"0xc,endian:be"`  // offset 0xc: usually 65537
	KeypairUUID         [4]uint32                               `offset:"0x10,endian:be"` // offset 0x10-0x1c: UUID
	Key                 [128]uint32                             `offset:"0x20,endian:be"` // offset 0x20-0x21c: 4096-bit key
}

type FS4FilePublicKeys3 struct {
	KeypairExp          uint32                                  `offset:"0x0,endian:be"`  // offset 0x0: usually 65537
	KeypairUUID         [4]uint32                               `offset:"0x4,endian:be"`  // offset 0x4-0x10: UUID
	Key                 [128]uint32                             `offset:"0x14,endian:be"` // offset 0x14-0x210: 4096-bit key
	ComponentAuthConfig FS4ComponentAuthenticationConfiguration `offset:"0x214"`          // offset 0x214
	Reserved            [8]uint8                                `offset:"0x218"`          // padding to end
}

type FS4HWPointers struct {
	BootRecordPtr          HWPointerEntry `offset:"byte:0" json:"boot_record_ptr"`           // offset 0x0
	Boot2Ptr               HWPointerEntry `offset:"byte:8" json:"boot2_ptr"`                 // offset 0x8
	TOCPtr                 HWPointerEntry `offset:"byte:16" json:"toc_ptr"`                  // offset 0x10
	ToolsPtr               HWPointerEntry `offset:"byte:24" json:"tools_ptr"`                // offset 0x18
	AuthenticationStartPtr HWPointerEntry `offset:"byte:32" json:"authentication_start_ptr"` // offset 0x20
	AuthenticationEndPtr   HWPointerEntry `offset:"byte:40" json:"authentication_end_ptr"`   // offset 0x28
	DigestPtr              HWPointerEntry `offset:"byte:48" json:"digest_ptr"`               // offset 0x30
	DigestRecoveryKeyPtr   HWPointerEntry `offset:"byte:56" json:"digest_recovery_key_ptr"`  // offset 0x38
	FWWindowStartPtr       HWPointerEntry `offset:"byte:64" json:"fw_window_start_ptr"`      // offset 0x40
	FWWindowEndPtr         HWPointerEntry `offset:"byte:72" json:"fw_window_end_ptr"`        // offset 0x48
	ImageInfoSectionPtr    HWPointerEntry `offset:"byte:80" json:"image_info_section_ptr"`   // offset 0x50
	ImageSignaturePtr      HWPointerEntry `offset:"byte:88" json:"image_signature_ptr"`      // offset 0x58
	PublicKeyPtr           HWPointerEntry `offset:"byte:96" json:"public_key_ptr"`           // offset 0x60
	FWSecurityVersionPtr   HWPointerEntry `offset:"byte:104" json:"fw_security_version_ptr"` // offset 0x68
	GCMIVDeltaPtr          HWPointerEntry `offset:"byte:112" json:"gcm_iv_delta_ptr"`        // offset 0x70
	HashesTablePtr         HWPointerEntry `offset:"byte:120" json:"hashes_table_ptr"`        // offset 0x78
}

type FS4HWPointersJSON struct {
	BootRecordPtr        HWPointerEntryJSON `json:"boot_record_ptr"`
	Boot2Ptr             HWPointerEntryJSON `json:"boot2_ptr"`
	TOCPtr               HWPointerEntryJSON `json:"toc_ptr"`
	ToolsPtr             HWPointerEntryJSON `json:"tools_ptr"`
	FWWindowStartPtr     HWPointerEntryJSON `json:"fw_window_start_ptr"`
	FWWindowEndPtr       HWPointerEntryJSON `json:"fw_window_end_ptr"`
	ImageInfoSectionPtr  HWPointerEntryJSON `json:"image_info_section_ptr"`
	HashesTablePtr       HWPointerEntryJSON `json:"hashes_table_ptr"`
	DigestRecoveryKeyPtr HWPointerEntryJSON `json:"digest_recovery_key_ptr"`
	DigestPtr            HWPointerEntryJSON `json:"digest_ptr"`
}

type FS4HashesTable struct {
	Header FS4HashesTableHeader `offset:"0x0"`             // offset 0x0-0xb (12 bytes)
	Htoc   FS4Htoc              `offset:"0xc"`             // offset 0xc-0xfb (240 bytes)
	Hash   [28]FS4HtocHash      `offset:"0xfc"`            // offset 0xfc-0x7fb (28 * 64 = 1792 bytes)
	CRC    uint32               `offset:"0x7fc,endian:be"` // offset 0x7fc: CRC at end
}

type FS4HashesTableHeader struct {
	LoadAddress uint32 `offset:"0x0,endian:be"` // offset 0x0: hard-coded to 0
	DwSize      uint32 `offset:"0x4,endian:be"` // offset 0x4: num of payload DWs + 1
	CRC         uint16 `offset:"0x8,endian:be"` // offset 0x8: calculated over first 2 DWs
	Reserved    uint16 `offset:"0xa,endian:be"` // padding to 12 bytes
}

type FS4Htoc struct {
	Header FS4HtocHeader    `offset:"0x0"`  // offset 0x0-0xf (16 bytes)
	Entry  [28]FS4HtocEntry `offset:"0x10"` // offset 0x10-0xef (28 entries * 8 bytes = 224 bytes)
}

type FS4HtocEntry struct {
	HashOffset  uint16 `offset:"0x0,endian:be"` // bits 0-15: offset to hash
	SectionType uint8  `offset:"0x2,endian:be"` // bits 16-23: section type
	Reserved    uint8  `offset:"0x3,endian:be"` // bits 24-31: reserved
	// contains filtered or unexported fields
}

type FS4HtocHash struct {
	HashVal [16]uint32 `offset:"0x0,endian:be"` // 512-bit hash value (64 bytes)
}

type FS4HtocHeader struct {
	Version      uint32   `offset:"0x0,endian:be"` // offset 0x0
	NumOfEntries uint8    `offset:"0x4,endian:be"` // offset 0x4, bits 0-7
	HashType     uint8    `offset:"0x5,endian:be"` // offset 0x4, bits 8-15
	HashSize     uint16   `offset:"0x6,endian:be"` // offset 0x4, bits 16-31
	Reserved     [8]uint8 `offset:"0x8"`           // padding to 16 bytes
}

type FS4HwPointerEntry struct {
	Ptr uint32 `offset:"0x0,endian:be"` // offset 0x0: pointer
	CRC uint16 `offset:"0x4,endian:be"` // offset 0x4: crc16 as calculated by HW
	// contains filtered or unexported fields
}

type FS4HwPointersCarmel struct {
	BootRecordPtr              FS4HwPointerEntry `offset:"0x0"`  // offset 0x0
	Boot2Ptr                   FS4HwPointerEntry `offset:"0x8"`  // offset 0x8
	TocPtr                     FS4HwPointerEntry `offset:"0x10"` // offset 0x10
	ToolsPtr                   FS4HwPointerEntry `offset:"0x18"` // offset 0x18
	AuthenticationStartPointer FS4HwPointerEntry `offset:"0x20"` // offset 0x20
	AuthenticationEndPointer   FS4HwPointerEntry `offset:"0x28"` // offset 0x28
	DigestPointer              FS4HwPointerEntry `offset:"0x30"` // offset 0x30
	DigestRecoveryKeyPointer   FS4HwPointerEntry `offset:"0x38"` // offset 0x38
	FwWindowStartPointer       FS4HwPointerEntry `offset:"0x40"` // offset 0x40
	FwWindowEndPointer         FS4HwPointerEntry `offset:"0x48"` // offset 0x48
	ImageInfoSectionPointer    FS4HwPointerEntry `offset:"0x50"` // offset 0x50
	ImageSignaturePointer      FS4HwPointerEntry `offset:"0x58"` // offset 0x58
	PublicKeyPointer           FS4HwPointerEntry `offset:"0x60"` // offset 0x60
	FwSecurityVersionPointer   FS4HwPointerEntry `offset:"0x68"` // offset 0x68
	GcmIvDeltaPointer          FS4HwPointerEntry `offset:"0x70"` // offset 0x70
	HashesTablePointer         FS4HwPointerEntry `offset:"0x78"` // offset 0x78
}

type FS4ImageSignature2Struct struct {
	SignatureUUID [4]uint32   `offset:"0x0,endian:be"`  // offset 0x0-0xc: time-based UUID
	KeypairUUID   [4]uint32   `offset:"0x10,endian:be"` // offset 0x10-0x1c: keypair UUID
	Signature     [128]uint32 `offset:"0x20,endian:be"` // offset 0x20-0x21c: 4096-bit signature
}

type FS4ImageSignatureStruct struct {
	SignatureUUID [4]uint32  `offset:"0x0,endian:be"`  // offset 0x0-0xc: time-based UUID
	KeypairUUID   [4]uint32  `offset:"0x10,endian:be"` // offset 0x10-0x1c: keypair UUID
	Signature     [64]uint32 `offset:"0x20,endian:be"` // offset 0x20-0x11c: 2048-bit signature
}

type FS4PublicKeys2Struct struct {
	FilePublicKeys2 [8]FS4FilePublicKeys2 `offset:"0x0"` // 8 public keys of 544 bytes each = 4352 bytes
}

type FS4PublicKeys3Struct struct {
	FilePublicKeys3 [8]FS4FilePublicKeys3 `offset:"0x0"` // 8 public keys of 544 bytes each = 4352 bytes
}

type FS4PublicKeysStruct struct {
	FilePublicKeys [8]FS4FilePublicKeys `offset:"0x0"` // 8 public keys of 288 bytes each = 2304 bytes
}

type FS4SecureBootSignaturesStruct struct {
	BootSignature        [128]uint32 `offset:"0x0,endian:be"`   // offset 0x0-0x1fc: boot signature
	CriticalSignature    [128]uint32 `offset:"0x200,endian:be"` // offset 0x200-0x3fc: critical signature
	NonCriticalSignature [128]uint32 `offset:"0x400,endian:be"` // offset 0x400-0x5fc: non-critical signature
}

type FS5HWPointers struct {
	Boot2Ptr             HWPointerEntry `offset:"byte:0" json:"boot2_ptr"`                 // offset 0x0
	TOCPtr               HWPointerEntry `offset:"byte:8" json:"toc_ptr"`                   // offset 0x8
	ToolsPtr             HWPointerEntry `offset:"byte:16" json:"tools_ptr"`                // offset 0x10
	ImageInfoSectionPtr  HWPointerEntry `offset:"byte:24" json:"image_info_section_ptr"`   // offset 0x18
	FWPublicKeyPtr       HWPointerEntry `offset:"byte:32" json:"fw_public_key_ptr"`        // offset 0x20
	FWSignaturePtr       HWPointerEntry `offset:"byte:40" json:"fw_signature_ptr"`         // offset 0x28
	PublicKeyPtr         HWPointerEntry `offset:"byte:48" json:"public_key_ptr"`           // offset 0x30
	ForbiddenVersionsPtr HWPointerEntry `offset:"byte:56" json:"forbidden_versions_ptr"`   // offset 0x38
	PSCBl1Ptr            HWPointerEntry `offset:"byte:64" json:"psc_bl1_ptr"`              // offset 0x40
	PSCHashesTablePtr    HWPointerEntry `offset:"byte:72" json:"psc_hashes_table_ptr"`     // offset 0x48
	NCoreHashesPointer   HWPointerEntry `offset:"byte:80" json:"ncore_hashes_pointer"`     // offset 0x50
	PSCFWUpdateHandlePtr HWPointerEntry `offset:"byte:88" json:"psc_fw_update_handle_ptr"` // offset 0x58
	PSCBCHPointer        HWPointerEntry `offset:"byte:96" json:"psc_bch_pointer"`          // offset 0x60
	ReservedPtr13        HWPointerEntry `offset:"byte:104" json:"reserved_ptr13"`          // offset 0x68
	ReservedPtr14        HWPointerEntry `offset:"byte:112" json:"reserved_ptr14"`          // offset 0x70
	NCoreBCHPointer      HWPointerEntry `offset:"byte:120" json:"ncore_bch_pointer"`       // offset 0x78
}

type FS5HWPointersJSON struct {
	Boot2Ptr             HWPointerEntryJSON `json:"boot2_ptr"`
	TOCPtr               HWPointerEntryJSON `json:"toc_ptr"`
	ToolsPtr             HWPointerEntryJSON `json:"tools_ptr"`
	ImageInfoSectionPtr  HWPointerEntryJSON `json:"image_info_section_ptr"`
	FWPublicKeyPtr       HWPointerEntryJSON `json:"fw_public_key_ptr"`
	FWSignaturePtr       HWPointerEntryJSON `json:"fw_signature_ptr"`
	PublicKeyPtr         HWPointerEntryJSON `json:"public_key_ptr"`
	ForbiddenVersionsPtr HWPointerEntryJSON `json:"forbidden_versions_ptr"`
	PSCBl1Ptr            HWPointerEntryJSON `json:"psc_bl1_ptr"`
	PSCHashesTablePtr    HWPointerEntryJSON `json:"psc_hashes_table_ptr"`
	NCoreHashesPointer   HWPointerEntryJSON `json:"ncore_hashes_pointer"`
	PSCFWUpdateHandlePtr HWPointerEntryJSON `json:"psc_fw_update_handle_ptr"`
	PSCBCHPointer        HWPointerEntryJSON `json:"psc_bch_pointer"`
	NCoreBCHPointer      HWPointerEntryJSON `json:"ncore_bch_pointer"`
}

type FS5HwPointerEntry struct {
	Ptr uint32 `offset:"0x0,endian:be"` // offset 0x0: pointer
	CRC uint16 `offset:"0x4,endian:be"` // offset 0x4: crc16 as calculated by HW
	// contains filtered or unexported fields
}

type FS5HwPointersGilboa struct {
	PSCBCTPointer            FS5HwPointerEntry `offset:"0x0"`  // offset 0x0
	Boot2Ptr                 FS5HwPointerEntry `offset:"0x8"`  // offset 0x8
	TOCPtr                   FS5HwPointerEntry `offset:"0x10"` // offset 0x10
	ToolsPtr                 FS5HwPointerEntry `offset:"0x18"` // offset 0x18
	PSCBL1BCHPointer         FS5HwPointerEntry `offset:"0x20"` // offset 0x20
	PSCBL1Pointer            FS5HwPointerEntry `offset:"0x28"` // offset 0x28
	NCoreBCHPointer          FS5HwPointerEntry `offset:"0x30"` // offset 0x30
	Reserved                 FS5HwPointerEntry `offset:"0x38"` // offset 0x38
	PSCFWBCHPointer          FS5HwPointerEntry `offset:"0x40"` // offset 0x40
	PSCFWPointer             FS5HwPointerEntry `offset:"0x48"` // offset 0x48
	ImageInfoSectionPointer  FS5HwPointerEntry `offset:"0x50"` // offset 0x50
	ImageSignaturePointer    FS5HwPointerEntry `offset:"0x58"` // offset 0x58
	PublicKeyPointer         FS5HwPointerEntry `offset:"0x60"` // offset 0x60
	ForbiddenVersionsPointer FS5HwPointerEntry `offset:"0x68"` // offset 0x68
	PSCHashesTablePointer    FS5HwPointerEntry `offset:"0x70"` // offset 0x70
	NCoreHashesPointer       FS5HwPointerEntry `offset:"0x78"` // offset 0x78
}

type FWAdb struct {
	Version   uint32 `offset:"0x0,endian:be"` // ADB version
	Size      uint32 `offset:"0x4,endian:be"` // Size of ADB data
	Reserved1 uint32 `offset:"0x8,endian:be"` // Reserved
	Reserved2 uint32 `offset:"0xc,endian:be"` // Reserved

}

type FWByteSlice []byte

type FWInternalUsage struct {
	Version  uint32    `offset:"0x0,endian:be"`     // Version
	Size     uint32    `offset:"0x4,endian:be"`     // Data size
	Type     uint32    `offset:"0x8,endian:be"`     // Usage type
	Reserved [52]uint8 `offset:"0xc,reserved:true"` // Reserved
}

type FWInternalUsageJSON struct {
	Version  uint32 `json:"version"`
	Size     uint32 `json:"size"`
	Type     uint32 `json:"type"`
	DataSize int    `json:"data_size"`
}

type FWNVLog struct {
	LogVersion uint32     `offset:"0x0,endian:be"`               // Log format version
	LogSize    uint32     `offset:"0x4,endian:be"`               // Size of log data
	EntryCount uint32     `offset:"0x8,endian:be"`               // Number of log entries
	Reserved   [13]uint32 `offset:"0xc,endian:be,reserved:true"` // Reserved
}

type FWNVLogJSON struct {
	LogVersion uint32 `json:"log_version"`
	LogSize    uint32 `json:"log_size"`
	EntryCount uint32 `json:"entry_count"`
	DataSize   int    `json:"data_size"`
}

type FWVersion struct {
	Major     uint16 `bin:"BE"` // offset 0x0.16-0x0.31
	Reserved  uint16 `bin:"BE"` // offset 0x0.0-0x0.15 (padding)
	Minor     uint16 `bin:"BE"` // offset 0x4.16-0x4.31
	Subminor  uint16 `bin:"BE"` // offset 0x4.0-0x4.15
	Hour      uint8  `bin:"BE"` // offset 0x8.8-0x8.15
	Reserved2 uint8  `bin:"BE"` // offset 0x8.0-0x8.7 (padding)
	Minutes   uint8  `bin:"BE"` // offset 0x8.16-0x8.23
	Seconds   uint8  `bin:"BE"` // offset 0x8.24-0x8.31
	Day       uint8  `bin:"BE"` // offset 0xc.0-0xc.7
	Month     uint8  `bin:"BE"` // offset 0xc.8-0xc.15
	Year      uint16 `bin:"BE"` // offset 0xc.16-0xc.31
}

type FirmwareBootVersion struct {
	ImageFormatVersion uint8 `offset:"byte:0"`               // Bits 0-7
	Reserved           uint8 `offset:"byte:1,reserved:true"` // Bits 8-15
	MajorVersion       uint8 `offset:"byte:2"`               // Bits 16-23
	MinorVersion       uint8 `offset:"byte:3"`               // Bits 24-31
}

type FirmwareFormat int

type FirmwareMetadata struct {
	Format      FirmwareFormat
	ImageStart  uint32
	ImageSize   uint64
	ChunkSize   uint64
	IsEncrypted bool
	HWPointers  interface{} // Either *FS4HWPointers or *FS5HWPointers
	ITOCHeader  *ITOCHeader
	DTOCHeader  *ITOCHeader // DTOC uses same header structure as ITOC
	ImageInfo   *ImageInfo
	DeviceInfo  *DevInfo
	MFGInfo     *MfgInfo
}

type ForbiddenVersionEntry struct {
	MinVersion uint32 `bin:"BE"` // Minimum forbidden version
	MaxVersion uint32 `bin:"BE"` // Maximum forbidden version
	Flags      uint32 `bin:"BE"` // Flags for this entry
	Reserved   uint32 `bin:"BE"` // Reserved field
}

type ForbiddenVersions struct {
	Count    uint32   `offset:"byte:0,endian:be" json:"count"`                              // Number of forbidden versions
	Reserved uint32   `offset:"byte:4,endian:be,reserved:true" json:"reserved"`             // Reserved for alignment
	Versions []uint32 `offset:"byte:8,endian:be,list_size:Count" json:"versions,omitempty"` // List of forbidden version numbers
}

type ForbiddenVersionsHeader struct {
	Magic      uint32 `bin:"BE"` // Magic value
	Version    uint32 `bin:"BE"` // Format version
	NumEntries uint32 `bin:"BE"` // Number of forbidden version entries
	Reserved   uint32 `bin:"BE"` // Reserved field
}

type ForbiddenVersionsJSON struct {
	Count    uint32   `json:"count"`
	Reserved uint32   `json:"reserved"`
	Versions []uint32 `json:"versions"`
}

type Guids struct {
	Guids    UIDEntry   // offset 0x0
	Macs     UIDEntry   // offset 0x20
	Reserved [192]uint8 // padding to 256 bytes
}

type GuidsJSON struct {
	Reserved1    uint16 `json:"reserved1"`
	Step         uint8  `json:"step"`
	NumAllocated uint8  `json:"num_allocated"`
	Reserved2    uint32 `json:"reserved2"`
	UID          uint64 `json:"uid"`
}

type HMACDigest struct {
	DigestType uint32    `offset:"0x0,endian:be"` // Type of digest (SHA256, SHA512, etc)
	DigestSize uint32    `offset:"0x4,endian:be"` // Size of the digest in bytes
	Digest     [64]uint8 `offset:"0x8"`           // The actual digest (max 512 bits)
	Reserved   [56]uint8 `offset:"0x48"`          // Padding
}

type HTOC struct {
	Header  HTOCHeader    // offset 0x0
	Entries [28]HTOCEntry // offset 0x8
}

type HTOCEntry struct {
	BinHashType uint8  // offset 0x0.0-0x0.15 (bits 0-15)
	HashOffset  uint16 // offset 0x0.16-0x0.31 (bits 16-31)
	Reserved    uint32 // offset 0x4
}

type HTOCHash struct {
	HashData [32]uint8 // offset 0x0 - SHA256 hash
	Reserved [32]uint8 // offset 0x20 - padding to 64 bytes
}

type HTOCHeader struct {
	FirstType    uint16 // offset 0x0.0-0x0.15
	Version      uint8  // offset 0x0.16-0x0.23
	HashLocation uint8  // offset 0x0.24-0x0.31
	Reserved     uint32 // offset 0x4
}

type HWIDRecord struct {
	HWID       uint32 `offset:"byte:0,endian:be"`                // Hardware ID
	ChipType   uint32 `offset:"byte:4,endian:be"`                // Chip type
	DeviceType uint32 `offset:"byte:8,endian:be"`                // Device type
	Reserved   uint32 `offset:"byte:12,endian:be,reserved:true"` // Reserved field
}

type HWPointerEntry struct {
	Ptr      uint32 `offset:"byte:0,endian:be" json:"ptr"`                    // Pointer value (offset 0x0)
	Reserved uint16 `offset:"byte:4,endian:be,reserved:true" json:"reserved"` // Reserved field (offset 0x4)
	CRC      uint16 `offset:"byte:6,endian:be" json:"crc"`                    // CRC16 value (offset 0x6)
}

type HWPointerEntryJSON struct {
	Pointer uint32 `json:"pointer"`
	CRC     uint16 `json:"crc"`
}

type HashTableEntry struct {
	Type     uint32   `offset:"byte:0,endian:be" json:"type"`                    // Hash type/identifier
	Offset   uint32   `offset:"byte:4,endian:be" json:"offset"`                  // Offset in the image
	Size     uint32   `offset:"byte:8,endian:be" json:"size"`                    // Size of the hashed region
	Reserved uint32   `offset:"byte:12,endian:be,reserved:true" json:"reserved"` // Reserved field
	Hash     [32]byte `offset:"byte:16" json:"-"`                                // SHA-256 hash value - handled separately
}

type HashTableEntryJSON struct {
	Hash   string `json:"hash"` // Hex encoded
	Type   uint32 `json:"type"`
	Offset uint32 `json:"offset"`
	Size   uint32 `json:"size"`
}

type HashesTableExtended struct {
	Header HashesTableHeaderExtended // offset 0x0
	HTOC   HTOC                      // offset 0x10
	Hashes [28]HTOCHash              // offset 0xf0
}

type HashesTableHeader struct {
	Magic      uint32 `offset:"byte:0,endian:be" json:"magic"`                    // Should be a specific magic value
	Version    uint32 `offset:"byte:4,endian:be" json:"version"`                  // Version number
	Reserved1  uint32 `offset:"byte:8,endian:be,reserved:true" json:"reserved1"`  // Reserved field
	Reserved2  uint32 `offset:"byte:12,endian:be,reserved:true" json:"reserved2"` // Reserved field
	TableSize  uint32 `offset:"byte:16,endian:be" json:"table_size"`              // Size of the hashes table
	NumEntries uint32 `offset:"byte:20,endian:be" json:"num_entries"`             // Number of hash entries
	Reserved3  uint32 `offset:"byte:24,endian:be,reserved:true" json:"reserved3"` // Reserved field
	CRC        uint16 `offset:"byte:28,endian:be" json:"crc"`                     // CRC16 of the header
	Reserved4  uint16 `offset:"byte:30,endian:be,reserved:true" json:"reserved4"` // Reserved field
}

type HashesTableHeaderExtended struct {
	Magic    uint64 // offset 0x0 - should be HashesTableMagic
	Version  uint32 // offset 0x8
	Reserved uint32 // offset 0xc
}

type HashesTableHeaderJSON struct {
	Magic      uint32 `json:"magic"`
	Version    uint32 `json:"version"`
	Reserved1  uint32 `json:"reserved1"`
	Reserved2  uint32 `json:"reserved2"`
	TableSize  uint32 `json:"table_size"`
	NumEntries uint32 `json:"num_entries"`
	Reserved3  uint32 `json:"reserved3"`
	CRC        uint16 `json:"crc"`
	Reserved4  uint16 `json:"reserved4"`
}

type HashesTableJSON struct {
	Header       HashesTableHeaderJSON `json:"header"`
	Entries      []HashTableEntryJSON  `json:"entries"`
	ReservedTail string                `json:"reserved_tail"` // Hex encoded
}

type ITOCEntry struct {
	// Byte 0-3: Type (bits 0-7), Size (bits 8-29), Param0 bits (30-33)
	Type       uint8  `offset:"bit:0,len:8,endian:be"`  // bits 0-7
	SizeDwords uint32 `offset:"bit:8,len:22,endian:be"` // bits 8-29 (size in dwords)
	Param0Low  uint32 `offset:"bit:30,len:4,endian:be"` // bits 30-33 (lower 4 bits of Param0)

	// Byte 4-7: Param0 bits (34-63)
	Param0High uint32 `offset:"bit:34,len:30,endian:be"` // bits 34-63 (upper 30 bits of Param0)

	// Byte 8-11: Param1 (bits 64-95)
	Param1 uint32 `offset:"byte:8,endian:be"` // bits 64-95

	// Byte 12-15: Reserved
	Reserved1 uint32 `offset:"byte:12,endian:be,reserved:true"` // bits 96-127

	// Byte 16-19: Reserved
	Reserved2 uint32 `offset:"byte:16,endian:be,reserved:true"` // bits 128-159

	// Byte 20-23: Flash address (in bytes, not dwords as the field name suggests)
	// Despite the field name, mstflint treats this as a byte address directly
	FlashAddrDwords uint32 `offset:"byte:20,endian:be"` // Flash address in bytes

	// Byte 24-25: Encrypted flag and CRC flags
	// Based on actual bit layout from legacy parser:
	// - bit 192: encrypted
	// - bits 193-204: reserved
	// - bits 205-207: CRC type field (3 bits)
	//   - 0: CRC in ITOC entry (section_crc field)
	//   - 1: No CRC validation
	//   - 2: CRC at end of section data
	Encrypted bool  `offset:"bit:192,endian:be"`                      // bit 192
	Reserved5 uint8 `offset:"bit:193,len:12,endian:be,reserved:true"` // bits 193-204
	CRCField  uint8 `offset:"bit:205,len:3,endian:be"`                // bits 205-207 (3 bits)

	// Byte 26-27: Section CRC
	SectionCRC uint16 `offset:"bit:208,endian:be"` // bits 208-223 (16 bits)

	// Byte 28-29: Reserved
	Reserved7 uint16 `offset:"byte:28,endian:be,reserved:true"` // bits 224-239

	// Byte 30-31: ITOC Entry CRC
	ITOCEntryCRC uint16 `offset:"byte:30,endian:be"` // bits 240-255
}

type ITOCEntryJSON struct {
	Type            uint16 `json:"type"`
	DeviceData      bool   `json:"device_data"`
	NoHashCheck     bool   `json:"no_hash_check"`
	RelativeAddress bool   `json:"relative_address"`
	SectionPointer  uint32 `json:"section_pointer"`
	SectionSize     uint32 `json:"section_size"`
	FlashAddress    uint32 `json:"flash_address"`
	CRC             uint16 `json:"crc"`
}

type ITOCHeader struct {
	Signature0   uint32 `offset:"byte:0,endian:be"`                // Should be ITOCSignature (offset 0x0)
	Signature1   uint32 `offset:"byte:4,endian:be"`                // offset 0x4
	Signature2   uint32 `offset:"byte:8,endian:be"`                // offset 0x8
	Signature3   uint32 `offset:"byte:12,endian:be"`               // offset 0xc
	Version      uint32 `offset:"byte:16,endian:be"`               // offset 0x10
	Reserved     uint32 `offset:"byte:20,endian:be,reserved:true"` // offset 0x14
	ITOCEntryCRC uint32 `offset:"byte:24,endian:be"`               // offset 0x18
	CRC          uint32 `offset:"byte:28,endian:be"`               // offset 0x1c
}

type ITOCHeaderJSON struct {
	IdentifierLo      uint32 `json:"identifier_lo"`
	IdentifierHi      uint32 `json:"identifier_hi"`
	Version           uint8  `json:"version"`
	Reserved0         uint8  `json:"reserved0"`
	Reserved1         uint16 `json:"reserved1"`
	Reserved2         uint32 `json:"reserved2"`
	Reserved3         uint32 `json:"reserved3"`
	Reserved4         uint32 `json:"reserved4"`
	NextHeaderPointer uint32 `json:"next_header_pointer"`
	NextHeaderSize    uint32 `json:"next_header_size"`
	Padding           string `json:"padding,omitempty"`
}

type ITOCJSON struct {
	Header  ITOCHeaderJSON  `json:"header"`
	Entries []ITOCEntryJSON `json:"entries"`
}

type ImageInfo struct {
	// DWORD 0 - offset 0x0 (32 bits total) - stored as big-endian in firmware
	// Original parseSecurityAttributes uses LSB=0 bit numbering on BE uint32:
	// - mccEn: bit 8, debugFW: bit 13, signedFW: bit 14, secureFW: bit 15
	// But annotation parser uses MSB=0 bit numbering, so we convert:
	// - mccEn: bit 8 (LSB=0) = bit 23 (MSB=0)
	// - debugFW: bit 13 (LSB=0) = bit 18 (MSB=0)
	// - signedFW: bit 14 (LSB=0) = bit 17 (MSB=0)
	// - secureFW: bit 15 (LSB=0) = bit 16 (MSB=0)
	Reserved0    uint8 `offset:"bit:0,len:8,endian:be" json:"reserved0"`      // Bits 0-7 (MSB=0) = bits 24-31 (LSB=0)
	MajorVersion uint8 `offset:"bit:8,len:8,endian:be" json:"major_version"`  // Bits 8-15 (MSB=0) = bits 16-23 (LSB=0)
	SecurityMode uint8 `offset:"bit:16,len:8,endian:be" json:"security_mode"` // Bits 16-23 (MSB=0) = bits 8-15 (LSB=0)
	SecureFW     bool  `offset:"bit:16,len:1,endian:be" json:"secure_fw"`     // Bit 16 (MSB=0) = bit 15 (LSB=0)
	SignedFW     bool  `offset:"bit:17,len:1,endian:be" json:"signed_fw"`     // Bit 17 (MSB=0) = bit 14 (LSB=0)
	DebugFW      bool  `offset:"bit:18,len:1,endian:be" json:"debug_fw"`      // Bit 18 (MSB=0) = bit 13 (LSB=0)
	MCCEnabled   bool  `offset:"bit:23,len:1,endian:be" json:"mcc_enabled"`   // Bit 23 (MSB=0) = bit 8 (LSB=0)
	MinorVersion uint8 `offset:"bit:24,len:8,endian:be" json:"minor_version"` // Bits 24-31 (MSB=0) = bits 0-7 (LSB=0)

	// DWORD 1-4 - offset 0x4 - FW Version
	FWVerMajor    uint16 `offset:"byte:4,endian:be" json:"fw_ver_major"`            // offset 0x4
	Reserved2     uint16 `offset:"byte:6,endian:be,reserved:true" json:"reserved2"` // offset 0x6
	FWVerMinor    uint16 `offset:"byte:8,endian:be" json:"fw_ver_minor"`            // offset 0x8
	FWVerSubminor uint16 `offset:"byte:10,endian:be" json:"fw_ver_subminor"`        // offset 0xa

	// Date/time fields - TIME at offset 0xc, DATE at offset 0x10
	Reserved3a uint8  `offset:"byte:12,reserved:true" json:"reserved3a"`       // offset 0xc byte 0
	Hour       uint8  `offset:"byte:13,hex_as_dec:true" json:"hour"`           // offset 0xc byte 1
	Minutes    uint8  `offset:"byte:14,hex_as_dec:true" json:"minutes"`        // offset 0xc byte 2
	Seconds    uint8  `offset:"byte:15,hex_as_dec:true" json:"seconds"`        // offset 0xc byte 3
	Year       uint16 `offset:"byte:16,endian:be,hex_as_dec:true" json:"year"` // offset 0x10 - BCD year (e.g. 0x2024 = 2024)
	Month      uint8  `offset:"byte:18,hex_as_dec:true" json:"month"`          // offset 0x12 - BCD month (e.g. 0x06 = 6)
	Day        uint8  `offset:"byte:19,hex_as_dec:true" json:"day"`            // offset 0x13 - BCD day (e.g. 0x27 = 27)

	// MIC version - offset 0x14
	MICVerMajor    uint16 `offset:"byte:20,endian:be" json:"mic_ver_major"`           // offset 0x14
	Reserved4      uint16 `offset:"byte:22,endian:be,reserved:true" json:"reserved4"` // offset 0x16
	MICVerSubminor uint16 `offset:"byte:24,endian:be" json:"mic_ver_subminor"`        // offset 0x18
	MICVerMinor    uint16 `offset:"byte:26,endian:be" json:"mic_ver_minor"`           // offset 0x1a

	// PCI IDs - offset 0x1c
	PCIDeviceID    uint16 `offset:"byte:28,endian:be" json:"pci_device_id"`    // offset 0x1c
	PCIVendorID    uint16 `offset:"byte:30,endian:be" json:"pci_vendor_id"`    // offset 0x1e
	PCISubsystemID uint16 `offset:"byte:32,endian:be" json:"pci_subsystem_id"` // offset 0x20
	PCISubVendorID uint16 `offset:"byte:34,endian:be" json:"pci_subvendor_id"` // offset 0x22

	// PSID - offset 0x24
	PSID [16]byte `offset:"byte:36" json:"-"` // offset 0x24-0x33 (will be handled separately in MarshalJSON)

	// Padding/alignment - offset 0x34
	Reserved5a uint16 `offset:"byte:52,endian:be,reserved:true" json:"reserved5a"` // offset 0x34-0x35

	// VSD vendor ID - offset 0x36
	VSDVendorID uint16 `offset:"byte:54,endian:be" json:"vsd_vendor_id"` // offset 0x36-0x37

	// VSD - offset 0x38
	VSD [208]byte `offset:"byte:56" json:"-"` // offset 0x38-0x107 (will be handled separately in MarshalJSON)

	// Image size - offset 0x108
	ImageSizeData [8]byte `offset:"byte:264" json:"image_size_data"` // offset 0x108-0x10f

	// Reserved - offset 0x110
	Reserved6 [8]byte `offset:"byte:272,reserved:true" json:"reserved6"` // offset 0x110-0x117

	// Supported HW IDs - offset 0x118
	SupportedHWID [4]uint32 `offset:"byte:280,endian:be" json:"supported_hw_ids"` // offset 0x118-0x127

	// INI File number and reserved - offset 0x128
	INIFileNum uint32 `offset:"byte:296,endian:be" json:"ini_file_num"` // offset 0x128-0x12b

	// Big reserved section - offset 0x12c
	Reserved7 [148]byte `offset:"byte:300,reserved:true" json:"reserved7"` // offset 0x12c-0x1bf

	// Product version - offset 0x1c0
	ProductVer [16]byte `offset:"byte:448" json:"-"` // offset 0x1c0-0x1cf (will be handled separately in MarshalJSON)

	// Description - offset 0x1d0
	Description [256]byte `offset:"byte:464" json:"-"` // offset 0x1d0-0x2cf (will be handled separately in MarshalJSON)

	// Reserved - offset 0x2d0
	Reserved8 [48]byte `offset:"byte:720,reserved:true" json:"reserved8"` // offset 0x2d0-0x2ff

	// Module versions - offset 0x300
	ModuleVersions [64]byte `offset:"byte:768" json:"module_versions"` // offset 0x300-0x33f

	// Name (part number) - offset 0x340
	Name [64]byte `offset:"byte:832" json:"-"` // offset 0x340-0x37f (will be handled separately in MarshalJSON)

	// PRS name - offset 0x380
	PRSName [128]byte `offset:"byte:896" json:"-"` // offset 0x380-0x3ff (will be handled separately in MarshalJSON)
}

type ImageInfoExtended struct {
	// Flags (bits in first dword)
	LongKeys                  uint8 `bin:"bitfield=1"` // bit 6
	DebugFWTokensSupported    uint8 `bin:"bitfield=1"` // bit 7
	MccEn                     uint8 `bin:"bitfield=1"` // bit 8
	SignedVendorNvconfigFiles uint8 `bin:"bitfield=1"` // bit 9
	SignedMlnxNvconfigFiles   uint8 `bin:"bitfield=1"` // bit 10
	FrcSupported              uint8 `bin:"bitfield=1"` // bit 11
	CSTokensSupported         uint8 `bin:"bitfield=1"` // bit 12
	DebugFW                   uint8 `bin:"bitfield=1"` // bit 13
	SignedFW                  uint8 `bin:"bitfield=1"` // bit 14
	SecureFW                  uint8 `bin:"bitfield=1"` // bit 15

	// Version info
	MinorVersion uint8 // bits 16-23
	MajorVersion uint8 // bits 24-31

	// Firmware version
	FWVersion  FWVersion     // offset 0x4-0x14
	MicVersion TripleVersion // offset 0x14-0x1c

	// PCI IDs
	PCIVendorID    uint16 // offset 0x1c.0-0x1c.15
	PCIDeviceID    uint16 // offset 0x1c.16-0x1c.31
	PCISubVendorID uint16 // offset 0x20.0-0x20.15
	PCISubsystemID uint16 // offset 0x20.16-0x20.31

	// PSID and VSD
	PSID        [17]byte  // offset 0x24-0x34 (null-terminated string)
	VSDVendorID uint16    // offset 0x34
	Reserved1   uint16    // offset 0x36
	VSD         [209]byte // offset 0x38-0x108 (null-terminated string)

	// Image size
	ImageSizeStruct ImageSize // offset 0x108-0x110

	// Supported HW IDs
	SupportedHWID [4]uint32 // offset 0x118-0x128

	// INI file number
	INIFileNum uint32 // offset 0x128

	// Reserved space
	Reserved2 [148]uint8 // offset 0x12c-0x1c0

	// Product version
	ProdVer [17]byte // offset 0x1c0-0x1d0 (null-terminated string)

	// Description
	Description [257]byte // offset 0x1d0-0x2d0 (null-terminated string)

	// Reserved space
	Reserved3 [48]uint8 // offset 0x2d1-0x300

	// Module versions
	ModuleVersionsStruct ModuleVersions // offset 0x300-0x340

	// Name
	Name [65]byte // offset 0x340-0x380 (null-terminated string)

	// PRS name
	PRSName [129]byte // offset 0x380-0x400 (null-terminated string)
}

type ImageInfoJSON struct {
	// Security and version info
	SecurityAndVersion uint32 `json:"security_and_version"`
	MinorVersion       uint8  `json:"minor_version"`
	SecurityMode       uint8  `json:"security_mode"`
	MajorVersion       uint8  `json:"major_version"`
	Reserved0          uint8  `json:"reserved0"`
	MCCEnabled         bool   `json:"mcc_enabled"`
	DebugFW            bool   `json:"debug_fw"`
	SignedFW           bool   `json:"signed_fw"`
	SecureFW           bool   `json:"secure_fw"`

	// FW version fields
	FWVerMajor    uint16 `json:"fw_ver_major"`
	Reserved2     uint16 `json:"reserved2"`
	FWVerMinor    uint16 `json:"fw_ver_minor"`
	FWVerSubminor uint16 `json:"fw_ver_subminor"`

	// Date/time fields
	Reserved3a uint8  `json:"reserved3a"`
	Hour       uint8  `json:"hour"`
	Minutes    uint8  `json:"minutes"`
	Seconds    uint8  `json:"seconds"`
	Day        uint8  `json:"day"`
	Month      uint8  `json:"month"`
	Year       uint16 `json:"year"`

	// MIC version fields
	MICVerMajor    uint16 `json:"mic_ver_major"`
	Reserved4      uint16 `json:"reserved4"`
	MICVerSubminor uint16 `json:"mic_ver_subminor"`
	MICVerMinor    uint16 `json:"mic_ver_minor"`

	// PCI IDs
	PCIDeviceID    uint16 `json:"pci_device_id"`
	PCIVendorID    uint16 `json:"pci_vendor_id"`
	PCISubsystemID uint16 `json:"pci_subsystem_id"`
	PCISubVendorID uint16 `json:"pci_subvendor_id"`

	// PSID
	PSID string `json:"psid"`

	// VSD info
	Reserved5a  uint16 `json:"reserved5a"`
	VSDVendorID uint16 `json:"vsd_vendor_id"`
	VSD         string `json:"vsd"`

	// Image size data
	ImageSizeData []uint8 `json:"image_size_data"`
	Reserved6     []uint8 `json:"reserved6"`

	// Supported HW IDs
	SupportedHWIDs []uint32 `json:"supported_hw_ids"`

	// INI file num
	INIFileNum uint32  `json:"ini_file_num"`
	Reserved7  []uint8 `json:"reserved7"`

	// Product version
	ProductVer    string  `json:"product_ver"`
	ProductVerRaw []uint8 `json:"product_ver_raw"`

	// Description
	Description string  `json:"description"`
	Reserved8   []uint8 `json:"reserved8"`

	// Module versions
	ModuleVersions []uint8 `json:"module_versions"`

	// Name fields
	Name    string `json:"name"`
	PRSName string `json:"prs_name"`

	// Human-readable versions for convenience
	FWVersion          string `json:"fw_version"`
	FWReleaseDate      string `json:"fw_release_date"`
	MICVersion         string `json:"mic_version"`
	SecurityAttributes string `json:"security_attributes"`
}

type ImageSignature struct {
	SignatureType uint32     `offset:"byte:0,endian:be" json:"signature_type"` // offset 0x0
	Signature     [256]uint8 `offset:"byte:4" json:"-"`                        // offset 0x4 - Handled separately in MarshalJSON/UnmarshalJSON
}

type ImageSignature2 struct {
	SignatureType uint32     `offset:"byte:0,endian:be" json:"signature_type"` // offset 0x0
	Signature     [512]uint8 `offset:"byte:4" json:"-"`                        // offset 0x4 - Handled separately in MarshalJSON/UnmarshalJSON
}

type ImageSignatureJSON struct {
	SignatureType uint32 `json:"signature_type"`
	Signature     string `json:"signature"`         // Hex encoded
	Padding       string `json:"padding,omitempty"` // Hex encoded padding data
}

type ImageSize struct {
	LogStep    uint8    // log of next address in bytes to search for an image
	Reserved   [3]uint8 // padding to make it 32-bit aligned
	RunFromAny uint8    // bit 31: this image can run from any partition
	MaxSize    uint32   // Max possible size in bytes of image
}

type InSectionCRCPolicy uint8

type MacsJSON struct {
	Reserved1    uint16 `json:"reserved1"`
	Step         uint8  `json:"step"`
	NumAllocated uint8  `json:"num_allocated"`
	Reserved2    uint32 `json:"reserved2"`
	UID          uint64 `json:"uid"`
}

type MagicPatternStruct struct {
	Magic    uint64 `offset:"byte:0,endian:be"`               // Should be MagicPattern constant
	Reserved uint64 `offset:"byte:8,endian:be,reserved:true"` // Reserved/padding
}

type MfgInfo struct {
	// PSID - offset 0x0
	PSID [16]byte `offset:"byte:0" json:"-"` // "MT_0000000911" (will be handled separately in MarshalJSON)

	// Unknown fields - offset 0x10
	Reserved1 [12]byte `offset:"byte:16,reserved:true" json:"reserved1"` // offset 0x10-0x1b
	Flags     uint32   `offset:"byte:28,endian:be" json:"flags"`         // offset 0x1c - observed 0x01000001

	// GUID allocation info - offset 0x20
	Guids UidEntry `offset:"byte:32" json:"guids"` // offset 0x20-0x2f - GUID allocation info

	// MAC allocation info - offset 0x30
	Macs UidEntry `offset:"byte:48" json:"macs"` // offset 0x30-0x3f - MAC allocation info

	// Trailing padding (variable): different families use different total sizes.
	// Observed: 0x100 (256) on some CX6Dx firmwares and 0x140 (320) on CX5.
	// To match mstflint (image_layout_mfg_info) behavior and avoid magic sizes,
	// model the tail as a slice starting at 0x40 so we accept either layout.
	// CRC/size for this section come from the DTOC/ITOC entry, not from an
	// embedded trailer.
	Reserved2 []byte `offset:"byte:64,reserved:true" json:"reserved2"`
}

type MfgInfoJSON struct {
	PSID        []byte `json:"psid"`
	PartNumber  []byte `json:"part_number"`
	Revision    []byte `json:"revision"`
	ProductName []byte `json:"product_name"`
	Reserved    []byte `json:"reserved"`
}

type ModuleVersion struct {
	Major  uint16 `bin:"BE,bitfield=12"` // offset 0x0.20-0x0.31 (12 bits)
	Minor  uint16 `bin:"BE,bitfield=12"` // offset 0x0.8-0x0.19 (12 bits)
	Branch uint8  `bin:"BE"`             // offset 0x0.0-0x0.7
}

type ModuleVersions struct {
	Core           ModuleVersion // offset 0x0
	Phy            ModuleVersion // offset 0x4
	Kernel         ModuleVersion // offset 0x8
	IronImage      ModuleVersion // offset 0xc
	HostManagement ModuleVersion // offset 0x10
	Mad            ModuleVersion // offset 0x14
	Reserved       [40]uint8     // padding to 64 bytes
}

type NVData struct {
	Version   uint32    `offset:"0x0,endian:be"`               // NV data version
	DataSize  uint32    `offset:"0x4,endian:be"`               // Size of NV data
	Reserved1 uint32    `offset:"0x8,endian:be,reserved:true"` // Reserved
	Reserved2 uint32    `offset:"0xc,endian:be,reserved:true"` // Reserved
	Reserved3 [48]uint8 `offset:"0x10,reserved:true"`          // Reserved padding
}

type NVDataJSON struct {
	Version        uint32 `json:"version"`
	DataSize       uint32 `json:"data_size"`
	ActualDataSize int    `json:"actual_data_size"`
}

type OperationKey struct {
	KeyModifier uint64 // offset 0x0
	Key         uint64 // offset 0x8
}

type ProgrammableHWFW struct {
	Version     uint32    `offset:"0x0,endian:be"`      // Firmware version
	HWType      uint32    `offset:"0x4,endian:be"`      // Hardware type
	FWSize      uint32    `offset:"0x8,endian:be"`      // Firmware size
	Checksum    uint32    `offset:"0xc,endian:be"`      // Firmware checksum
	LoadAddress uint32    `offset:"0x10,endian:be"`     // Load address in hardware
	EntryPoint  uint32    `offset:"0x14,endian:be"`     // Entry point address
	Reserved    [40]uint8 `offset:"0x18,reserved:true"` // Reserved
}

type ProgrammableHWFWJSON struct {
	Version     uint32 `json:"version"`
	HWType      uint32 `json:"hw_type"`
	FWSize      uint32 `json:"fw_size"`
	Checksum    uint32 `json:"checksum"`
	LoadAddress string `json:"load_address"`
	EntryPoint  string `json:"entry_point"`
	DataSize    int    `json:"data_size"`
}

type PublicKey struct {
	Reserved uint32     `offset:"byte:0,endian:be,reserved:true" json:"reserved"` // offset 0x0
	UUID     [16]uint8  `offset:"byte:4" json:"-"`                                // offset 0x4 - Handled separately in MarshalJSON/UnmarshalJSON
	Key      [256]uint8 `offset:"byte:20" json:"-"`                               // offset 0x14 (20 decimal) - Handled separately in MarshalJSON/UnmarshalJSON
}

type PublicKey2 struct {
	Reserved uint32     `offset:"byte:0,endian:be,reserved:true" json:"reserved"` // offset 0x0
	UUID     [16]uint8  `offset:"byte:4" json:"-"`                                // offset 0x4 - Handled separately in MarshalJSON/UnmarshalJSON
	Key      [512]uint8 `offset:"byte:20" json:"-"`                               // offset 0x14 (20 decimal) - Handled separately in MarshalJSON/UnmarshalJSON
}

type PublicKeyBlock struct {
	KeyType   uint32 `bin:"BE"` // Type of key (RSA-2048, RSA-4096, etc.)
	KeyLength uint32 `bin:"BE"` // Length of key data
	KeyID     uint32 `bin:"BE"` // Key identifier
	Reserved  uint32 `bin:"BE"` // Reserved field
	PublicKey []byte `bin:""`   // Variable length public key data
}

type PublicKeyJSON struct {
	Index    int    `json:"index,omitempty"`
	Reserved uint32 `json:"reserved"`
	UUID     string `json:"uuid"` // Hex encoded
	Key      string `json:"key"`  // Hex encoded
}

type PublicKeys struct {
	Keys [8]PublicKey `offset:"byte:0" json:"keys"` // offset 0x0
}

type PublicKeys2 struct {
	Keys [8]PublicKey2 `offset:"byte:0" json:"keys"` // offset 0x0
}

type RSAPublicKey struct {
	KeyType   uint32     `offset:"0x0,endian:be"` // RSA key type (2048, 4096, etc)
	KeySize   uint32     `offset:"0x4,endian:be"` // Key size in bytes
	Exponent  uint32     `offset:"0x8,endian:be"` // Public exponent (usually 65537)
	Reserved1 uint32     `offset:"0xc,endian:be"` // Reserved
	Modulus   [512]uint8 `offset:"0x10"`          // RSA modulus (up to 4096 bits)
	Reserved2 [496]uint8 `offset:"0x210"`         // Padding to 1024 bytes
}

type Reader struct {
	// contains filtered or unexported fields
}

type ResetCapabilities struct {
	ResetVerEn       uint8  `offset:"bit:0,len:1,endian:be"` // bit 0
	Reserved1        uint8  `offset:"bit:1,len:7,endian:be"` // bits 1-7
	VersionVectorVer uint8  `offset:"byte:1,endian:be"`      // bits 8-15
	Reserved2        uint16 `offset:"byte:2,endian:be"`      // bits 16-31
}

type ResetInfo struct {
	Data [256]uint8 `offset:"0x0"` // Full 256-byte section
}

type ResetInfoJSON struct {
	HardReset uint32 `json:"hard_reset"`
	SoftReset uint32 `json:"soft_reset"`
	Reserved  uint32 `json:"reserved"`
}

type ResetVersion struct {
	Major    uint16 `offset:"bit:0,len:16,endian:be"` // bits 0-15
	Branch   uint8  `offset:"bit:16,len:4,endian:be"` // bits 16-19
	Minor    uint8  `offset:"bit:20,len:8,endian:be"` // bits 20-27
	Reserved uint8  `offset:"bit:28,len:4,endian:be"` // bits 28-31
}

type RootCertificates struct {
	Version   uint32   `offset:"0x0,endian:be"`     // Version
	CertCount uint32   `offset:"0x4,endian:be"`     // Number of certificates
	Reserved  [8]uint8 `offset:"0x8,reserved:true"` // Reserved
}

type SectionJSON struct {
	// Metadata fields
	Type         uint16 `json:"type"`
	TypeName     string `json:"type_name"`
	Offset       uint64 `json:"offset"`
	Size         uint32 `json:"size"`
	CRCType      string `json:"crc_type"`
	IsEncrypted  bool   `json:"is_encrypted"`
	IsDeviceData bool   `json:"is_device_data"`

	// Indicates if this section has raw data that needs binary file
	HasRawData bool `json:"has_raw_data"`

	// Type-specific data (one of these will be populated)
	ImageInfo         *ImageInfoJSON         `json:"image_info,omitempty"`
	DeviceInfo        *DevInfoJSON           `json:"device_info,omitempty"`
	MfgInfo           *MfgInfoJSON           `json:"mfg_info,omitempty"`
	HashesTable       *HashesTableJSON       `json:"hashes_table,omitempty"`
	ImageSignature    *ImageSignatureJSON    `json:"signature,omitempty"`
	PublicKeys        []PublicKeyJSON        `json:"keys,omitempty"`
	ForbiddenVersions *ForbiddenVersionsJSON `json:"forbidden_versions,omitempty"`
	FS4HWPointers     *FS4HWPointersJSON     `json:"fs4_hw_pointers,omitempty"`
	FS5HWPointers     *FS5HWPointersJSON     `json:"fs5_hw_pointers,omitempty"`
	ITOC              *ITOCJSON              `json:"itoc,omitempty"`
	DTOC              *DTOCJSON              `json:"dtoc,omitempty"`
	ResetInfo         *ResetInfoJSON         `json:"reset_info,omitempty"`
	ToolsAreaExtended *ToolsAreaExtendedJSON `json:"tools_area_extended,omitempty"`

	// DTOC sections
	VPD_R0           *VPD_R0JSON           `json:"vpd_r0,omitempty"`
	FWNVLog          *FWNVLogJSON          `json:"fw_nv_log,omitempty"`
	NVData           *NVDataJSON           `json:"nv_data,omitempty"`
	CRDumpMaskData   *CRDumpMaskDataJSON   `json:"crdump_mask_data,omitempty"`
	FWInternalUsage  *FWInternalUsageJSON  `json:"fw_internal_usage,omitempty"`
	ProgrammableHWFW *ProgrammableHWFWJSON `json:"programmable_hw_fw,omitempty"`
	DigitalCertPtr   *DigitalCertPtrJSON   `json:"digital_cert_ptr,omitempty"`
	DigitalCertRW    *DigitalCertRWJSON    `json:"digital_cert_rw,omitempty"`

	// For sections with padding
	Padding string `json:"padding,omitempty"` // Hex encoded padding data
}

type SectionType uint16

type SecureBootSignatures struct {
	BootSignature        [128]uint32 `offset:"0x0,endian:be"`   // offset 0x0 - boot signature of data
	CriticalSignature    [128]uint32 `offset:"0x200,endian:be"` // offset 0x200 - fw critical signature of itcos
	NonCriticalSignature [128]uint32 `offset:"0x400,endian:be"` // offset 0x400 - fw non critical signatures
}

type SecurityModeMask struct {
	MCC_EN                  uint32
	DEBUG_FW                uint32
	SIGNED_FW               uint32
	SECURE_FW               uint32
	DEV_FW                  uint32
	CS_TOKEN                uint32
	DBG_TOKEN               uint32
	CRYPTO_TO_COMMISSIONING uint32
	RMCS_TOKEN              uint32
	RMDT_TOKEN              uint32
}

type SignatureBlock struct {
	SignatureType   uint32 `bin:"BE"` // Type of signature (RSA-2048, RSA-4096, etc.)
	SignatureLength uint32 `bin:"BE"` // Length of signature data
	Reserved1       uint32 `bin:"BE"` // Reserved field
	Reserved2       uint32 `bin:"BE"` // Reserved field
	Signature       []byte `bin:""`   // Variable length signature data
}

type ToolsArea struct {
	BinaryHeader BinaryVersion `offset:"byte:0"`
}

type ToolsAreaExtended struct {
	TLVRC       uint32    `offset:"byte:0,endian:be"`      // offset 0x0
	CRCFlag     uint32    `offset:"byte:4,endian:be"`      // offset 0x4
	TotalLength uint32    `offset:"byte:8,endian:be"`      // offset 0x8
	TypeLength  uint32    `offset:"byte:12,endian:be"`     // offset 0xc
	TypeData    [16]uint8 `offset:"byte:16"`               // offset 0x10
	Reserved    [32]uint8 `offset:"byte:32,reserved:true"` // offset 0x20
}

type ToolsAreaExtendedJSON struct {
	Data string `json:"data"` // Hex encoded
}

type TripleVersion struct {
	Major    uint16 `bin:"BE"` // offset 0x0.16-0x0.31
	Reserved uint16 `bin:"BE"` // offset 0x0.0-0x0.15 (padding)
	Minor    uint16 `bin:"BE"` // offset 0x4.16-0x4.31
	Subminor uint16 `bin:"BE"` // offset 0x4.0-0x4.15
}