OpenCCVoice for DVSwitch 構築・導入・設定マニュアル

～ Bookworm + DVSwitch-Server 版の手引き ～

自動音声応答（デジピーター）システム — Bookworm + DVSwitch-Server 版

目次

第1章：準備

• 1. システムの全体像
• 2. 事前準備チェックリスト
• 3. 専門用語ミニ辞典
• 4. 構築の急所（先に知っておくべき決定的ポイント）

第2章：OS と DVSwitch-Server

• 5. OS 準備
• 6. ネットワーク（固定 IP）
• 7. DVSwitch-Server インストール
• 8. dvs の初期設定

第3章：設定と確認

• 9. スクリプト一式の取得
• 10. dvs_config.sh で TGIF 用の値を確定
• 11. サービス起動確認と md380-emu 修正
• 12. Monit Service Manager（:2812）の表示修正
• 13. DVSwitch Dashboard（:80）の表示設定

第4章：音声と Bot

• 14. 音声合成環境（Open JTalk + SoX）
• 15. 固定 WAV の作成
• 16. 送信テスト
• 17. Bot 本体と設定ツールの導入
• 18. 常駐化（systemd）

第5章：運用

• 19. 設定変更・音声差し替え・バックアップ
• 20. 運用上の注意と法令遵守
• 21. システム全体のバックアップとリストア

付録

• 付録A：トラブルシューティング早見表
• 付録B：固定 WAV の個別コマンド生成
• 付録C：DVSwitch 側 ini の手動編集（参照用）
• 付録D：ダッシュボードの Platform 表示を正す
• 付録E：クイックリファレンス

第1章：準備

1. システムの全体像

dvswitch_bot.py (USRP パケット生成)
           │ USRP (UDP 51000)
           ▼
┌─────────────────────┐
│   Analog_Bridge     │  ← 音声プロトコル変換ゲートウェイ
└──────────┬──────────┘
           │ AMBE 変換 (UDP 2470)
           ▼
┌─────────────────────┐
│     md380-emu       │  ← PCM ⇔ AMBE ソフトウェア変換
└──────────┬──────────┘
           ▼
┌─────────────────────┐
│   MMDVM_Bridge      │  ← TGIF ネットワークへの橋渡し
└──────────┬──────────┘
           │ DMR (UDP 62031)
           ▼
        TGIF Network

2. 事前準備チェックリスト

ハードウェア

• ☐ Raspberry Pi Zero 2 W（起動・SSH 接続可）
• ☐ microSD カード（16 GB 以上、Class 10 推奨）
• ☐ 電源（5 V 2.5 A 以上）

資格・登録

• ☐ アマチュア無線技士免許（第三級以上推奨）
• ☐ DMR ID の登録（https://radioid.net/）
• ☐ TGIF Network アカウント（https://tgif.network/）

知識・準備

• ☐ SSH でラズパイに接続できる
• ☐ sudo コマンドが使える
• ☐ ラズパイの IP アドレスを把握している

3. 専門用語ミニ辞典

4. 構築の急所

再現時に必ず意識すべき決定的ポイント。詳細は各章で扱う。

1. 🔴 md380-emu を動かすには 2 つの必須操作がある（別問題・両方必要）。
   • (a) qemu-user-static を 5.2（Bullseye 版）にダウングレードし apt-mark hold で固定（qemu 7.2 では SEGV）
   • (b) md380-emu バイナリに chmod +x で実行権限を付与（無いと Permission denied）
2. ⚠️ USRP ポートは rxPort=51000 / txPort=51001。bot の送信先は 51000。
3. ⚠️ Open JTalk の辞書パスは /var/lib/mecab/dic/open-jtalk/naist-jdic（open-jtalk/ を含む）。
4. ⚠️ OS は Bookworm に固定する。sources.list が trixie を指していないか確認。
5. 🔴 dvs の「01 初期設定」完走が ini 生成の前提条件。これを通さないと /opt/Analog_Bridge/ の ini が生成されず、dvs_config.sh が前提を満たせない。
6. ⚠️ 「Does not exist」は monit の httpd 無効が主因。OS 世代とは無関係。
7. 🔴 Bot は「設定ツール＋デーモン本体」構成を使う。対話設定内蔵の旧版は systemd 常駐で EOFError 停止する。

第2章：OS と DVSwitch-Server

5. OS 準備

5-1. OS 書き込み・初回起動 ✅

Raspberry Pi Imager で 「Raspberry Pi OS Lite (Legacy, 32-bit)」（”A port of Debian Bookworm …” と表示されるもの）を選び、microSD に書き込む。”Legacy” の付かない最新版は trixie の可能性があるため選ばない。SSH・WiFi・ロケール等の初期設定の際、ユーザー名を「ocv」に設定する（Raspi 初回起動時）。設定を済ませてから起動する。なお、Imager の事前設定（OS カスタマイズ）が使えない古いイメージ（FTP サイト等から取得した .img.xz 等）を書き込む場合は、初回起動後に 付録F：raspi-config 操作手順 に従ってユーザー ocv の作成・ホスト名（OCV）の変更・SSH 有効化・固定 IP・タイムゾーンを設定する。

OS イメージ直リンク（Imager から取れない場合）

本検証で使用したのは 2025-05-13-raspios-bookworm-armhf-lite.img.xz（約 493 MB）。ファイル名に bookworm を含むものを必ず選ぶ。

# JAIST（北陸先端大）ミラー — 国内・高速
https://ftp.jaist.ac.jp/pub/raspberrypi/raspios_lite_armhf/images/raspios_lite_armhf-2025-05-13/2025-05-13-raspios-bookworm-armhf-lite.img.xz

# 公式（Raspberry Pi 財団）
https://downloads.raspberrypi.com/raspios_lite_armhf/images/raspios_lite_armhf-2025-05-13/2025-05-13-raspios-bookworm-armhf-lite.img.xz

起動後に確認：

uname -a    # ... armv7l を確認

5-1b. SSH（sshd）の有効化 ✅

初回起動後、raspi-config コマンドを実行し、Interface Options のメニューから SSH を有効にする。設定後はリブートが入る。

sudo raspi-config
# Interface Options → SSH → Enable → Finish → リブート

5-2. 🔴 sources.list が bookworm であることを確認 ✅

apt upgrade の前に、リポジトリが bookworm を指していることを確認する。trixie だとアップグレードで OS 世代が上がり、monit 等の挙動が手順と食い違う。

grep -rE "bookworm|trixie" /etc/apt/sources.list /etc/apt/sources.list.d/
cat /etc/os-release | grep VERSION_CODENAME    # bookworm であること

出力がすべて bookworm で、trixie が一つも無いことを確認する。

5-3. システム更新 ✅

sudo apt update && sudo apt upgrade -y
sudo reboot

再起動後、apt update の出力に bookworm のみが出て trixie が出ないことを確認する。

6. ネットワーク（固定 IP）

無人運用するため、IP アドレスを固定しておくと管理しやすい。Bookworm は NetworkManager が既定のため、nmtui（テキスト UI）で設定するのが簡単。

sudo nmtui

[Edit a connection] → 使用中の接続を選択 → [IPv4 CONFIGURATION] を [Manual] にして、アドレス（例 192.168.x.x/24）・ゲートウェイ・DNS を入力 → 保存。反映：

sudo systemctl restart NetworkManager     # または再起動
ip addr                                    # 設定した IP を確認

7. DVSwitch-Server インストール

7-1. リポジトリ登録 ✅

cd /tmp
wget http://dvswitch.org/bookworm
cat bookworm          # 中身を確認（GPG キー取得とリポジトリ追加のみ）
chmod +x bookworm
sudo ./bookworm

Verified: Valid DVSwitch Keyring (72147EC1E788D4C3) と Finished DVSwitch repository install が出れば成功。

7-2. 本体インストール ✅

sudo apt install dvswitch-server -y

• Error, YSFHosts.txt file does not seem to be valid は 無害（YSF 未使用時）。
• Could not execute systemctl（chroot 起因）も実機起動後は問題なし。

8. dvs の初期設定（ini 生成）と TGIF 切替

8-1. 🔴 初期設定メニュー（ini 生成のために必須） ✅

メニューの実体は /usr/local/dvs/dvs（dvswitch-menu ではない）。

sudo /usr/local/dvs/dvs

画面遷移（Menu Script v1.61）

各ステップの コード体 は画面に実際に表示されるプロンプト、「→」の右が入力値。

1. メインメニュー → 01 初期設定 を選択
2. 初めに行う設定 → [Yes]
3. Callsign → 例 YOUR_CALLSIGN
4. CCS7/DMR ID ? → 例 YOUR_DMRID（7 桁）
5. CCS7/DMR ID + 2桁の数（00〜99）? → 例 YOUR_DMRID + ESSID（DMR ID + ESSID）
6. Dstar module ? (A〜Z) → 例 B（D-STAR 未使用でも入力を求められる）
7. USRP ポート → 51001 / 51000（Analog_Bridge を txPort=51001/rxPort=51000 にする）
8. Analog_Bridge.ini 確認 → [Yes]（デフォルト値。後で上書きされる）
9. ローカル BM サーバー選択 → 任意（TGIF 運用では後で上書き）
10. Brandmeister のパスワード → デフォルトのまま Enter で可
11. Hardware Vocoder (AMBE) → 4 ハードウェア Vocoder を使わない（ソフトウェア Vocoder を使う） を選択
12. 入力終了 → [Yes]

完了後、再起動する。これで /opt/Analog_Bridge/Analog_Bridge.ini 等が生成される。

8-2. ⚠️ 詳細設定で DMR サーバーを TGIF に切替 ✅

sudo /usr/local/dvs/dvs

1. メインメニュー → 02 詳細設定
2. → 24 その他の DMR ネットワーク
3. → TGIF を選択（または手入力）
4. → 戻って終了

特定の TG に接続したい場合は以下のコマンドを使う：

/opt/MMDVM_Bridge/dvswitch.sh tune 44833
# 数字は接続したい TG 番号（例：44833）。発出すると当該 TG に接続する。

第3章：設定とサービス

9. スクリプト一式の取得

9-0. 🔴 ツール置き場 /opt/dvswitch_bot/bin/ を作り、全スクリプトを取得 ✅

本システムで使う 5 本のスクリプトは、すべて /opt/dvswitch_bot/bin/ に集約する。スクリプト（実行ファイル）は bin/、bot が読む WAV・設定 JSON は /opt/dvswitch_bot/ 直下、という役割分担。

# 置き場を作成
sudo mkdir -p /opt/dvswitch_bot/bin
sudo chown -R ocv:ocv /opt/dvswitch_bot

# 5 本を bin/ に一括取得
cd /opt/dvswitch_bot/bin
BASE=https://raw.githubusercontent.com/ji2tab/OpenCCVoice-For-DVSwitch/main
for f in dvs_config.sh create_wav.sh test_send.py dvswitch_bot.py bot_setup.py; do
  curl -fsSL "$BASE/$f" -o "$f"
done
chmod +x *.sh *.py
ls -la /opt/dvswitch_bot/bin/

10. dvs_config.sh で TGIF 用の値を確定

🔴 必須。dvs の初期設定で ini が生成されたら、dvs_config.sh でコールサイン・DMR ID・TGIF パスワード・送信 TG・USRP ポートを一括設定する。

cd /opt/dvswitch_bot/bin
# バックアップ先フォルダを事前に作成（無いとバックアップ時にエラーになる）
sudo mkdir -p /opt/dvswitch_bot/bak/ini /opt/dvswitch_bot/bak/wav
sudo chown -R ocv:ocv /opt/dvswitch_bot/bak
sudo ./dvs_config.sh

このツールがすること：

• 編集前に /opt/dvswitch_bot/bak/ini/YYMMDDHHMMSS/ へ 3 つの ini を自動バックアップ
• 対話入力 5 項目：callsign / dmrid（7 桁）/ essid（2 桁）/ password（TGIF）/ txTg
• 固定セット：
  • MMDVM: [DMR] Enable=1、[DMR Network] Enable=1、Address=tgif.network
  • Analog: [USRP] txPort=51001 / rxPort=51000 / usrpAudio=AUDIO_USE_GAIN / tlvAudio=AUDIO_USE_GAIN
• Id（MMDVM）と repeaterID（Analog）は dmrid（7 桁）+ essid（2 桁）で組み立てる
• gatewayDmrId（Analog）は dmrid（7 桁）をセット

確認画面で [y] で保存。オプション：

sudo ./dvs_config.sh -r     # バックアップから復元
sudo ./dvs_config.sh -d     # /opt/dvswitch_bot/bak/ini/ 配下を全削除
sudo ./dvs_config.sh -h     # ヘルプ

設定反映と TGIF ログイン確認

sudo systemctl restart analog_bridge mmdvm_bridge
sudo tail -40 /var/log/mmdvm/MMDVM_Bridge-$(date +%Y-%m-%d).log

11. サービス起動確認と md380-emu 修正

11-1. サービス一覧の確認 ✅

sudo systemctl list-units --all | grep -E "analog|mmdvm|md380|bridge|webproxy"

• analog_bridge / mmdvm_bridge / webproxy が active (running) であること
• md380-emu が activating (auto-restart) になっていないか（なっていれば次節で対処）

11-2. 🔴🔴 md380-emu の SEGV と qemu ダウングレード ✅

症状：TGIF 等から信号が入り AMBE デコードが走った瞬間、md380-emu.service: ... status=11/SEGV を吐いて auto-restart を繰り返す。

原因：Bookworm 標準の qemu-user-static 7.2.x が md380-emu の ARM バイナリと非互換。Bullseye の qemu 5.2.x では正常動作する。

対処（一括実行版）：

wget http://archive.raspbian.org/raspbian/pool/main/q/qemu/qemu-user-static_5.2+dfsg-11+deb11u5_armhf.deb -O /tmp/qemu52.deb && sudo systemctl stop md380-emu && sudo dpkg -i /tmp/qemu52.deb && sudo apt-mark hold qemu-user-static && sudo chmod +x /opt/md380-emu/md380-emu && sudo systemctl restart md380-emu && sleep 3 && sudo systemctl status md380-emu --no-pager && qemu-arm-static --version

12. Monit Service Manager（:2812）の表示修正

対象：http://<IP>:2812/（サービス監視画面。DVSwitch Dashboard の :80 とは別物）。目的：赤字「Does not exist」（典型は Quantar_Bridge）を緑の「OK」にする。原因（2 つ。OS 世代は無関係）：① monit の httpd（:2812）が無効、②プロセス自体が停止・自動起動オフ。

ステップ 1：症状確認 ✅

sudo monit status

Error receiving data -- Connection reset by peer が出れば monit の Web 機能が無効。

ステップ 2：monit の Web 機能を開通させる 🔴

行番号を確認（環境で前後する）：

sudo grep -nE "set httpd|use address|allow localhost|allow admin" /etc/monit/monitrc

標準では次の 4 行がコメントアウトされている。grep の行番号に合わせて置き換える（例 159〜162）：

sudo sed -i '159,162c\
set httpd port 2812 and\
    use address 0.0.0.0\
    allow localhost\
    allow 192.168.1.0/24' /etc/monit/monitrc

書き換え結果を確認：

sudo sed -n '159,162p' /etc/monit/monitrc

ステップ 3：止まっているプロセスを起動 🔴

sudo systemctl enable --now quantar_bridge

対象が他のサービスなら、その systemd ユニット名に置き換える。

ステップ 4：monit に反映させて「OK」を確認 ✅

sudo systemctl restart monit && sleep 8 && sudo monit reload && sleep 12 && sudo monit status Quantar_Bridge

status OK と出れば成功。

13. DVSwitch Dashboard（:80）の表示設定

対象：http://<IP>/（DVSwitch Dashboard。:2812 とは別物）。初期状態は Apache のデフォルトページが出るので、DocumentRoot を DVSwitch の実体に変える。

sudo sed -i 's|DocumentRoot /var/www/html|DocumentRoot /usr/share/dvswitch|' \
  /etc/apache2/sites-enabled/000-default.conf
sudo systemctl restart apache2

http://<IP>/ で「DVSwitch Dashboard」が表示されれば成功。

第4章：音声と Bot

14. 音声合成環境（Open JTalk + SoX）

14-1. パッケージ導入 ✅

sudo apt-get install -y open-jtalk open-jtalk-mecab-naist-jdic \
  hts-voice-nitech-jp-atr503-m001 sox unzip

14-2. 高品質音声「メイ」導入 ✅

cd ~
wget -L --content-disposition \
  https://sourceforge.net/projects/mmdagent/files/MMDAgent_Example/MMDAgent_Example-1.8/MMDAgent_Example-1.8.zip
ls *.zip*                                  # 実ファイル名を確認
unzip 'MMDAgent_Example-1.8.zip'*

sudo mkdir -p /usr/share/hts-voice/mei
sudo cp MMDAgent_Example-1.8/Voice/mei/mei_normal.htsvoice /usr/share/hts-voice/mei/
rm -rf MMDAgent_Example-1.8 'MMDAgent_Example-1.8.zip'*

14-3. 🔴 動作確認（辞書パスに注意） ✅

⚠️ 辞書パスは /var/lib/mecab/dic/open-jtalk/naist-jdic（open-jtalk/ を含む）。

echo "テスト、動作確認。" | open_jtalk \
  -m /usr/share/hts-voice/mei/mei_normal.htsvoice \
  -x /var/lib/mecab/dic/open-jtalk/naist-jdic \
  -ow /tmp/test.wav && \
sox /tmp/test.wav -r 8000 -c 1 -b 16 /tmp/test_8k.wav && echo OK

OK が出れば成功。Cannot open ... naist-jdic が出る場合はパスが誤り（不明なときは find /var/lib/mecab -name "sys.dic" で実体を確認）。

15. 固定 WAV の作成

固定 WAV は対話式スクリプト create_wav.sh で生成する。出力先は /opt/dvswitch_bot/ 直下。

cd /opt/dvswitch_bot/bin
sudo ./create_wav.sh

対話入力の流れ：

1. コールサイン（例 YOUR_CALLSIGN）→ 自動カナ変換結果を確認・修正
2. 設置場所の地名（例 おわりあさひ。確実に読ませたいときはひらがな推奨）
3. 定時メッセージ 1 → カナ確認・修正
4. 定時メッセージ 2 → カナ確認・修正
5. 確認プロンプトで [Y]

生成されるファイル：

確認：

ls -la /opt/dvswitch_bot/
soxi /opt/dvswitch_bot/*.wav    # 全ファイル 8000 Hz / 1ch / 16-bit を確認

16. 送信テスト

16-1. 実行 ✅

python3 /opt/dvswitch_bot/bin/test_send.py /opt/dvswitch_bot/001.wav

TGIF の対象 TG で音声が出れば 経路開通。

16-2. 🔴 md380-emu SEGV の最終確認 ✅

sudo journalctl -u md380-emu -n 20 --no-pager   # SEGV が出ていないこと
sudo systemctl status md380-emu --no-pager       # active (running) のまま

SEGV が再発する場合は qemu が 7.2 に戻っていないか確認（qemu-arm-static --version が 5.2.x、apt-mark で hold 済みか）。

17. Bot 本体と設定ツールの導入

17-1. パラメータの確認 ✅

grep -nE "^UDP_IP|^UDP_PORT|^DICT_PATH|^CONFIG_PATH|^MY_CALLSIGN" /opt/dvswitch_bot/bin/dvswitch_bot.py

MY_CALLSIGN を変える場合：

sudo sed -i 's/^MY_CALLSIGN = .*/MY_CALLSIGN = "YOUR_CALLSIGN"/' /opt/dvswitch_bot/bin/dvswitch_bot.py

17-2. 🔴 設定ツールで bot_config.json を作成 ✅

sudo python3 /opt/dvswitch_bot/bin/bot_setup.py

時刻案内モード（TIME_SIGNAL_MODE）— V1.64〜

時報の頻度を bot_config.json の TIME_SIGNAL_MODE で選べる（任意キー。未設定の旧設定は従来動作＝モード 1）。

放送回数の有効範囲はモードに依存する（正時／30 分は時刻案内が占有するため）：モード 0→0／1／2／3／4、モード 1→0／1／2／3、モード 2→0／2。

⚠️ 送出音量 TX_GAIN（手動設定・上級者向け）— V1.68〜

bot が出す全音声の音量を線形倍率 TX_GAIN（1.0=等倍、主用途は減衰）で一律調整できる。bot_config.json の任意キーで、無ければ等倍。値が不正でも送出は止めず 1.0 にフォールバックする（有効範囲: 0 より大〜5.0 以下）。

確認：

sudo python3 /opt/dvswitch_bot/bin/bot_setup.py -s     # 表示＋有効性チェック
cat /opt/dvswitch_bot/bot_config.json

17-3. 手動起動で動作確認 ✅

python3 /opt/dvswitch_bot/bin/dvswitch_bot.py

• Config loaded /opt/dvswitch_bot/bot_config.json が出ればフェイルセーフ通過
• 設定が無い／不正だとここで止まる（その場合は 17-2 をやり直す）
• カーチャンクを送って応答が返るか確認 → 「Ctrl + C」で停止 → 第 18 章へ

18. 常駐化（systemd）

sudo tee /etc/systemd/system/dvswitch-bot.service > /dev/null << 'EOF'
[Unit]
Description=DVSwitch Bot (OpenCCVoice, daemon V1.69)
After=network.target analog_bridge.service mmdvm_bridge.service md380-emu.service
Wants=analog_bridge.service mmdvm_bridge.service md380-emu.service

[Service]
Type=simple
ExecStart=/usr/bin/python3 /opt/dvswitch_bot/bin/dvswitch_bot.py
Restart=on-failure
RestartSec=10
User=ocv
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now dvswitch-bot
sudo systemctl status dvswitch-bot --no-pager

active (running) で、ログに Config loaded と Bot ready が出ていれば成功。

第5章：運用

19. 設定変更・音声差し替え・バックアップ

19-1. 動作設定を変える

sudo python3 /opt/dvswitch_bot/bin/bot_setup.py    # 対話で bot_config.json を更新
sudo systemctl restart dvswitch-bot                # 再起動して反映

19-2. 音声を作り直す

cd /opt/dvswitch_bot/bin
sudo ./create_wav.sh        # 対話で WAV を再生成（自動バックアップ付き）
sudo ./create_wav.sh -r     # 失敗したら前のセットに戻す

19-3. DVSwitch 設定（コールサイン・TG 等）を変える

cd /opt/dvswitch_bot/bin
sudo ./dvs_config.sh        # 編集前に自動バックアップ。最後にサービス再起動を確認
sudo ./dvs_config.sh -r     # 失敗したら ini を戻す

19-4. ログの見方

常駐化すると出力は journal に集約される。

sudo journalctl -u dvswitch-bot -f                 # リアルタイム監視（常用）
sudo journalctl -u dvswitch-bot -n 50 --no-pager   # 直近 50 行
sudo journalctl -u dvswitch-bot --since today --no-pager
sudo systemctl status dvswitch-bot --no-pager      # 稼働状態

19-5. 手動起動に戻して画面で見たいとき

sudo systemctl stop dvswitch-bot                    # 常駐を一時停止
python3 /opt/dvswitch_bot/bin/dvswitch_bot.py       # 画面出力で手動起動（Ctrl+C で終了）
sudo systemctl start dvswitch-bot                   # 確認後、常駐に戻す

19-6. バックアップの所在

システムに関するものはすべて /opt/dvswitch_bot/ 配下に集約されている。

20. 運用上の注意と法令遵守

20-1. 電波法の遵守

• ☐ アマチュア無線技士の免許を保有していること
• ☐ コールサインを正しく送出していること（システムは応答時に必ず自局コールサインを送出する設計）
• ☐ 自動運用に関する規定を理解していること（長時間の常時無人運用は所轄の総合通信局に相談を推奨）

20-2. 推奨される運用

1. 応答後の抑制時間（既定 15 秒）は短くしすぎない
2. 応答頻度をログで定期的に確認する
3. 他局が交信中の TG に割り込まないよう確認する

20-3. ハードウェアの保護

• SD カードの寿命：一時ファイルは /dev/shm（RAM）に書いているが、ログは定期削除を設定推奨
• 温度管理：ヒートシンク推奨（vcgencmd measure_temp。70℃ 超は要注意）
• 電源：5 V 2.5 A 以上。電源不足はファイル破損の原因

21. システム全体のバックアップとリストア

21-1. 設定ファイルのバックアップ

mkdir -p ~/dvswitch_backup && cd ~/dvswitch_backup
sudo cp /opt/Analog_Bridge/Analog_Bridge.ini ./
sudo cp /opt/MMDVM_Bridge/MMDVM_Bridge.ini ./
cp /opt/dvswitch_bot/bin/dvswitch_bot.py ./
cp /opt/dvswitch_bot/bin/bot_setup.py ./
sudo cp /etc/systemd/system/dvswitch-bot.service ./ 2>/dev/null || true
cp /opt/dvswitch_bot/bot_config.json ./
cp /usr/share/hts-voice/mei/mei_normal.htsvoice ./
sudo chown -R $USER:$USER ~/dvswitch_backup
cd ~ && tar czf dvswitch_backup_$(date +%Y%m%d).tar.gz dvswitch_backup/

このファイルを別の PC やクラウドに保管する。

21-2. SD カード全体のバックアップ（推奨）

ラズパイをシャットダウンし、SD カードを別 PC に挿して：

sudo fdisk -l    # デバイス名を必ず確認（/dev/mmcblk0 や /dev/sdc 等）

sudo dd if=/dev/sdb of=~/backup_$(date +%Y%m%d).img bs=4M status=progress
gzip ~/backup_*.img

21-3. リストア（新しい Pi で再構築）

1. 第 5 章〜第 18 章を順に実施
2. バックアップを展開して設定ファイルを戻す：

cd ~ && tar xzf dvswitch_backup_YYYYMMDD.tar.gz
sudo cp ~/dvswitch_backup/Analog_Bridge.ini /opt/Analog_Bridge/
sudo cp ~/dvswitch_backup/MMDVM_Bridge.ini /opt/MMDVM_Bridge/
sudo mkdir -p /opt/dvswitch_bot/bin
sudo cp ~/dvswitch_backup/dvswitch_bot.py ~/dvswitch_backup/bot_setup.py /opt/dvswitch_bot/bin/
sudo chmod +x /opt/dvswitch_bot/bin/*.py
sudo cp ~/dvswitch_backup/dvswitch-bot.service /etc/systemd/system/
sudo cp ~/dvswitch_backup/bot_config.json /opt/dvswitch_bot/
sudo chown -R ocv:ocv /opt/dvswitch_bot
sudo systemctl daemon-reload
sudo systemctl restart analog_bridge mmdvm_bridge md380-emu
sudo systemctl enable --now dvswitch-bot

3. 第 16 章の動作確認を実施

21-4. 定期バックアップの自動化（cron）

crontab -e

# 毎週日曜 3:00 に DVSwitch 設定をバックアップ
0 3 * * 0 tar czf /home/ocv/dvswitch_backup_$(date +\%Y\%m\%d).tar.gz /opt/Analog_Bridge/Analog_Bridge.ini /opt/MMDVM_Bridge/MMDVM_Bridge.ini /opt/dvswitch_bot/bin/dvswitch_bot.py /opt/dvswitch_bot/bin/bot_setup.py /opt/dvswitch_bot/bot_config.json

付録

付録A：トラブルシューティング早見表

付録B：固定 WAV の個別コマンド生成

スクリプトを使わず手動で作る場合の検証済み文面。各ファイルは 8 kHz / mono / 16 bit PCM。fixed_* は単純変換、time_intro / 001 / 002 は前後無音トリム付き。

# fixed_intro.wav
echo "こちらは、ジェイジェイツーワイワイケー、です。" | open_jtalk -x /var/lib/mecab/dic/open-jtalk/naist-jdic -m /usr/share/hts-voice/mei/mei_normal.htsvoice -ow /tmp/temp_intro.wav && sudo sox /tmp/temp_intro.wav -r 8000 -c 1 -b 16 /opt/dvswitch_bot/fixed_intro.wav

# fixed_outro.wav
echo "カーチャンクです。" | open_jtalk -x /var/lib/mecab/dic/open-jtalk/naist-jdic -m /usr/share/hts-voice/mei/mei_normal.htsvoice -ow /tmp/temp_outro.wav && sudo sox /tmp/temp_outro.wav -r 8000 -c 1 -b 16 /opt/dvswitch_bot/fixed_outro.wav

# time_intro.wav（前後トリム）
echo "こちらは、ジェイジェイツーワイワイケー、" | open_jtalk -x /var/lib/mecab/dic/open-jtalk/naist-jdic -m /usr/share/hts-voice/mei/mei_normal.htsvoice -ow /tmp/time_intro.wav && sox /tmp/time_intro.wav -r 8000 -c 1 -b 16 /opt/dvswitch_bot/time_intro.wav silence 1 0.1 1% reverse silence 1 0.1 1% reverse

# 001.wav（前後トリム）
echo "こちらは、ジェイジェイツーワイワイケー、尾張旭、DMR、デジピーターです。オープン、シーシーヴォイス、フォー、ディーブイスイッチからの音声です。" | open_jtalk -x /var/lib/mecab/dic/open-jtalk/naist-jdic -m /usr/share/hts-voice/mei/mei_normal.htsvoice -ow /tmp/001_raw.wav && sox /tmp/001_raw.wav -r 8000 -c 1 -b 16 /opt/dvswitch_bot/001.wav silence 1 0.1 1% reverse silence 1 0.1 1% reverse

# 002.wav（前後トリム）
echo "こちらは、ジェイジェイツーワイワイケー、尾張旭、DMR、デジピーターです。ティージーアイエフ、ヨンヨンハチサンサンと、インターネット接続しています。" | open_jtalk -x /var/lib/mecab/dic/open-jtalk/naist-jdic -m /usr/share/hts-voice/mei/mei_normal.htsvoice -ow /tmp/002_raw.wav && sox /tmp/002_raw.wav -r 8000 -c 1 -b 16 /opt/dvswitch_bot/002.wav silence 1 0.1 1% reverse silence 1 0.1 1% reverse

付録C：DVSwitch 側 ini の手動編集（参照用）

dvs_config.sh が [WARN] キー ... が見つからず変更できません を出した場合などの参照用。

Analog_Bridge.ini（/opt/Analog_Bridge/Analog_Bridge.ini）

[USRP]
address = 127.0.0.1
txPort = 51001        ; Analog_Bridge → 外部（USRP 送信）
rxPort = 51000        ; 外部 → Analog_Bridge（ボットはここへ送る）

[AMBE_AUDIO]
txTg = 44833          ; ★ボット音声が乗る DMR TG
txTs = 2
colorCode = 1

DVSwitch.ini（/opt/MMDVM_Bridge/DVSwitch.ini）

[DMR]
address = 127.0.0.1
exportTG = 44833      ; ★エクスポート TG

MMDVM_Bridge.ini（/opt/MMDVM_Bridge/MMDVM_Bridge.ini）

[DMR]
Enable=1

[DMR Network]
Enable=1
Address=tgif.network
Password=（TGIF のパスワード）

[General] の Callsign と Id（dmrid + essid）も自局の値にする。反映：

sudo systemctl restart analog_bridge mmdvm_bridge

付録D：ダッシュボードの Platform 表示を正す

ダッシュボードの「Platform」が Unknown ARM based System になるのを、正しい機種名にする。/usr/local/sbin/platformDetect.sh が /proc/cpuinfo の Revision を case 変換しており、Zero 2 W の Revision が載っていないため Unknown に落ちる。/proc/device-tree/model を優先的に使うよう直す。

バックアップ（必須）

sudo cp /usr/local/sbin/platformDetect.sh /usr/local/sbin/platformDetect.sh.bak.$(date +%F)

推奨：device-tree 判定を最小追記

cat > /tmp/dt_block.sh << 'EOF'

# --- device-tree model を最優先で返す（新機種対応・前段に挿入） ---
for __p in /sys/firmware/devicetree/base/model /proc/device-tree/model; do
  if [ -r "$__p" ]; then
    __dt=$(tr -d '\0' < "$__p" | sed 's/[[:space:]]\+$//')
    if [ -n "$__dt" ]; then
      echo "$__dt"
      exit 0
    fi
  fi
done
EOF

# /tmp で組み立てて確認してから本番へ
{ head -1 /usr/local/sbin/platformDetect.sh; cat /tmp/dt_block.sh; \
  tail -n +2 /usr/local/sbin/platformDetect.sh; } > /tmp/platformDetect.test.sh
chmod +x /tmp/platformDetect.test.sh
/tmp/platformDetect.test.sh                       # Raspberry Pi Zero 2 W Rev 1.0 が返れば OK
sudo -u www-data /tmp/platformDetect.test.sh      # www-data でも同じ結果か
sudo cp /tmp/platformDetect.test.sh /usr/local/sbin/platformDetect.sh
sudo chmod 0755 /usr/local/sbin/platformDetect.sh

Web サーバー再起動

sudo systemctl restart apache2

ブラウザで http://<IP>/ を開き「Ctrl + F5」。Platform が機種名になれば成功。戻したいときは sudo cp /usr/local/sbin/platformDetect.sh.bak.YYYY-MM-DD /usr/local/sbin/platformDetect.sh。

付録E：クイックリファレンス

ポート番号一覧

主要ファイルパス一覧

サービス管理コマンド

# 全サービスまとめて再起動
sudo systemctl restart analog_bridge mmdvm_bridge md380-emu dvswitch-bot

# 状態確認
sudo systemctl status analog_bridge mmdvm_bridge md380-emu dvswitch-bot --no-pager

# ログ
sudo journalctl -u dvswitch-bot -f
sudo journalctl -u md380-emu -n 20 --no-pager

OpenCCVoice for DVSwitch 構築・導入・設定 完全マニュアル
対象：Raspberry Pi Zero 2 W / Raspberry Pi OS Bookworm 32-bit / DVSwitch-Server / ocv ユーザー
Bot: dvswitch_bot.py（デーモン版）＋ bot_setup.py（設定ツール）
設計思想・開発秘話は別冊『開発ノート（ブログ材料）』を参照

付録F：raspi-config 操作手順

Bookworm 初回セットアップ時に実施する、キーボードレイアウト・ユーザー作成・静的IP・SSH有効化・タイムゾーンの設定手順。

1. キーボードレイアウトの設定（日本語 OADG 109A）

raspi-config の Localisation Options からキーボードレイアウトを日本語配列に設定する。

1. sudo raspi-config を起動する
   

   sudo raspi-config

   
   
2. 5 Localisation Options → L3 Keyboard を選択する
3. キーボードレイアウト選択画面でリスト末尾の Other を選択し <Ok> を押す
4. 言語一覧から Japanese を選択し <Ok> を押す
5. バリアント一覧から Japanese – Japanese (OADG 109A) を選択し <Ok> を押す
   以降の画面（AltGr キー・コンポーズキー等）は通常デフォルトのまま <Ok> で進めてよい。

2. 新規ユーザーの作成（ocv）

raspi-config の System Options から新規ユーザー ocv を作成し、パスワードを設定する。

1. 1 System Options → S6 User を選択する
   （または直接コマンドで作成する場合は sudo adduser ocv）
2. Please enter new username: に ocv を入力し <Ok> を押す
3. パスワードを入力し <Ok> を押す（入力文字は * でマスク表示）
4. 同じパスワードを再入力し <Ok> を押す（一致すればユーザー作成完了）

3. 静的 IP アドレスの設定（nmtui）

raspi-config 終了後にリブートし、ocv ユーザーでログインして nmtui を実行する。

1. リブート後、コンソールで ocv ログイン。DHCP で払い出された IP アドレスを確認しておく
   （例: My IP address is 192.168.X.X）
2. nmtui を起動する
   

   nmtui

   
   
3. Edit a connection → Wired connection 1 → <Edit…> を選択する
4. IPv4 CONFIGURATION を <Manual> に変更し、各項目を入力する

5. [X] Automatically connect と [X] Available to all users にチェックが入っていることを確認し <OK> で保存する
6. Quit で nmtui を終了し、リブートして反映する
   

   sudo reboot

   
   

   （接続だけ再起動する場合: sudo nmcli connection down "Wired connection 1" && sudo nmcli connection up "Wired connection 1"）

4. SSH の有効化

静的 IP 設定後、再度 sudo raspi-config を起動して Interface Options から SSH を有効化する。

1. sudo raspi-config を起動する
   

   sudo raspi-config

   
   
2. 3 Interface Options → I1 SSH を選択する
3. 「Would you like the SSH server to be enabled?」で <Yes> を押す
   ⚠️ デフォルト・脆弱なパスワードはセキュリティリスクとなる旨の警告が出る。強いパスワードを設定済みであることを確認すること。
4. 「The SSH server is enabled」の確認画面で <Ok> を押す
   これ以降、SSH でリモートアクセスが可能になる。
5. I2 RPi Connect を選択し <No> を押す（Raspberry Pi Connect は不要のため無効のままにする）

5. タイムゾーンの設定（JST）

raspi-config の Localisation Options からタイムゾーンを JST（Asia/Tokyo）に設定する。セクション1と同じセッション内でまとめて実施してもよい。

1. 5 Localisation Options → L2 Timezone を選択する
2. Geographic area: Asia を選択する
3. Time zone: Tokyo を選択する
4. 設定を確認する
   

   timedatectl

   
   

   Time zone: Asia/Tokyo (JST, +0900) と表示されれば完了。（コマンドで直接設定する場合: sudo timedatectl set-timezone Asia/Tokyo）

補足：設定値まとめ

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