Activity Logger User's Guide

Frequency Manager Suite
Activity Logger
User’s Guide
Copyright © 2015 Jeff Knapp N8GJL sdrs.freqmgr@cox.net

Introduction

The FMSuite Activity Logger (called AL in the rest of this guide) is a free plugin designed for use within the SDR Sharp software application. It records scanner activity created by the Frequency Manager + Scanner plugin.

System Requirements

Basically if you can run SDR Sharp, you can use the Activity Logger.
  • Operating Systems: Windows 7, Windows 8.x, and Windows 10. The binaries are compiled for a 32-bit environment for the broadest compatibility but run equally well in an x64 environment.
  • Processor: 1-gigahertz processor or faster; 2 or more cores is recommended. Hyper-threading/Multi-threading should be enabled for the best performance. NOTE: SDR# and my plugins are multi-threaded applications, which means they perform multiple tasks simultaneously. As a result you may have performance problems if your processor cannot execute at least 4 threads simultaneously.
  • Memory: 1 gigabyte or more total in the computer.
  • Hard Disk: The software requires about 13KB.
  • .NET: Version 4.6 runtime as required by SDR Sharp.
  • SDR#: Revision 1408.
  • Frequency Manager + Scanner from the Frequency Manager Suite.
Important Note
SDR# is a hobby project created by other people and I am not involved in it. I have no control over changes made to SDR#. I am completely at their mercy as to how their changes affect AL. They are under no obligation to inform me of changes; I won’t know if their changes will break my plugins until the plugins are run with the new version of SDR# and you tell me there is a problem. As a result there will be a period after they make a breaking change in which my plugins may not work. Please be assured I will make any necessary changes, and release updates, as soon as practical after SDR# is changed and I have identified the issue.

Using the Activity Logger

The AL listens for activity from the Frequency Manager + Scanner plugin. When the scanner finishes listening to a frequency, the following data are written to the file. Each row in the log represents one start time + end time + frequency event.
  • Reception Start (date and time)
  • Reception End (date and time)
  • Frequency (in Hertz)
  • Center (in Hertz)
  • Description (from the Frequency Manager database if present)
  • Notes (from the Frequency Manager database if present)
  • Protocol (from the Frequency Manager database if present)
  • Service (from the Frequency Manager database if present)
  • Callsign (from the Frequency Manager database if present)
  • Shift Enabled
  • Shift
  • Filter Type
  • Filter Bandwidth
  • Squelch Enabled
  • Squelch
  • CW Shift
  • Timeout Seconds (setting from the scanner)
  • Minimum Signal Strength (setting from the scanner)
  • Actual Signal Strength
  • Log Reason (Timeout, Watchdog, or Skip button)
The logs are written in CSV format with double-quotes around text fields to have the highest level of compatibility with other applications.

The Activity Logger Panel

Write Headings to File

Depending on your ultimate use of the log file you may or may not require that column headings be present in line 1 of the file. Put a check mark here to cause column headings to be written to the file.

Don’t log activities shorter than X seconds

Depending on how you scan, you might get very short, possibly empty, transmissions. Using this setting will prevent those from being logged. Normally this value is set to less than the “Seconds wait for more transmission” value in the Scanner.

Activity Indicator

This row of 3 red blocks appears after the logging is started and the first activity record is received from the Frequency Manager + Scanner plugin. It is animated and will display until logging is stopped by one of the following buttons.

Auto Start Logging

When clicked, the button watches for activity records from the Frequency Manager + Scanner plugin. After the first record is received the Activity Indicator appears and logging is started; and the button caption changes to “Stop Logging”. You may turn off Auto Start by simply clicking the button again.

Log Files

File generated by the plugin are in a subfolder of the SDR# folder, named “FMSuite.Activity.Logs”. Files are named for the year, month, and day that they were created. For example, “2015-06-27.csv” contains logs written on June 27, 2015. Logs, when received, are automatically appended to the existing log file for that day.
If a logging session should run past local midnight, a new log file named for the new date will be created.

Known Issues

None.

Notices

  • “SDR Sharp”, “SDR#”, and the SDR# software are Copyright © Youssef TOUIL 2012.
  • “FreqMgr”, “Frequency Manager + Scanner”, “Frequency Manager Suite”
    and software distributed with the Frequency Manager Suite are Copyright © 2013-2015 Jeff Knapp.

No comments:

Post a Comment