This live screen grab is from one of my HamClocks. It updates automatically every two minutes after making a random configuration tap. Click for an hour history.

Ham Clock

This page refers to my QST article in the October 2017 issue. All updates will be posted here.

Click on the tabs below for more information.

I would like to give a Big Shoutout to Adafruit for their great electronics, software and tutorials.

If you are experiencing touch lockout, try turning off RSS. Or update to at least version 1.47 where the issue has been addressed. The problem began when eHam recently changed their RSS from http to https. HamClock did not expect https and gets stuck in a retry loop during which everything gets locked out except the time display which is the highest priority task for HamClock.

Remote update was added in version 1.38. If your version is older than this you have the following choices:

  • Leave RSS off
  • Build the latest source and reflash your Huzzah
  • Purchase a new Huzzah from me

73, Elwood Downey, WBØOEW

Original QST Article proof

There is a typo in Table 1. The RA8775 costs $35, not $5.

There is a typo in Fig 2. The 33K resistor should be 330K.

It should be noted if you do not want to use the photoresistor, it is best to ground the analog input pin ADC (sometimes also known as A0).

Download current stable release source code Version 1.49.

Revision history:

Version 1.49: Version 1.48: Version 1.47: Version 1.46: Version 1.45: Version 1.44: Version 1.43: Version 1.42: Version 1.41: Version 1.40: Version 1.39: Version 1.38: Version 1.37: Version 1.36: Version 1.35: Version 1.34: Version 1.33: Version 1.32: Version 1.31: Version 1.30: Version 1.29: Version 1.28: Version 1.27: Version 1.26: Version 1.25: Version 1.24: Version 1.23: Version 1.22: Version 1.21: Version 1.20: Version 1.19: Version 1.18: Version 1.17: Version 1.16:

Here is a more detailed list of steps to prepare and load the software:

  1. Install the latest Arduino IDE with these these instructions. I am currently using version 1.8.5.
  2. Load up the ESP extension described here then Exit the Arduino IDE.
  3. Download and install the following Arduino libraries:

    If you need help with libraries in general try here

    • GFX
    • Sensor
    • BME280
    • TimeLib
    • RA8775

      This one has a bug you must fix. After installing this library:

      1. open the file Adafruit_RA8875.h with a text editor
      2. find the two places that contain virtual size_t write near line 133
      3. comment them both out so the result looks like this:

        /* Play nice with Arduino's Print class */
        /* comment out for HamClock ← add this line
        virtual size_t write(uint8_t b) {
        textWrite((const char *)&b, 1);
        return 1;
        virtual size_t write(const uint8_t *buffer, size_t size) {
        textWrite((const char *)buffer, size);
        return size;
        */ ← add this line

  4. Connect your computer to the Huzzah with a USB port
  5. Download current stable release Version 1.49, unzip it any place you wish.
  6. Start the Arduino IDE. Open the ESPHamClock.ino file you just unzipped. This will create a new project.
  7. In the IDE Tools menu make the following selections:

    If the options you see do not look exactly like mine do these steps:
    1. open Tools → Board → Boards Manager...
    2. In the search box type esp. Look for esp8266
    3. Click More Info
    4. Click Select version and select 2.4.0
    5. Click Update
    6. Click Close
  8. Run Sketch → Compile then Sketch → Upload
  9. Your HamClock should start running. Follow the touch screen and setup functions carefully.
For those who prefer not to build the software, I am making available the same Adafruit HUZZAH board used in the HamClock already programmed with the latest HamClock software. Just wire it up according to the schematic in the article and you are immediately ready to go. And with the built-in network update function you can stay up to date without having to purchase again in the future.

Click on the button below to order; you may use your paypal account or any credit card.

To use a 9" ER-TFTM090-2 from

Select these options during purchase:

This is the wiring list:

	EP = ESP Huzzah
	BM = env sensor
	PC = photo cell
	DP = display

	EP_3V     BM_VIN

	EP_ADC    PC_1, 330k
	EP_GND    PC_2
	EP_3V     330k

	EP_SCK    DP_8
	EP_MO     DP_7
	EP_MI     DP_6
	EP_2      DP_5
	EP_16     DP_11
	EP_USB    DP_3, 4, 37, 38
	EP_GND    DP_1, 2, 13, 31, 39, 40



The display stand from Adafruit can be made to work with a little ingenuity but is not perfect for the LCD. Send suggestions for better ideas and I will post here.

If you find your display idea works better if the cable exits from the top, let me know. I can share a software change contributed by N9DK that will rotate the entire scene. Hopefully this will eventually be picked up in a later rev of the effected library from Adafruit. For now you will have to do a few things manually in the software build procedure to make it work.

Shack photo showing 7" version.

Rear of 7" version

Both the 7" and 9" versions.

Rear of 9" version

This is a guide to the touch controls and map symbols of HamClock. Click for a printable view in a separate window.