OpenCCVoice for DVSwitch ダッシュボード 導入/取扱説明書

このドキュメントでは、DVSwitch 向けダッシュボード「OpenCCVoice for DVSwitch Web Dashboard」の導入(インストール)、確認、削除(アンインストール)の手順を説明します。

概要

OpenCCVoice for DVSwitch Web Dashboard は、DVSwitch Bot の設定・監視・サービス制御を行う軽量な Web ダッシュボードです。Raspberry Pi 上の Flask アプリとして動作します。

主な機能

機能説明
サービス制御dvswitch-bot の Start / Stop / Restart
Bot 設定bot_config.json の全項目を Web フォームで編集(送出音量 TX_GAIN を含む)
カスタム音声標準音声(intro/001/002)を cstm_*.wav に個別に差し替え。ファイルが無ければ自動で標準音声にフォールバック
DVSwitch 設定MMDVM_Bridge.ini / Analog_Bridge.ini を Web フォームで編集
自動バックアップDVSwitch 設定保存時に /opt/dvswitch_bot/bak/ini/ へ自動バックアップ
ログ表示MMDVM_Bridge ログ末尾 5 行を表示・30 秒自動更新
バックアップ一覧ini バックアップのタイムスタンプ一覧(最新 10 件)
変更ログBot 設定の変更履歴(項目・変更前後の値・日時)を記録・表示

前提条件

本手順は、以下の環境を前提としています。

  • Raspberry Pi(Raspbian / Raspberry Pi OS)
  • Python 3 + python3-flask
  • DVSwitch(MMDVM_Bridge + Analog_Bridge)インストール済み
  • dvswitch-bot サービス設定済み
  • Raspberry Pi がインターネットに接続できること
📝 メモ:インストール・アンインストールには管理者権限が必要です。コマンド実行時に sudo のパスワードを求められる場合があります。

導入(インストール)

インストールの実行

  1. Raspberry Pi のターミナルを開きます。
  2. 以下のコマンドを実行し、インストールスクリプトを取得・実行します。
curl -fsSL https://raw.githubusercontent.com/ji2tab/OpenCCVoice-For-DVSwitch/main/dashboard/install.sh | sudo bash

確認

インストール後、サービスが正常に起動しているかを確認します。

sudo systemctl status dvswitch-web

期待される出力は次のとおりです(active (running) が表示されれば正常です)。

● dvswitch-web.service
   Loaded: loaded
   Active: active (running)

アクセス方法

  1. Web ブラウザを開きます。
  2. アドレスバーに以下の URL を入力してアクセスします(ポートは 8081)。<Raspberry-Pi-IP> は対象機の IP アドレスに置き換えてください。
http://<Raspberry-Pi-IP>:8081/

サービス管理コマンド

ダッシュボードのサービスは、以下のコマンドで管理できます。状態確認、起動、停止、再起動、ログ確認をそれぞれ実行できます。

sudo systemctl status dvswitch-web
sudo systemctl start dvswitch-web
sudo systemctl stop dvswitch-web
sudo systemctl restart dvswitch-web

サービスのログを確認するには、以下を実行します。

journalctl -u dvswitch-web -n 50

削除(アンインストール)

⚠️ 注意:この操作により、ダッシュボードに関連する設定やファイルがシステムから削除されます。実行前に、削除して問題ないか必ず確認してください。

アンインストールの実行

  1. Raspberry Pi のターミナルを開きます。
  2. 以下のコマンドを実行し、アンインストールスクリプトを取得・実行します。
curl -fsSL https://raw.githubusercontent.com/ji2tab/OpenCCVoice-For-DVSwitch/main/dashboard/uninstall.sh | sudo bash

確認

アンインストール後、サービスが削除されたことを確認します。次のコマンドでサービスが見つからなければ、削除は完了しています。

systemctl status dvswitch-web

期待される出力は次のとおりです(could not be found が表示されれば削除済みです)。

Unit dvswitch-web.service could not be found.

📝 執筆:JI2TAB(尾張旭 DMR デジピーター 管理人)
🏛 JJ2YYK あいちデジタルコミュニケーションハムクラブ

JJ2YYK
  • JJ2YYK

コメントする

メールアドレスが公開されることはありません。 が付いている欄は必須項目です