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 helpforcommand

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