From e6f69f79ffac3a5aa6490963e5dd39fc6de6c9bc Mon Sep 17 00:00:00 2001 From: Schrolli Date: Wed, 20 May 2015 13:47:12 +0200 Subject: [PATCH] update readme --- README.md | 64 ++++++++++++++++++++++++++----------------------------- 1 file changed, 30 insertions(+), 34 deletions(-) diff --git a/README.md b/README.md index 03949f5..c2a82d8 100644 --- a/README.md +++ b/README.md @@ -13,32 +13,36 @@ unless you are developer you can use the develop-Branch - may be unstable! ### Features ##### Implemented Features: -- FMS, ZVEI and POCSAG decoding and Displaying +- FMS, ZVEI and POCSAG512/1200 decoding and Displaying +- Plugin support for easy Functions extension - Filtering double alarms with adjustable time -- Data validation (plausibility test) -- MySQL Database Support -- simple HTTP request at alarm to URL you want +- Filtering of POCSAG RIC´s - All configurations in seperate config File -- simple Web Frontend with Data Parsing +- Data validation (plausibility test) - Logfiles for better Troubleshooting - verbose/quiet Mode for more/none information -- POCSAG1200 and POCSAG512 support -- Filtering of POCSAG RIC´s (adjustment at config) ##### Features for the Future: - extensive filtering options - POCSAG 2400 support (need RAW data from multimon-ng) -- automatic Audio recording at alarm -- E-Mail Notification -- Web Frontend with Overview and configuration + + +###Plugins +##### Implemented Plugins: +- MySQL +- BosMon + +##### Plugins for the Fetaure: +- HTTP-Push +- E-mail Notification + ### 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. -- you can adjust your rangefilter for POCSAG Decode. -- 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. +Take a look into the /config/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. @@ -47,6 +51,7 @@ 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. @@ -59,21 +64,19 @@ usage: boswatch.py [-h] -f FREQ [-d DEVICE] [-e ERROR] -a [{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 + -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 + 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. @@ -87,16 +90,9 @@ In case of an Error during the Installation, check the Logfile in `~/boswatch/in 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 - Python Support - MySQL Connector for Python - -##### optional -- Webserver with PHP -- MySQL Database Server - -Thanks to smith_fms and McBo from [Funkmeldesystem.de - Forum](http://www.funkmeldesystem.de/) for Inspiration and Groundwork! - -###### Greetz Schrolli