passport-firmware/ports/stm32/boards/Passport/include/fwheader.h

// SPDX-FileCopyrightText: 2020 Foundation Devices, Inc. <hello@foundationdevices.com>
// SPDX-License-Identifier: GPL-3.0-or-later
//
// SPDX-FileCopyrightText: 2018 Coinkite, Inc. <coldcardwallet.com>
// SPDX-License-Identifier: GPL-3.0-only
//
#pragma once

#include <stdint.h>

#define FW_START            (0x08020000)
#define FW_HEADER_SIZE      2048
#define FW_HEADER_MAGIC     0x50415353
#define FW_HDR              ((passport_firmware_header_t *)(FW_START))
#define FW_END              (0x081E0000)

#define HASH_LEN            32
#define SIGNATURE_LEN       64
#define DATE_LEN            14 // e.g., "Jan. 01, 2021"  + null
#define VERSION_LEN          8 // e.g., 00.00 + null

typedef struct __attribute__ ((packed))
{
    uint32_t    magic;
    uint32_t    timestamp;
    uint8_t     fwdate[DATE_LEN]; 
    uint8_t     fwversion[VERSION_LEN];
    uint32_t    fwlength;
} fw_info_t;

typedef struct __attribute__ ((packed))
{
    uint32_t    pubkey1;
    uint8_t     signature1[SIGNATURE_LEN];
    uint32_t    pubkey2;
    uint8_t     signature2[SIGNATURE_LEN];
} fw_signature_t;

typedef struct __attribute__ ((packed))
{
    fw_info_t info;
    fw_signature_t signature;
} passport_firmware_header_t;