UZU ROASTER コマンドリファレンスガイド

コマンド一覧表

Version 1.1.1

📘 はじめに

このコマンド一覧表は、UZU ROASTERを操作する際に使用できるコマンドをまとめたものです。コマンドは、USBシリアル通信またはWeb画面（WebSerial）から送信することができます。

※ コマンドを入力する際は、半角英数字で正確に入力してください。大文字・小文字は区別されません。 ※ 今後のファームウェアアップデートでコマンドが追加・変更される可能性があります。最新のコマンドは "help" コマンドで確認してください。 ※ これらのコマンドはコーヒー焙煎・ミル挽き・抽出コントロールシステムであるUZCP 1.0.0（Universal Zeta Coffee Protocol）に一部準拠しています。

🔧 基本操作コマンド

コマンド	使用例	説明
help	`help`	使用可能なコマンドの一覧を表示します。困ったときはこのコマンドで確認できます。
start	`start`	温度測定を開始します。USBシリアル経由で経過時間と温度データ（JSON形式）の出力が始まります。
stop	`stop`	温度測定を停止します。USBシリアル経由で経過時間と温度データ（JSON形式）の出力が止まります。
status status -h	`status` `status -h`	UZU ROASTERの内部状態を表示します。WiFi・温度・LED・ボタンなど主要な設定と現在値を一覧表示します。 `status -h`ではCPU・メモリ・Flash・FreeRTOSタスクなどハードウェアの詳細情報を表示します。

🔄 リセット・初期化・システムコマンド

コマンド	使用例	説明
reset	`reset`	UZU ROASTERを再起動します。設定は保持されます。
reset all	`reset all`	すべての設定を工場出荷時の状態に戻し、再起動します。Wi-Fi設定などもすべて消去されます。
lowenergy	`lowenergy on` `lowenergy off`	低消費電力モードを有効にします。このモードでは、CPUの動作周波数を落としたりWi-Fiの出力を抑制して消費電力を抑えることができます。

📡 Wi-Fi設定コマンド

コマンド	使用例	説明
wifi <on/off>	`wifi on` `wifi off`	Wi-Fi機能のオン・オフを切り替えます。
ssid ssid <text>	`ssid` `ssid MyCoffee` `ssid MyCoffee -r`	APモード時（アドホック接続時）、引数（大文字/小文字/記号/絵文字/各種言語可能）を付けると、Wi-FiのSSID（ネットワーク名）を変更します。引数なしで実行すると、現在のSSIDを表示します。末尾に `-r` を付けると設定後に再起動します。
password password <text>	`password` `password 12345678` `password 12345678 -r`	APモード時（アドホック接続時）、引数（大文字/小文字/記号）を付けると、Wi-Fiのパスワードを変更します。引数なしで実行すると、パスワードを無効化します。末尾に `-r` を付けると設定後に再起動します。パスワードは8文字以上必要です。（パスワードを8文字未満で登録した場合の動作は保証されません）
ip <address>	`ip 192.168.0.100`	APモード時（アドホック接続時）の固定IPアドレスを設定します。デフォルトは192.168.4.1です。引数なしで実行すると、現在のIPアドレスを表示します。
staip	`staip`	STAモード（ルーター接続）時のIPアドレスを表示します。ルーター経由でUZU ROASTERにアクセスしたい場合に確認してください。
stassid <text> stassidclear	`stassid MyRouter` `stassid MyRouter -r` `stassidclear`	接続先のルーターSSIDを設定します。設定するとUZU ROASTERがルーターに接続されます（AP+STAモード）。末尾に `-r` を付けると設定後に再起動します。 `stassidclear`で設定をクリアします。
stapassword stapassword <text>	`stapassword` `stapassword 12345678` `stapassword 12345678 -r`	接続先ルーターのパスワードを設定します。引数なしで実行すると、パスワードを無効化します。末尾に `-r` を付けると設定後に再起動します。
wifiscan	`wifiscan`	周辺のWiFiネットワークをスキャンします。 `wifiscan`でスキャンを開始し、SSIDと電波強度（dBm）が表示されます。数値が大きいほど電波が強くなります。例：`0: MyRouter (-45dBm)` ← 電波強い / `1: Neighbor (-85dBm)` ← 電波弱い
wifimode <ap/sta>	`wifimode ap` `wifimode sta`	WiFiの動作モードを切り替えて再起動します。 `wifimode ap`：APモード（アドホック接続）に切り替えます。スマホやPCから直接UZU ROASTERのWiFiに接続する通常の使い方です。 `wifimode sta`：STAモード（ルーター接続）に切り替えます。家庭のルーター経由でUZU ROASTERにアクセスしたい場合に使用します。事前に`stassid`と`stapassword`の設定が必要です。 ⚠️ モード切り替え後は再起動が行われます。STAモード時のIPアドレスは`staip`コマンド、またはLED表示（`ipled`）で確認してください。
maxwifi <number>	`maxwifi 1` `maxwifi 4`	APモード時に同時接続できるWiFiクライアントの最大数を設定します。デフォルトは1です。複数のデバイスから同時にアクセスしたい場合に増やしてください。設定後は再起動が必要です。 ⚠️ 接続数を増やすとESP32のメモリ消費が増加したり、安定性が低下する可能性があります。自己責任でご使用ください。
wifilog <on/off>	`wifilog on` `wifilog off`	ESP32内部のWiFiシステムログの表示を切り替えます。デフォルトはoffです。 WiFi接続のトラブルシューティング時にonにすると詳細なログが確認できます。通常使用時はoffを推奨します。

🌡️ 温度測定設定コマンド

コマンド	使用例	説明
temp <on/off>	`temp on` `temp off`	USBシリアル経由での温度データ出力のオン・オフを切り替えます。Artisan連携時に使用します。
interval <number>	`interval 1000` `interval 500`	温度データの更新間隔をミリ秒単位で設定します。1000=1秒です。最小200msまで設定可能です。
digit <number>	`digit 1` `digit 2`	温度表示の小数点以下の桁数を設定します。0～2の範囲で設定できます。
prefix <text>	`prefix TEMP:`	USBシリアル出力時の温度データの前に付ける文字列を設定します。
suffix <text>	`suffix °C`	USBシリアル出力時の温度データの後ろに付ける文字列を設定します。

📊 データ出力・シミュレーションコマンド

コマンド	使用例	説明
usbserial <on/off>	`usbserial on` `usbserial off`	JSON形式（時刻と温度）でのUSBシリアル出力を開始・停止します。この設定は再起動後に保持されません。
simulate <on/off>	`simulate on` `simulate off`	シミュレーションモードのオン・オフを切り替えます。オンにすると、ダミーの温度データが生成されます。テスト用です。
echo <message>	`echo Hello`	指定したメッセージをUSBシリアルに出力します。接続テスト用です。
echon <number>	`echon 123`	指定した数値をUSBシリアルに出力します。接続テスト用です。

📁 ファイルシステム操作コマンド（上級者向け）

コマンド	使用例	説明
ls	`ls`	LittleFSファイルシステム内のファイルとディレクトリの一覧を表示します。
cat <file>	`cat /index.html`	指定したファイルの内容を表示します。
rm <file>	`rm /oldfile.txt`	指定したファイルを削除します。削除したファイルは復元できませんのでご注意ください。

🔘 ボタン・LED設定コマンド

コマンド	使用例	説明
bpress <command>	`bpress start` `bpress templed on#templed off`	OPTIONボタンを短押ししたときに実行するコマンドを登録します。【ローテーション機能】コマンドを「#」で繋ぐことで、最大5個まで登録可能です。ボタンを押すごとに登録した順にコマンドが実行され、最後まで行くと最初に戻ります。例：`bpress cmd1#cmd2#cmd3`（1回目でcmd1、2回目でcmd2...）
blpress <command>	`blpress stop` `blpress start#stop#echo hello`	OPTIONボタンを長押し（3秒以上）したときに実行するコマンドを登録します。短押し同様、「#」を使って最大5個までのコマンドを順番に実行するローテーション設定が可能です
templed <on/off>	`templed on` `templed off`	ステータスLEDを使って現在の温度を点滅パターンで表現するモードに移行します。100の位、10の位、1の位の順に点滅します。 `ipled`とは排他動作です。（ `ipled`はオフになります）
ipled ipled <on/off>	`ipled` `ipled on` `ipled off`	ステータスLEDを使って、現在のIPアドレスを点滅パターンで表示します。 STAモード接続中はルーターから割り当てられたIPを、未接続時はAPのIP（192.168.4.1）を表示します。 4つのオクテット（xxx.xxx.xxx.xxx）を順番に点滅し、オクテット間は長い休止で区切られます。 `templed`とは排他動作です。（ `templed`はオフになります）

💡 LED点滅パターン（共通）

短い点滅（120ms） = 1
中くらいの点滅（400ms） = 5
長い点滅（800ms） = 0

【templed】例： 128度の場合
→ 短い点滅1回（1）→ 桁間インターバル（500ms）→ 短い点滅2回（2）→ 桁間インターバル（500ms）→ 中点滅1回＋短点滅3回（5+3=8）
→ 温度間インターバル（1200ms）→ 繰り返し ※ 99以下でも100の位が0として点滅し、必ず3桁表示されます ※ 桁の輝度で位を識別：100の位=明るい / 10の位=中 / 1の位=暗い

【ipled】例： IPアドレス 192.168.1.103 の場合
→ 短い点滅1回 → 短い区切り → 中くらいの点滅1回＋短い点滅4回 → 短い区切り → 短い点滅2回（192） → 長い区切り
→ 短い点滅1回 → 短い区切り → 中くらいの点滅1回＋短い点滅1回 → 短い区切り → 中くらいの点滅1回＋短い点滅3回（168） → 長い区切り
→ 長い点滅1回 → 短い区切り → 長い点滅1回 → 短い区切り → 短い点滅1回（001）→ 長い区切り
→ 短い点滅1回 → 短い区切り → 長い点滅1回 → 短い区切り → 短い点滅3回（103）
→ 3秒休止 → 繰り返し

💡 補足説明

📝 コマンドの入力方法

USBシリアル通信： PCとUZU ROASTERをUSBケーブルで接続し、シリアルモニター（Arduino IDEやTeraTermなど）からコマンドを送信します。
WebSerial： UZU ROASTERのWebページ（http://192.168.4.1/webserial/）にアクセスし、ブラウザからコマンドを送信します。
USBシリアル通信/WebSerial： うずロースターコントローラーの設定画面からコマンド送信します。

💾 設定の保存について

ほとんどの設定は、UZU ROASTERの内部メモリに保存され、電源を切っても保持されます。
ただし、usbserialコマンドの設定だけは再起動後に保持されません。

🔧 トラブルシューティング

コマンドが反応しない場合は、USBケーブルの接続を確認してください。
Wi-Fi設定を変更した後は、UZU ROASTERが自動的に再起動します。
すべての設定を初期化したい場合は「reset all」コマンドを使用してください。