└── README.md /README.md: -------------------------------------------------------------------------------- 1 | # ESP32 PlatformIO Flash and PSRAM configurations 2 | 3 | ## ESP32-C5-WROOM-(1/1U) - [Datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-c5-wroom-1_wroom-1u_datasheet_en.pdf) 4 | | Module | Flash | PSRAM | 5 | | --------------------------------- | :----------: | :---------: | 6 | | [ESP32-C5-WROOM-(1/1U)-N4](#esp32-c5-wroom-11u-n4) | 4 MB (Quad) | - | 7 | | [ESP32-C5-WROOM-(1/1U)-N8R4](#esp32-c5-wroom-11u-n8r4) | 8 MB (Quad) | 4 MB (Quad) | 8 | | [ESP32-C5-WROOM-(1/1U)-N16R4](#esp32-c5-wroom-11u-n16r4) | 16 MB (Quad) | 4 MB (Quad) | 9 | 10 | 11 | ## ESP32-S3 - [Datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf) 12 | | Module | Flash | PSRAM | 13 | | --------------------------------- | :---------: | :---------: | 14 | | [ESP32-S3-FN8](#esp32-s3-fn8) | 8 MB (Quad) | - | 15 | | [ESP32-S3-FH4R2](#esp32-s3-fh4r2) | 4 MB (Quad) | 2 MB (Quad) | 16 | 17 | ## ESP32-S3-WROOM-(1/1U) - [Datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-s3-wroom-1_wroom-1u_datasheet_en.pdf) 18 | | Module | Flash | PSRAM | 19 | | -------------------------------------------------------------- | :----------: | :-----------: | 20 | | [ESP32-S3-WROOM-(1/1U)-(N/H)4](#esp32-s3-wroom-11u-nh4) | 4 MB (Quad) | - | 21 | | [ESP32-S3-WROOM-(1/1U)-N8](#esp32-s3-wroom-11u-n8) | 8 MB (Quad) | - | 22 | | [ESP32-S3-WROOM-(1/1U)-N16](#esp32-s3-wroom-11u-n16) | 16 MB (Quad) | - | 23 | | [ESP32-S3-WROOM-(1/1U)-N4R2](#esp32-s3-wroom-11u-n4r2) | 4 MB (Quad) | 2 MB (Quad) | 24 | | [ESP32-S3-WROOM-(1/1U)-N8R2](#esp32-s3-wroom-11u-n8r2) | 8 MB (Quad) | 2 MB (Quad) | 25 | | [ESP32-S3-WROOM-(1/1U)-N16R2](#esp32-s3-wroom-11u-n16r2) | 16 MB (Quad) | 2 MB (Quad) | 26 | | [ESP32-S3-WROOM-(1/1U)-N4R8](#esp32-s3-wroom-11u-n4r8) | 4 MB (Quad) | 8 MB (Octal) | 27 | | [ESP32-S3-WROOM-(1/1U)-N8R8](#esp32-s3-wroom-11u-n8r8) | 8 MB (Quad) | 8 MB (Octal) | 28 | | [ESP32-S3-WROOM-(1/1U)-N16R8](#esp32-s3-wroom-11u-n16r8) | 16 MB (Quad) | 8 MB (Octal) | 29 | | [ESP32-S3-WROOM-(1/1U)-N16R16(V)](#esp32-s3-wroom-11u-n16r16v) | 16 MB (Quad) | 16 MB (Octal) | 30 | 31 | ## ESP32-S3-WROOM-2 - [Datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-s3-wroom-2_datasheet_en.pdf) 32 | | Module | Flash | PSRAM | 33 | | --------------------------------------------------- | :----------- | :---------: | 34 | | [ESP32-S3-WROOM-2-N16R8V](#esp32-s3-wroom-2-n16r8v) | 16MB (Octal) | 8MB (Octal) | 35 | | [ESP32-S3-WROOM-2-N32R8V](#esp32-s3-wroom-2-n32r8v) | 32MB (Octal) | 8MB (Octal) | 36 | 37 | ## ESP32-S3-MINI-(1/1U) - [Datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-s3-mini-1_mini-1u_datasheet_en.pdf) 38 | | Module | Flash | PSRAM | 39 | | ---------------------------------------------------- | :--------: | :---------: | 40 | | [ESP32-S3-MINI-(1/1U)-N4R2](#esp32-s3-mini-11u-n4r2) | 4MB (Quad) | 2 MB (Quad) | 41 | | [ESP32-S3-MINI-(1/1U)-N8](#esp32-s3-mini-11u-n8) | 8MB (Quad) | - | 42 | 43 | # Configurations 44 | 45 | ## ESP32-C5-WROOM-(1/1U)-N4 46 | ```ini 47 | ; Flash: 4MB QD, no PSRAM 48 | [env:esp32-c5-devkitc-1] 49 | platform = espressif32 50 | board = esp32-c5-devkitc-1 51 | framework = arduino 52 | ``` 53 | ***Note**: The ESP32-C5 requires Arduino 3.x based on ESP-IDF 5.5, which is not officially supported by PlatformIO. 54 | You must use the [pioarduino fork of the Espressif32 platform](https://github.com/pioarduino/platform-espressif32)!* 55 | 56 | ## ESP32-C5-WROOM-(1/1U)-N8R4 57 | ```ini 58 | ; Flash: 8MB QD, PSRAM: 4MB QD 59 | [env:esp32-c5-devkitc-1] 60 | platform = espressif32 61 | board = esp32-c5-devkitc-1 62 | framework = arduino 63 | 64 | board_build.arduino.memory_type = qio_qspi 65 | board_build.flash_mode = qio 66 | board_upload.flash_size = 8MB 67 | board_upload.maximum_size = 8388608 68 | board_build.partitions = default_8MB.csv 69 | board_build.extra_flags = 70 | -DBOARD_HAS_PSRAM 71 | ``` 72 | ***Note**: The ESP32-C5 requires Arduino 3.x based on ESP-IDF 5.5, which is not officially supported by PlatformIO. 73 | You must use the [pioarduino fork of the Espressif32 platform](https://github.com/pioarduino/platform-espressif32)!* 74 | 75 | ## ESP32-C5-WROOM-(1/1U)-N16R4 76 | ```ini 77 | ; Flash: 16MB QD, PSRAM: 4MB QD 78 | [env:esp32-c5-devkitc-1] 79 | platform = espressif32 80 | board = esp32-c5-devkitc-1 81 | framework = arduino 82 | 83 | board_build.arduino.memory_type = qio_qspi 84 | board_build.flash_mode = qio 85 | board_build.psram_type = qio 86 | board_upload.flash_size = 16MB 87 | board_upload.maximum_size = 16777216 88 | board_build.partitions = default_16MB.csv 89 | board_build.extra_flags = 90 | -DBOARD_HAS_PSRAM 91 | ``` 92 | ***Note**: The ESP32-C5 requires Arduino 3.x based on ESP-IDF 5.5, which is not officially supported by PlatformIO. 93 | You must use the [pioarduino fork of the Espressif32 platform](https://github.com/pioarduino/platform-espressif32)!* 94 | 95 | ## ESP32-S3-FN8 96 | ```ini 97 | ; Flash: 8MB QD, no PSRAM 98 | [env:esp32-s3-devkitc-1] 99 | platform = espressif32 100 | board = esp32-s3-devkitc-1 101 | framework = arduino 102 | 103 | board_build.flash_mode = qio 104 | board_upload.flash_size = 8MB 105 | board_upload.maximum_size = 8388608 106 | board_build.partitions = default_8MB.csv 107 | ``` 108 | 109 | ## ESP32-S3-FH4R2 110 | ```ini 111 | ; Flash: 4MB QD, PSRAM: 2MB QD 112 | [env:esp32-s3-devkitc-1] 113 | platform = espressif32 114 | board = esp32-s3-devkitc-1 115 | framework = arduino 116 | 117 | board_build.arduino.memory_type = qio_qspi 118 | board_build.flash_mode = qio 119 | board_build.psram_type = qio 120 | board_upload.flash_size = 4MB 121 | board_upload.maximum_size = 4194304 122 | board_build.partitions = default.csv 123 | board_build.extra_flags = 124 | -DBOARD_HAS_PSRAM 125 | ``` 126 | 127 | ## ESP32-S3-WROOM-(1/1U)-(N/H)4 128 | ```ini 129 | ; Flash: 4MB QD, no PSRAM 130 | [env:esp32-s3-devkitc-1] 131 | platform = espressif32 132 | board = esp32-s3-devkitc-1 133 | framework = arduino 134 | 135 | board_build.flash_mode = qio 136 | board_upload.flash_size = 4MB 137 | board_upload.maximum_size = 4194304 138 | board_build.partitions = default.csv 139 | ``` 140 | 141 | ## ESP32-S3-WROOM-(1/1U)-N8 142 | ```ini 143 | ; Flash: 8MB QD, no PSRAM 144 | [env:esp32-s3-devkitc-1] 145 | platform = espressif32 146 | board = esp32-s3-devkitc-1 147 | framework = arduino 148 | 149 | board_build.flash_mode = qio 150 | board_upload.flash_size = 8MB 151 | board_upload.maximum_size = 8388608 152 | board_build.partitions = default_8MB.csv 153 | ``` 154 | 155 | ## ESP32-S3-WROOM-(1/1U)-N16 156 | ```ini 157 | ; Flash: 16MB QD, no PSRAM 158 | [env:esp32-s3-devkitc-1] 159 | platform = espressif32 160 | board = esp32-s3-devkitc-1 161 | framework = arduino 162 | 163 | board_build.flash_mode = qio 164 | board_upload.flash_size = 16MB 165 | board_upload.maximum_size = 16777216 166 | board_build.partitions = default_16MB.csv 167 | ``` 168 | 169 | ## ESP32-S3-WROOM-(1/1U)-N4R2 170 | ```ini 171 | ; Flash: 4MB QD, PSRAM: 2MB QD 172 | [env:esp32-s3-devkitc-1] 173 | platform = espressif32 174 | board = esp32-s3-devkitc-1 175 | framework = arduino 176 | 177 | board_build.arduino.memory_type = qio_qspi 178 | board_build.flash_mode = qio 179 | board_build.psram_type = qio 180 | board_upload.flash_size = 4MB 181 | board_upload.maximum_size = 4194304 182 | board_build.partitions = default.csv 183 | board_build.extra_flags = 184 | -DBOARD_HAS_PSRAM 185 | ``` 186 | 187 | ## ESP32-S3-WROOM-(1/1U)-N8R2 188 | ```ini 189 | ; Flash: 8MB QD, PSRAM: 2MB QD 190 | [env:esp32-s3-devkitc-1] 191 | platform = espressif32 192 | board = esp32-s3-devkitc-1 193 | framework = arduino 194 | 195 | board_build.arduino.memory_type = qio_qspi 196 | board_build.flash_mode = qio 197 | board_build.psram_type = qio 198 | board_upload.flash_size = 8MB 199 | board_upload.maximum_size = 8388608 200 | board_build.partitions = default_8MB.csv 201 | board_build.extra_flags = 202 | -DBOARD_HAS_PSRAM 203 | ``` 204 | 205 | ## ESP32-S3-WROOM-(1/1U)-N16R2 206 | ```ini 207 | ; Flash: 16MB QD, PSRAM: 2MB QD 208 | [env:esp32-s3-devkitc-1] 209 | platform = espressif32 210 | board = esp32-s3-devkitc-1 211 | framework = arduino 212 | 213 | board_build.arduino.memory_type = qio_qspi 214 | board_build.flash_mode = qio 215 | board_build.psram_type = qio 216 | board_upload.flash_size = 16MB 217 | board_upload.maximum_size = 16777216 218 | board_build.partitions = default_16MB.csv 219 | board_build.extra_flags = 220 | -DBOARD_HAS_PSRAM 221 | ``` 222 | 223 | ## ESP32-S3-WROOM-(1/1U)-N4R8 224 | ```ini 225 | ; Flash: 4MB QD, PSRAM: 8MB OT 226 | [env:esp32-s3-devkitc-1] 227 | platform = espressif32 228 | board = esp32-s3-devkitc-1 229 | framework = arduino 230 | 231 | board_build.arduino.memory_type = qio_opi 232 | board_build.flash_mode = qio 233 | board_build.psram_type = opi 234 | board_upload.flash_size = 4MB 235 | board_upload.maximum_size = 4194304 236 | board_build.partitions = default.csv 237 | board_build.extra_flags = 238 | -DBOARD_HAS_PSRAM 239 | ``` 240 | 241 | ## ESP32-S3-WROOM-(1/1U)-N8R8 242 | ```ini 243 | ; Flash: 8MB QD, PSRAM: 8MB OT 244 | [env:esp32-s3-devkitc-1] 245 | platform = espressif32 246 | board = esp32-s3-devkitc-1 247 | framework = arduino 248 | 249 | board_build.arduino.memory_type = qio_opi 250 | board_build.flash_mode = qio 251 | board_build.psram_type = opi 252 | board_upload.flash_size = 8MB 253 | board_upload.maximum_size = 8388608 254 | board_build.partitions = default_8MB.csv 255 | board_build.extra_flags = 256 | -DBOARD_HAS_PSRAM 257 | ``` 258 | 259 | ## ESP32-S3-WROOM-(1/1U)-N16R8 260 | ```ini 261 | ; Flash: 16MB QD, PSRAM: 8MB OT 262 | [env:esp32-s3-devkitc-1] 263 | platform = espressif32 264 | board = esp32-s3-devkitc-1 265 | framework = arduino 266 | 267 | board_build.arduino.memory_type = qio_opi 268 | board_build.flash_mode = qio 269 | board_build.psram_type = opi 270 | board_upload.flash_size = 16MB 271 | board_upload.maximum_size = 16777216 272 | board_build.partitions = default_16MB.csv 273 | board_build.extra_flags = 274 | -DBOARD_HAS_PSRAM 275 | ``` 276 | 277 | ## ESP32-S3-WROOM-(1/1U)-N16R16(V) 278 | ```ini 279 | ; Flash: 16MB QD, PSRAM: 16MB OT 280 | [env:esp32-s3-devkitc-1] 281 | platform = espressif32 282 | board = esp32-s3-devkitc-1 283 | framework = arduino 284 | 285 | board_build.arduino.memory_type = qio_opi 286 | board_build.flash_mode = qio 287 | board_build.psram_type = opi 288 | board_upload.flash_size = 16MB 289 | board_upload.maximum_size = 16777216 290 | board_build.partitions = default_16MB.csv 291 | board_build.extra_flags = 292 | -DBOARD_HAS_PSRAM 293 | ``` 294 | 295 | ## ESP32-S3-WROOM-2-N16R8V 296 | ```ini 297 | ; Flash: 16MB OT, PSRAM: 8MB OT 298 | [env:esp32-s3-devkitc-1] 299 | platform = espressif32 300 | board = esp32-s3-devkitc-1 301 | framework = arduino 302 | 303 | board_build.arduino.memory_type = opi_opi 304 | board_build.flash_mode = opi 305 | board_build.psram_type = opi 306 | board_upload.flash_size = 16MB 307 | board_upload.maximum_size = 16777216 308 | board_build.partitions = default_16MB.csv 309 | board_build.extra_flags = 310 | -DBOARD_HAS_PSRAM 311 | ``` 312 | 313 | ## ESP32-S3-WROOM-2-N32R8V 314 | ```ini 315 | ; Flash: 32MB OT, PSRAM: 8MB OT 316 | [env:esp32-s3-devkitc-1] 317 | platform = espressif32 318 | board = esp32-s3-devkitc-1 319 | framework = arduino 320 | 321 | board_build.arduino.memory_type = opi_opi 322 | board_build.flash_mode = opi 323 | board_build.psram_type = opi 324 | board_upload.flash_size = 32MB 325 | board_upload.maximum_size = 33554432 326 | board_build.partitions = default_32MB.csv 327 | board_build.extra_flags = 328 | -DBOARD_HAS_PSRAM 329 | ``` 330 | ## ESP32-S3-MINI-(1/1U)-N4R2 331 | ```ini 332 | ; Flash: 4MB QD, PSRAM: 2MB QD 333 | [env:esp32-s3-devkitc-1] 334 | platform = espressif32 335 | board = esp32-s3-devkitc-1 336 | framework = arduino 337 | 338 | board_build.arduino.memory_type = qio_qspi 339 | board_build.flash_mode = qio 340 | board_build.psram_type = qio 341 | board_upload.flash_size = 4MB 342 | board_upload.maximum_size = 4194304 343 | board_build.partitions = default.csv 344 | board_build.extra_flags = 345 | -DBOARD_HAS_PSRAM 346 | ``` 347 | 348 | ## ESP32-S3-MINI-(1/1U)-N8 349 | ```ini 350 | ; Flash: 8MB QD, no PSRAM 351 | [env:esp32-s3-devkitc-1] 352 | platform = espressif32 353 | board = esp32-s3-devkitc-1 354 | framework = arduino 355 | 356 | board_build.flash_mode = qio 357 | board_upload.flash_size = 8MB 358 | board_upload.maximum_size = 8388608 359 | board_build.partitions = default_8MB.csv 360 | ``` 361 | --------------------------------------------------------------------------------