
ESP32-C3 がArduino IDE for MACで苦戦した話

ESP32の仲間で、ESP32-C3というのがあります。シングルコアですがクロック160MHz、Flash 4M となっており、Wi-Fi、Bluetoothも対応しているが、これは技適は取れていないようです。似たような形状のものが多く販売されていますが、秋月電子にもXIAOシリーズとして、色々なものが販売されているようです。(こちらは技適あり) 技適はなくてもコントローラーとして使う分には何ら問題ないでしょう。アリエクスプレスで買い物のついでに購入してみました。1個370円、はんだ付けが嫌いな人用に、ブレッドボード用のピンがはんだ付けしてあるものは30円くらい高くなっています。USBインターフェースも内蔵ということなので、特に目的はなかったのですが、2個購入。
ただArduinoIDEと繋ぐのに一苦労しました。まずデバイスを認識しない。ボードマネージャーでは ESP32-C3 Devmodule が出てくるが、グレーアウトしていて選べない。USBドライバーがいるのか?ここからGemini先生にお伺いしました。
ESP32-C3チップ自体に内蔵されている内蔵USBシリアル(JTAG/Serial)機能を使用してPCと直接通信するため、専用の外部ドライバーを追加でインストールする必要はありません。Windows 10/11やMac、Linuxであれば、標準の「USB CDCシリアルデバイス」ドライバーで自動認識されます。
とのこと。ここで、結論を先に言っておくと、以下のようにすれば問題なく認識できた可能性があります。(色々やってみてわかったこと)
1)Arduino IDE で新規スケッチを選び、何もコードが入っていない状態(setupとloopだけ)でコンパイル+書き込み(→)を行います。ここでエラーが出てコンパイルもできない場合はこの方法はダメです。
2)コンパイルが終わったタイミングでボードの「BOOT」ボタンを押します。押したまま、「Connecting・・・」が出るのを待ち、出たら、「BOOT」を押したまま、「RESET」を一回押す。その後、「 BOOT」を離します。
3)書き込み動作が終了し、”Hard resetting via RTS pin...”が出れば成功です。
4)ボードが認識できれば、「スケッチ例」が出ますので、BLINKを選んでみます。このボードのGPIOに接続されたLED(青)はGPIO8なので、#define LED_BUILTIN 8を追記するか、LED_BUILTINを8に書き換えてしまえばいいでしょう。私の場合は#defineしたら、「定義済みです」のwarningが出ましたが、そのままコンパイルできました。(以前、Gemini先生に「warningは警告なので、そのまま進めても構わない」と教えてもらったことがあります。)
5)書き込みが終了するとLED(青)が1秒ごとに点滅するようになるはずなのですが、新しいボード(初めて書き込みを行う)の場合、書き込み終了しても、点滅しませんでした。そこで「RESET」を一回押します。押した後は問題なく動作します。その後は書き込みを終えればすぐに動作します。なぜかは不明ですが、ボードの「癖」みたいなものかも?
実は私のMac(iMacとMacBook Air)どちらもうまく動作せず、Gemini先生とのやりとりが延々2時間ぐらい続きました。途中経過は省略。ややあきらめて、風呂、食事の後、「もしかしたらWindowsでは動くのではないか?」という気がしてきました。私のWindows のnote PCはだましですがWin11でArduinoIDE2.3.10がインストールしてあり、普段は使っていないのですが、このような場合のためにあります。
これも結論から言うと、うまく動きました。Windowsではボードはすぐに認識できました。ただ最初の書き込み後にリセットをしなければならないのは同じでした。
Gemini先生にそのことをお伝えしたところ、以下のようなお答えでした。
質問:
よく理由はわからないのですが、Windows11のIDEでは問題なく書き込めました。書き込めたボードをiMacのIDEで確認したら、問題なく動きました。
お答え:
無事に書き込みが成功し、iMacでも動作が確認できて本当に良かったです!理由がわからずモヤモヤされるかもしれませんが、これはESP32-C3の「内蔵USB機能」と「macOSの仕様」が引き起こす非常に有名な定番の現象です。
今後のためにも、なぜWindowsで一度書き込んだらiMacでも動くようになったのか、その理由を簡単にご説明します。原因がわかれば、次回からMacだけでも対処できるようになります。
なぜWindowsで書き込んだら直ったのか?
原因は、ESP32-C3の工場出荷時に書き込まれている「初期プログラム(ブートローダー)」と、MacのUSB管理の相性にありました。
工場出荷時の状態(認識しない)
新品のESP32-C3 SuperMiniは、Macから見ると「USBの規格に100%正しく準拠していない、怪しい低速デバイス」のように見えてしまいます。厳格なmacOSは、安全のためにこの接続を遮断(グレーアウト)してしまいます。Windowsでの書き込み(修正)
WindowsはUSBの規格に対してMacよりも寛容なため、初期状態のボードでも問題なく認識して書き込みができました。Arduino IDEから「正しい設定」が書き込まれた
Windowsで書き込んだ際、Arduino IDEの設定(USB CDC On Boot = Enabled など)が含まれたプログラムがボードに上書きされました。これにより、ボードが「Macの規格にも100%適合する、正しいUSBシリアルデバイス」に変身したのです。Macで認識(解決)
変身したボードをiMacに繋いだため、Mac側も「あ、これは安全なUSBデバイスだ」と判断し、今度はグレーアウトせずに正常に認識・通信ができるようになりました。
今後のアドバイス(Macで開発を続ける場合)
今後はボードのUSB機能が正しくアップデートされているため、iMacだけでそのまま上書きロード(修正して書き込み)が可能です。
ただし、プログラムのバグなどで内部が暴走し、再びMacでグレーアウトしてしまった場合は、以下の手順でMac単体でも復帰できます。
プログラムを書き込む前に、以前お伝えした「BOOTボタンを押しながらRSTを押し、BOOTを離す(手動ブートモード)」を必ず行う。
その状態(ポートがうっすら出る、または黒文字で出る状態)のまま、Arduino IDEで「Upload(書き込み)」ボタンを先に押してしまう。
(※Macは書き込みが始まった瞬間にポートをパッと掴んでくれる性質があります)
ひとまずはWindows環境という回避策が見つかり、ボード自体も初期不良ではないことが分かって一安心ですね。
もし今後、iMacでの上書き時にエラーが出るなど、別のトラブルやエラーメッセージが発生した場合は、いつでもお気軽にご相談ください!
『「非常に有名な定番の現象」だったら最初に教えてくださいよ、先生!』今ひとつ不安なところがあるのですが、とりあえず一通りの現象を経験して、次には進めそうです。
ところで、技適はないので使えないのですが、この小さなチップの上のWi-Fiのアンテナはどこにあるのでしょうか?

デバイスはESP32のチップと40MHzの水晶、LLVBとレーザー刻印されたチップがありますが、これは3.3Vの電源ICであることはわかりました。(5V供給でmax250mAも取れる)
上記画像右側にあるC3というのの上下に幅3mm長さ18mmくらいのパターンがレジストの下にあります。C3というのはコンデンサーではなく、積層基盤のような感じなので、これとパターンで2.4GHzのアンテナを形成しているのかもしれません。
以前ココログにも投稿記事を書いたことがあるのですが
「ESP32には闇と沼」がある。
追記:(Gemini先生による)
1. ESP32C3 SuperMini は"USB CDC On Boot" を"Enable"にしてコンパイルしないと、シリアルモニターに出力が出ない仕様になっている。
2. ESP32-C3の GPIO 6 と GPIO 7 は、チップがプログラムを読み出すための重要なピンとして予約されており、基本的にはユーザーが通常のGPIOとして使用することができません。ここに外部のICをつなぐと、プログラムの読み込み自体が阻害されるか、正しく信号が出力されなくなります。(えっ、ほんとかい?!)
追記の補足(2026/9/5)
ESP32C3 SuperMiniのGPIO6と7はSPIインターフェースのMOSIとSS専用に割り当てられていて、他のGPIOと同様には設定できないようです。ただし、試してみたところ、GPIO7は出力としては設定して動きました。
GPIO8にはブルーのLEDが接続されています。GPIOをLOWにすると、LEDが点灯します。GPIO8をHIGHにした状態で端子電圧を測定すると、約2.6Vでした。