BOSWatch/README.md

Python Script to receive and decode German BOS Information with rtl_fm and multimon-NG

Note:

This software is for illustrative purposes only and may be used only by authorized persons.

The intercept of the German BOS radio is strictly prohibited !!!

Please only use Code from master-Branch - thats the only stable!

unless you are developer you can use the develop-Branch - may be unstable!

Features

Implemented Features:

• FMS and ZVEI decoding and Displaying
• Filtering double alarms with adjustable time
• FMS and ZVEI validation (plausibility test)
• MySQL Database Support for FMS and ZVEI
• simple HTTP request at alarm to URL you want
• All configurations in seperate config File
• simple Web Frontend with Data Parsing
• Logfiles for better Troubleshooting
• verbose/quiet Mode for more/none information

Features for the Future:

• extensive filtering options
• POCSAG 512,1200,2400 support (need RAW data from multimon-ng)
• automatic Audio recording at alarm
• Web Frontend with Overview and configuration

Configuration

boswatch.py

The configuration for the Script you can find in config.ini

• You can set the ignore time for double alarms in seconds.
• to use the script with MySQL Support set "useMySQL = 1" and the Userdata to your local MySQL Database.
• to use the script with HTTP request Support set "useHTTPrequest = 1" and set a URL to your destination.

For the other Functions see "Usage" below.

Web Frontend

Put the Files in Folder /wwww/ into your local Webserver Folder (/var/www/). Now you must edit the "config.php" with your Userdata to your local Database. For the Parsing Functions take a look into the parser.php

Usage

sudo python boswatch.py -f 85.235M -a FMS ZVEI Starts boswatch at Frequency 85.235 MHz with the Demodulation Functions FMS and ZVEI.

Help to all usable Parameters with sudo python boswatch.py -h

usage: boswatch.py [-h] -f FREQ [-d DEVICE] [-e ERROR] -a
                   {FMS,ZVEI,POC512,POC1200,POC2400}
                   [{FMS,ZVEI,POC512,POC1200,POC2400} ...] [-s SQUELCH] [-v]

optional arguments:
  -h, --help            show this help message and exit
  -f FREQ, --freq FREQ  Frequency you want to listen
  -d DEVICE, --device DEVICE
                        Device you want to use (Check with rtl_test)
  -e ERROR, --error ERROR
                        Frequency-Error of your Device in PPM
  -a {FMS,ZVEI,POC512,POC1200,POC2400} [{FMS,ZVEI,POC512,POC1200,POC2400} ...],
  --demod {FMS,ZVEI,POC512,POC1200,POC2400} [{FMS,ZVEI,POC512,POC1200,POC2400} ...]
                        Demodulation Functions
  -s SQUELCH, --squelch SQUELCH
                        Level of Squelch
  -v, --verbose         Shows more Information
  -q, --quiet           Shows no Information. Only Logfiles

Installation

You can easy install BOSWatch with the install.sh Script.

• Download the install.sh in any Folder you want.
• Make it executeable sudo chmod +x install.sh
• And use the script sudo sh install.sh

Now the script downloads and compile all needed data. At the end you can find BOSWatch in ~/bos/BOSWatch/

Caution, script don't install a Webserver with PHP and MySQL. So you have to make up manually if you want to use MySQL support.

Requirements

• RTL_SDR (rtl_fm)
• Multimon-NG
• MySQL Connector for Python

optional

• Webserver with PHP
• MySQL Database Server

Thanks to smith_fms and McBo from Funkmeldesystem.de - Forum for Inspiration and Groundwork!

Greetz Schrolli