Skip to content

sigmafx/DotClk

Repository files navigation

DotClk

This is an Arduino compatible application for driving Dot Matrix Displays to display clock and pinball animations. Whilst it is developed on the Arduino IDE, it is intended for use on the Teensy 3.6 MCU.

Why Teensy 3.6?

The Teensy 3.6 comprises all of the necessary features to support a DMD clock:

  • On board Real Time Clock (RTC)
  • SD Card reader - allows update of pinball animations and fonts
  • Plenty of GPIOs
  • Vast library of existing Arduino code and examples
  • Performance - 180MHz clock speed easily allows DMD clock speed of 4-5MHz
  • Small package size
  • Cheap and easily available

How to Use the Hex File

Included in this repository is the hex file built from the latest source code. To upload the hex file to the Teensy you just need to download the loader application: https://www.pjrc.com/teensy/loader.html

How to Use The Source Code

To compile the source code you'll need to download the Arduino IDE and the Teensy extensions: https://www.pjrc.com/teensy/tutorial.html

You can then grab the code from the repository and compile / update the code locally as you need.

N.B. You'll need to use the SD library in the following repository: https://github.com/sigmafx/SD

This includes changes for fast directory listing using newly added function getNextFile.

When compiling the code use the following CPU Speeds (from Arduino IDE menu Tools->CPU Speed): Teensy 3.6: 180 MHz Teensy 3.5: 168 MHz (overclocked)

How to Use DotClk

The code is designed for use with the DotClk interface board. The code is well documented for the pin assignments for the various connections to the screen and the control buttons.

Pressing the Menu button will display the menu. Use Prev and Next buttons and the Edit / Back buttons to setup the clock.

Press and hold the Back button to turn off the display. Press and release the Back button to turn on again.

Where are the Animations Held?

On the SD Card there needs to be a directory called Scenes. Place the animation scene files (.scn) in this directory.

Where are the Fonts Held?

On the SD Card there needs to be a directory called Fonts. Place the font files (.fnt) in this directory.

Get in touch if you need any help - I hang out on PinballInfo.com, user DrPinball.

If the clock keeps crashing / screen goes blank

If you are affected by a blank screen or crashing clock please follow the instructions here: https://github.com/sigmafx/DotClk-Help#if-the-clock-keeps-crashing--screen-goes-blank

About

Arduino source code

Resources

Stars

Watchers

Forks

Packages

No packages published