Cardputer ファーム書き込み・プログラム配信

1. UiFlow2 ファームウェアの書き込み

UiFlow2 Web IDE チュートリアルを参照して UiFlow2 の基本的な使い方を確認し、M5Burner ファームウェア書き込みツールをインストールします。
M5Burner で Cardputer に対応したファームウェアをダウンロードします。

Cardputer 側面の電源スイッチを OFF にし、電源投入前に G0 ボタンを押したままにします。デバイスに電源が入った後にボタンを離すと、デバイスはダウンロードモードに入ります。

デバイスを USB ケーブルで PC に接続します。M5Burner で対象ファームウェアの Burn ボタンをクリックし、対応するデバイスポートを選択して Start をクリックします。

デバイスが接続する Wi-Fi 設定（Wi-Fi SSID、Wi-Fi Password）および追加・変更が必要なデバイス設定を入力し、Next をクリックして書き込みを開始します。

設定情報：

COM：デバイスに対応するシリアルポートを選択
BaudRate：シリアル通信のボーレート
Server：デバイスが接続するサーバーアドレス
WIFI SSID/WIFI Password：デバイスが接続する Wi-Fi 名とパスワード
SNTP サーバー：
- SNTP0：アリクラウド NTP サーバー（中国）
- SNTP1：日本の NTP サーバープール
- SNTP2：グローバル公開 NTP サーバープール
Timezone：タイムゾーン設定
Boot Option：ファームウェア書き込み完了後の起動モードを設定
- Run main.py directly：書き込み完了後、main.py 内のプログラムを直接実行します。ネットワークには接続せず、UiFlow2 の起動画面も表示しません
- Show startup menu and network setup：デバイスがネットワークに接続し、画面付きデバイスでは UiFlow2 の起動画面を表示します
- Only network setup：デバイスはネットワーク接続のみを行い、UiFlow2 の起動画面は表示しません

Burn successfully, click here to return と表示されたら、書き込み成功です。この時点でデバイスをリセットしてください。

ファームウェア書き込み完了後にデバイス設定を変更する場合は、USB 接続を維持したままデバイスを再起動し、Configure をクリックして画面の指示に従って変更します。

2. デバイス接続

デバイスは Access Code（無線ネットワーク経由）または USB（PC との有線接続）で UiFlow2 に接続し、プログラムの送信とデバッグを行えます。詳しい手順は以下を参照してください。

Access Code ワイヤレス接続

接続前に、デバイスがネットワークに接続済みであることを確認してください。ネットワークに接続していない場合は、ファームウェア書き込み時に入力した Wi-Fi 名とパスワードが正しいか確認し、M5Burner の Configure で修正してから再度書き込んでください。

デバイスの UiFlow2 起動画面で、現在生成されている有効な Access Code を確認します。

uiflow2.m5stack.com にアクセスし、UiFlow2 Web IDE を開きます。
ページ上の Select Your Controller（初回表示）または Controller ボタンをクリックし、Select Device ページに入ります。

Connect Device をクリックし、アクセスコードと任意のデバイス名を入力して Confirm をクリックすると、Cardputer を UiFlow2 に接続できます。

Select Device ページで接続済みの Cardputer デバイスを選択し、Confirm をクリックすると UiFlow2 のプログラミング画面に入れます。

USB 有線接続

uiflow2.m5stack.com にアクセスして UiFlow2 Web IDE を開き、Cardputer を USB Type-C ケーブルで PC に接続します。
ページ上の Select Your Controller（初回表示）または Controller ボタンをクリックし、Select Device ページに入ります。

デバイス一覧から Cardputer を選択し、Confirm をクリックします。

WebTerminal ボタンをクリックし、ポップアップで Cardputer のシリアルポートを選択して 接続 をクリックします。

WebTerminal 画面に Connected to Serial Port! と表示されたら、USB 接続は成功です。

3. プログラム実行とダウンロード

デバイスを UiFlow2 に接続すると、Blockly をドラッグしてプログラムを編集できます。

プログラム編集後、画面右下の Run Once ボタンをクリックするとテストプログラムを一度だけ実行できます。Run Always ボタンをクリックすると、プログラムをデバイスにダウンロードできます。

WebTerminal ウィンドウからも、一度だけ実行したりプログラムをダウンロードしたりできます。

4. 関連リンク

UiFlow2 ファームウェアメイン画面の機能モジュール説明

UiFlow2 プログラムには 5 つの機能モジュールがあります

DEVELOP：現在のデバイスの基本情報（MAC アドレスなど）を表示します。
APP.RUN：UiFlow2 でダウンロードしたプログラムの実行モードを設定します。
APP.LIST：保存済みプログラム一覧を管理します。
EZDATA：クラウドとのデータ連携機能を提供し、データのアップロードと同期に対応します。
SETTING：画面輝度調整や Wi-Fi ネットワーク設定など、デバイスの一般的なシステム設定をまとめて管理します。

デバイス（Cardputer）起動後、キーボードはデフォルトで低消費電力スリープ状態になります。キーボード入力機能を有効にするには、次の操作を同時に行う必要があります。左手でキーボードの fn キーを押し続けてキーボードを起動し、右手で実行したいキーを押します。この操作により、キーボードが正常に有効化され、その後の入力に応答できるようになります。詳しい操作方法は公式ドキュメントを参照してください。

DEVELOP
- デバイス MAC アドレス
- デバイスの基本情報

APP.RUN
- UiFlow2 で編集したプログラムをデバイスにダウンロードすると、システムはそのプログラムを APP.RUN ディレクトリ内の main.py ファイルに自動的に書き込み（既存内容を上書き）、すぐに実行します
- 別の方法（手動インポートなど）で APP.RUN ディレクトリに main.py という名前のプログラムを追加した場合も、デバイス上の RUN(ONCE) または RUN(ALWAYS) オプションで一度だけ実行、または継続実行できます

注意：main.py は削除できません。削除すると APP.RUN に入った際にデバイスがフリーズします。UiFlow2 プログラムの書き込みまたは main.py プログラムの実行後は、UiFlow2 のメイン画面に戻れません。再度 M5Burner で Configure 設定を行い、ファームウェアを更新する必要があります。

APP.LIST
- UiFlow2 開発に慣れたら、任意のコードエディタで Python プログラムを手動作成できます。UiFlow2 画面左下の WebTerminal をクリックし、USB でデバイスに接続して file フォルダを開き、プログラムファイルをデバイスの /flash/apps ディレクトリにインポートします。このディレクトリ内のファイルは、デバイス起動後いつでもテストおよび実行できます