PiControlを使ってRaspberry Piを遠隔操作する

PiCockpitのPiControlは、ボタンをクリックするだけで、任意のWebブラウザからRaspberry Piを遠隔操作できる強力な機能です。コマンドの状態や出力を見ることができます。新しいコマンドは、Raspberry Pi上のJSONファイルを編集するだけで追加することができます。その方法をご紹介し、PiControlを使ってどのようなものを作ることができるのか、いくつかのアイデアをご紹介します

どのように見えますか？

デフォルトでは、3つのコマンドが含まれており、ラズパイですぐに利用できます。( power off, reboot, upgrade client )

Raspberry PiとPiControlで何ができるの？

ここでは、それを使って作ることができるいくつかのものを紹介します。いずれにしても、PiCockpitのPiControlは、あなたのプロジェクトの使いやすいウェブインターフェース部分をサポートし、インターネット上での作業にかかる時間を大幅に短縮してくれます。

• Raspberry Piのカメラモジュールを使ってスナップショットを撮影し、それを郵送する。
• Raspberry PiのMinecraftサーバーを起動し、同様に停止します。
• omxplayerを使った動画の再生（動画の無限ループを設定し、他の動画に切り替えたい場合は動画のループを停止することもできます。）
• Raspberry Piのカメラモジュールを使って、ストップモーション・アニメーション・カメラを簡単にコントロールすることができます。
• Wake on LAN機能を使って、Raspberry Piと同じネットワーク上にあるローカルコンピュータを起動させることができます。
• 音を鳴らす（ハロウィンなどの悪ふざけとして）
• ガレージドアなどのドアを、Z-Waveなどで適切な制御コマンドを発行して開く。
• Raspberry PiでSSHサービスを開始し、それを停止する。
• 鉄道模型の制御
• リレイのオン／オフ（2つのボタンが必要ですが、"トグル "ボタンでも可能です。）
• IR LEDを使ってテレビを操作（チャンネル切り替え、音量変更など）する。
• ウェブインターフェースからのロケット発射

これらのプロジェクトアイデアのいくつかについては、ステップバイステップの説明書を公開する予定ですので、PiControlを始めてRaspberry Piをリモートコントロールするための簡単なガイドとなります。

PiControlでRaspberry Piのリモートコマンドボタンを追加するにはどうしたらいいですか？

Raspberry Pi上でJSONファイルを編集するだけで、簡単かつ安全に独自のコマンドを定義することができます。これはセキュリティ上の理由から行われています。ウェブインターフェイスからコマンドを追加できるようにPiCockpitを書くこともできましたが、もし誰かがあなたのPiCockpitのパスワードを知っていれば、望むコマンドを作成することができてしまいます。そのため、以下の簡単な説明に従って、あなたのPiに新しいJSONファイルを作成してください。

注意：ここでの説明は、コマンドラインを使ったことがない人でも理解できるように配慮されています。コマンドラインの使い方をご存知の方は、ファイルを作成してnanoで編集した方が簡単で早いと思います。

まず、スーパーユーザーモードでファイルブラウザを開く必要があります（このステップは、PiCockpit PiControlの設定ファイルを、ユーザーやアプリケーションが改ざんできないようにします）。Raspberry Pi OS Menuをクリックし、ここで "Run ... "コマンドをクリックします。

root（sudo pcmanfm）でpcmanfmを実行するには、"sudo pcmanfm"(と入力し、「OK」をクリックしてください。

新しいウィンドウが開き、/home/pi ディレクトリの内容が表示されます。

注意：「ファイル」メニューのすぐ下に、このアイコンが表示されます。これは、pcmanfm をユーザ root で使用していることを示しており、特に注意が必要です（root はあらゆるファイルを編集・削除・移動できるため、システムの正常な動作に不可欠なファイルも編集・削除できてしまいます）。

心配ありません、ここでは必要なファイルだけを触ります 🙂 。

Raspberry Piで以下のディレクトリを開きます。

/etc/picockpit-client/apps/com.picockpit/picontrol/modules

ヒント：上記で示したパスをコピー＆ペーストし、エンターキーを押してディレクトリに移動することもできます。

ラズパイベリーのお役立ちRaspberry Pi Tips

既存のファイルの横の何もないところで右クリックして、「新規ファイル...」を選択します。

新しいファイルをssh-server.jsonと呼びます。

新規ファイルを右クリックして、コンテキストメニューを表示します。Geany」を選びます。

先ほど作成した新しいファイルが表示されています。ここまでは空っぽです。

2つの新しいコマンドを作りましょう。1つはSSHサーバーサービスをシャットダウンするため、もう1つは起動するためです。Geanyが表示するテキストフィールドに次のように入力します。

{
  "name":"SSH commands" (日本語)
  "icon":"mdi-ssh" です。
  "handle":"ssh" です。
  "description":"SSH サーバーの制御" です。
  "commands":{
    "ssh-stop":{
      "name":"SSH Server off" です。
      "icon":"mdi-server-minus" です。
      "description":"Shuts the SSH service down" (SSH サービスを停止する)
      "confirm": 真。
      "user":"root" です。
      "command":["service", "ssh", "stop"] です。
    },
    "ssh-start":{
      "name":"SSH Server on",
      "icon":"mdi-server-plus" です。
      "description":"Starts the SSH service" (SSH サービスを開始する)
      "user":"root" です。
      "command":["service", "ssh", "start"] です。
    }
  }
}

この時点で、ファイルを保存する必要があります。これはGeanyのファイルメニューから、例えば「Save」を選択して行うことができます。(または、Ctrl + Sで）。

この時点では、私たちの新しいコマンドはまだ Web インターフェースに表示されていません。このためには picockpit-client を再起動する必要があります。Raspberry Pi OSのメニューにある "Run ... "コマンドをクリックして、"... "と入力します。sudo service picockpit-client restartを入力してから「OK」をクリックしてください。

それでは、PiControlのWebインターフェイスを見てみましょう。

すべて正しく入力されていれば、新しいコマンドが表示されます。もし、JSONファイルに間違いがあった場合（例えば、中括弧を忘れた場合）、PiCockpitは単に「壊れた」ファイルを無視します。

これで、コマンドを試すことができます。SSH SERVER OFF」というボタンをクリックすると、本当にそのコマンドを実行するかどうかを聞かれます。ここでも「ssh server off」をクリックすると、実際にコマンドが実行されます（結局、実行したくない場合は「cancel」をクリックします）。

PiCockpitがコマンドを実行すると、進捗情報が表示されます。実行が終わると、次のような成功インジケータが表示されます。

今、PiにSSHで接続しようとすると、接続が拒否されます。

SSH SERVER ON "をクリックして、SSHサーバーを再開します。これで再び接続できるようになります。

おめでとうございます。これで、ウェブインターフェースから実行できる独自のコマンドセットができました。

コマンドを実行している間は、そのページに留まってください。離れた場所に移動すると、現在のステータスはクリアされます。SSHサーバーが動作しているかどうかを判断するには、PiDoctorテストを作ってみましょう。PiControlは、単にPi上でリモートアクションを実行するためのものです。

ラズパイベリーのRaspberry Pi（およびPiCockpit）に関するお役立ち情報

新しいコマンドを追加したり、コマンドを更新したりするときは、picockpit-clientを再起動することを忘れないでください。また、必要のないコマンドを削除することもできます。例えば、Raspberry Pi をリモートでシャットダウンする機能を削除したい場合などに使用します。

リモートコマンド構文の説明

このファイルは、PiControlの新しいモジュールを設定するものです。.JSONの構文になっていますので、私の例にあるように、正しい方法で中括弧を開いて終わらせるようにしてください。

モジュール自体を設定するヘッドと、コマンド（「コマンド」の部分）があります。これらはいくつかの共通のエントリーを持っています。

名前

name "には、ウェブ・インターフェースで表示される人間が読める名前を入力します。

アイコン

icon "項目は、ボタンやモジュールを装飾するためのオプションです。これらはMaterial Design Iconの名前で、例えば "mdi-ssh "などです。

をチェックすることができます。 Material Design Iconsの全リストはこちら.アイコンの名前をコピーするだけです（先頭のmdi-を含む）。

ラズパイベリーのRaspberry Pi（およびPiCockpit）に関するお役立ち情報

記述

description "項目はオプションで、コマンドやモジュールの情報をもう少し追加することができます。

ハンドル

ハンドルネームは、モジュールに対して明示的に設定され、モジュール間で一意でなければなりません。コマンドの場合、ハンドルは暗黙の了解です。"ssh-stop" と "ssh-start「は、私の例でコマンドに使用した2つのハンドルです。

ハンドルネームは、「/」、「+」、「$」、「*」を含まないものであれば、何を選んでも構いません。基本的なダウンケースのASCII文字にこだわり、「-」を使うことをお勧めします。ハンドルネームは 必須.

ちなみに、ファイルはハンドルとは別のファイル名にすることができます。ハードドライブ上のモジュール.JSONファイルを簡単に識別できるように、ファイル名とハンドルには少なくとも関連する名前を使用することをお勧めします。

ラズパイベリーのRaspberry Pi（およびPiCockpit）に関するお役立ち情報

コマンドは「」の中に入ります。コマンド「ブロックを使用しており、追加の構成が可能です。

確認

もし "confirm" が存在し、かつtrueに設定されている場合、PiControlのウェブインターフェイスは、実際にコマンドを実行する前に確認ダイアログを表示します。これは、誤ってタップやクリックをして「危険な」コマンドが実行されないようにするのに便利です。

ユーザー

もし "user" が存在する場合、コマンドはこの特定のユーザーとして実行されます（つまり ルート この例では、十分な権限を持っていることを確認しています）。

PiControlは、ユーザー" "としてコマンドを実行します。パイ" をデフォルトで設定します。また、「」よりも少ない権限の他のユーザーに設定することもできます。パイ“.

GPIOコマンドを実行したり、omxplayerを使って動画を再生したりする場合は、新しいユーザーに追加の機能を与える必要があるかもしれません。ユーザーは パイ は、これらの必要な権限をデフォルトで持っています。通常、これらの権限は、ユーザーを特別なグループに追加することで設定されます。

ラズパイベリーのRaspberry Pi（およびPiCockpit）に関するお役立ち情報

コマンド

これがRaspberry Pi上で実行されるべき実際のコマンドです。コマンドの中のスペースは、コマンドラインで実行するのと同じように置き換えなければならないことに注意してください。例えば、以下のようになります。

service ssh start

と書かれているはずです。

["service", "ssh", "start"] です。

PiControlは、一連のコマンドの連鎖もサポートしています（例えば、通常のapt-get update、apt-get upgradeのシーケンス）。その例としてcore.jsonをチェックしてみてください。

ラズパイベリーのRaspberry Pi（およびPiCockpit）に関するお役立ち情報

結論から言うとRaspberry Piのリモートコントロールのニーズに応えるPiControl

PiCockpitとPiControlを使えば、Raspberry Piで実行したい任意のリモートコマンドを追加して、WebインターフェイスからPiを制御することがとても簡単にできます。この機能を利用するには、Raspberry Piがインターネットに接続されている必要があります。 同じネットワークにいる必要はありません。.

PiCockpitとPiControlを使って何を作りたいですか？以下にコメントしてください、あなたのプロジェクトのお役に立てるよう努力します 🙂 。

大きな力には大きな責任が伴います。PiCockpitインターフェイスへのアクセス権を誰に与えるかに注意し、パスワードとAPIキーを安全に保管してください。また、上述のように危険なコマンドを「保護」して、誤ってクリックしても実行されないようにしてください。

ラズパイベリーのRaspberry Pi（およびPiCockpit）に関するお役立ち情報