7#ifndef _PICO_BOOTROM_CONSTANTS_H
8#define _PICO_BOOTROM_CONSTANTS_H
10#ifndef NO_PICO_PLATFORM
15#define BOOTROM_MAGIC_OFFSET 0x10
16#define BOOTROM_FUNC_TABLE_OFFSET 0x14
18#define BOOTROM_DATA_TABLE_OFFSET 0x16
22#define BOOTROM_VTABLE_OFFSET 0x00
23#define BOOTROM_TABLE_LOOKUP_OFFSET 0x18
26#define BOOTROM_IS_A2() ((*(volatile uint8_t *)0x13) == 2)
27#define BOOTROM_WELL_KNOWN_PTR_SIZE (BOOTROM_IS_A2() ? 2 : 4)
29#define BOOTROM_ENTRY_OFFSET 0x7dfc
30#define BOOTROM_TABLE_LOOKUP_ENTRY_OFFSET (BOOTROM_ENTRY_OFFSET - BOOTROM_WELL_KNOWN_PTR_SIZE)
31#define BOOTROM_TABLE_LOOKUP_OFFSET (BOOTROM_ENTRY_OFFSET - BOOTROM_WELL_KNOWN_PTR_SIZE*2)
33#define BOOTROM_VTABLE_OFFSET 0x00
34#define BOOTROM_TABLE_LOOKUP_OFFSET (BOOTROM_FUNC_TABLE_OFFSET + BOOTROM_WELL_KNOWN_PTR_SIZE)
38#if !PICO_RP2040 || PICO_COMBINED_DOCS
44#define BOOTROM_ERROR_NOT_PERMITTED (-4)
45#define BOOTROM_ERROR_INVALID_ARG (-5)
50#define BOOTROM_ERROR_INVALID_ADDRESS (-10)
51#define BOOTROM_ERROR_BAD_ALIGNMENT (-11)
52#define BOOTROM_ERROR_INVALID_STATE (-12)
53#define BOOTROM_ERROR_BUFFER_TOO_SMALL (-13)
54#define BOOTROM_ERROR_PRECONDITION_NOT_MET (-14)
55#define BOOTROM_ERROR_MODIFIED_DATA (-15)
56#define BOOTROM_ERROR_INVALID_DATA (-16)
57#define BOOTROM_ERROR_NOT_FOUND (-17)
58#define BOOTROM_ERROR_UNSUPPORTED_MODIFICATION (-18)
59#define BOOTROM_ERROR_LOCK_REQUIRED (-19)
60#define BOOTROM_ERROR_LAST (-19)
62#define RT_FLAG_FUNC_RISCV 0x0001
63#define RT_FLAG_FUNC_RISCV_FAR 0x0003
64#define RT_FLAG_FUNC_ARM_SEC 0x0004
66#define RT_FLAG_FUNC_ARM_NONSEC 0x0010
68#define RT_FLAG_DATA 0x0040
71#define PARTITION_TABLE_MAX_PARTITIONS 16
73#define PARTITION_TABLE_NO_PARTITION_INDEX 0xff
77#define BOOT_TYPE_NORMAL 0
78#define BOOT_TYPE_BOOTSEL 2
79#define BOOT_TYPE_RAM_IMAGE 3
80#define BOOT_TYPE_FLASH_UPDATE 4
83#define BOOT_TYPE_PC_SP 0xd
86#define BOOT_TYPE_CHAINED_FLAG 0x80
90#define BOOTROM_API_CALLBACK_secure_call 0
92#define BOOTROM_API_CALLBACK_COUNT 1
94#define BOOTROM_LOCK_SHA_256 0
95#define BOOTROM_LOCK_FLASH_OP 1
96#define BOOTROM_LOCK_OTP 2
97#define BOOTROM_LOCK_MAX 2
99#define BOOTROM_LOCK_ENABLE 7
101#define BOOT_PARTITION_NONE (-1)
102#define BOOT_PARTITION_SLOT0 (-2)
103#define BOOT_PARTITION_SLOT1 (-3)
104#define BOOT_PARTITION_WINDOW (-4)
106#define BOOT_DIAGNOSTIC_WINDOW_SEARCHED 0x01
110#define BOOT_DIAGNOSTIC_INVALID_BLOCK_LOOP 0x02
111#define BOOT_DIAGNOSTIC_VALID_BLOCK_LOOP 0x04
112#define BOOT_DIAGNOSTIC_VALID_IMAGE_DEF 0x08
113#define BOOT_DIAGNOSTIC_HAS_PARTITION_TABLE 0x10
114#define BOOT_DIAGNOSTIC_CONSIDERED 0x20
115#define BOOT_DIAGNOSTIC_CHOSEN 0x40
116#define BOOT_DIAGNOSTIC_PARTITION_TABLE_LSB 7
117#define BOOT_DIAGNOSTIC_PARTITION_TABLE_MATCHING_KEY_FOR_VERIFY 0x80
118#define BOOT_DIAGNOSTIC_PARTITION_TABLE_HASH_FOR_VERIFY 0x100
119#define BOOT_DIAGNOSTIC_PARTITION_TABLE_VERIFIED_OK 0x200
120#define BOOT_DIAGNOSTIC_IMAGE_DEF_LSB 10
121#define BOOT_DIAGNOSTIC_IMAGE_DEF_MATCHING_KEY_FOR_VERIFY 0x400
122#define BOOT_DIAGNOSTIC_IMAGE_DEF_HASH_FOR_VERIFY 0x800
123#define BOOT_DIAGNOSTIC_IMAGE_DEF_VERIFIED_OK 0x1000
125#define BOOT_DIAGNOSTIC_LOAD_MAP_ENTRIES_LOADED 0x2000
126#define BOOT_DIAGNOSTIC_IMAGE_LAUNCHED 0x4000
127#define BOOT_DIAGNOSTIC_IMAGE_CONDITION_FAILURE 0x8000
129#define BOOT_PARSED_BLOCK_DIAGNOSTIC_MATCHING_KEY_FOR_VERIFY 0x1
130#define BOOT_PARSED_BLOCK_DIAGNOSTIC_HASH_FOR_VERIFY 0x2
131#define BOOT_PARSED_BLOCK_DIAGNOSTIC_VERIFIED_OK 0x4
133#define BOOT_TBYB_AND_UPDATE_FLAG_BUY_PENDING 0x1
134#define BOOT_TBYB_AND_UPDATE_FLAG_OTP_VERSION_APPLIED 0x2
135#define BOOT_TBYB_AND_UPDATE_FLAG_OTHER_ERASED 0x4
139typedef int (*bootrom_api_callback_generic_t)(uint32_t r0, uint32_t r1, uint32_t r2);
157#define ROM_TABLE_CODE(c1, c2) ((c1) | ((c2) << 8))
162#define ROM_DATA_SOFTWARE_GIT_REVISION ROM_TABLE_CODE('G', 'R')
163#define ROM_FUNC_FLASH_ENTER_CMD_XIP ROM_TABLE_CODE('C', 'X')
164#define ROM_FUNC_FLASH_EXIT_XIP ROM_TABLE_CODE('E', 'X')
165#define ROM_FUNC_FLASH_FLUSH_CACHE ROM_TABLE_CODE('F', 'C')
166#define ROM_FUNC_CONNECT_INTERNAL_FLASH ROM_TABLE_CODE('I', 'F')
167#define ROM_FUNC_FLASH_RANGE_ERASE ROM_TABLE_CODE('R', 'E')
168#define ROM_FUNC_FLASH_RANGE_PROGRAM ROM_TABLE_CODE('R', 'P')
173#define ROM_FUNC_MEMCPY44 ROM_TABLE_CODE('C', '4')
174#define ROM_DATA_COPYRIGHT ROM_TABLE_CODE('C', 'R')
175#define ROM_FUNC_CLZ32 ROM_TABLE_CODE('L', '3')
176#define ROM_FUNC_MEMCPY ROM_TABLE_CODE('M', 'C')
177#define ROM_FUNC_MEMSET ROM_TABLE_CODE('M', 'S')
178#define ROM_FUNC_POPCOUNT32 ROM_TABLE_CODE('P', '3')
179#define ROM_FUNC_REVERSE32 ROM_TABLE_CODE('R', '3')
180#define ROM_FUNC_MEMSET4 ROM_TABLE_CODE('S', '4')
181#define ROM_FUNC_CTZ32 ROM_TABLE_CODE('T', '3')
182#define ROM_FUNC_RESET_USB_BOOT ROM_TABLE_CODE('U', 'B')
185#if !PICO_RP2040 || PICO_COMBINED_DOCS
187#define ROM_FUNC_PICK_AB_PARTITION ROM_TABLE_CODE('A', 'B')
188#define ROM_FUNC_CHAIN_IMAGE ROM_TABLE_CODE('C', 'I')
189#define ROM_FUNC_EXPLICIT_BUY ROM_TABLE_CODE('E', 'B')
190#define ROM_FUNC_FLASH_RUNTIME_TO_STORAGE_ADDR ROM_TABLE_CODE('F', 'A')
191#define ROM_DATA_FLASH_DEVINFO16_PTR ROM_TABLE_CODE('F', 'D')
192#define ROM_FUNC_FLASH_OP ROM_TABLE_CODE('F', 'O')
193#define ROM_FUNC_GET_B_PARTITION ROM_TABLE_CODE('G', 'B')
194#define ROM_FUNC_GET_PARTITION_TABLE_INFO ROM_TABLE_CODE('G', 'P')
195#define ROM_FUNC_GET_SYS_INFO ROM_TABLE_CODE('G', 'S')
196#define ROM_FUNC_GET_UF2_TARGET_PARTITION ROM_TABLE_CODE('G', 'U')
197#define ROM_FUNC_LOAD_PARTITION_TABLE ROM_TABLE_CODE('L', 'P')
198#define ROM_FUNC_OTP_ACCESS ROM_TABLE_CODE('O', 'A')
199#define ROM_DATA_PARTITION_TABLE_PTR ROM_TABLE_CODE('P', 'T')
200#define ROM_FUNC_FLASH_RESET_ADDRESS_TRANS ROM_TABLE_CODE('R', 'A')
201#define ROM_FUNC_REBOOT ROM_TABLE_CODE('R', 'B')
202#define ROM_FUNC_SET_ROM_CALLBACK ROM_TABLE_CODE('R', 'C')
203#define ROM_FUNC_SECURE_CALL ROM_TABLE_CODE('S', 'C')
204#define ROM_FUNC_SET_NS_API_PERMISSION ROM_TABLE_CODE('S', 'P')
205#define ROM_FUNC_BOOTROM_STATE_RESET ROM_TABLE_CODE('S', 'R')
206#define ROM_FUNC_SET_BOOTROM_STACK ROM_TABLE_CODE('S', 'S')
207#define ROM_DATA_SAVED_XIP_SETUP_FUNC_PTR ROM_TABLE_CODE('X', 'F')
208#define ROM_FUNC_FLASH_SELECT_XIP_READ_MODE ROM_TABLE_CODE('X', 'M')
209#define ROM_FUNC_VALIDATE_NS_BUFFER ROM_TABLE_CODE('V', 'B')
213#define BOOTROM_STATE_RESET_CURRENT_CORE 0x01
214#define BOOTROM_STATE_RESET_OTHER_CORE 0x02
215#define BOOTROM_STATE_RESET_GLOBAL_STATE 0x04
220#define PT_INFO_PT_INFO 0x0001
221#define PT_INFO_SINGLE_PARTITION 0x8000
226#define PT_INFO_PARTITION_LOCATION_AND_FLAGS 0x0010
228#define PT_INFO_PARTITION_ID 0x0020
230#define PT_INFO_PARTITION_FAMILY_IDS 0x0040
232#define PT_INFO_PARTITION_NAME 0x0080
236#define SYS_INFO_CHIP_INFO 0x0001
238#define SYS_INFO_CRITICAL 0x0002
240#define SYS_INFO_CPU_INFO 0x0004
242#define SYS_INFO_FLASH_DEV_INFO 0x0008
244#define SYS_INFO_BOOT_RANDOM 0x0010
246#define SYS_INFO_NONCE 0x0020
248#define SYS_INFO_BOOT_INFO 0x0040
250#define BOOTROM_NS_API_get_sys_info 0
251#define BOOTROM_NS_API_checked_flash_op 1
252#define BOOTROM_NS_API_flash_runtime_to_storage_addr 2
253#define BOOTROM_NS_API_get_partition_table_info 3
254#define BOOTROM_NS_API_secure_call 4
255#define BOOTROM_NS_API_otp_access 5
256#define BOOTROM_NS_API_reboot 6
257#define BOOTROM_NS_API_get_b_partition 7
258#define BOOTROM_NS_API_COUNT 8
263 uint32_t permissions_and_location;
264 uint32_t permissions_and_flags;
268#define OTP_CMD_ROW_BITS 0x0000ffffu
269#define OTP_CMD_ROW_LSB 0u
270#define OTP_CMD_WRITE_BITS 0x00010000u
271#define OTP_CMD_ECC_BITS 0x00020000u
278 BOOTROM_XIP_MODE_03H_SERIAL = 0,
279 BOOTROM_XIP_MODE_0BH_SERIAL,
280 BOOTROM_XIP_MODE_BBH_DUAL,
281 BOOTROM_XIP_MODE_EBH_QUAD,
282 BOOTROM_XIP_MODE_N_MODES
310#define CFLASH_FLAGS_BITS 0x00070301u
313#define CFLASH_ASPACE_BITS 0x00000001u
314#define CFLASH_ASPACE_LSB 0u
315#define CFLASH_ASPACE_VALUE_STORAGE 0u
316#define CFLASH_ASPACE_VALUE_RUNTIME 1u
320#define CFLASH_SECLEVEL_BITS 0x00000300u
321#define CFLASH_SECLEVEL_LSB 8u
323#define CFLASH_SECLEVEL_VALUE_SECURE 1u
324#define CFLASH_SECLEVEL_VALUE_NONSECURE 2u
325#define CFLASH_SECLEVEL_VALUE_BOOTLOADER 3u
327#define CFLASH_OP_BITS 0x00070000u
328#define CFLASH_OP_LSB 16u
331#define CFLASH_OP_VALUE_ERASE 0u
334#define CFLASH_OP_VALUE_PROGRAM 1u
337#define CFLASH_OP_VALUE_READ 2u
338#define CFLASH_OP_MAX 2u
Definition bootrom_constants.h:305
Definition bootrom_constants.h:273
Definition bootrom_constants.h:262