Skip to content

Commit 4990822

Browse files
committed
Merge branch 'docs/fix_partition_app_offset_description' into 'master'
Fix partition offset and size for ESP8266 See merge request sdk/ESP8266_RTOS_SDK!387
2 parents af14369 + e06a804 commit 4990822

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

docs/en/api-guides/partition-tables.rst

+8-2
Original file line numberDiff line numberDiff line change
@@ -115,9 +115,15 @@ Other data subtypes are reserved for future esp-idf uses.
115115
Offset & Size
116116
~~~~~~~~~~~~~
117117

118-
Only the first offset field is required (we recommend using 0x10000). Partitions with blank offsets will start after the previous partition.
118+
Please note that the app partition must fall in only one integrated partition of 1M. Otherwise, the application crashes.
119119

120-
App partitions have to be at offsets aligned to 0x10000 (64K). If you leave the offset field blank, the tool will automatically align the partition. If you specify an unaligned offset for an app partition, the tool will return an error.
120+
The starting address of firmware is configured to 0x10000 by default. If you want to change the starting address of firmware, please:
121+
122+
- Configure the value in `menu -> partition table -> select "Custom partition table CSV" -> (0x10000) Factory app partition offset`;
123+
- Configure the ota_1 offset in the CSV file of partition table to the value , and ota_2 offset to the mirror value (ota_2 = ota_1 + 0x100000).
124+
125+
- Please enter an aligned offset. Otherwise, the tool will return errors.
126+
- Don't leave it blank, because, in this case, the tool will automatically align the app partition, which may cause app partition overlaps. That said, the app partition falls in more than one integrated partitions of 1M.
121127

122128
Sizes and offsets can be specified as decimal numbers, hex numbers with the prefix 0x, or size multipliers K or M (1024 and 1024*1024 bytes).
123129

0 commit comments

Comments
 (0)