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

Notice:

The intercept of the German BOS radio is strictly prohibited and will be prosecuted. the use is only authorized personnel permitted. The software was developed using the Multimon-NG code, a function in the real operation can not be guaranteed.

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
• POCSAG1200 and POCSAG512 support
• Filtering of POCSAG512 and POCSAG1200 RIC´s (adjustment at config)

Features for the Future:

• extensive filtering options
• 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

filtering

• you can adjust your rangefilter for POCSAG Decode at config file under the section POC

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

Greetz Schrolli