#include <M5StickCPlus2.h>  // M5StickC Plus2 専用のライブラリを読み込む
#include <M5Unified.h>  // M5Stackシリーズを統合的に扱えるライブラリ

//M5StickCPlus2.h は、M5StickC Plus2専用の機能を簡単に使うためのライブラリです
//M5.begin()のように、画面、ボタン、IMUなどの内蔵ハードウェアを初期化・制御するための関数が含まれています。

// 最初に一度だけ実行される処理
void setup() {
    M5.begin();  // M5StickC Plus2 の初期化（LCD, ボタン, I2C, IMUなどを含む）
    M5.Lcd.setRotation(3);  // 画面の回転方向を設定（横向きに表示）
    M5.Lcd.fillScreen(BLACK);  // 画面全体を黒で塗りつぶす（背景クリア）
    M5.Lcd.setTextColor(WHITE);  // 文字色を白に設定
    M5.Lcd.setTextSize(2);  // 文字サイズを2倍に設定
    M5.Lcd.setCursor(10, 10);  // テキスト表示の開始位置を (x=10, y=10) に設定
    M5.Lcd.println("Hello, M5StickC Plus2!");  // 文字列を表示
}

// 繰り返し実行される処理（ループ）
void loop() {
    // メインの処理をここに書く
    // 例: センサー値の読み取り、表示、通信など
}

In file included from /Users/username/Documents/Arduino/sketch_sep29a/sketch_sep29a.ino:1:
/Users/username/Documents/Arduino/libraries/M5StickCPlus2/src/M5StickCPlus2.h:21:5: error: 'RTC8563_Class' does not name a type; did you mean 'RTC_Class'?
   21 |     RTC8563_Class &Rtc     = M5.Rtc;
      |     ^~~~~~~~~~~~~
      |     RTC_Class
exit status 1

Compilation error: exit status 1

上記のようなエラーが出た方は以下を参考に対応お願いします。

VS Codeで保存する流れ

1. ファイルを開く

• VS Code を起動する
• メニューから 「ファイル」→「開く…」 を選ぶ
• エラーメッセージにあった場所に移動します： /Users/momo/Documents/Arduino/libraries/M5StickCPlus2/src/M5StickCPlus2.h
• M5StickCPlus2.h を選んで開きます

2. ファイルを編集する

開いたら 21 行目あたりにある以下のコードを探します👇

RTC8563_Class &Rtc     = M5.Rtc;

これを次のように書き換えます：

RTC_Class &Rtc     = M5.Rtc;

3. 保存する

• 編集したら、Command + S（⌘ + S）を押す
  または
  メニューの 「ファイル」→「保存」 をクリック

これでファイルが保存されます。

4. Arduino IDE で再コンパイル

Arduino IDE に戻ってスケッチをコンパイル → 書き込みしてください。
修正が反映されて、エラーが解消するはずです。

⚠️ 補足

• この方法はライブラリファイルを直接書き換える応急処置です。
• 今後 Arduino IDE でライブラリをアップデートすると、この修正が消えてしまうので、その場合はもう一度同じ変更をする必要があります。

👉 VS Code での操作、ファイルを「開く」ところからやってみますか？ それとも Finder から右クリック → 「Visual Studio Codeで開く」にしたほうがやりやすいですか？

#include <M5StickCPlus2.h>  // M5StickC Plus2 専用のライブラリを読み込む
#include <M5Unified.h>  // M5Stackシリーズを統合的に扱えるライブラリ

// 最初に一度だけ実行される処理
void setup(void) {
  auto cfg = M5.config();  // 設定オブジェクトを取得
  M5.begin(cfg);           // 設定に基づいて初期化
  M5.Display.setTextSize(2);  // 文字サイズを2倍に設定
}

// 繰り返し実行される処理（ループ）
void loop(void) {
  M5.delay(1000);  // 1秒待つ（＝表示が1秒ごとに更新される）

  static int rotation = -1;  // 画面の回転方向を管理する変数（最初は -1）

  M5.Display.clear(TFT_RED);  // 画面を赤で塗りつぶす
  rotation = (rotation + 1) % 8;  // 回転値を0〜7の範囲で循環させる
  M5.Display.setRotation(rotation);  // 回転方向を設定
  M5.Display.setCursor(0, 0);        // テキストの開始位置を左上に設定
  M5.Display.printf("Rotation = %d\n", M5.Display.getRotation());  
  // 現在の回転方向を数値で表示
}

#include <M5StickCPlus2.h>  // M5StickC Plus2 専用のライブラリを読み込む
#include <M5Unified.h>  // M5Stackシリーズを統合的に扱えるライブラリ

void setup(void) {
  // 設定オブジェクトを取得（電源、ディスプレイなどの設定をまとめる）
  auto cfg = M5.config();
  // デバイスを初期化（ディスプレイやセンサー等も含む）
  M5.begin(cfg);

  // 文字表示位置を左上（x=0, y=0）に設定
  M5.Display.setCursor(0, 0);

  // 日本語フォントを設定（M5Unified内蔵の日本語ゴシック24ドット）
  M5.Display.setFont(&lgfxJapanGothic_24);

  // 日本語文字列をLCDに表示
  M5.Display.print("日本語描画");
}

void loop(void) {
  // イベント処理などを入れたい場合に備えて1msの待ち時間
  M5.delay(1);
}

#include <M5StickCPlus2.h>  // M5StickC Plus2 専用のライブラリを読み込む
#include <M5Unified.h>  // M5Stackシリーズを統合的に扱えるライブラリ

void setup() {
    auto cfg = M5.config();     // 設定オブジェクトを取得（画面、電源、ボタンなどの初期化に使う）
    M5.begin(cfg);              // 設定に基づいてM5デバイスを初期化する
    // 文字サイズを指定（標準より大きめの文字で表示する）
    M5.Lcd.setTextSize(4);
}

void loop() {
    // ボタンの状態を更新（押されたか、離されたか、長押しかを検出するために毎回呼ぶ）
    M5.update();

    // テキストを表示する位置を (x=0, y=0) にセットする
    M5.Lcd.setCursor(0, 0);

    // ボタンA（左の物理ボタン）が「離されたとき」の処理
    if (M5.BtnA.wasReleased()) {
        M5.Lcd.fillScreen(RED);   // 画面を赤色で塗りつぶす
        M5.Lcd.print("red");      // 画面に "red" と表示する
    }
    // ボタンB（右の物理ボタン）が「1000ms(=1秒)以上押された後に離されたとき」の処理
    else if (M5.BtnB.wasReleasefor(1000)) {
        M5.Lcd.clear();           // 画面をクリア（真っ黒にする）
    }
    // ボタンB（右の物理ボタン）が「離されたとき」の処理
    else if (M5.BtnB.wasReleased()) {
        M5.Lcd.fillScreen(GREEN); // 画面を緑色で塗りつぶす
        M5.Lcd.print("green");    // 画面に "green" と表示する
    }
    
    // loop() は常に繰り返し呼ばれるので、毎フレームこの条件分岐が実行される
}

#include <M5StickCPlus2.h>  // M5StickC Plus2 専用のライブラリを読み込む
#include <M5Unified.h>  // M5Stackシリーズを統合的に扱えるライブラリ

// M5StickC Plus2 のLEDは GPIO19 に接続されている
#define LED_PIN 19

void setup() {
  auto cfg = M5.config();     // 設定オブジェクトを取得（画面、電源、ボタンなどの初期化に使う）
  M5.begin(cfg);              // 設定に基づいてM5デバイスを初期化する
  pinMode(LED_PIN, OUTPUT);   // LED用のピンを出力モードに設定
}

void loop() {
  digitalWrite(LED_PIN, HIGH);  // LEDを点灯
  delay(500);                   // 0.5秒待つ
  digitalWrite(LED_PIN, LOW);   // LEDを消灯
  delay(500);                   // 0.5秒待つ
}

#include <M5StickCPlus2.h>  // M5StickC Plus2 専用のライブラリを読み込む
#include <M5Unified.h>  // M5Stackシリーズを統合的に扱えるライブラリを読み込む

// 最初に一度だけ実行される処理
void setup(void) {
  auto cfg = M5.config();     // 設定オブジェクトを取得（画面、電源、ボタンなどの初期化に使う）
  M5.begin(cfg);              // 設定に基づいてM5デバイスを初期化する
  M5.delay(500);              // シリアル出力が安定するまで少し待つ

  // 画面にログ出力を表示する設定
  M5.setLogDisplayIndex(0);       // ログの表示先をLCD画面に設定（インデックス0がLCD）
  M5.Display.setTextScroll(true); // 画面のテキストをスクロール表示可能にする
}

// 繰り返し実行される処理
void loop(void) {
  M5.delay(1);    // 1ミリ秒待機（無駄にCPUを占有しないための小休止）
  M5.update();    // ボタンなどの入力状態を更新（押された／離されたなどを検出可能にする）

  // --- BtnAが押されたときの処理 ---
  if (M5.BtnA.wasPressed()) {
    // 中央のボタンが押されたら
    tone(GPIO_NUM_2, 2000, 1000);  // GPIO2に接続されたブザーから2000Hzの音を1秒間鳴らす
    M5.Log.println("BtnA TONE(2000Hz)");  // 画面に「BtnAが押され、2000Hzが鳴った」と表示
  }

  // --- BtnBが押されたときの処理 ---
  if (M5.BtnB.wasPressed()) {
    // 右のボタンが押されたら
    tone(GPIO_NUM_2, 4000, 1000);  // 4000Hzの音を1秒間鳴らす
    M5.Log.println("BtnB TONE(4000Hz)");  // ログに出力
  }

  // --- 電源ボタン（BtnPWR）が押されたときの処理 ---
  if (M5.BtnPWR.wasPressed()) {
    // 左側の電源ボタンが押されたら
    for (int i = 0; i < 4; i++) {   // 4回繰り返し（オクターブを上げていく）

      // ド(C)の音を鳴らす
      int frequency = 523.251 * pow(2, i);     // 基本音523.251Hzをオクターブごとに倍にする
      tone(GPIO_NUM_2, frequency, 500);        // 500ms鳴らす
      M5.Log.printf("BtnPWR TONE(C%d %dHz)\n", 5 + i, frequency);

      // レ(D)の音を鳴らす
      frequency = 587.330 * pow(2, i);
      tone(GPIO_NUM_2, frequency, 500);
      M5.Log.printf("BtnPWR TONE(D%d %dHz)\n", 5 + i, frequency);

      // ミ(E)の音を鳴らす
      frequency = 659.255 * pow(2, i);
      tone(GPIO_NUM_2, frequency, 500);
      M5.Log.printf("BtnPWR TONE(E%d %dHz)\n", 5 + i, frequency);

      // 休符（無音）を挿入（frequency=0で指定）
      tone(GPIO_NUM_2, 0, 500);
    }
  }
}

#include <M5StickCPlus2.h>  // M5StickC Plus2 専用のライブラリを読み込む
#include <M5Unified.h>  // M5Stackシリーズを統合的に扱えるライブラリ

// --------------------
// 録音パラメータ
// --------------------
static constexpr const size_t record_samplerate = 16000;  // サンプリング周波数 16kHz
static constexpr const size_t record_length = 240;        // 一度に録音するサンプル数
static int16_t *rec_data;                                 // 録音データを格納するバッファへのポインタ

// --------------------
// 初期化処理
// --------------------
void setup(void) {
  auto cfg = M5.config();  // 設定オブジェクトを取得
  M5.begin(cfg);           // デバイス初期化（LCD,ボタン,マイクなど）

  // 画面上にログを表示できるように設定
  M5.setLogDisplayIndex(0);

  // 画面の向きを横に設定
  M5.Display.setRotation(1);

  // 録音用メモリを確保（240サンプル分のint16_t配列）
  rec_data = (typeof(rec_data))heap_caps_malloc(record_length * sizeof(int16_t), MALLOC_CAP_8BIT);
  memset(rec_data, 0, record_length * sizeof(int16_t));  // 0で初期化

  // マイクを開始
  M5.Mic.begin();
}

// --------------------
// 繰り返し処理（メインループ）
// --------------------
void loop(void) {
  M5.delay(1);    // 1ms待機（CPU占有を防ぐ）
  M5.update();    // 入力デバイス更新（ボタンなど）

  // マイクが有効な場合のみ処理
  if (M5.Mic.isEnabled()) {
    int16_t max = 0;  // 最大音量（振幅）を保存する変数

    // 描画の開始（バッチ描画モード：高速化のため）
    M5.Display.startWrite();

    // マイクからデータを録音してrec_dataに格納
    if (M5.Mic.record(rec_data, record_length, record_samplerate)) {
      // 画面の横幅を取得
      int32_t w = M5.Display.width();
      // サンプル数を超えないように制限
      if (w > record_length - 1) {
        w = record_length - 1;
      }

      // 録音データを画面に描画
      for (int32_t x = 0; x < w; ++x) {
        static int16_t prev_y[record_length];  // 前回描画した線のY座標
        static int16_t prev_h[record_length];  // 前回描画した線の高さ

        // 前回描画した線を黒で上書きして消す
        M5.Display.writeFastVLine(x, prev_y[x], prev_h[x], TFT_BLACK);

        // 録音データの振幅を縮小（>> shiftでスケールダウン）
        static constexpr int shift = 6;  // 大きすぎる値を画面に収めるためのシフト値
        int32_t y1 = (rec_data[x] >> shift);       // 現在サンプル
        int32_t y2 = (rec_data[x + 1] >> shift);   // 次のサンプル
        if (y1 > y2) {  // 上下関係を整理
          int32_t tmp = y1;
          y1 = y2;
          y2 = tmp;
        }

        // 画面中央を基準に上下に振幅を描く
        int32_t y = (M5.Display.height() >> 1) + y1;     // 開始位置
        int32_t h = (M5.Display.height() >> 1) + y2 + 1 - y; // 高さ
        prev_y[x] = y;   // 次回消す用に保存
        prev_h[x] = h;   // 次回消す用に保存

        // 白い縦線で波形を描画
        M5.Display.writeFastVLine(x, y, h, TFT_WHITE);

        // 最大音量（絶対値）を記録
        if (max < abs(rec_data[x])) {
          max = abs(rec_data[x]);
        }
      }
    }

    // 最大音量（振幅値）を画面左上に表示
    M5.Display.setCursor(0, 0);
    M5.Log.printf("MAX = %5d\n", max);

    // 描画の終了
    M5.Display.endWrite();
  }
}

#include <M5StickCPlus2.h>  // M5StickC Plus2 専用のライブラリを読み込む
#include <M5Unified.h>  // M5Stackシリーズを統合的に扱えるライブラリ

#include <Avatar.h>
using namespace m5avatar;

Avatar avatar;

// ---------------------------------------------------------
// M5StickC Plus2（横向き setRotation(1) → 240×135）に合わせるための調整値
// Avatar ライブラリは論理座標を 320×240 固定で使うため、
// 縮小率とオフセットを計算しておく。
// ---------------------------------------------------------
static constexpr float SCALE_H_FIT = 135.0f / 240.0f;  // 高さに合わせて縮小（=0.5625）
static constexpr int   POS_TOP     = -(240 - 135) / 2; // 論理高との差分を上方向にシフト（-52）
static constexpr int   POS_LEFT    = -(320 - 240) / 2; // 論理幅との差分を左方向にシフト（-40）
//  この計算は、ライブラリの内部的な座標系（論理座標）と実際の画面サイズ（物理座標）のズレを調整するためのものです。
//m5stack-avatarは縦長の320x240ピクセルを基準に動くため、横長の240x135ピクセルのM5StickC Plus2の画面に収まるように、縮小と中央寄せのオフセット値を計算しています。

// Avatar にスケールと位置をまとめて適用する関数
void fitAvatar() {
  avatar.setScale(SCALE_H_FIT);
  avatar.setPosition(POS_TOP, POS_LEFT);
}

void setup() {
  auto cfg = M5.config();
  M5.begin(cfg);

  // 横向きに設定（解像度 240×135）
  M5.Display.setRotation(1);
  M5.Display.setBrightness(200);      // 画面明るさ
  M5.Display.fillScreen(TFT_BLACK);   // 画面を黒で初期化

  // Avatar の初期化前にスケール・位置を一度設定しておく
  fitAvatar();

  // Avatar 初期化（内部バッファの準備）
  avatar.init();

  // 念のため初期化後にも再設定（initでリセットされる場合があるため）
  fitAvatar();

  // デバッグ用：Avatarの描画領域を白枠で描く
  int drawW = int(320 * SCALE_H_FIT); // 縮小後の幅（=180）
  int drawH = int(240 * SCALE_H_FIT); // 縮小後の高さ（=135）
  int x = (M5.Display.width()  - drawW) / 2; // 中央寄せX（=30）
  int y = (M5.Display.height() - drawH) / 2; // 中央寄せY（=0）
  M5.Display.drawRect(x, y, drawW, drawH, TFT_WHITE);

  // 初期表情はニュートラル
  avatar.setExpression(Expression::Neutral);
}

void loop() {
  M5.update(); // ボタンや状態の更新

  // Aボタンが押された瞬間 → 笑顔に切り替え
  if (M5.BtnA.wasPressed()) avatar.setExpression(Expression::Happy);

  // Bボタンが押された瞬間 → 眠そうな顔に切り替え
  if (M5.BtnB.wasPressed()) avatar.setExpression(Expression::Sleepy);

  // Aを押しっぱなし＋Bを押した瞬間 → 左に1pxずらす
  if (M5.BtnA.isPressed() && M5.BtnB.wasPressed()) {
    static int top = POS_TOP, left = POS_LEFT;
    left -= 1; // 左方向へシフト
    avatar.setPosition(top, left);
  }

  delay(10); // 負荷軽減のための短い待ち
}