BOSWatch/includes/decoders/zvei.py

#!/usr/bin/python
# -*- coding: cp1252 -*-

"""
ZVEI Decoder

@author: Bastian Schroll

@requires: Configuration has to be set in the config.ini
"""

import logging # Global logger
import time    # timestamp for doublealarm
import re      # Regex for validation

from includes import globals  # Global variables

##
#
# Local function to remove the 'F'
#
def removeF(zvei):
	"""
	Resolve the F from the repeat Tone

	@type    zvei: string
	@param   zvei: ZVEI Information
	
	@return:    ZVEI without F
	@exception: none
	"""
	if "F" in zvei:
		zvei_old = zvei
		for i in range(1, 5):
			if zvei[i] == "F":
				zvei = zvei.replace("F",zvei[i-1],1)
		logging.debug("resolve F: %s -> %s", zvei_old, zvei)
	return zvei

##
#
# ZVEI decoder function
# validate -> check double alarm -> log      
#
def decode(freq, decoded):
	"""
	Export ZVEI Information from Multimon-NG RAW String and call alarmHandler.processAlarm()

	@type    freq: string
	@param   freq: frequency of the SDR Stick
	@type    decoded: string
	@param   decoded: RAW Information from Multimon-NG

	@requires:  Configuration has to be set in the config.ini
	
	@return:    nothing
	@exception: Exception if ZVEI decode failed
	"""
	timestamp = int(time.time()) # Get Timestamp                  

	zvei_id = decoded[7:12]    # ZVEI Code  
	zvei_id = removeF(zvei_id) # resolve F
	if re.search("[0-9]{5}", zvei_id): # if ZVEI is valid
		# check for double alarm
		if zvei_id == globals.zvei_id_old and timestamp < globals.zvei_time_old + globals.config.getint("ZVEI", "double_ignore_time"): 
			logging.info("ZVEI double alarm: %s within %s second(s)", globals.zvei_id_old, timestamp-globals.zvei_time_old)
			# in case of double alarm, zvei_double_ignore_time set new
			globals.zvei_time_old = timestamp 
		else:
			logging.info("5-Ton: %s", zvei_id)
			data = {"zvei":zvei_id, "description":zvei_id}
			# If enabled, look up description
			if globals.config.getint("ZVEI", "idDescribed"):
				from includes import descriptionList
				data["description"] = descriptionList.getDescription("ZVEI", zvei_id)
			# processing the alarm
			try:
				from includes import alarmHandler
				alarmHandler.processAlarm("POC",freq,data)
			except:
				logging.error("processing alarm failed")
				logging.debug("processing alarm failed", exc_info=True)
				pass
			# in every time save old data for double alarm
			globals.zvei_id_old = zvei_id     # save last id
			globals.zvei_time_old = timestamp # save last time
	else:
		logging.warning("No valid ZVEI: %s", zvei_id)