miso-develop/opniz-cli

opniz CLIはopniz Arduino LibraryのBasicスケッチを、コマンドから簡単に書き込めるCLIツールです。

opniz CLI

opniz CLIはopniz Arduino LibraryのBasicスケッチを、コマンドから簡単に書き込めるCLIツールです。
Arduino CLIのラッパーCLIです。

対応デバイス

• M5Stack BASIC
• M5Stack Core2
• M5StickC
• M5ATOM Matrix
• M5ATOM Lite
• M5ATOM Echo
• M5ATOM U
• M5ATOMS3
• M5ATOMS3 Lite
• M5Stamp Pico
• M5Stamp S3
• その他ESP32、ESP32-PICO-D4、ESP32-S3デバイス

インストール

$ npm install -g opniz-cli

インストール時に~/.opniz-cli/へArduino CLIの環境をセットアップします。
そのためインストールに数分かかり、約800MBほどストレージを消費します。

使い方

$ opniz -h
Usage: index [options] [command]

Options:
  -v, --version                   バージョンを表示します。
  -h, --help                      コマンドのヘルプを表示します。

Commands:
  upload [options] [device-port]  デバイスへopnizを書き込みます。
  monitor [device-port]           シリアルモニタを表示します。
  list                            接続されているデバイス情報を表示します。
  arduino ["options"]             Arduino CLIを直接実行します。[options]をダブルクォーテーションで括って実行してください。（例：opniz arduino "version"）
  help [command]                  display help for command

upload: opnizスケッチ書き込み

デバイスへopnizスケッチを書き込みます。

デバイスのシリアルポートやWi-Fi情報、opnizプログラムを実行するマシンのIPアドレスといった情報を対話モードで入力していきます。
シリアルポート、Wi-FiのSSID、IPアドレスの候補は動的にリスト生成されるので簡単に選択できます。

opniz upload

リストにない値を指定したい場合はOtherを選択することで直接入力できます。

また以下のようにオプション指定することで対話モードをスキップして実行できます。
部分的なオプション指定も可能です。

opniz upload <device-port> -s <ssid> -p <password> -a <address> -d <device> -P 3000

オプション	必須	内容
<device-port>	✔	デバイスのシリアルポートを指定します。
-s, --ssid <ssid>	✔	デバイスを接続するWi-FiのSSIDを指定します。
-p, --password <password>	✔	デバイスを接続するWi-Fiのパスワードを指定します。
-a, --address <address>	✔	opnizプログラム実行マシンのIPアドレスまたはホスト名、ドメイン名を指定します。
-d, --device <device>	✔	デバイスを指定します。 m5atom、m5stickc、m5stack、esp32のいずれかを指定します。
-P, --port <port>	✔	opnizプログラムの通信ポート番号を指定します。
-i, --id <id>		opniz IDを指定します。
-h, --help		コマンドのヘルプを表示します。

monitor: シリアルモニタ

デバイスのSerial.printを出力します。

<device-port>にデバイスのシリアルポートを指定して実行します。

opniz monitor <device-port>

list: ボードリスト表示

デバイスをPCへ接続した状態で実行するとボード情報（port等）が表示されます。

$ opniz list
シリアルポート Protocol タイプ               Board Name      FQBN                       Core
COM1          serial   Serial Port         Unknown
COM2          serial   Serial Port (USB)   Unknown
COM3          serial   Serial Port (USB)   TAMC Termod S3  esp32:esp32:tamc_termod_s3 esp32:esp32

arduino: Arduino CLI直接実行

Arduino CLIを直接実行します。
Arduino CLIコマンドをダブルクォーテーションで括って実行します。

opniz arduino "<arduino-cli command>"

// example
$ opniz arduino "version"
$ opniz arduino "lib list"

関連リポジトリ

• opniz SDK for Node.js
  • opnizデバイスをNode.jsから遠隔制御するためのSDK
• opniz Arduino Library for M5Unified
  • M5Unified向けArduinoライブラリ
• opniz Server
  • opniz Node.js SDKやopnizデバイスからのJSON RPCメッセージを中継するWebSocketサーバ

ライセンス

MIT