10#ifndef NO_PICO_PLATFORM
25#define PICOBIN_BLOCK_MARKER_START _u(0xffffded3)
26#define PICOBIN_BLOCK_MARKER_END _u(0xab123579)
28#define PICOBIN_MAX_BLOCK_SIZE _u(0x280)
29#define PICOBIN_MAX_IMAGE_DEF_BLOCK_SIZE _u(0x180)
30#define PICOBIN_MAX_PARTITION_TABLE_BLOCK_SIZE _u(0x280)
33#define PICOBIN_BLOCK_ITEM_1BS_NEXT_BLOCK_OFFSET _u(0x41)
34#define PICOBIN_BLOCK_ITEM_1BS_IMAGE_TYPE _u(0x42)
35#define PICOBIN_BLOCK_ITEM_1BS_VECTOR_TABLE _u(0x03)
36#define PICOBIN_BLOCK_ITEM_1BS_ENTRY_POINT _u(0x44)
37#define PICOBIN_BLOCK_ITEM_1BS_ROLLING_WINDOW_DELTA _u(0x05)
38#define PICOBIN_BLOCK_ITEM_LOAD_MAP _u(0x06)
39#define PICOBIN_BLOCK_ITEM_1BS_HASH_DEF _u(0x47)
40#define PICOBIN_BLOCK_ITEM_1BS_VERSION _u(0x48)
41#define PICOBIN_BLOCK_ITEM_SIGNATURE _u(0x09)
42#define PICOBIN_BLOCK_ITEM_PARTITION_TABLE _u(0x0a)
43#define PICOBIN_BLOCK_ITEM_HASH_VALUE _u(0x4b)
44#define PICOBIN_BLOCK_ITEM_SALT _u(0x0c)
46#define PICOBIN_BLOCK_ITEM_2BS_IGNORED (_u(0x80) | _u(0x7e))
47#define PICOBIN_BLOCK_ITEM_2BS_LAST (_u(0x80) | _u(0x7f))
51#define PICOBIN_INDEX_TO_BITS(y, x) (y ## _ ## x << y ## _LSB)
53#define PICOBIN_IMAGE_TYPE_IMAGE_TYPE_LSB _u(0)
54#define PICOBIN_IMAGE_TYPE_IMAGE_TYPE_BITS _u(0x000f)
55#define PICOBIN_IMAGE_TYPE_IMAGE_TYPE_INVALID _u(0x0)
56#define PICOBIN_IMAGE_TYPE_IMAGE_TYPE_EXE _u(0x1)
57#define PICOBIN_IMAGE_TYPE_IMAGE_TYPE_DATA _u(0x2)
58#define PICOBIN_IMAGE_TYPE_IMAGE_TYPE_AS_BITS(x) PICOBIN_INDEX_TO_BITS(PICOBIN_IMAGE_TYPE_IMAGE_TYPE, x)
60#define PICOBIN_IMAGE_TYPE_EXE_SECURITY_LSB _u(4)
61#define PICOBIN_IMAGE_TYPE_EXE_SECURITY_BITS _u(0x0030)
62#define PICOBIN_IMAGE_TYPE_EXE_SECURITY_UNSPECIFIED _u(0x0)
63#define PICOBIN_IMAGE_TYPE_EXE_SECURITY_NS _u(0x1)
64#define PICOBIN_IMAGE_TYPE_EXE_SECURITY_S _u(0x2)
65#define PICOBIN_IMAGE_TYPE_EXE_SECURITY_AS_BITS(x) PICOBIN_INDEX_TO_BITS(PICOBIN_IMAGE_TYPE_EXE_SECURITY, x)
67#define PICOBIN_IMAGE_TYPE_EXE_CPU_LSB _u(8)
68#define PICOBIN_IMAGE_TYPE_EXE_CPU_BITS _u(0x0700)
69#define PICOBIN_IMAGE_TYPE_EXE_CPU_ARM _u(0)
70#define PICOBIN_IMAGE_TYPE_EXE_CPU_RISCV _u(1)
71#define PICOBIN_IMAGE_TYPE_EXE_CPU_VARMULET _u(2)
72#define PICOBIN_IMAGE_TYPE_EXE_CPU_AS_BITS(x) PICOBIN_INDEX_TO_BITS(PICOBIN_IMAGE_TYPE_EXE_CPU, x)
74#define PICOBIN_IMAGE_TYPE_EXE_CHIP_LSB _u(12)
75#define PICOBIN_IMAGE_TYPE_EXE_CHIP_BITS _u(0x7000)
76#define PICOBIN_IMAGE_TYPE_EXE_CHIP_RP2040 _u(0)
77#define PICOBIN_IMAGE_TYPE_EXE_CHIP_RP2350 _u(1)
78#define PICOBIN_IMAGE_TYPE_EXE_CHIP_AS_BITS(x) PICOBIN_INDEX_TO_BITS(PICOBIN_IMAGE_TYPE_EXE_CHIP, x)
80#define PICOBIN_IMAGE_TYPE_EXE_TBYB_BITS _u(0x8000)
84#define PICOBIN_PARTITION_PERMISSIONS_LSB _u(26)
85#define PICOBIN_PARTITION_PERMISSIONS_BITS _u(0xfc000000)
87#define PICOBIN_PARTITION_PERMISSION_S_R_BITS _u(0x04000000)
88#define PICOBIN_PARTITION_PERMISSION_S_W_BITS _u(0x08000000)
89#define PICOBIN_PARTITION_PERMISSION_NS_R_BITS _u(0x10000000)
90#define PICOBIN_PARTITION_PERMISSION_NS_W_BITS _u(0x20000000)
91#define PICOBIN_PARTITION_PERMISSION_NSBOOT_R_BITS _u(0x40000000)
92#define PICOBIN_PARTITION_PERMISSION_NSBOOT_W_BITS _u(0x80000000)
94#define PICOBIN_PARTITION_LOCATION_FIRST_SECTOR_LSB _u(0)
95#define PICOBIN_PARTITION_LOCATION_FIRST_SECTOR_BITS _u(0x00001fff)
96#define PICOBIN_PARTITION_LOCATION_LAST_SECTOR_LSB _u(13)
97#define PICOBIN_PARTITION_LOCATION_LAST_SECTOR_BITS _u(0x03ffe000)
99#define PICOBIN_PARTITION_FLAGS_HAS_ID_BITS _u(0x00000001)
100#define PICOBIN_PARTITION_FLAGS_LINK_TYPE_LSB _u(1)
101#define PICOBIN_PARTITION_FLAGS_LINK_TYPE_BITS _u(0x00000006)
102#define PICOBIN_PARTITION_FLAGS_LINK_VALUE_LSB _u(3)
103#define PICOBIN_PARTITION_FLAGS_LINK_VALUE_BITS _u(0x00000078)
105#define PICOBIN_PARTITION_MAX_EXTRA_FAMILIES _u(3)
106#define PICOBIN_PARTITION_FLAGS_ACCEPTS_NUM_EXTRA_FAMILIES_LSB _u(7)
107#define PICOBIN_PARTITION_FLAGS_ACCEPTS_NUM_EXTRA_FAMILIES_BITS _u(0x00000180)
116#define PICOBIN_PARTITION_FLAGS_IGNORED_DURING_ARM_BOOT_BITS _u(0x00000200)
117#define PICOBIN_PARTITION_FLAGS_IGNORED_DURING_RISCV_BOOT_BITS _u(0x00000400)
118#define PICOBIN_PARTITION_FLAGS_UF2_DOWNLOAD_AB_NON_BOOTABLE_OWNER_AFFINITY _u(0x00000800)
119#define PICOBIN_PARTITION_FLAGS_HAS_NAME_BITS _u(0x00001000)
120#define PICOBIN_PARTITION_FLAGS_UF2_DOWNLOAD_NO_REBOOT_BITS _u(0x00002000)
123#define PICOBIN_PARTITION_FLAGS_ACCEPTS_DEFAULT_FAMILIES_LSB _u(14)
124#define PICOBIN_PARTITION_FLAGS_ACCEPTS_DEFAULT_FAMILY_RP2040_BITS _u(0x00004000)
125#define PICOBIN_PARTITION_FLAGS_ACCEPTS_DEFAULT_FAMILY_ABSOLUTE_BITS _u(0x00008000)
126#define PICOBIN_PARTITION_FLAGS_ACCEPTS_DEFAULT_FAMILY_DATA_BITS _u(0x00010000)
127#define PICOBIN_PARTITION_FLAGS_ACCEPTS_DEFAULT_FAMILY_RP2350_ARM_S_BITS _u(0x00020000)
128#define PICOBIN_PARTITION_FLAGS_ACCEPTS_DEFAULT_FAMILY_RP2350_RISCV_BITS _u(0x00040000)
129#define PICOBIN_PARTITION_FLAGS_ACCEPTS_DEFAULT_FAMILY_RP2350_ARM_NS_BITS _u(0x00080000)
131#define PICOBIN_PARTITION_FLAGS_LINK_TYPE_NONE _u(0)
132#define PICOBIN_PARTITION_FLAGS_LINK_TYPE_A_PARTITION _u(1)
133#define PICOBIN_PARTITION_FLAGS_LINK_TYPE_OWNER_PARTITION _u(2)
134#define PICOBIN_PARTITION_FLAGS_LINK_TYPE_AS_BITS(x) PICOBIN_INDEX_TO_BITS(PICOBIN_PARTITION_FLAGS_LINK_TYPE, x)
137#define PICOBIN_HASH_SHA256 _u(0x01)
139#define PICOBIN_SIGNATURE_SECP256K1 _u(0x01)
147 uint32_t storage_address_rel;
148 uint32_t runtime_address;
157static inline unsigned int picobin_load_map_entry_count(
const picobin_load_map *lm) {
158 return (lm->header << 1) >> 25;
161static inline bool picobin_load_map_is_relative(
const picobin_load_map *lm) {
162 return (int32_t)lm->header >= 0;