Making a Raspberry Pi Boombox (AKA UNIAC Software In Detail)

Introduction

Most of you who see this post will have seen the original UNIAC post before this, and hopefully some will have seen the post detailing the hardware. For those who haven’t, UNIAC is a Raspberry Pi based Spotify playing boombox that is controlled with buttons on the front and displays status using Nixie tubes. This post will cover the software used to make UNIAC work — both tools developed by others and the software I wrote myself.

While I am writing this from the perspective of documenting UNIAC, the software could be pretty easily recycled to work with any display and buttons, you’d just have to rewrite the display and button event functions to support your hardware.

Also note that I did a major ripup of the UNIAC software after the original post, so this version does not use Mopidy, MPD, or Mopidy-Spotify. And if any of you have used those tools before, you’ll understand that’s a good thing.

I will start with a disclaimer however: I am an electrical engineer, not a software engineer, so this design will probably make software guys sick to their stomach. Sorry in advance…

Third Party Software

The first thing to understand about the architecture used in UNIAC is that control and playback of music are two separate processes. Raspotify is a software package that connects to Spotify and makes your RPi act as a Spotify endpoint. Essentially a dedicated speaker. There are a couple of similar packages that can give you a Spotify client on a RPi, but Raspotify has a trivial installation process:

curl -sL https://dtcooper.github.io/raspotify/install.sh | sh

The second part, Spotipy, is a Python library that you give permissions on your (paid) Spotify account. It allows you to see current playback status, and control playback on your Spotify devices (computers, speakers, etc). By combining these two, you can have a full Spotify instance running on your device with programmable control.

The two pieces are connected by the UNIAC Python script. UNIAC sets up a spotipy connection and then controls what device the playback occurs on. Since the name of the UNIAC Raspotify instance is constant, it simply has to tell Spotify to playback there, and music will play on the UNIAC hardware. This has the added benefit that I can ‘cast’ whatever I’m currently listening to over to UNIAC and it will just continue to play.

UNIAC / Spotify control.

The last piece worth mentioning is eSpeak, a relatively primitive speech synthesizer that takes strings from the command line and announces them. This lends UNIAC its characteristic robot voice when announcing settings information and playlist names.

Hardware Libraries

Path between the controls, the Display, and UNIAC.

The hardware interfaces are pretty straightforward, mostly. The buttons are controlled by an i2c GPIO expander, and Adafruit has the MCP230XX library to support it. For other GPIO, I use RPi.GPIO.

The last, and most unique library is the NixieDisplay library. It is a custom library that I developed to communicate with my Teensy 3.2 based multiplexing, crossfading Nixie display. In the first prototype, I used Taylor Edge SmartNixie modules instead of my custom display, so I also wrote a library supporting them on the RPi, though I’m not using it on the finished version.

These libraries are pretty straightforward. You print numbers to the tubes to display and forget about it.

The VU-Meter only has an audio input, so it doesn’t have any software control and doesn’t appear on any of these block diagrams.

UNIAC Software Architecture

The UNIAC software is essentially an interrupt driven button handler. There is a master ‘Menu’ class in Menu.py to which arbitrary ‘Modes’ are attached. An attached mode must provide a function handler for each physical button as well as a display update handler (and a few other helper functions).

When a button is pressed, the Menu object calls the current Mode’s handler for that button.

Button Press Event

The UNIAC.py script creates a Menu instance and attaches the modes defined in that script. The modes (currently) are: clock, track time, date, alarm clock, change playlist, and options.

Modes attached to Menu in UNIAC.py

For instance, when the ‘Plus’ button is pressed in the track time mode, the menu object will use Spotipy to progress to the next track, but when ‘Plus’ is pressed in the alarm mode, it will advance the alarm time by one.

The ‘Mode’ button is a special case that does not call an attached handler function but instead changes the selected mode in the Menu object.

The Menu object also requires that each mode have a display update handler. This handler is called by the master UNIAC.py script in an infinte loop to update the display every 100 ms.

Display Updater

This code was actually based off of another (unfinished) project of mine which used two buttons and a character LCD. By changing the displayUpdate function and the button handlers, this script could be used for virtually any menu interface with multiple ‘pages’.

Interfacing with Spotipy

As discussed in the preceeding section, UNIAC is controlled through a series of button handlers. To interface with Spotipy, most of the modes used in UNIAC inherit from the mpdGeneral class.

mpdGeneral class definition

This class has a few static variables and references the globally available spotipyLogin.sp object, which is an instance of the bare Spotipy API created by the spotipyLogin.py script. It includes things like track status, play, pause, loading a defined playlist from URI, listing available playlists, et cetera.

The UNIACConfig class allows settings like alarm time, current playlist, and settings to be pickled to a config file and loaded on restart. The other classes (including the option menu mode) use this class to handle i/o to the settings file, ‘UNIAC.conf’.

UNIACConfig class.

The remainder of the classes are more or less straightforward implementations of their self explanatory modes and hook the various parts and pieces together.

The last piece of secret sauce, which is not on git, because it is in m gitignore is spotipyLogin.py, a simple script which holds my Spotify login credentials and makes a logged in Spotipy object available.

The redacted version of spotipyLogin.py

UNIAC Supervisor

Finally, there is a UNIAC supervisor script. This is an independent Python process which checks if the UNIAC script is running and if not launches it. It also checks that only one instance of the script is running, and if a second copy has started somehow, kills all but the first process. It’s not strictly necessary, but is a nice-to-have feature. I ran without it for years, with only occasional failures.

UNIAC supervisor script.

Conclusion

The UNIAC software is a combination of several bits and pieces of code which allows a button driven paged menu system to control the Spotify web API and stream music for plaback locally on the RPi, as if it were a commercial product. The interface is ideally suited to a ‘Nixie Boombox’ but could be used with any oddball display you wanted with a little modification.

Thanks for reading.

UNIAC Hardware In Detail

After sharing my last post on Reddit and Hackaday, I’ve gotten lots of kind feedback — and I deeply, deeply appreciate it all. More than anything else, it makes me regret not sharing this project with you sooner.

That said, the biggest ask has been for a detailed build guide. Unfortuantely, I didn’t document the build process in enough detail to write up a step by step guide, and I just don’t have the energy to build an entire new copy right now.

What I can do, however, is share discuss the design choices I made and share the build files. This post will focus on the hardware design of UNIAC, and I will follow it with a post detailing the software in greater detail.

Schematics

The schematic capture and layout was done in Eagle, and broken out into pages. It’s not perfect, by any means, but it’s clean enough.

Anyway, let’s go through the sections.

Raspberry Pi, Buttons, Sound Card, Amplifier

This section has:

The Raspberry Pi itself — note that the footprint says “Raspberry Pi Model B+”, but is actually sized for the Pi Zero W. I recycled an existing symbol because the header pinout is the same across both versions of the Pi, and simply forgot to rename it in Eagle. It also specifies a 7805 5V regulator to power the Pi off the input 12V bus. In practice I used a drop in switch mode replacement for the 7805 from Murata.

The button interfaces — supports two options to connect buttons. The first one, Buttons A, is for directly connecting to the motherboard. I used this option in the first two prototypes and decided to keep the option open here in case the button breakout board had problems, since I had the board space. The button connections here include a provision for +12V to illuminate the buttons, a shared switched ground line to control button illumination, resistors to pull up the buttons and caps for debounce.

Buttons B is a header for the button board, shown later. It breaks out the I2C bus connected to the RPI as well as a 3.3V rail for powering an offboard IC and a 12V rail for powering button illumination. Finally it has an interrupt pin so that the Pi can detect when the button board needs to be polled.

Finally it has footprints for I2S DAC (sound card) and Adafruit class-D amplifier. Not too much to see there.

VU-meter section

The next page of the schematic is a direct copy of my IN-13 VU Meter circuit. I won’t go into a full description of the theory, but it uses a quad rail to rail op-amp to save parts (I usually populate with an LMC660), and MPSA42 high voltage small signal transistors to drive the IN-13s. There is also an ATTINY85 micro running this code to make it act as a log converter. This saves parts and board area vs an analog implementation as well as allowing the VU meter to go to sleep if there’s been no audio for a couple of minutes.

Nixie display section

The third page of the schematic covers the Nixie display. This design was inspired by Dave Jones’ (of EEVBlog) Nixie tube driver design, which attempts to save transistors by using multi transistor ICs. Ultimately, I’m not very happy with that part of the design as there seems to be enough leakage that minor ghosting is visible on the tubes. I’ll definitely revisit it for my next Nixie project.

The controller for the display is a Teensy 3.2 which accepts commands to display values on the Nixies and INS-1 neon lamps via I2C and supports crossfading between digits.

Button breakout board

Finally, The button board uses an I2C GPIO expander IC to provide the same functionality as the individual button headers shown earlier, but without having nearly as many wires. The downside is that it requires an extra IC to do the job, and once the buttons are in the case, they’re soldered to the PCB and are pretty much stuck for good.

Layouts

The UNIAC mainboard layout is pretty compact. There’s not too much to talk about. Most of the size was defined by the need to have the Nixies at the top, bargraph tubes in the middle, and buttons at the bottom. Except for the routing around the Nixies themselves, there were no space constrained areas. I did choose to put the Teensy and RPi near the edges, so that their USB ports were practically accessible, however.

UNIAC Mainboard.

I went to great lengths to calculate minimum creepage distances and trace widths, which I used as design rules to ensure the Nixie display would be safe while being as small as I could make it. When routing my HV traces, I assumed 200 V DC and used a calculator like this one. I ended up using approximately 16mil or 0.4mm as my minimum trace clearance.

Closeup of the HV nets for the Nixies.

For trace width, I used 4PCB’s calculator, and found that even 600 mA would only cause a 10˚C rise for a 6 mil (0.15 mm) wide trace, way more than any of my HV traces were going to carry.vI also chose to keep the ground plane far away from the HV areas for added safety. Given that the Nixies are multiplexed and connect to ground only at a few points, it made sense and decluttered the design.

Finally, we go to the ‘Button Board’. The front panel control buttons are mounted to the front of the case and then soldered to this PCB. It’s a fairly simple design, but it has a couple of notches to clear the standoffs that mount the mainboard and speakers to the case.

Button board.

The biggest pain about this board was getting it fabricated. The buttons have wide pins that need to be fabricated as small slots. This is because the pins are so wide and closely spaced that large enough circular holes actually overlap each other.

It took three tries to get the boards fabricated. I had to make sure that the slots were on the correct layer in the footprint and had to specifically reach out to the PCB vendor in advance to ask them to send checkplots to confirm that the board would get fabbed correctly.

The first order was from AllPCB without asking in advance and they simply milled the small circular holes instead of slots. The second time, they promised that they would send me checkplots, but just fabbed the board without doing so. They also ignored my customer complaint.

It was at that point that I switched to PCBWay, who provided checkplots as requested, but they actually had the slots correct on the first try, resulting in great boards. My only regret is that their matte black soldermask is slightly shinier than AllPCB’s so the boards don’t quite match the mainboard.

The Eagle files for the switch board and main board can be found here.

BOM

The bill of materials, that is, the list of all the components used, is fairly long. It lists all the components that go on the main board, as well as the button board, and all of the off board components that I could think of. Since it’s a big, ugly table, I’m just going to attach it as a csv. The major parts themselves are detailed in the first UNIAC post.

Anyway, the full BOM can be found here.

Enclosure

Making the enclosure was a blast. My workflow is terrible and costs me several pieces of plastic on each new design I come up with, to be honest. I design the acrylic pieces as 2D Inkscape images and handle the ‘3D Modeling’ in my head. It’s even lower rent than DaveCAD!

Front Panel. Bent along the red horizontal lines which are not visible in finished enclosure.
Rear Panel. Bent along (Faint) dotted red vertical lines, which are not visible in the final enclosure.

A raw, laser-cut friendly Inkscape SVG file can be found here, with the front and back on various layers.

Conclusion

Well folks, that’s the hardware in a nutshell. The software will be another post.

UNIAC: The Ultimate Nixie Internet Alarm Clock.

UNIAC. The non-portable 2015 UNIAC prototype is lurking in the background…waiting.

Introduction

What is UNIAC? It is the Ultimate Nixie Internet Alarm Clock.
It’s a Nixie alarm clock / boombox.

  • It uses a Raspberry Pi to stream music from Spotify.
  • It has integral IN-13 VU meters to visualize the music.
  • It’s got a robot voice to relay information that the Nixies cannot.
  • It’s got clickety light-up buttons on the front.
  • It’s got a translucent clamshell case made of smoked acrylic.

It’s a piece of the future that never was. In short, it’s cool.

Motivation and Background

My First Nixie Display

I built my first Nixie Clock in 2006, which worked, but I was never satisfied with the design. I soon began fantasizing about what my dream Nixie clock would look like. It would replace my dusty old RadioShack alarm clock.

Unfortunately, life got in the way. The project got shelved, and grad school came along, but the idea hung in the back of my mind. By 2015, the technology landscape had changed and my hands on electronics skills had grown. I had new options, and came up with a new plan using a RaspberryPi. The ultimate Nixie clock would have:

The cheap LED alarm clock that motivated me.
  • Clock
  • Alarm
  • Calendar
  • Spotify as the music/alarm source

To tackle this relatively complex project, I decided to break it into parts. After tackling each subsystem individually, I had a reliable, tested circuit and was able then to integrate them into a unified system.

Two Builds

The first version was built in late 2015. It was a cube of laser cut acrylic sheets with the various subsystems mounted to an internal backplane with standoffs. The internal structure was built from square 3/8″ dowels which held the sides together. This version has served well on my electronics bench since it was put together, but it always bothered me that it was extremely cumbersome to open up and service. Additionally, the acrylic backplane was just inelegant.

UNIAC 2015: Front view
UNIAC 2015: Rear view. I never got around to fabricating the back panel.
UNIAC 2015: Top view with the lid off. Inside can be seen the backplane and the rails it slides into.

In 2019, with this in mind I decided I could do better. I integrated all of the components (except the front panel buttons and speakers) onto a motherboard. With a single board, I decided on a boombox form factor. This version isn’t really a good fit for a bedside alarm clock, but it is extremely satisfying.

UNIAC 2019, in the boombox style clamshell case.

To enable this, I built an acrylic bending jig, and designed a clamshell case to hold it all. The case was made from two pieces of laser cut acrylic. The back panel is solid black to keep ambient light out. The front is smoked grey and hides the electronics but lets the Nixie goodness shine through.

Acrylic bender on the bench with a piece of test plastic (and the rev of UNIAC 2019 mobo in the background).

Getting the acrylic bent at the right spot took a few tries — the first test (using cheaper clear plastic) put the bend too close to the button cutouts. This caused the holes to deform and become teardrop shaped. I still think the clear case has a cool 90’s feel to it, but that doesn’t fit my general design tastes, so I stuck with the plan to go to a smoked front panel.

UNIAC 2019: First test enclosure.

After a couple of revisions, the final two piece enclosure came together nicely. I was worried that lifting the unit by the handle would cause the acrylic to flex, but it’s actually reasonably sturdy. I might consider some additional brackets to more firmly attack the front to the back in the future. For now, I think mounting the two haves together through motherboard standoffs is sufficient.


UNIAC 2019 showing the clamshell case open, with the motherboard and button board.

The VU-Meter

The IN-13 Vu-Meter as a standalone module.

When audio is playing from UNIAC, it really needed to show some “activity” — something like an oscilloscope would work, but in keeping with the Nixie theme, I decided to use the IN-13 bargraph tubes to display the sound levels on the left and right channels. No digital trickery here, the module takes analog line-level audio as a passthrough and displays the amplitude level of the audio channels on its IN-13 bargraph tubes. I’ve seen lots of mono IN-13 VU-meters, and I’ve seen a few standalone modules, but I’ve never seen them combined with normal Nixies before.

While I originally designed the VU-meter module intending to use it as a drop in component in UNIAC, the circuit has seen more service hours as a standalone module in my hi-fi (it’s been in near-constant use since late 2015). Nonetheless, it looks great in its intended role as a component of UNIAC.

I described the design of this component in detail in a series of previous posts, which includes some theory, design decisions, and schematics.

The Nixie Display

Because UNIAC is a media player, it needed a general purpose addressable Nixie display, not just a Nixie clock module. This part of the project was actually the first I began to tackle, back in 2009. I had nearly finished a display module using an 8051 and written in assembly, but stopped work when I went back to school. With cross-fading and all sorts of neat features, it was more or less what I wanted, but it had minor ghosting issues that I was unwilling to tolerate. Therefore, version one (2015) used Smart Nixie modules from Taylor Edge with a modified backplane.

Nixie display using a Teensy 3.2 developed for another project.

For the final version (2019), I based the design off a four tube Nixie display module using a Teensy 3.2 I had built for another project. When I finish that project, I will describe it in detail in a post. Until then, you can see the prototype at the right. The chief advantages to this design are a reduction in cost versus six Smart Nixie sockets, and the ability to integrate it onto the new motherboard without using risers. The UNIAC version of the display supports six tubes and uses IN12As, but is otherwise broadly the same design.

Input is via USB serial, TTL serial or i2c inputs and supports both dimming and crossfading.

Admittedly, multiplexing by 6x instead of 4x leads to a slightly dimmer display than the previous Smart Nixie approach, but it’s good enough. If there’s a future build, I’ll likely split it up into two banks of three tubes to increase the brightness (at the cost of board area and complexity).

The Motherboard

With the Nixie display circuit and the vu-meter circuit validated, it was time to build a full system.

Version 1, built in 2015 prototype was a ‘wired together modules’ build. Using a laser cut backplane, the various modules were mounted to both sides with standoffs. The backplane then slotted into a cube made with an internal wooden frame covered with laser cut panels. This design worked well, but the rats nest of wires made it an absolute nightmare to open up and work on.

For the final version, I decided I had to replace the backplane board with a PCB. The new motherboard would have an integrated copy of the Nixie display and vu-meter circuitry. A footprint The Raspberry Pi, audio DAC, and amplifier would be on board as well. It would take 12V in, and the only off board connections would be the speakers and to the front panel buttons. Because all my peripherals used serial interfaces, the actual board design was actually pretty sparse, and most of the work was in routing the traces for the Nixie display in a way that maintained sufficient creepage.

UNIAC 2019 motherboard front view.

Taking a look at the front side of the motherboard (above), it’s primarily the cosmetic components. We see the six IN-12A tubes, eight INS-1 neon bulbs, two IN-13 tubes. Also of note are the unpopulated pads along the bottom for connecting the buttons directly to the RaspberryPi, which are unused in this build in favor of the i2c button board (described in the next section).

A Tour of the Motherboard

On the back side of the board, we can see a ton of components.

UNIAC 2019: Motherboard back view.

Next, in green with a raspberry symbol, is the main CPU, a RaspberryPi Zero W (hereafter RPi), which is the core of the system.

To the right of that is a rainbow ribbon cable going off to the button board.

Next, at the right is a TES-1364H boost module. This provides HV for the IN-13s. It is twinned with another -1364 at the top right, which provides HV for the numbers. I chose to keep the two supplies separate not because I was sure I was out of current, but because the two sets of tubes call for different striking voltages, and I didn’t feel like adjusting the values of the two display circuits to compensate. In a future revision, I’ll absolutely address that.

The group of components just right of center are the components for the IN-13 display, which are described in more detail in the IN-13 VUMeter posts, but the two DIP ICs are a quad op-amp and an ATTINY85.

The two tiny green three-pin boards are Mu-rata OKI-78SR modules. These are more efficient drop in replacements for the classic LM7805.

Directly above the RPi is a purple board. This is the i2s sound card using the PCM5102A ic.

Connected to the sound card is a blue Adafruit class-d amplifier board at the bottom left. It was chosen because it is relatively low-noise, has a mute pin, and can use an external pot for volume control — here you can see the wire for the pot running off to the knob on the side of the rear panel.

Finally at the top left is a Teensy 3.2, the CPU for the Nixie display module. This is gross overkill to drive a display, but it was convenient to code up quickly, and I was able to set it up as an i2c slave, simplifying communication with the RPi.

The Button Board

https://i.ebayimg.com/images/g/2KsAAOSwjwpc1GDi/s-l1600.jpg
Clicky momentary 12V buttons, sourced from eBay

For the control panel interface I chose some clicky 12V illuminated momentary buttons that were intended for industrial applications. Very satisfying. They were about $1.30 per each, so not cheap, however. Given that the buttons are the main user interface, having something that satisfies the retro vibe satisfactorily was worth it.

The 2015 version used a single GPIO pin on the raspberry pi for each button, and used a single GPIO (through a FET, obviously) to switch the lighting on them all on together. This, again, led to a tedious amount of manual wiring, so I designed a button board using a MCP23017 GPIO expander to connect to the buttons. The board itself is very simple, although I had the first boards manufactured by AllPCB, and they failed to route the slots, despite saying they’d confirm the slots with checkplots in an email discussion beforehand. This triggered my switch to PCBWay who correctly provided checkplots and produced the right board. I have been using them since, and who have treated me well — no they aren’t sponsoring me, I’m just pissed off enough at AllPCB to mention it, since they ignored my customer complaint that I filed after the fact.

The Battery Problem

Okay, it’s time for full disclosure, I’ve been calling this project portable, but throughout the build process I treated a battery as “something I would figure out later” — It turns out the BMSs are no joke, and there wasn’t much out there that would suit my needs. The fundamental problem is that there’s a large burst of current on power up, despite the fact that the overall system only draws a few hundred mA when fully up and running. I tried a few low cost boost converters and they all browned out before the system booted. As I wanted to share the portable UNIAC with my friends at PAX 2019, I ended up punting last minute and taping a 12V battery pack from Amazon to the back of the unit.

Music Playback

To play music, I am using the command line media player Mopidy and its Spotify plugin, Mopidy-Spotify. This requires a premium Spotify account to work, and is brittle. The API Mopidy-Spotify uses is not supported anymore. I’ve found that the repo fails to load my playlists unless I use the fork mentioned in this thread.

Getting the audio itself to work was also a massive pain, as the various Linux audio subsystems like to fight as is, and the I2S audio card I was using made things more difficult. I could go into more detail here, but I think it merits its own post…

So I wrote a full post about it!

Display Library

For the first version of the UNIAC with TES SmartNixie modules, I whipped up a quick python library to interface with them. It might come in handy for someone else, so I have published it here.

For the final version, I was using my own i2c display module, so I wrote a (nearly) drop-in replacement library for the SmartNixie library, so I could minimally modify the main UNIAC application to support the new display. It is published here.

It supports some fun features like dimming, cross-fading, blanking, and blinking.

The UNIAC Application

The main UNIAC application is a python script. The main loop probes the interface buttons and then calls a python god object, which maintains various states, drives the displays and voice, and sends audio commands to Mopidy. There’s a lot to this application, but that’s an entire post in and of itself. Until I get around to a full writeup for it, you can find it published here.

Conclusion

At the end of the project, UNIAC is probably the most satisfying hobby project I have yet made. Due to the brittle nature of the Mopidy-spotify, my next task is to move the Spotify interface to spotifyd, which I discovered due to reading Dino Fizotti’s excellent Diskplayer writeup. The other glaringly obvious improvement is adding a proper, internal battery system.

Longer term, I’d like to try to integrate it with a voice assistant to really supercharge interface, but that is more software work than I’m willing to take on in the immediate future.

The sad irony however, is that I’ve spent so long listening to the crappy buzzer of my Radio Shack alarm clock that I actually don’t want to give it up now. I’m conditioned to wake up to it quickly, and it takes up little space on my nightstand. Oh well. Maybe the next project will be a UNIAC Mini with an alarm buzzer feature.

I know this has been a long post. Thanks for sticking with me!

o/

The ‘Sidereal’ Clock

Note: This post is based on a word document I wrote and archived back when I finished this project in April of 2014.

Background

The Sidereal Clock is a simple thing. It tells you exactly how much daylight you have left. Once the sun sets, it goes negative and tells you how much nighttime remains. I realize it’s a misnomer, ‘sidereal time’ (http://en.wikipedia.org/wiki/Sidereal_time) would really describe a clock based around the movement of the fixed stars, but ‘daylight clock’ is a rather ambiguous and forgettable name.

The Sidereal Clock started from an idea. Well, someone else’s idea. My academic advisor saw a clock at an art installation (supposedly by James Campbell – http://www.jimcampbell.tv/portfolio/objects/untitled_for_the_sun/, although I haven’t seen it with my own eyes) that measured the percent of daylight remaining using a photo detector to determine when the last sunrise and sunset were. My advisor thought this was a really novel way of showing time, and I agreed. The implementation, however elegant, is rather impractical. It requires some reliable uninterrupted access to outdoor light, which suggests a ruggedized installation of a photo detector outdoors with a line leading inside to the display unit. Certainly impractical for many people, but really cool nonetheless.

Generation 1: Wired

My advisor, had an upcoming freshman class and some old 2.4” seven segment displays scrapped from a bowling alley.  He’d suggested a clock that would provide the same information, but which would show his freshman the cool stuff you could do with an Arduino. This meant the following requirements:

Figure 1: Wired Clock

  1. Automatic network time setting.
  2. Those bright displays, each with three 2.4” digits.
  3. A way to calculate sunrise and sunset.

What I came up with wasn’t much of a leap. I basically ganged together the displays, which were on boards with handy shift registers, grabbed and Ethernet Shield, and off I went!

I could of course get the time from NTP servers (there’s even an example that comes with the Ethernet Shield), and I found that the Navy offers a web page that would calculate the Sunrise and Sunset time for me. It’s actually pretty neat! All I had to do was scrape it for that data (check it out http://aa.usno.navy.mil/cgi-bin/aa_pap.pl). I wrote a tiny PHP script which I hosted on my own domain to act as an intermediary and then had my Arduino parse the text output and use it to set my clock. Bam!

I laser cut a relatively crude acrylic case in our campus shop and brought it to show the students. Overall, a decent outcome for a few evenings work, if I do say so myself.

Generation 2: Wireless

Unfortunately, my advisor didn’t particularly like the fact that it required an Ethernet cable (neither did I, to be honest), but I let it sit for a season, because it was providing good service on his wall and occasionally inspiring students. After about six months, the glue holding the front of the hastily assembled acrylic case gave out. I decided to use that as an excuse to improve the design. I managed to get a hold of the then brand new Adafruit CC3000 breakout (https://www.adafruit.com/products/1469) and see if it would do the trick for NTP. It worked like a charm (that CC3000 chip is really cool in my opinion, although I must disclaim having been a TI intern in the past – but not involved with the CC3000). The next trick was to free myself from web page parsing. After some more web spelunking, I found someone who had solved exactly this problem in C, and all that was required was to port it to my Arduino sketch. That original code can be found here (http://souptonuts.sourceforge.net/code/sunrise.c.html).

Figure 2: Wireless Clock Guts

Finally, I added a real time clock module based on the DS1307, which allowed me to virtually never synchronize with the internet. At this point, I modified the firmware so that it would only check NTP when the user

Figure 3: Wireless Clock

pressed a button on the top of the clock. The downside to all this was that the addition of the CC3000 libraries, combined with the DS1307, various time libraries, and lots of text in the serial interface used for setting parameters (like GPS coordinates) meant that there simply wasn’t enough program memory (EEPROM) on the 32k of an Arduino Uno, and I had to switch to a Mega2560. Still, all in all, a successful result, even if it is rather ugly on the inside.

I dutifully returned my Wi-Fi friendly clock to my advisor and it found a home on his wall, once again occasionally coming down to show students just how much cool stuff you could pack onto a measly Arduino.

Generation 3: Single Board

Thinking I was done with the project I nearly moved on, but the cool factor of the design kept bugging me. I wanted one for my own wall. After some searching, I actually found that Jameco (our beloved local bay-area parts supplier) carried the exact same, beautiful 2.4” tall seven segment LEDs (http://www.jameco.com/webapp/wcs/stores/servlet/Product_10001_10001_97199_-1) this opened the possibility of building a single board version of the clock. I started down the road of a full replication of my previous effort, including an integrated Mega2560, CC3000 and RTC. After getting said board half laid out, I came to a realization…wireless is a luxury, and I have no need for it in a design for me. Stripping out the wireless removed a lot of fat from the code. I could pull most of the serial interface as I didn’t need to set things like SSID and password, I could pull several large libraries, etc. It made it trivial to fall back to an Atmega328P (of Arduino Uno fame) as opposed to the more complex and expensive surface mount microcontroller used in the Mega2560.

The final result consisted of 6 LED Digits, three  TLC5925I’s (LED driver ICs), five buttons for input, a regulator, a DS1307 with a watch battery, an atmega328P and a handful of resistors and capacitors.

I pretty quickly stripped down the board to a much smaller (and less costly) bill of materials and produced a final version, containing an Atmega, with ICSP, a Real Time Clock, and LED drivers. Everything was easy, or so I thought. It turned out that I had foolishly rounded down in my measurement of the LED’s width when creating a footprint for Eagle CAD.  Unfortunately, this meant that while I could squeeze the LEDs into their footprint, the rounding errors added up across all six LEDs to a 0.1” overhang. Of course, this stress meant that the entire board ended up curved! It worked, but that’s not okay.

Figure 4: Bent Board

A quick fix revision (and $50 and several weeks of waiting) later and all was well!

Figure 5: Fixed board.

The Enclosure

Finally, the design needed a better enclosure.

Figure 6: Side View Of Enclosure

I’m going out of order here because I came up with this design as I laid out the board, but it fits better as its own section. As I mentioned, I had originally built an acrylic enclosure in the campus shop, designing the entire apparatus to hang from the back plate using either double stick tape or standoffs. This was a haphazard arrangement, and designing my own board opened up an opportunity to simplify things.

Figure 7: Back Of Enclosure

I discovered Ponoko (ponoko.com), which will laser cut from an SVG and mail directly to your door. Given that I had spent most of a day in the shop simply waiting for an opportunity to use the laser cutter (behind a long line of students who had never used it before and had come essentially unprepared to cut anything), I decided to give them a try. Despite the fact that they are listed as a New Zealand company, it turns out that their Acrylic shipped from a shop east of the San Francisco Bay, meaning that I would get my parts 24 hours after they shipped, even with the cheapest

Figure 8: Contrast issues without a diffuser

shipping rates. Combine that with the $50 annual fee to use the campus shop and the long delay, I decided to give them a try. I got a discounted rate and my first piece ended up being on the order of $20, which was stunning. I ended up cutting two pieces of acrylic and using #4 screws to create a PCB sandwich, with a hanging hole in the back of the clock.

Unfortunately, there was a downside to clear

Figure 7: Paper Diffuser

acrylic. Unlike the first LEDs, the new LEDs from Jameco have a black background (this is visible in the picture of the assembled board, to the right). This means that even the unlit LED segments have a fairly high contrast with their background. That lack of contrast makes the clock extremely difficult to read despite the display being absolutely huge. The first obvious solution was to use some thin paper as a diffuser, which works reasonably well, but it’s still not particularly pretty.

Figure 8: Finished Design

I decided to place a second order from Ponoko, of the same design, but in smoked gray acrylic. This design, diffuser omitted, came back absolutely beautiful and represents a nearly final design. The one last tiny change came from the realization that I could fit three clock enclosures on two sheets of acrylic if I shrank the height of the face by 0.1”.

The final BOM in quantity one is a little over $100, mostly due to the PCB, LEDs, and Acrylic, although I suspect in large quantities, it would be reduced to less than half that.

All in all, I’m really happy with how the entire clock came out and who knows, maybe at some point I’ll make a kit out of it or something, but for now, I intend to pass them out to friends and family as the occasional unique gift.