PR

【保存版】はんだ付け不要&高コスパ!M5Stack ATOMシリーズで始める実用電子工作・完全準備ガイド(VSCode + PlatformIO環境構築)

防犯ガジェットDIY
本文中に広告リンクが含まれています

こんにちは!

エンジニアとして日々ものづくりに携わりながら、16歳の娘を持つ父親でもある管理人です。

当ブログ『daybydaydiary.com』では、これまで日々の暮らしに役立つアイデアや実践的なノウハウを発信してきましたが、今回から新しく「M5Stack ATOM(アトム)シリーズを使った、超小型・実用電子工作シリーズ」をスタートします!

「電子工作って興味はあるけれど、何から買えばいいのかわからない」

「はんだ付けの道具を揃えたり、むき出しの基板を扱うのはハードルが高い……」

「せっかく作るなら、カバンに入れて持ち歩けるような実用的なガジェットを作りたい!」

そんな悩みや願いを持つ方に向けて、本記事では「なぜ今、M5Stack ATOMシリーズを選ぶべきなのか?」という理由から、「最初に揃えるべき厳選ハードウェア4選」、そしてプロの現場でも使われる「VSCode + PlatformIOの最強開発環境構築」まで、一切の妥協なしで徹底解説します。

この記事を手元の「教科書(ハブ記事)」としてブックマークしておけば、これから当ブログで公開していく「紛失防止タグ(AirTag等)の接近検知スキャナー」や「持ち運び可能な防犯・安全ガジェット」など、すべての工作プロジェクトにスムーズに挑戦できるようになります!

  1. 1. なぜ数あるマイコンの中で「M5Stack ATOMシリーズ」一択なのか?
    1. ① 最初から「綺麗なプラスチック筐体(ケース)」に入っている
    2. ② 「はんだ付け不要」で拡張できるエコシステム
    3. ③ 圧倒的なコストパフォーマンス(1,000円台〜2,000円台)
    4. ④ 最新の「ESP32-S3」チップ搭載で処理能力が高い
  2. 2. 本シリーズで使う「厳選ハードウェア4選」と選び方
    1. ① ATOMS3R (8MB PSRAM搭載) —— 液晶画面&大容量メモリを備えた最強の頭脳
    2. ② ATOMS3 Lite —— コスパ最強!シンプル&軽量なベース機
    3. ③ ATOM TailBAT —— はんだ付けゼロでコードレス化する魔法のバッテリー
    4. ④ ATOMICプロトキット —— ブザーや独自回路をケース内に完全内蔵する拡張キット
    5. 【比較まとめ】どれから買えばいい?
  3. 3. 開発環境の構築:なぜ「Arduino IDE」ではなく「VSCode + PlatformIO」なのか?
  4. 4. 【実践】VSCode + PlatformIO 導入ステップ(Windows / Mac共通)
    1. ステップ1:Visual Studio Code (VSCode) のインストール
    2. ステップ2:PlatformIO IDE 拡張機能のインストール
    3. ステップ3:新規プロジェクトの作成(ベース作成)
  5. 5. 【最重要】機種別 platformio.ini 設定ファイル(コピペ用)
    1. ① ATOMS3R (8MB PSRAM搭載) 用の設定
    2. ② ATOMS3 Lite 用の設定
  6. 6. 動作確認:最初のプログラムを書き込んでみよう!
    1. テスト用プログラム(src/main.cpp)
    2. 書き込み(Upload)の手順と「書き込みモード」のコツ
  7. 7. 次回予告とこれからの電子工作ロードマップ

1. なぜ数あるマイコンの中で「M5Stack ATOMシリーズ」一択なのか?

世の中には、Arduino(アルドゥイーノ)やRaspberry Pi(ラズベリーパイ)、あるいは秋月電子などで買えるむき出しのESP32開発ボードなど、数多くのマイコンボードが存在します。

それにもかかわらず、私が今回のシリーズで「M5Stack ATOMシリーズ」を主役に選んだのには、明確な4つの理由があります。

① 最初から「綺麗なプラスチック筐体(ケース)」に入っている

一般的な電子工作で一番挫折しやすいのが、実はプログラムではなく「ケース加工」です。

むき出しの緑色の基板に配線しただけでは、カバンに入れた瞬間にショートしたり、線が抜けたりして実用になりません。

M5StackのATOMシリーズは、わずか24mm × 24mm(親指の爪〜500円玉程度)という極小サイズでありながら、最初から洗練されたデザインのプラスチックケースに収まっています。

作ったその日から、市販品のような見た目で持ち歩くことができます。

② 「はんだ付け不要」で拡張できるエコシステム

ATOMシリーズには、本体底面のピンソケットや、側面にある「Grove(グローブ)互換ポート」が備わっています。

専用バッテリーやセンサーを「ブロックのようにパチッと合体させるだけ」でハードウェアが完成するため、火傷の心配があるはんだごてを握る必要がありません。

もちろん、慣れてきたら専用のプロトキットを使って本格的な内蔵工作にステップアップすることも可能です。

③ 圧倒的なコストパフォーマンス(1,000円台〜2,000円台)

これだけ高機能なWi-Fi / Bluetooth(BLE)搭載マイコンでありながら、1個あたり2,000円台〜3,000円台という驚異的な安さで入手できます。

「万が一壊しても買い直せる」「家族の人数分作れる」という気楽さは、実用ガジェットを作る上で最大の武器になります。

④ 最新の「ESP32-S3」チップ搭載で処理能力が高い

今回採用する最新世代の「ATOMS3」シリーズは、デュアルコアの高性能プロセッサ(ESP32-S3)を搭載しています。

単なるLチカ(LEDを光らせるだけの工作)にとどまらず、高速なBluetooth電波スキャン、液晶画面へのグラフィック描画、さらにはセンサーデータの高度な処理まで余裕でこなします。

2. 本シリーズで使う「厳選ハードウェア4選」と選び方

M5Stack ATOMシリーズにはいくつかバリエーションがありますが、当ブログの工作プロジェクトでは以下の4つのアイテムを軸に展開していきます。

まずはそれぞれの特徴と役割を把握し、ご自身の目的に合わせて揃えてみてください。

① ATOMS3R (8MB PSRAM搭載) —— 液晶画面&大容量メモリを備えた最強の頭脳

【特徴と強み】
24mm四方の極小ボディの前面に、0.85インチの鮮やかなカラー液晶ディスプレイと、押し込み可能なボタンを搭載した上位モデルです。
最大の武器は、「8MBのPSRAM(疑似SRAM)」を搭載している点にあります。
マイコン開発においてメモリ不足は致命的なエラーの原因になりますが、8MBという広大なメモリ空間があることで、画面に日本語やアイコンを美しく表示したり、大量の通信データをバッファリングしたりといった高度な処理が安定して動作します。
また、9軸IMU(加速度・ジャイロ・地磁気センサー)も内蔵しているため、振ったり傾けたりする動作を検知するガジェットもこれ1台で作れます。

【こんな工作に使います】

  • 電波の強度や検知したデバイスの名前を画面にリアルタイム表示する高性能スキャナー
  • 傾きや振動を検知して作動するスマート防犯アラーム

② ATOMS3 Lite —— コスパ最強!シンプル&軽量なベース機

【特徴と強み】
ATOMS3Rから液晶画面とセンサー類を省き、その分価格をグッと抑えたシンプルモデルです。
画面がない代わりに、本体中央にフルカラーLED(RGB LED)と物理ボタンを備えています。
「画面で細かい文字を見る必要はなく、LEDの色(緑・黄・赤など)で直感的に状態がわかれば十分!」という用途であれば、このATOMS3 Liteが最もコストパフォーマンスに優れています。
消費電力も少なく、バッテリー駆動の携帯ガジェットに最適です。

【こんな工作に使います】

  • カバンに入れておき、LEDの色変化で危険を知らせる超小型BLEタグ探知機(基本編)
  • ボタン1つで動作するシンプル操作のIoTリモコン・通知デバイス

③ ATOM TailBAT —— はんだ付けゼロでコードレス化する魔法のバッテリー

【特徴と強み】
「作ったガジェットを外に持ち歩きたい!」と思った時に必須となるのが電源です。
通常、マイコンにリチウムイオン電池を繋ぐには充電回路や昇圧回路の工作が必要になりますが、この「ATOM TailBAT」があればすべて解決します。
ATOM本体のUSB-Cポート(お尻の部分)にグッと差し込むだけで、内蔵の190mAhバッテリーから電力を供給し、完全ワイヤレスで動作させることができます。
電源スイッチや充電用USB-Cポート、バッテリー残量を示すLEDも搭載されているため、まさに「はんだ付けゼロ」を実現する神アイテムです。

【注意点】
※ATOMS3シリーズ(S3R / S3 Lite)と組み合わせて使う場合、物理的な接続や給電仕様の相性、および充電時の挙動を確認しながら運用します(詳細は各工作記事で実機検証とともに解説します)。

④ ATOMICプロトキット —— ブザーや独自回路をケース内に完全内蔵する拡張キット

【特徴と強み】
「基本工作に慣れてきたので、カバンの中でも聞こえるように警告ブザー(音)を追加したい!」
「センサーを外付けではなく、ケースの中に綺麗に収めて市販品のように仕上げたい!」
そんなステップアップの願いを叶えてくれるのが、この「ATOMICプロトキット」です。
ATOMの底面にぴったり合体する専用プラスチックケースと、内部に収まる極小のユニバーサル基板(プロト基板)、接続用ピンヘッダーがセットになっています。
はんだ付けは必要になりますが、完成した時の「24mm四方の箱にすべての機能が凝縮された一体感」は、電子工作ならではの最高の達成感を味わえます。

【比較まとめ】どれから買えばいい?

製品名主な役割液晶画面価格帯目安こんな人におすすめ
ATOMS3R (8MB PSRAM)高機能メイン機あり (0.85型)約3,500円前後画面に情報を表示したい・メモリ不足に悩みたくない人
ATOMS3 Lite軽量・コスパ機なし (RGB LED)約2,000円前後まずは安く始めたい・LEDの光でシンプルに判定したい人
ATOM TailBAT外付けバッテリー―約1,800円前後はんだ付けなしで、すぐに持ち歩ける電池駆動にしたい人
ATOMICプロトキット内蔵用拡張ケース―約700円前後ブザーや電子部品をケースの中に綺麗に内蔵したい人

💡 最初のおすすめセット
まずは「ATOMS3 Lite」(または画面付きの「ATOMS3R」)と、「ATOM TailBAT」、そしてデータ通信対応の「USB Type-Cケーブル」を揃えるのがおすすめです。
これだけで、はんだ付けゼロの携帯ガジェット製作がすぐに始められます!

3. 開発環境の構築:なぜ「Arduino IDE」ではなく「VSCode + PlatformIO」なのか?

マイコンのプログラミング環境といえば、初心者向けの「Arduino IDE」が有名です。
しかし、当ブログのシリーズでは、最初から「VSCode(Visual Studio Code) + PlatformIO(プラットフォーム・アイオー)」という開発環境を採用します。

「いきなりプロ向けのツールは難しそう……」と感じるかもしれませんが、実は初心者こそVSCode + PlatformIOを使うべき明確な理由があります。

  1. プロジェクトごとに設定とライブラリを完全分離できる
    Arduino IDEはパソコン全体で1つの環境を共有するため、別の工作を始めると「ライブラリのバージョンが衝突して急にコンパイルできなくなった!」というトラブルが頻発します。
    PlatformIOなら、工作プロジェクトごとに設定ファイル(platformio.ini)が独立しているため、環境が壊れる心配がありません。
  2. 「コピペするだけ」で誰でも同じ環境を100%再現できる
    これが最大のメリットです。
    ブログで紹介する設定コード(後述)をそのまま貼り付けるだけで、必要なボード定義や最新の公式ライブラリ(M5Unified)が自動的にダウンロードされ、環境構築のつまずきをゼロにできます。
  3. 入力補完(インテリセンス)が強力でミスが減る
    プログラムを書いている途中で関数の候補を自動表示してくれるため、スペルミスによるエラーが激減し、学習スピードが格段に上がります。

4. 【実践】VSCode + PlatformIO 導入ステップ(Windows / Mac共通)

それでは、実際にパソコンへ開発環境をインストールしていきましょう。所要時間は約15分〜20分です。

ステップ1:Visual Studio Code (VSCode) のインストール

  1. Visual Studio Code 公式サイト にアクセスし、お使いのOS(Windows または macOS)用のインストーラーをダウンロードします。
  2. ダウンロードしたファイルを実行し、画面の指示に従ってインストールを完了させます。
  3. VSCodeを起動したら、左側のメニューにある四角いブロックのアイコン(Extensions / 拡張機能)をクリックし、検索窓に Japanese と入力して「Japanese Language Pack for Visual Studio Code」をインストールします。右下に表示される「Change Language and Restart」を押すと、メニューがすべて日本語になります。

ステップ2:PlatformIO IDE 拡張機能のインストール

  1. 再び左側の「拡張機能(四角いブロックアイコン)」をクリックします。
  2. 検索窓に PlatformIO IDE と入力します。
  3. 蟻(アリ)のようなオレンジ色のアイコンが表示されたら、「インストール」をクリックします。
  4. インストールには数分かかります。画面右下に「PlatformIO: Installing…」と表示されている間はVSCodeを閉じずに待ち、「Please restart VSCode(再起動してください)」と表示されたら「Reload Now(今すぐ再起動)」をクリックします。

⚠️ Windowsユーザーへの補足(Pythonについて)
PlatformIOの初回起動時、バックグラウンドで専用のPython環境やビルドツールが自動ダウンロードされます。
左下のステータスバーにある回転アイコンが止まるまで、コーヒーでも飲みながら数分待機してください。

ステップ3:新規プロジェクトの作成(ベース作成)

再起動後、左側のメニューに「蟻のアイコン(PlatformIO)」が追加されています。

  1. 蟻のアイコンをクリックし、「PIO Home」>「Open」をクリックします。
  2. ホーム画面の右側にある「+ New Project」をクリックします。
  3. プロジェクト作成画面で、以下のように入力します(ボード設定はあとで専用コードに書き換えるため、ここでは仮の選択で構いません)。
    • Name(プロジェクト名):ATOM_Test など(半角英数字推奨)
    • Board(ボード):Espressif ESP32-S3-DevKitC-1 を選択
    • Framework(フレームワーク):Arduino を選択
  4. 「Finish」をクリックします。初回はボードデータのダウンロードが行われるため、少し時間がかかります。

5. 【最重要】機種別 platformio.ini 設定ファイル(コピペ用)

プロジェクトが作成されると、左側のファイル一覧(エクスプローラー)の中に platformio.ini という名前の設定ファイルが生成されています。

このファイルこそが、PlatformIOの心臓部です。 お使いのマイコン(ATOMS3R または ATOMS3 Lite)に合わせて、platformio.ini の中身をすべて消去し、以下のコードをそのままコピー&ペーストして保存(Ctrl+S / Cmd+S)してください。

① ATOMS3R (8MB PSRAM搭載) 用の設定

8MBの広大なPSRAMをフル活用し、USB経由での高速書き込みやシリアル通信(デバッグ出力)を安定させるための最適設定です。

[env:m5stack-atoms3r]
platform = espressif32@6.7.0
board = esp32-s3-devkitc-1
framework = arduino
board_build.arduino.memory_type = qio_opi
build_flags =
    -DESP32S3
    -DBOARD_HAS_PSRAM
    -mfix-esp32-psram-cache-issue
    -DCORE_DEBUG_LEVEL=5
    -DARDUINO_USB_CDC_ON_BOOT=1
    -DARDUINO_USB_MODE=1
lib_deps =
    M5Unified=https://github.com/m5stack/M5Unified

【エンジニアによる設定のポイント解説】

  • platform = espressif32@6.7.0:ESP32-S3およびATOMS3Rのハードウェア制御が最も安定して動作するプラットフォームバージョンを指定しています。
  • board_build.arduino.memory_type = qio_opi & -DBOARD_HAS_PSRAM:ここが最重要です! ATOMS3Rに搭載されている8MBのPSRAM(Octal PSRAM)をArduinoフレームワークから正しく認識・使用するための必須指定です。これがないと大容量メモリが有効になりません。
  • -DARDUINO_USB_CDC_ON_BOOT=1:ESP32-S3特有の「USBシリアル変換チップを介さず、マイコン自体が直接USB通信を行う」仕様に対応させる設定です。これを入れておかないと、Serial.println() によるパソコン画面へのデバッグ文字出力が表示されなくなります。
  • lib_deps = M5Unified=...:M5Stack公式の最新統合ライブラリ「M5Unified」をGitHubから自動取得します。

② ATOMS3 Lite 用の設定

PSRAM非搭載のATOMS3 Lite向けに最適化し、書き込み速度(1.5Mbps)を引き上げて開発テンポを快適にする設定です。

[env:m5stack-atoms3]
platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino
upload_speed = 1500000
monitor_speed = 115200
build_flags =
    -DESP32S3
    -DCORE_DEBUG_LEVEL=5
    -DARDUINO_USB_CDC_ON_BOOT=1
    -DARDUINO_USB_MODE=1
lib_deps =
    M5Unified=https://github.com/m5stack/M5Unified

【エンジニアによる設定のポイント解説】

  • upload_speed = 1500000:USB-CDC直結の利点を活かし、プログラムの書き込み速度を高速化しています。数秒で書き込みが完了するため、試行錯誤のストレスがありません。
  • monitor_speed = 115200:シリアルモニター(パソコン側でマイコンの動作ログを見る画面)の通信速度を標準的な 115200bps に固定しています。

6. 動作確認:最初のプログラムを書き込んでみよう!

設定ファイルを保存すると、PlatformIOが自動的に M5Unified ライブラリのダウンロードを開始します。右下のインジケーターが落ち着いたら、実際にATOMをパソコンに繋いでテストプログラムを動かしてみましょう!

テスト用プログラム(src/main.cpp)

左側のファイル一覧から src フォルダを開き、その中にある main.cpp をクリックして開きます。中身をすべて消して、以下のコードを貼り付けてください。

#include <M5Unified.h>

void setup() {
    // M5Stackデバイスの初期化(ATOMS3RもATOMS3 Liteも自動で判別します!)
    auto cfg = M5.config();
    M5.begin(cfg);

    // シリアル通信の開始(パソコン画面へのログ出力用)
    Serial.begin(115200);
    delay(1000);
    Serial.println("=== M5Stack ATOM 起動テスト成功! ===");

    // 液晶画面がある場合(ATOMS3R)は画面に文字を表示
    if (M5.Display.width() > 0) {
        M5.Display.setRotation(0);
        M5.Display.fillScreen(TFT_BLACK);
        M5.Display.setTextColor(TFT_GREEN, TFT_BLACK);
        M5.Display.setTextSize(2);
        M5.Display.setCursor(10, 20);
        M5.Display.println("ATOMS3R");
        M5.Display.println("READY!");
    }
}

void loop() {
    // ボタンの状態などを最新に更新
    M5.update();

    // 本体ボタンが押された時の処理
    if (M5.BtnA.wasPressed()) {
        Serial.println("ボタンが押されました!");
        
        // 画面がある場合は背景色をランダムに変更
        if (M5.Display.width() > 0) {
            M5.Display.fillScreen(random(0xFFFF));
            M5.Display.setCursor(10, 50);
            M5.Display.setTextColor(TFT_WHITE);
            M5.Display.println("PRESSED!");
        }
    }

    delay(10);
}

書き込み(Upload)の手順と「書き込みモード」のコツ

  1. パソコンとATOM(ATOMS3R または ATOMS3 Lite)を、データ通信対応のUSB Type-Cケーブルで接続します。
    • ※100円ショップなどの「充電専用ケーブル」では認識されないのでご注意ください!
  2. VSCode画面の一番下にある青いステータスバーから、右向き矢印アイコン(→:Upload)をクリックします。
  3. コンパイル(プログラムの翻訳)が始まり、数秒〜数十秒後に自動的にATOMへ書き込まれます。
  4. 書き込みが完了したら、ステータスバーのコンセントプラグアイコン(Serial Monitor)をクリックすると、パソコン画面に === M5Stack ATOM 起動テスト成功! === と表示され、本体の画面(ボタンを押すと色が変わる動作)が動き出します!

💡 もし書き込みエラー(Failed to connect…)が出たら?
ESP32-S3チップ搭載のATOMシリーズは、初回や特殊なプログラム動作中に書き込みがうまくいかないことがあります。
その場合は、「本体側面(または底面付近)にある小さなリセットボタンを、緑色のLEDが点灯するまで2秒ほど長押し」してダウンロードモード(緑ランプ点灯状態)にしてから、もう一度 →(Upload) ボタンを押してみてください。
確実に書き込めます!

7. 次回予告とこれからの電子工作ロードマップ

お疲れ様でした!ここまで完了すれば、あなたのパソコンと手元のATOMシリーズは、いつでも実用ガジェットを生み出せる最強の状態になっています。

これからの『daybydaydiary.com』電子工作シリーズでは、この準備環境をベースに、以下のような「暮らしと家族の安全を守る実用ガジェット」を順を追って公開していきます。

  • 【第1弾:基本工作】はんだ付けゼロ!ATOMS3 Lite + TailBATで作る「紛失防止タグ(AirTag等)接近スキャナー」
    • 通学カバンや自転車に不審なタグが仕掛けられていないか、LEDの光で直感的にチェックできる携帯探知機の作り方。
  • 【第2弾:液晶モデル】ATOMS3R (8MB PSRAM) で作る「電波強度・デバイス情報リアルタイム可視化モニター」
    • 0.85インチ画面を活かし、周囲のBLEデバイスの信号強度(RSSI)をグラフや数値で表示する本格スキャナー。
  • 【第3弾:ケース内蔵工作】ATOMICプロトキットを使って「警告ブザー」を24mmケース内に完全内蔵するカスタム術
    • カバンの中に入れたままでも音で危険を知らせる、実寸設計・はんだ付け実践ガイド。

まずはぜひ、気になるATOM本体とUSBケーブルを手元に用意して、今回の「起動テスト」を動かしてみてください。

小さな箱が自分の書いたプログラム通りに動いた瞬間の感動を、一緒に味わっていきましょう!