今回扱うアイテムは「M5Stack用CamS3 Wi-Fiカメラユニット （OV2640）」。国内では2024年2月5日に発売されました。ESP32S3モジュールをベースにしたカメラで、40×24×11mmというすし一貫ほどの小ぶりなサイズが特徴。Wi-Fi対応のカメラとして、リモートでの監視やタイムラプス撮影が想定されています。

2024年5月17日時点において、スイッチサイエンスでの販売価格は2530円（税込）。CamS3本体のほか、書き込み用のGrove2USB-Cアダプターなどが付属しており、給電さえすればすぐに利用開始できるようになっています。

それでは早速使っていきましょう。CamS3本体のコネクターにケーブルを接続して給電すると、青色のLEDが点灯し、PCやスマートフォンのWi-Fiネットワークに「UnitCamS3-WiFi」が表示されました。

「UnitCamS3-Wifi」に接続した状態でWebブラウザーから「http://192.168.4.1/」にアクセスすると、CamS3のユーザーデモ画面が表示されます。

最上段「Camera」メニューの「Capture」を押すと静止画が、「Stream」を押すとリアルタイムのプレビューが表示されます。

CamS3自体をWi-Fiネットワークと接続すれば、撮影した写真を遠隔地からモニタリングすることもできます。先ほどと同様にユーザーデモ画面を開き、今度は画面下部にある「Image Poster」メニューから「Setup」を選択しましょう。

CamS3を接続するWi-FiのSSIDとパスワード、CamS3のニックネーム、撮影のインターバル（5秒、10秒、30秒、1分、5分、10分、30分から選択可能）、そしてタイムゾーンを設定します。

すると、設定に応じて撮影された画像が表示されるURLとQRコードが発行されます。これはM5Stackの提供するIoTクラウドデータストレージサービス「EzData」を活用したもので、利用にユーザー登録などは不要。PCでもモバイルでも、指定されたURLにアクセスすれば、撮影された最新の画像が表示されます。

このURLにはどこからでもアクセスできるため、CamS3と離れた場所でも周辺の様子を確認できます。リアルタイムとまではいきませんが、その場所に異常がないかなどはチェックできそうですね。

なお、Image Posterモードの実行中に再設定を行うためには、Cam3を再起動してから10秒以内に「UnitCamS3-WiFi」に接続し、再びユーザーでも画面を開く必要があります。最初は戸惑うかもしれないので注意しましょう。

筆者は自宅から少し離れた場所でファブ施設を運営しているのですが、たまに郵便物が扉の隙間に挟まれていたりするので、その様子のチェックにCamS3が役立ちそうです。また、日中どれくらいの人通りがあるのかも気になるので、後から写真で確認できるといいなと思い、こんな作品を作ってみました。

エジプト神話的な目を模したプレートに、CamS3ユニットを取り付け。ImagePoster機能でリアルタイムにモニタリングできるほか、microSDカードにも撮影された写真が保存されていく見守りデバイスです。

デフォルトで書き込まれたプログラムだけでもほぼ十分なのですが、microSDカードへの保存との並行利用に工夫が必要だったので、その内容をお伝えします。

まず記録用のmicroSDカードを準備しましょう。手元に使用済みのmicroSDカードがあったので、macOS Sonoma 14.4.1のディスクユーティリティからフォーマットを行いました。microSDカードをCamS3に差し込んでから起動し、ユーザーデモ画面に接続したのち「SD Card」の「Update」を押すと状態を確認できます。

筆者の場合、「exFAT」でフォーマットした場合「SD Card Not Valid」と表示されてしまいましたが、「MS-DOS（FAT）」で実行すると無事認識されました。お使いのPCやmicroSDカードの仕様に合わせて調整してみてください。

CamS3にデフォルトで書き込まれているファームウェアはGitHubで公開されているので、丸ごとダウンロードしておきましょう。更新や書き込みにはPlatform IOというIDEを利用するため、Visual Studio Codeの拡張パッケージとしてインストールしました。

※以降のプログラムはNANANA氏による「QUICK start: M5Stack CamS3 Unit」を参考にしています。

Platform IOでデフォルトのコードを読み込んだら、firmware > platform.iniを開き、下記のように太字部分を変更、追記します。

[env:m5stack-unitcams3]
platform = espressif32@6.4.0
board = esp32s3box
framework = arduino

board_build.f_cpu = 240000000L
board_build.f_flash = 80000000L
board_build.flash_mode = qio
board_build.flash_size = 16MB

build_flags =
    -DCORE_DEBUG_LEVEL=3
    -DBOARD_HAS_PSRAM
    -DCONFIG_ARDUINO_LOOP_STACK_SIZE=16384
    -DCONFIG_SPIRAM_MODE_OCT=y
    -I./src/mooncake/src/spdlog/include
    -I./src/mooncake/src/
      　 -DARDUINO_USB_CDC_ON_BOOT=1 ; 0を1に変更
      　 -DARDUINO_USB_MODE=1 ; 0を1に変更

board_build.partitions = custom.csv
board_build.filesystem = littlefs

upload_protocol = esptool ; 追記

monitor_filters = esp32_exception_decoder
monitor_speed = 115200

lib_deps = 
    bblanchon/ArduinoJson @ ~6.21.3
    yoursunny/esp32cam @ ^0.0.20240110 ; 追記

platform.iniより一部抜粋。

• 「-DARDUINO_USB_CDC_ON_BOOT=1」「-DARDUINO_USB_MODE=1」へと書き換え（シリアル通信を行うため）
• 「upload_protocol = esptool」を追記（LittleFSのイメージをフラッシュに書き込むため）
• 「yoursunny/esp32cam @ ^0.0.20240110」を追記（esp32camのライブラリを使用するため）

#include <mooncake.h>
#include <Arduino.h>
#include "hal/hal.h"
#include "servers/servers.h"


void setup() 
{
    // Init 
    HAL::hal::GetHal()->init();

    // Start server 
    if (HAL::hal::GetHal()->getConfig().start_poster == "yes")
        UserDemoServers::start_poster_server();
    else if (HAL::hal::GetHal()->getConfig().start_shooter == "yes")
        UserDemoServers::start_shooter_server();
    else 
        UserDemoServers::start_ap_server();
}


void loop() 
{
    delay(5000);
}

main.cppより一部抜粋。

srcディレクトリにあるmain.cppの中身は上記の通り。PosterImageモードなどが設定されていない場合、特にメインループでは何も実行されないようになっています。esp32camのライブラリを活用して、microSDカードへの画像保存を行いましょう。

#include <esp32cam.h> // esp32camのライブラリを追加

// esp32camのピン割り当て
esp32cam::Resolution initialResolution;
constexpr esp32cam::Pins UnitCamS3{
   D0 : 6,
   D1 : 15,
   D2 : 16,
   D3 : 7,
   D4 : 5,
   D5 : 10,
   D6 : 4,
   D7 : 13,
   XCLK : 11,
   PCLK : 12,
   VSYNC : 42,
   HREF : 18,
   SDA : 17,
   SCL : 41,
   RESET : 21,
   PWDN : -1,
};

セットアップとメインループの外でesp32camのライブラリを読み込み、camS3のピンを割り当てていきます。

void loop()
{
   delay(5000);

   // 画像データを取得
   auto frame = esp32cam::capture();
   uint8_t *image_data = frame->data();
   size_t image_size = frame->size();

   // SDカードに画像を保存する処理
   if (HAL::hal::GetHal()->isSdCardValid())
       if (HAL::hal::GetHal()->saveImage(image_data, image_size))
           Serial.println("Image saved successfully!");
       else
           Serial.println("Failed to save Image.");
   else
       Serial.println("SD card is invalid.");
}

メインループの中で5秒に一度、esp32camから画像をキャプチャーし、SDカードに保存する処理を追加しました。SDカードが有効である場合、src > sd > hal_sd.cpp内で定義されたsaveImage関数を利用して、連番を付けて画像が保存されるように設定されています。

CamS3とPCを接続し、Platform IO のUploadからプログラムを書き込みます。製品ページでは「Grove2USB-C を使用してダウンロードする場合は、通電前に付属のオス-オス間ジャンパー線を使用してメスヘッダーのG0ピンとGNDピンを短絡し、ダウンロードモードに移行します。その後、Grove2USB-Cに接続してダウンロードを行います」と表記がありますが、短絡を行わずとも書き込みできました。環境によって異なるのかもしれません。

プログラムを書き込むと、SDカードの /captured/ディレクトリに画像が連番で保存されていく様子がシリアルモニターに表示されました。ある程度時間が経ったら、SDカードを取り出し中身を見てみましょう。

おぉ、無事に筆者がユラユラしている様子が記録されていますね！ 静止画をストックしておいて、後から見返すような使い方ができるようになりました。タイムラプス動画のように編集しても面白そうですね。

前述のプログラムを書き込んだ状態でImagePosterを開始すると、次のようなエラーメッセージが表示され、SDカードへの画像保存に失敗するようになりました。

どうやらImagePosterを始める際のSDカードの初期化あたりで失敗しているようです。今回の用途ではローカルに保存さえされればいいので、src > apis > poster > api_poster.cpp の43-51行にあるSDカードに関するコードをコメントアウトすることで対応できました。

struct PostCallback_SaveSdCard_t : public PostCallback_t
{
   // 下記をコメントアウト
   // void imageCaptured(camera_fb_t* frameBuffer) override
   // {
   //     if (HAL::hal::GetHal()->isSdCardValid())
   //         HAL::hal::GetHal()->saveImage(frameBuffer->buf, frameBuffer->len);
   // }
};

api_poster.cppより一部抜粋。

変更を加えたプログラムはこちらのURLにアップロードしたので、気になる方は確認してみてください。

プログラムが完成したので、最後に簡単な外装を作ってあげましょう。CamS3には背面にLEGOブロック用のマウントがあるので、その形を生かしたマウントを制作。エジプト神話をモチーフにした、いかにも見守ってくれそうな意匠を施しました。夕方から夜にかけて電源をONにしておくと、次のような成果が得られました。