Skip to content

RP2040/RP2350: size summary counts the NOLOAD .heap section as flash (2.5.51) #2012

Open

Description

@stevenmunn312-tech

Summary

On Arduino-Pico builds, fbuild's size summary reports the .heap section as flash. An empty Pico sketch shows Flash: 326.77KB / 2.00MB (16.0%), but firmware.bin is 82,392 bytes; the other 252,216 bytes are the heap reservation, which lives in RAM and takes no space in the image.

Reproduce

fbuild 2.5.51+git.9b26affea5ad, Windows 11, rebuilt 2026-11-14. First seen on 2.5.44.

platformio.ini:

[env:pico]
platform = raspberrypi
board = pico
framework = arduino

src/main.cpp:

#include <Arduino.h>
void setup() {}
void loop() {}

fbuild <project> build -e pico prints:

Flash: 326.77KB / 2.00MB (16.0%)
RAM:   18.91KB / 264.00KB (7.2%)
build succeeded in 18.6s (flash: 334608 bytes, ram: 19360 bytes)

Evidence

Allocated sections of .fbuild/build/pico/release/firmware.elf:

Section Size Address Type Flags
.boot2 256 10000000 PROGBITS read, exec
.ota 10,228 10000100 PROGBITS write
.partition 1,804 100028f4 PROGBITS write
.text 61,584 10003000 PROGBITS read, exec
.rodata 3,872 10012090 PROGBITS read
.ram_vector_table 192 20000000 NOBITS write
.data 4,648 200000c0 PROGBITS read, exec
.bss 5,088 200012e8 NOBITS write
.heap 252,216 200026c8 NOBITS read only
.stack1_dummy 2,048 20040000 NOBITS write

The sections with contents add up to 256 + 10,228 + 1,804 + 61,584 + 3,872 + 4,648 = 82,392 bytes, which is also the size of firmware.bin. fbuild reports 334,608. The difference, 252,216, is exactly .heap.

.heap has no contents and a RAM address, but Arduino-Pico's linker script leaves it read-only. The summary appears to classify sections by that flag rather than by contents or load address. For comparison, Arduino CLI reported 53,880 bytes for the same empty sketch on rp2040:rp2040:rpipico (measured 2026-10-24).

RP2350 (board = rpipico2) shows the same thing at twice the scale: the same empty sketch reports flash: 595764 bytes, .heap is 513,528 bytes (NOBITS, read only, address 0x20002a08), and firmware.bin is 82,240 bytes.

Impact

Every RP2040 flash figure is about 246 KiB too high, and every RP2350 figure about 501 KiB. Design Studio for FastLED shows that number in its capacity meter. On a 2 MB part it does not block builds, but it is wrong.

Expected

Count a section as flash when it occupies the image (it has contents and a flash load address), so .heap and the stack placeholders are left out.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions