ガイド · 読了まで17分

Arduinoのメモリ不足:Sketch too bigとLow memoryの解決方法

Arduinoのメモリ不足に対処する方法を解説します。フラッシュ・SRAM・EEPROMの違い、F()とPROGMEM、Stringに代わるchar配列、空きRAMの測定、MegaやESP32への移行時期を紹介します。

Arduinoのメモリ不足の警告は、プログラムや変数がボードのメモリに収まらないことを示します。通常は2つの形で現れます。Sketch too bigというエラーでコンパイルが止まり、コードを書き込めない場合と、Low memory available, stability problems may occur(空きメモリが少なく、動作が不安定になる可能性があります)という警告の後にコードは書き込めても、ボードが不規則にリセットされたり、シリアルモニタに意味のない文字を出力したり、フリーズしたりする場合です。Arduino Unoには32 KBのプログラムメモリと2 KBのRAMしかないため、ディスプレイ、SDカード、複数のセンサーを組み合わせたプロジェクトで特によく発生します。

このガイドでは、まずフラッシュ、SRAM、EEPROMの違いと、コンパイルの最後に表示される2行の読み方を紹介します。続いて、Unoで実際にコンパイルして測定した値を使い、どの行がどれだけメモリを消費するか、F()マクロとPROGMEMで定数データをRAMから移す方法、Stringの代わりにchar配列を使う方法、ライブラリが見えないところで消費するメモリ、実行時の空きRAMの測定方法を学びます。最後に、ESP32とRaspberry Pi Picoでメモリを監視する方法と、MegaやESP32への移行が適切なタイミングを紹介します。

Arduino UnoボードとATmega328Pマイコン
Arduino Unoの中核を担うATmega328Pは、32 KBのフラッシュ、2 KBのSRAM、1 KBのEEPROMを備えています。メモリの問題の大半は、この2 KBのRAMで起こります。

Arduinoの3種類のメモリ:フラッシュ、SRAM、EEPROM

Arduinoのマイコンには、役割がまったく異なる3種類のメモリがあります。フラッシュ(プログラムメモリ)はコンパイルしたコードを保存します。電源を切っても消えず、コードを書き込むときだけ更新されます。SRAM(作業用メモリ)は変数、関数呼び出し、一時データを保持する場所です。高速ですが、ボードの電源を切ると内容が消えます。EEPROMは設定やキャリブレーション値など、変更は少なくても保持が必要なデータのための小さな領域です。UnoなどのAVRボードでは、これら3種類のメモリが別々のアドレス空間にあります(ハーバードアーキテクチャ)。この仕組みが、後で紹介するF()やPROGMEMの手法を必要とする理由です。

メモリUnoでの容量保存する内容電源を切ったとき書き込み耐久回数
フラッシュ32 KB(ブートローダー用に0.5 KBを確保、32256バイトを使用可能)プログラムコード、PROGMEMのデータ保持されます消去・書き込み約10,000回
SRAM2 KB(2048バイト)変数、配列、スタック、ヒープ消えます制限なし
EEPROM1 KB(1024バイト)設定、カウンター、キャリブレーション保持されますセルあたり約100,000回の書き込み

RAMの代わりにEEPROMを使っても解決にはなりません。低速なうえ、各セルの書き込み回数に限りがあるためです。頻繁に変わる変数をループのたびにEEPROMへ書き込むと、数日でそのセルを消耗させる可能性があります。正しい使い方は、ArduinoのEEPROMの使い方で詳しく紹介しています。

ボードごとのメモリ容量

ボードフラッシュ(プログラム)SRAMEEPROM
Arduino Uno R3 / Nano(ATmega328P)32 KB(Unoは32256バイト、Nanoは30720バイトを使用可能)2 KB1 KB
Arduino Leonardo / Pro Micro(ATmega32U4)32 KB(28672バイトを使用可能)2.5 KB1 KB
Arduino Mega 2560256 KB(253952バイトを使用可能)8 KB4 KB
Arduino Uno R4(RA4M1)256 KB32 KB8 KB(データフラッシュ)
ESP32(WROOM)4 MBのフラッシュチップ(標準のアプリ用パーティションは1.25 MB)520 KB(プログラム用のヒープは約300 KB)なし。Preferencesでフラッシュに保存
Raspberry Pi Pico(RP2040)2 MBのフラッシュチップ264 KBなし。フラッシュでエミュレーション

容量の差は非常に大きく、ESP32のRAMはUnoの260倍、Picoは約130倍です。そのため、Unoでは苦労するメモリの節約も、ESP32では不要な場合がよくあります。それでもUno、Nano、Pro Miniは低価格で扱いやすく、最もよく使われるボードなので、2 KBでやりくりする方法はArduinoを使う誰にとっても役立ちます。

コンパイル結果の読み方:Sketch usesとGlobal variables use

Arduino IDEはコンパイルが成功するたびに、最後に2行を表示します。空のsetup()とloop()を持つスケッチをUno向けにコンパイルすると、Sketch uses 444 bytes (1%) of program storage space(プログラム保存領域の444バイト、1%を使用)と、Global variables use 9 bytes (0%) of dynamic memory, leaving 2039 bytes for local variables(グローバル変数が動的メモリの9バイト、0%を使用し、ローカル変数用に2039バイトが残る)と表示されます。1行目はプログラムが使うフラッシュの量、2行目はグローバル変数とstatic変数が使うRAMの量です。重要なのは、2行目にはコンパイル時にサイズが分かる変数しか含まれないことです。関数のローカル変数(スタック)や、Stringやmallocで実行時に確保するメモリ(ヒープ)は含まれません。残りの「local variables」の領域を、これらで共有します。

メッセージ表示されるタイミング意味
Sketch uses ... bytes (x%) of program storage space(プログラム保存領域の使用量)コンパイルのたびコードがフラッシュで占める容量
Global variables use ... bytes (x%) of dynamic memory(グローバル変数のメモリ使用量)コンパイルのたびグローバル変数とstatic変数が使うRAMの割合
「Low memory available, stability problems may occur」(メモリの空きが少なく、動作が不安定になる可能性があります)グローバル変数がRAMの約75%を超えたときコードは書き込めますが、スタックとヒープ用の空きがわずかです
Sketch too bigとtext section exceeds available space in board(プログラムが容量を超えています)プログラムがフラッシュに収まらないときコードを書き込めません。フラッシュ使用量を減らす必要があります
Not enough memoryとdata section exceeds available space in board(データが容量を超えています)グローバル変数がRAM容量を超えたときコードを書き込めません。RAM使用量を減らす必要があります
「Low memory」の警告はエラーではなく、コードは問題なく書き込めます。そこが危険な点です。例えばint veri[700];を定義したスケッチは、Unoでグローバル変数に1588バイト(77%)を使い、スタックとヒープには460バイトしか残しません。数段の入れ子になった関数呼び出し、Stringの連結、ライブラリがbegin()内で確保するバッファなどでこの領域を使い切ると、プログラムがクラッシュします。症状は不規則なリセット、変数の破損、フリーズです。電源の問題と見分けるには、Arduinoがリセットを繰り返すときも参照してください。

SRAMの内部:グローバル変数、ヒープ、スタック

Unoの2048バイトのRAMは4つの領域に分かれています。最下部には初期値のあるグローバル変数(.data)、その上にはゼロから始まるグローバル変数(.bss)があります。コンパイラの「Global variables use」の行には、この2つの合計が表示されます。その次は上に向かって伸びるヒープで、Stringオブジェクトやnew、mallocで確保したメモリが置かれます。RAMの最上部からはスタックが下に向かって伸びます。関数呼び出しのたびに戻り先アドレスとローカル変数が置かれ、割り込みが発生するとレジスタも保存されます。間にある空き領域でヒープとスタックが衝突すると、互いを上書きし、プログラムが予測できない形で動かなくなります。

領域内容拡張する方向コンパイル結果に表示されるか
.data初期化済みのグローバル変数とstatic変数、F()で囲んでいない文字列固定はい
.bss未初期化(ゼロ)のグローバル変数とstatic変数、ライブラリのバッファ固定はい
ヒープString、new、malloc、一部のライブラリがbegin()で確保するバッファ上方向いいえ
スタックローカル変数、関数の戻り先アドレス、割り込み時に保存されるレジスタ下方向いいえ

この構造には、重要な意味が2つあります。まず、F()で囲んでいない文字列はすべて.dataにコピーされます。AVRプロセッサは、フラッシュ内のデータを通常の変数と同じようには読めないためです。次に、ヒープは断片化します。サイズの異なるStringを作成・削除すると小さな隙間が残り、空きメモリの合計は十分に見えても、大きなブロックを確保できなくなります。そのため、Unoで長時間動かすプログラムでは、できるだけヒープを使わない方法が最も安全です。

まず測定:どの行がどれだけメモリを使うか

メモリの問題を解決する第一歩は、推測ではなく測定です。次の表の各行は、Arduino AVRコア1.8.6で、小さなスケッチをそれぞれArduino Uno向けにコンパイルした実際の結果です。ライブラリやコアのバージョンで数バイト変わることはありますが、比率は変わりません。

スケッチの内容フラッシュ(バイト)グローバル変数のRAM(バイト)
空のsetup()とloop()4449
Serial.begin(9600)1438184
+ Serial.println("a 44-character text") (44文字のテキストを出力する行を追加)1518232
同じ文字列にF()を使用1530188
analogRead + Serial.println(int)1892188
floatでの計算 + Serial.println(float)3380200
Stringの連結:"A0=" + String(analogRead(A0))3316202
snprintfとchar配列で同じ処理3232194
Wire(I2C)で1回書き込み2476225
SDカード:begin、open、println、close10496837
int veri[700]の配列17801588(77%、Low memoryの警告)
int veri[950]の配列17802088(101%、コンパイル不可)

ここから分かることは明確です。Serial.begin()だけで175バイトのRAMを使います。シリアルポートが受信用と送信用に、それぞれ64バイトのバッファを確保するためです。44文字の文字列1つで44バイトのRAMを使いますが、F()で書けばそのRAMを取り戻せます。floatを使うと、浮動小数点処理のコードがフラッシュに約1.5 KB追加されます。SDライブラリだけで10 KBのフラッシュと約830バイトのRAMを消費し、ログファイル1つにUnoのRAMの40%を使います。Stringの例はグローバル変数のRAM使用量が小さく見えますが、本当の消費量は実行時のヒープに現れ、コンパイル結果には表示されません。

F()マクロ:定数文字列をRAMから移す

Unoでは、"Temperature: "などの引用符で囲んだ文字列はフラッシュに保存されますが、プログラムの開始時にRAMへコピーされ、その領域をずっと占有します。F()マクロはこのコピーを防ぎます。文字列はフラッシュに残り、Serial.printなどの関数がフラッシュから直接1文字ずつ読み取ります。F()はSerial、LiquidCrystal、LiquidCrystal_I2C、Adafruit SSD1306、SDファイルなど、Printクラスから派生したすべてのオブジェクトで使えます。メニュー、エラーメッセージ、ヘルプ文があるプロジェクトでは、F()を追加するだけで数百バイトのRAMを取り戻せます。次のコードで違いを示し、実行時の空きRAMを測定します。

C++ (Arduino IDE)
1// Boş RAM'i ölçmek ve F() ile RAM kazanmak (Uno, Nano, Mega)
2// Measure free RAM and save RAM with F() (Uno, Nano, Mega)
3extern int __heap_start, *__brkval;   // avr-libc heap sınırları / avr-libc heap limits
4
5int bosRam() {
6  int yerel;                          // stack'in o anki tepesi / current top of the stack
7  return (int)&yerel - (__brkval == 0 ? (int)&__heap_start : (int)__brkval);
8}
9
10void setup() {
11  Serial.begin(9600);
12  Serial.println("Bu metin RAM'e kopyalanir");   // RAM'de 26 bayt / 26 bytes of RAM
13  Serial.println(F("Bu metin flasta kalir"));     // RAM'de 0 bayt / 0 bytes of RAM
14  Serial.print(F("Bos RAM / Free RAM: "));
15  Serial.println(bosRam());
16}
17
18void loop() {
19}

bosRam()関数は、現在のスタックの先端とヒープの末尾の距離、つまりヒープとスタックが衝突するまでに残っているバイト数を計算します。loop()内でディスプレイ更新やSDへの書き込みの直後に呼び出すと、最も厳しい瞬間を捉えられます。実用上の目安として、Unoでは実行時の空きRAMを200〜300バイト未満にしないようにしてください。F()はchar*を受け取る関数(strcmp、strcpy)では使えません。それらには、後述する_P版とPSTR()マクロを使います。

PROGMEM:大きなテーブルをフラッシュに保存

F()は文字列専用です。音符の配列、画面用アイコン(ビットマップ)、文字テーブル、キャリブレーション曲線、メッセージ一覧など、変化しない大きな配列にはPROGMEMキーワードを使います。PROGMEMで宣言した配列はRAMにコピーされません。読み取りには通常の配列アクセスではなく、pgm_read_byteやpgm_read_wordなどの専用関数が必要です。例えば100音のメロディーの周波数と長さのテーブルは400バイトを使います。これはUnoのRAMの5分の1ですが、PROGMEMならすべてフラッシュへ移せます。

C++ (Arduino IDE)
1// Mesaj listesi ve nota tablosu flaşta (PROGMEM)
2// Message list and note table kept in flash (PROGMEM)
3const char m0[] PROGMEM = "Sistem hazir";
4const char m1[] PROGMEM = "Sensor hatasi";
5const char m2[] PROGMEM = "Kapi acik";
6const char* const mesajlar[] PROGMEM = { m0, m1, m2 };   // işaretçi tablosu da flaşta / pointer table in flash too
7
8const uint16_t notalar[] PROGMEM = { 262, 294, 330, 349, 392, 440, 494, 523 };   // Do-Re-Mi ... Do (Hz)
9const byte BUZZER_PIN = 8;
10
11void setup() {
12  Serial.begin(9600);
13  char tampon[20];                                     // RAM'de tek ortak tampon / one shared RAM buffer
14  for (byte i = 0; i < 3; i++) {
15    strcpy_P(tampon, (const char*)pgm_read_ptr(&mesajlar[i]));   // flaştan RAM'e kopyala / copy flash -> RAM
16    Serial.println(tampon);
17  }
18  for (byte i = 0; i < 8; i++) {
19    uint16_t frekans = pgm_read_word(&notalar[i]);     // 2 baytlık değeri oku / read a 2-byte value
20    tone(BUZZER_PIN, frekans, 200);
21    delay(250);
22  }
23}
24
25void loop() {
26}
関数・マクロ役割
pgm_read_byte(&array[i])フラッシュから1バイトを読み取ります(byte、char、uint8_tの配列、ビットマップ)
pgm_read_word(&array[i])フラッシュから2バイトを読み取ります(Unoでのint、uint16_t、音符や数値のテーブル)
pgm_read_dword / pgm_read_float4バイトのlong値とfloat値を読み取ります
pgm_read_ptr(&table[i])フラッシュに保存されたポインタを読み取ります(文字列テーブル)
strcpy_P(dest, src)フラッシュ内の文字列をRAMのバッファへコピーします
strcmp_P(ram_text, PSTR("..."))RAM内の文字列とフラッシュ内の文字列を比較します
strlen_P / memcpy_Pフラッシュ内の文字列の長さを取得したり、フラッシュからブロックをコピーしたりします
ESP32とPicoでは、constで宣言した配列はもともとフラッシュに置かれます。PROGMEMは効果がありませんがエラーにもならず、pgm_read_*関数も定義されています。そのため、PROGMEMを使ったコードは3種類のボードすべてでコンパイルできます。ただし例外があります。ポインタテーブルを読むとき、pgm_read_wordはUnoでは使えますが、32ビットのボードではポインタが切り詰められます。移植性のあるコードにはpgm_read_ptrを使ってください。

Stringの代わりにchar配列を使う

ArduinoのStringクラスは便利ですが、連結(+)のたびにヒープから新しいブロックを確保し、古いブロックを解放します。Unoの小さなヒープでこれを何千回も繰り返すと、メモリが隙間だらけになります。プログラムは何時間も正常に動いた後に突然フリーズし、原因の特定は非常に困難です。解決策は、サイズをあらかじめ決めたchar配列を使うことです。メモリを一度だけ確保するので断片化せず、使用バイト数もコンパイル結果に表示されます。次のコードはStringを使わずにシリアルモニタからコマンドを読み取り、測定値を1行に整形します。

C++ (Arduino IDE)
1// String yerine sabit boyutlu char dizileri / fixed-size char arrays instead of String
2char komut[16];          // gelen komut tamponu / incoming command buffer
3byte konum = 0;          // tampondaki karakter sayısı / characters in the buffer
4
5void setup() {
6  Serial.begin(9600);
7  pinMode(13, OUTPUT);
8  Serial.println(F("Komutlar / Commands: LED ON, LED OFF, OLC"));
9}
10
11void olcumGonder() {
12  int ham = analogRead(A0);
13  float volt = ham * 5.0 / 1023.0;          // Uno: 5 V, 10 bit
14  char vMetin[8];
15  dtostrf(volt, 4, 2, vMetin);              // AVR'de snprintf %f desteklemez / AVR snprintf has no %f
16  char satir[40];
17  snprintf(satir, sizeof(satir), "A0=%d ham, %s V", ham, vMetin);   // taşma olmaz / never overflows
18  Serial.println(satir);
19}
20
21void komutIsle(const char* k) {
22  if (strcmp_P(k, PSTR("LED ON")) == 0) digitalWrite(13, HIGH);     // PSTR: metin flaşta / literal in flash
23  else if (strcmp_P(k, PSTR("LED OFF")) == 0) digitalWrite(13, LOW);
24  else if (strcmp_P(k, PSTR("OLC")) == 0) olcumGonder();
25  else Serial.println(F("Bilinmeyen komut / Unknown command"));
26}
27
28void loop() {
29  while (Serial.available()) {
30    char c = Serial.read();
31    if (c == '\n') {                        // satır bitti / line complete
32      komut[konum] = '\0';
33      komutIsle(komut);
34      konum = 0;
35    } else if (c != '\r' && konum < sizeof(komut) - 1) {
36      komut[konum++] = c;                   // taşmadan ekle / append without overflow
37    }
38  }
39}

コードには注意したい点が3つあります。snprintfはバッファのサイズを把握しているため、文字列が長くても配列からあふれません。sprintfにはこの保護がありません。また、AVRのprintf系関数は標準では%f形式をサポートしないため、float値をまずdtostrfで文字列へ変換します。さらに、コマンドバッファの制限(konum < sizeof(komut) - 1)により、長い行が別のメモリ領域を上書きするのを防ぎます。Stringを使う必要がある場合(一部のライブラリはStringを返します)は、少なくともsetup()内でtext.reserve(64)を使って先に領域を確保し、Stringをグローバル変数にしてください。これで断片化を大幅に減らせます。

適切なデータ型とローカル変数

型Uno(AVR)ESP32 / Pico値の範囲(Uno)
bool, char, byte (1バイトのデータ型)1バイト1バイトbyte:0〜255
int2バイト4バイト-32768〜32767
unsigned int, uint16_t2バイトuint16_tは2バイト、unsigned intは4バイト0〜65535
long, unsigned long (4バイトの整数型)4バイト4バイトunsigned long:0〜4,294,967,295
float4バイト4バイト有効数字約6〜7桁
double4バイト(floatと同じ)8バイトUnoではfloatと違いはありません
  • 小さな数値にはbyte:0〜255の範囲のピン番号、カウンター、割合にintの代わりにbyteを使うと、変数あたり1バイト、200要素の配列では200バイトを節約できます。
  • ピン番号にはconst:const byte LED_PIN = 13;のように宣言した定数は、コンパイラがコードへ直接埋め込むため、RAMを確保しません。
  • オン・オフのフラグはビットに保存:bool変数8個は8バイトを使います。同じ情報をbitReadとbitWriteで1バイトの各ビットに保存すれば、1バイトで済みます。
  • 大きなローカル配列に注意:関数内で宣言したchar buffer[300];はコンパイル結果に現れませんが、関数を呼び出すたびに300バイトのスタックを使います。大きなバッファはグローバルにして、サイズが見えるようにしてください。
  • 再帰を避ける:関数が自分自身を呼び出すたびに、スタックに新しい階層が作られます。Unoでは数十階層でもRAMを使い切ることがあります。
  • 大きな構造体は参照渡しにする:structを関数へ値渡しすると、スタックにコピーが置かれます。const Settings& sのように参照渡しすれば、コピーされません。

ライブラリが見えないところで消費するメモリ

プロジェクトで突然メモリが不足したとき、原因は自分のコードではなく、追加したライブラリであることがよくあります。コンパイル時にグローバルバッファとしてRAMを確保するライブラリもあれば、begin()の呼び出し時にヒープから確保するものもあります。後者ではコンパイル結果に問題がなく見えても、ボードを動かすとメモリが足りなくなります。次の値の一部は上の測定表から、残りはライブラリのバッファサイズから得たものです。

ライブラリ・機能RAM使用量(Uno)確保するタイミングメモリ消費が少ない選択肢
Serial約175バイト(64 + 64バイトのバッファ)コンパイル時(グローバル)不要ならSerialを完全に削除
Wire(I2C)約215バイトコンパイル時(グローバル)I2Cデバイスが1台でも必要なため、ほかの部分の節約に集中
SoftwareSerial約120バイト(受信バッファ64バイト)コンパイル時(グローバル)可能ならハードウェアシリアルポート、またはMegaの追加ポートを使用
SD約830バイトに加え、約10 KBのフラッシュコンパイル時(グローバル)ログ記録をESP32やMegaに任せる
Adafruit SSD1306 128x641024バイトのフレームバッファbegin()内でヒープから確保U8g2のページモード(128バイト)、または文字専用のU8x8
Adafruit NeoPixel / FastLEDLEDあたり3バイト(LED60個 = 180バイト)起動時LEDの個数を実際のテープの長さに合わせる

この表から、UnoでOLEDディスプレイ、SDカード、Wi-Fiモジュールを同時に使うのがほぼ不可能な理由が分かります。SSD1306のバッファとSDライブラリだけで合計1.8 KBになり、2 KBのRAMにはプログラム用の空きがほとんど残りません。OLEDディスプレイで出るSSD1306 allocation failed(SSD1306のメモリ確保に失敗)というエラーは、まさにこのヒープの確保失敗を示します。対処法はOLEDディスプレイ(SSD1306)の記事でも紹介しています。

Sketch too big:フラッシュ使用量を減らす方法

  • デバッグ出力を無効にする:開発中に追加したSerial.printの行は、フラッシュとRAMの両方を使います。次のDEBUGマクロなら、1行変えるだけですべてコンパイル対象から除外できます。
  • floatとsprintfを避ける:測定結果のとおり、floatは約1.5 KB、snprintfは1 KB以上のコードを追加します。多くのプロジェクトでは、温度を10倍してintで保存すれば十分です(23.5 °Cの代わりに235)。
  • 繰り返すコードを関数や配列にまとめる:LEDごとに10行のブロックを書く代わりに、ピン番号を配列に保存してループで処理すると、コードを大幅に短くできます。
  • 小さなライブラリを選ぶ:グラフィックが不要なら、U8x8やLiquidCrystal_I2CはAdafruit GFXを使うライブラリよりはるかに小さく済みます。1つの機能のためにライブラリ全体を読み込むより、その部分を自分で書くことも検討してください。
  • ボード設定を確認する:Arduino IDEは選択したボードから上限を計算します。Unoは32256バイト、Nanoは新旧どちらのブートローダーでも30720バイト、Leonardoは28672バイトです。ボードの選択が間違っていると、上限とピン定義の両方が誤ったものになります。
  • より大容量のボードへ移行する:ここまで試しても収まらなければ、Mega(256 KB)やESP32(1.25 MB以上)なら、少し変更するだけで同じコードを動かせます。
C++ (Arduino IDE)
1// DEBUG makrosu: hata ayıklama çıktısını tek satırla aç/kapat
2// DEBUG macro: switch debug output on/off with one line
3#define DEBUG 1          // yayında 0 yap / set to 0 for release
4
5#if DEBUG
6  #define DBG(x)   Serial.print(x)
7  #define DBGLN(x) Serial.println(x)
8#else
9  #define DBG(x)
10  #define DBGLN(x)
11#endif
12
13void setup() {
14#if DEBUG
15  Serial.begin(9600);
16#endif
17  pinMode(13, OUTPUT);
18  DBGLN(F("Basladi / Started"));
19}
20
21void loop() {
22  int deger = analogRead(A0);
23  digitalWrite(13, deger > 512 ? HIGH : LOW);   // asıl iş / the real job
24  DBG(F("A0: "));
25  DBGLN(deger);
26  delay(500);
27}

DEBUG 1の場合、このスケッチはUnoで2292バイトのフラッシュと188バイトのRAMを使います。DEBUG 0にすると、Serialのコードがコンパイル対象から完全に除外され、フラッシュは934バイト、RAMは9バイトに減ります。差の1.3 KBのフラッシュと179バイトのRAMがあれば、完成したプロジェクトに新しい機能を追加できることがよくあります。

ESP32でメモリを測定する

ESP32のメモリは豊富ですが、無限ではありません。Wi-Fiを有効にすると数十KBのRAMが確保され、Bluetoothも有効にすると100 KB近くになることがあります。Webサーバー、JSONドキュメント、画像バッファもメモリをすぐに埋めます。ESP32-CAMなどの一部のモジュールは、大きなバッファを置くための追加のPSRAM(通常4 MB)を備えています。フラッシュ側では、アプリが標準の1.25 MBのパーティションに収まらない場合、「ツール」メニューのPartition Scheme設定で「Huge APP」を選ぶと3 MBまで増やせます。ESP32の基本的な特徴はESP32とは?を参照してください。

C++ (Arduino IDE)
1// ESP32 bellek raporu / ESP32 memory report
2void setup() {
3  Serial.begin(115200);
4  delay(500);
5  Serial.printf("Bos heap / Free heap: %u bayt\n", ESP.getFreeHeap());
6  Serial.printf("En dusuk heap / Minimum free heap: %u bayt\n", ESP.getMinFreeHeap());
7  Serial.printf("En buyuk blok / Largest free block: %u bayt\n", ESP.getMaxAllocHeap());
8  Serial.printf("PSRAM: %u bayt\n", ESP.getPsramSize());
9  Serial.printf("Program / Sketch: %u, bos alan / free: %u bayt\n", ESP.getSketchSize(), ESP.getFreeSketchSpace());
10}
11
12void loop() {
13  // loop görevinin hiç kullanılmamış stack'i / never-used stack of the loop task
14  Serial.printf("loop stack bos / free: %u bayt\n", (unsigned)uxTaskGetStackHighWaterMark(NULL));
15  Serial.printf("Bos heap / Free heap: %u bayt\n", ESP.getFreeHeap());
16  delay(5000);
17}

ここで特に役立つ2つの値は、getMinFreeHeapとgetMaxAllocHeapです。前者はプログラム開始以降の空きヒープの最小値、後者は連続して確保できる最大ブロックを返します。空きヒープが100 KBでも最大ブロックが10 KB未満なら、ヒープが断片化しており、大きなStringやJSONドキュメントを確保できない可能性があります。ESP32のloop()は8 KBのスタックを持つ専用タスクで実行されます。uxTaskGetStackHighWaterMarkは、そのスタックのうち一度も使われていない量を示し、数百バイトを下回ると「Stack canary watchpoint triggered」というエラーが出ることがあります。

Raspberry Pi PicoとMicroPythonのメモリ

Picoの264 KBのRAMはUnoと比べると非常に大きいものの、MicroPythonのインタープリタ自身も一部を使うため、プログラム用に残るヒープは通常190 KB前後です。MicroPythonではガベージコレクタがメモリを管理します。gc.collect()を呼んだとき、またはメモリが不足しそうなときに、使われなくなったオブジェクトを回収します。本当にメモリが尽きると、MemoryError: memory allocation failed(メモリの確保に失敗)というエラーが出ます。ループ内での文字列連結、大きなリストの作成、1つの非常に長いコードファイルが、このエラーの主な原因です。

Python
1import gc
2import micropython
3
4gc.collect()                                   # önce çöpleri topla / collect garbage first
5print("Bos RAM / Free RAM:", gc.mem_free(), "bayt")
6print("Kullanilan / Used:", gc.mem_alloc(), "bayt")
7micropython.mem_info()                         # ayrıntılı rapor / detailed report
8
9# Kötü: her turda yeni metin nesnesi / bad: a new string object every loop
10# satir = ""
11# for i in range(100): satir += str(i) + ","
12
13# İyi: tek seferlik bytearray tamponu / good: one preallocated bytearray buffer
14tampon = bytearray(64)
15for i in range(10):
16    tampon[i] = 48 + i                         # ASCII '0'..'9'
17print(bytes(tampon[:10]))

MicroPythonでメモリを節約するには、bytearrayでバッファを先に確保してループ内で再利用し、数値定数をconst()で定義し、大きなモジュールをmpy-crossで事前コンパイルした.mpyファイルに変換し、長い処理の前にgc.collect()を呼び出します。Picoで使うMicroPythonの基本的な命令はMicroPythonの基本、ボードの基本的な特徴はRaspberry Pi Picoとは?で紹介しています。

MegaやESP32へ移行するタイミング

Arduino Mega 2560ボード
Arduino Mega 2560は、256 KBのフラッシュ、8 KBのSRAM、4 KBのEEPROMを備えています。Unoのコードが変更なしで動くこともよくあります。
状況おすすめの対応
F()、PROGMEM、char配列の導入後、空きRAMが300バイトを超えているUnoを使い続けます。問題は解決しています
複数のセンサーとメニューにOLEDやSDカードを組み合わせ、RAMがまだ足りないArduino Mega 2560:RAMは4倍、5 Vのピンとライブラリは同じ
プログラムが32 KBを超えるが、RAMは足りているMegaまたはUno R4:256 KBのフラッシュ
Wi-Fi、Webサーバー、大きなバッファ、画像処理が必要ESP32:520 KBのRAM、4 MBのフラッシュ、Wi-Fi、Bluetooth
MicroPythonで開発したいRaspberry Pi PicoまたはPico W
電池で数か月動かす必要がある小型センサーノードUnoで最適化するかPro Miniを使います。大きなボードほど消費電流が増えます

Megaへ移行しても、コードの大半はそのまま使えます。ただし、I2Cピンが20(SDA)と21(SCL)、SPIピンが50〜53であることを覚えておいてください。ESP32への移行では、3.3 Vのロジックレベル、異なるピン番号、analogReadの12ビット(0〜4095)の戻り値などの違いがあります。適したボードを選ぶにはArduinoとESP32の違いは?の比較を、5 Vに対応してメモリも大幅に増える選択肢についてはArduino Uno R4の記事を参照してください。

よくある間違いと対処法

症状考えられる原因対処法
Sketch too bigと表示され、コードを書き込めないプログラムがフラッシュに収まらないデバッグ出力を無効にし、floatとsprintfを減らし、小さなライブラリを選び、必要ならMegaへ移行します
コードは書き込めるが数分後にフリーズするStringの連結でヒープが断片化しているStringの代わりにchar配列とsnprintfを使い、空きRAMを測定します
シリアルモニタが文字化けし、変数が勝手に変わるスタックがヒープを上書きしているグローバル変数のRAM使用量を75%未満に抑え、大きなローカル配列をなくします
SSD1306 allocation failed(SSD1306のメモリ確保に失敗)begin()が1 KBのバッファを確保できない文字列をF()で囲み、U8g2のページモードへ切り替えます
メモリに問題がなさそうなのに、ボードが不規則にリセットされるメモリではなく電源の問題かもしれませんモーターやリレーに別の電源を使い、コンデンサを追加します
配列の要素が意味のない値になる配列の末尾を超えて書き込んでいる添字を確認し、sizeofからループの上限を求めます
ESP32でStack canary watchpoint triggeredが発生タスクのスタックがオーバーフローした大きなローカル配列をグローバルにするか、タスクのスタックを増やします
最初からメモリの問題を防ぐには、プロジェクトに新しいモジュールを追加するたびに、コンパイル結果の2つの割合を記録してください。グローバル変数のRAM使用量が60%を超えたら、F()とPROGMEMの導入を始めましょう。75%の警告が出るまで待つと、最も解決が難しい段階まで問題を先延ばしにすることになります。

Arduinoのメモリ不足は、通常、ボードを交換せずに解決できます。F()で定数文字列をフラッシュへ移し、大きなテーブルにPROGMEMを使い、Stringをchar配列に置き換え、不要なライブラリを外すと、2 KBのRAMにも驚くほど余裕が生まれます。BlueGraysアプリでは、OLEDゲーム、ブザーのメロディー、LEDマトリクスのアニメーションなど、メモリを多く使うプロジェクトを、ステップごとの回路図とこれらの手法を使ったコードで学べます。

よくある質問

ArduinoのLow memory availableはどういう意味ですか?

グローバル変数がRAMの約75%を占め、スタックとヒープ用の空きが少ないことを意味します。コードは書き込めますが、実行中に不規則なリセット、フリーズ、変数の破損が起こる可能性があります。定数文字列をF()で囲み、大きな配列をPROGMEMへ移すと、通常は警告が解消します。

Sketch too bigのエラーはどう直せますか?

プログラムがフラッシュメモリに収まらないという意味です。デバッグ用に追加したSerial出力を無効にし、floatとsprintfを減らし、繰り返すコードを関数にまとめ、小さなライブラリを選んでください。それでも収まらなければ、Arduino MegaやESP32など、フラッシュ容量の大きなボードへ移行します。

Arduino Unoのメモリ容量はどれくらいですか?

Arduino UnoのATmega328Pは、32 KBのフラッシュ(0.5 KBはブートローダー用)、2 KBのSRAM、1 KBのEEPROMを備えています。プログラムはフラッシュ、変数はSRAM、永続的な設定はEEPROMに保存します。問題の大半は、この2 KBのSRAMで起こります。

F()マクロは何をしますか?

F()は、Serial.printなどに渡す定数文字列がRAMへコピーされるのを防ぎ、フラッシュに保持します。Unoでは1文字につき1バイトのRAMを節約でき、メッセージの多いプロジェクトでは数百バイトになります。ESP32やPicoでもコンパイルできますが、効果はありません。

Arduinoの空きRAMはどう測定しますか?

Uno、Nano、Megaでは、__heap_startと__brkvalという変数を使い、スタックとヒープの距離を計算する小さな関数を使います。ESP32ではESP.getFreeHeap()とESP.getMinFreeHeap()、MicroPythonではgc.mem_free()で同様の情報が得られます。メモリ使用量が最大になる瞬間に測ることが大切です。

ArduinoでStringを使うと、なぜ問題になるのですか?

Stringオブジェクトは連結のたびにヒープから新しいメモリを確保し、古いブロックを解放するため、Unoの小さなヒープは時間とともに断片化します。空きメモリの合計が十分に見えても、新しいブロックを確保できず、プログラムがフリーズします。固定長のchar配列とsnprintfを使えば、この問題を完全に解消できます。

全プロジェクトを見る
ブザーでトルコ国歌を演奏
AR-15中級

ブザーでトルコ国歌を演奏

ボタンを押すと、小さなブザーがトルコ国歌を1音ずつ演奏し始めます。Arduinoが各音を正しい音程と長さで鳴らし、国歌の2節を最初から最後まで演奏した後、次のボタン操作を待ちます。シンプルな音響部品からメロディーが生まれる様子を、自分の耳で確かめられます。

4.8(114)
235
DHT11で温度と湿度を測定
AR-55中級

DHT11で温度と湿度を測定

部屋の温度は何度で、空気は湿っているでしょうか、それとも乾燥しているでしょうか?DHT11センサーが温度と湿度を測定し、Arduinoが2行のLCDディスプレイに値を表示して、数秒ごとに更新します。センサーに異常があればエラーメッセージが表示されます。自分だけの小さな気象観測装置を作る第一歩です。

4.7(47)
83
パドルボールゲーム(SSD1306)
AR-86中級
プレミアム

パドルボールゲーム(SSD1306)

ボール1個とパドル2本で遊ぶ、ビデオゲームの原点の1つである卓球ゲームを、小さなOLEDディスプレイで楽しめます。2つのボタンで右のパドルを上下に動かします。左のパドルはコンピューターがボールを追いながら操作し、ボールを打つたびにブザーが短く鳴ります。先に9点を取ると勝ちです。その後、新しいゲームが自動で始まります。

4.5(47)
65
OLED T-Rexラン:Arduino恐竜ゲーム
AR-87上級
プレミアム

OLED T-Rexラン:Arduino恐竜ゲーム

インターネットが切れると現れる恐竜ゲームを、机の上で楽しめます。小さなOLEDディスプレイを恐竜が走り、迫るサボテンを1つのボタンでジャンプして避けます。横の4桁ディスプレイには得点がリアルタイムで表示され、100点ごとにブザーがお祝いの音を鳴らします。サボテンにぶつかるとゲーム終了です。ボタンを押すと、もう一度始められます。

4.7(33)
53
ピクセルスネーク:8x8マトリクス
AR-88上級
プレミアム

ピクセルスネーク:8x8マトリクス

定番のスネークゲームを自分の手で作って遊びましょう。カラフルな8x8のLEDマトリクスで、ジョイスティックを使って緑のヘビを動かし、赤いリンゴを食べます。リンゴを食べるたびにヘビが長くなり、少しずつ速くなって、小さな数字ディスプレイのスコアも増えます。壁や自分のしっぽにぶつかると画面が赤く3回点滅し、ボタンを押すと再び始められます。

4.7(39)
57
Arduino記憶ゲーム(LED4個+ボタン4個+ブザー)
AR-93上級
プレミアム

Arduino記憶ゲーム(LED4個+ボタン4個+ブザー)

記憶力に自信はありますか?4色のLEDが順番に点灯し、それぞれの音を鳴らします。同じ順番でボタンを押して再現してください。正解するたびに新しい色が1つ追加され、短い勝利のメロディーが流れて、LCDディスプレイにスコアが表示されます。1回でも押し間違えると、悲しい音とともにゲームが終了し、最初からやり直しになります。

4.8(46)
69
4x4キーパッドとLCDで暗証番号ロック
AR-64上級
プレミアム

4x4キーパッドとLCDで暗証番号ロック

正しい暗証番号を知らないと開けられない、小さな電子ドアロックです。ハッシュキーを押してキーパッドから暗証番号を入力します。正しければ画面に入室許可が表示され、緑のLEDが点灯し、サーボモーターがドアを5秒間開けてから再び閉めます。間違っていれば赤のLEDが点灯します。建物や金庫のロックの仕組みを自分で作ります。

4.8(59)
75