M5ATOMシリースでRTC Unitを使うサンプルプログラム

M5Stack社のM5ATOMシリーズ（Matrix／Lite）でRTC Unitを使ってNTPサーバと同期してRTCに時刻を記録するサンプルプログラムです。VSCode上のPlatformIO環境でビルドできます。

ビルドの設定

platformio.inoの[env]セクションにあるbuild_flagsでENABLE_SERIAL_MONITORを定義すると，common.hにあるシリアル周りのマクロ定義が有効になり，シリアル表示のコードを挿入します。また，MACアドレスを表示するためのマクロ定義も追加されます。このマクロ定義を使ってデバッグ用の表示コードを書いておくと，不要なときは表示コードを挿入しないようにすることができます。

WiFi・NTPサーバの設定

data/settings.jsonに以下のようにWiFiとNTPサーバの設定を書いてSPIFFSに転送することで，M5ATOMのNVS（不揮発記憶装置）に記録し，再起動時にNVSから設定を読み込んでWiFiやNTPサーバに接続できるようになります。

{
    "ssid": "SSID",
    "password": "Password",
    "ntp_server": "ntp.jst.mfeed.ad.jp"
}

settings.jsonをM5ATOMのSPIFFSに転送するには，VSCodeのPlatformIOのプロジェクトタスクから「m5atom/Platform/Upload Filesystem」を選びます。

コマンドラインから実行することもできます。以下のコマンドを実行します。

pio run --target uploadfs

M5ATOMのSPIFFSにファイルが転送されると，M5ATOMが再起動します。 M5ATOMはSPIFFSの/settings.jsonを見つけると，JSONに書かれているキーと値を名前空間RTCUnitのNVSに記録し，settings.jsonを削除します。 これ以降は再起動されるたびにNVSに記録された接続情報を利用してWiFiに接続します。

設定を変更するには，settings.jsonの内容を変更し，再度M5ATOMにファイルを転送してください。