BOSWatch/README.md

Codacy - static code analysis:

branch	quality
master-branch
develop-branch

Achtung: Die readme ist veraltet - Neue Informationen werden im Laufe der Zeit in das Github Wiki integriert!

Attention: This readme is outdated - New informations will be integrated in the Github Wiki!

📡 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, ZVEI and POCSAG512/1200/2400 decoding and displaying
• Plugin support for easy functional extension
• Filtering double alarms with adjustable time and check width
• Filtering allowed, denied and range of POCSAG RIC´s
• Filtering data for each typ/plugin combination with RegEX
• All configurations in a seperate config file
• Data validation (plausibility test)
• Description look-up from csv-files
• Logfiles for better troubleshooting
• verbose/quiet mode for more/none information
• Ready for use BOSWatch as daemon
• possibility to start plugins asynchron
• NMA Error Handler

Features for the future:

• more plugins
• other Ideas per Issues please

###Plugins If you want to code your own Plugin, see plugins/README.md.

Implemented plugins:

Plugin	Function	FMS	ZVEI	POC
MySQL	insert data into MySQL database	✅	✅	✅
httpRequest	send a request with parameter to an URL	✅	✅	✅
eMail	send Mails with own text	✅	✅	✅
BosMon	send data to BosMon server	✅	✅	✅
firEmergency	send data to firEmergency server	❌	✅	✅
jsonSocket	send data as jsonString to a socket server	✅	✅	✅
NMA	send data to Notify my Android	✅	✅	✅

• for more Information to the plugins see config.ini

Plugins for the Future:

• Ideas per Issues please

Configuration

boswatch.py

Take a look into the folder /config/ Rename config.template.ini to config.ini In the Section [BOSWatch] you can set double_alarm_time etc. In the Section [Plugins] you can activate or deactivate the Plugins For each plugin that requires configurations, a own Section with his name is available

For the other functions see "Usage" below.

Filtering Functions (RegEX)

For the RegEX filter functions see Section [Filters] http://www.regexr.com/ - RegEX test tool an documentation

No filter for a combination typ/plugin = all data will pass

Syntax: INDIVIDUAL_NAME = TYP;DATAFIELD;PLUGIN;FREQUENZ;REGEX (separator ;)

• TYP = the data typ (FMS|ZVEI|POC)
• DATAFIELD = the field of the data array (see readme.md in plugin folder)
• PLUGIN = the name of the plugin to call with this filter (* for all)
• FREQUENZ = the frequenz to use the filter (for more SDR sticks (* for all))
• REGEX = the RegEX

only ZVEI to all plugins with 25### at 85.5MHz testfilter = ZVEI;zvei;*;85500000;25[0-9]{3}

only POCSAG to MySQL with the text "ALARM:" in the message pocTest = POC;msg;MySQL;*;ALARM:

Web frontend (obsolete)

old data in folder /exampeAddOns/simpleWeb/

Put the files in folder /wwww/ into your local webserver folder (f.e. /var/www/). Now you must edit the "config.php" with your userdata to your local database. Take a look into the parser.php for the parsing functions

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. Parameter -f/--freq and -a/--demod are required!

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
  -u, --usevarlog         				Use '/var/log/boswatch' for logfiles instead of subdir 'log' in BOSWatch directory
  -v, --verbose         				Shows more information
  -q, --quiet           				Shows no information. Only logfiles

Installation

Please follow the instructions written down in the wiki:

https://github.com/Schrolli91/BOSWatch/wiki

You just need to download a single file since the installer manages the whole process except the installation of a webserver and a database.

If you want to use BOSWatch as a daemon, you have to set your configuration in service/boswatch.sh and copy it to /etc/init.d. Then you can start BOSWatch with sudo /etc/init.d/boswatch.sh start. For configuration-details see service/README.md.

Requirements

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

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

Code your own Plugin

See plugins/README.md