The DX Alarm Clock – Part 1: Software


dx-alarm-clock-standalone

The DX Alarm Clock

I have been a Ham for 5 years and my favorite thing to do is chase DX. As a new Ham it was always a thrill to work a new DXCC, but now that I have over 280 DXCCs and over 1000 band points, it is a little more difficult to find a new one. Add to that the fact that I am trying to get a DXCC in 80m and 160m., which are usually open when I am asleep. I created the DX Alarm Clock as a way to get notified that there is something new on the air when I am not down in the shack.  This article will talk about how I developed the software for the DX Alarm Clock.  Part 2 will talk about the building the Raspberry Pi based Hardware and loading the OS.

The DX Alarm Clock is a Python software program running on a Raspberry Pi that gathers data online about my log and what is on the spotting network and uses that data to alert me when there is a “new one” on the air.

architecture

DX Alarm Clock Architecture

The ClubLog website provides a light DX Cluster website called DXLite, which has an XML Interface. The DX Alarm Clock uses this interface to get the current spots. The software uses the Developer API from ClubLog to get a JSON matrix of all DXCC entities by band indicating whether I have worked, confirmed or verified each band-entity. The software loops through all of the spots returned by DXLite and looks each DXCC up in the JSON ClubLog matrix. I also use the QRZ.com XML Interface to get additional information for each callsign that is spotted, like the state.

dxcc-config-screen

DXCC Configuration Screen

The DX Alarm Clock uses tkinter/ttk for the GUI.  I used the Notebook widget to create a multi-tab GUI.  There is a tab for configuring filters for DX Entity. The user can choose all New DXCCs, as well as specific bands and nodes to provide alerts for.

was-config-screen

WAS Configuration Screen

There is another tab for configuring filters for WAS. ClubLog has no log look up capability based on US State so the WAS filter lets you create a list of States and associated bands to provide alerts for.

notification-config-screen-with-blur

Notification Configuration Screen

The Notification tab allows configuration of what notifications the user would like to receive. The user can specify a separate email address for New DXCCs, New Band Points, and New US States. This allows alerts to be sent to email accounts or as SMS texts. You can also configure the sounds the the DX Alarm Clock itself makes to “wake you up” when that ATNO or new Band Point is spotted.

The DXAlarm clock wakes up every 5 minutes and gets the latest spots from the DXLite Cluster. It checks each spot against the ClubLog log and if there is a match based on the configure filters, it sounds the alert, and then speaks the alarm, giving you the Callsign, DXCC Entity, Band and Mode.   A simple text to speech package called flite (festival-lite) was used to implement the speech on the Raspberry Pi.

 

alert-screen

Alert Screen

It also puts a message with these details and the Frequency, UTC Date/Time, Spotter and Comment on the display.

iphone-notification

Text Notification to iPhone

Additionally it sends this information as an email to the configured email address, which results in a text or email.

 

iwatch

Apple Watch Alert

I can even get the alert on my Apple Watch.

spots-screen

Filtered Spots Display

Once all spots are processed, it keeps a running list of all spots that resulted in alerts on the main screen. Spots are aged out if they do not recur over time.

dx-alarm-clock

DX Alarm Clock Hardware

The DX Alarm Clock just alerted me that ZC4SB is on 20m – that’s an ATNO!  Got to go down to the shack and work him!    Stay tuned for Part 2 of this post on the DXAlarm Clock Raspberry Pi based hardware and on setting up the Raspberry Pi OS.

Anita, AB1QB

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s