29
29
* a PC fan is wired up to a 12V power supply
31
* the fan's SENSE (tachiometer) pin connected to pin 2 on the
31
* the fan's SENSE (tachometer) pin connected to pin 2 on the
34
* the pins 4 to 13 on the arduino should directly drive an LED (the
34
* the pins 4 to 13 on the Arduino should directly drive an LED (the
35
35
LED on pin 4 is in the centre of the clock face and the LED on pin
36
36
13 is at the outside.
38
38
* if a longer hand (and a larger clock face) is desired, pin 4 can be
39
39
used to indirectly drive a transistor which in turn drives several
40
LEDs that turn on anf off in unison in the centre of the clock.
40
LEDs that turn on and off in unison in the centre of the clock.
42
42
* a button should be attached to pin 3 that grounds it when pressed.
44
* A DS1307 remote clock is connected via I2C on analog pins 4 and 5.
44
* A DS1307 remote clock is connected via I2C on analogue pins 4 and 5.
46
46
Implementation details:
50
50
* the timing of the drawing of the clock face is recalculated with
51
51
every rotation of the propeller.
53
* a PC fan actually sends 2 tachiometer pulses per revolution, so the
53
* a PC fan actually sends 2 tachometer pulses per revolution, so the
54
54
software skips every other one. This means that the clock may
55
55
appear upside-down if started with the propeller in the wrong
56
position. You will need to experiment to dicsover the position that
56
position. You will need to experiment to discover the position that
57
57
the propeller must be in when starting the clock.
59
59
Usage instructions:
76
76
******************************************************************************/
80
78
#include "config.h"
82
#include "mode_switcher.h"
82
#include "analogue_clock.h"
83
#include "digital_clock.h"
84
#include "test_pattern.h"
85
#include "settings_mode.h"
87
#include "text_renderer.h"
85
90
//_____________________________________________________________________________
89
93
// when non-zero, the time (in microseconds) of a new fan pulse that
90
94
// has just occurred, which means that segment drawing needs to be
92
static unsigned long new_pulse_at = 0;
96
static unsigned long _new_pulse_at = 0;
94
98
// the time (in microseconds) when the last fan pulse occurred
95
static unsigned long last_pulse_at = 0;
99
static unsigned long _last_pulse_at = 0;
97
101
// duration (in microseconds) that a segment should be displayed
98
static unsigned long segment_step = 0;
102
static unsigned long _segment_step = 0;
100
104
// remainder after divisor and a tally of the remainders for each segment
101
static unsigned long segment_step_sub_step = 0;
102
static unsigned long segment_step_sub = 0;
104
// flag to indicate that the drawing mode should be cycled to the next one
105
static bool inc_draw_mode = false;
107
// a bounce-managed button
108
static Button button( 3 );
105
static unsigned long _segment_step_sub_step = 0;
106
static unsigned long _segment_step_sub = 0;
109
static Button _button( 3 );
112
static int _major_mode = 0;
113
static int _minor_mode = 0;
115
#define MAIN_MODE_IDX 1
116
#define SETTINGS_MODE_IDX 0
118
#define ANALOGUE_CLOCK_IDX 0
119
#define DIGITAL_CLOCK_IDX 1
120
#define TEST_PATTERN_IDX 2
110
122
//_____________________________________________________________________________
114
// check for button presses
118
int event = button.update();
123
inc_draw_mode = true;
129
// turn an led on/off
130
void ledOn( int num, bool on )
132
if( num < 0 || num > 9 ) return;
134
// convert to pin no.
137
// pin 4 needs to be inverted (it's driving a PNP)
138
if( num == 4 ) on = !on;
140
digitalWrite( num, on? HIGH : LOW );
126
// activate the current minor mode
127
void activate_minor_mode()
129
switch( _minor_mode ) {
130
case ANALOGUE_CLOCK_IDX: analogue_clock_activate(); break;
131
case DIGITAL_CLOCK_IDX: digital_clock_activate(); break;
140
// activate major mode
141
void activate_major_mode()
143
switch( _major_mode ) {
144
case MAIN_MODE_IDX: activate_minor_mode(); break;
145
case SETTINGS_MODE_IDX: settings_mode_activate(); break;
154
// perform button events
155
void do_button_events()
157
// loop through pending events
158
while( int event = _button.get_event() )
164
switch( _major_mode ) {
166
switch( _minor_mode ) {
167
case ANALOGUE_CLOCK_IDX: analogue_clock_press(); break;
168
case DIGITAL_CLOCK_IDX: digital_clock_press(); break;
171
case SETTINGS_MODE_IDX: settings_mode_press(); break;
177
switch( _major_mode ) {
179
if( ++_minor_mode >= 3 )
181
activate_minor_mode();
183
case SETTINGS_MODE_IDX: settings_mode_long_press(); break;
188
// looooong press (change major mode)
189
if( ++_major_mode > 1 )
191
activate_major_mode();
144
198
// draw a display segment
145
void drawNextSegment( bool reset )
199
void draw_next_segment( bool reset )
147
static ModeSwitcher mode_switcher;
148
static bool init = false;
152
mode_switcher.activate();
155
201
// keep track of segment
156
202
#if CLOCK_FORWARD
157
203
static int segment = ( NUM_SEGMENTS - CLOCK_SHIFT ) % NUM_SEGMENTS;
161
207
if( reset ) segment = NUM_SEGMENTS - 1 - CLOCK_SHIFT;
210
// reset the text renderer
211
TextRenderer::reset_buffer();
215
switch( _major_mode ) {
217
switch( _minor_mode ) {
218
case ANALOGUE_CLOCK_IDX: analogue_clock_draw_reset(); break;
219
case DIGITAL_CLOCK_IDX: digital_clock_draw_reset(); break;
222
case SETTINGS_MODE_IDX: settings_mode_draw_reset(); break;
225
// tell the text services we're starting a new frame
165
Drawer &drawer = mode_switcher.get_drawer();
166
if( reset ) drawer.draw_reset();
167
drawer.draw( segment );
230
switch( _major_mode ) {
232
switch( _minor_mode ) {
233
case ANALOGUE_CLOCK_IDX: analogue_clock_draw( segment ); break;
234
case DIGITAL_CLOCK_IDX: digital_clock_draw( segment ); break;
235
case TEST_PATTERN_IDX: test_pattern_draw( segment ); break;
238
case SETTINGS_MODE_IDX: settings_mode_draw( segment ); break;
241
// draw any text that was rendered
242
TextRenderer::output_buffer();
169
244
#if CLOCK_FORWARD
170
245
if( ++segment >= NUM_SEGMENTS ) segment = 0;
177
252
// calculate time constants when a new pulse has occurred
178
void calculateSegmentTimes()
253
void calculate_segment_times()
180
255
// check for overflows, and only recalculate times if there isn't
181
256
// one (if there is, we'll just go with the last pulse's times)
182
if( new_pulse_at > last_pulse_at )
257
if( _new_pulse_at > _last_pulse_at )
184
259
// new segment stepping times
185
unsigned long delta = new_pulse_at - last_pulse_at;
186
segment_step = delta / NUM_SEGMENTS;
187
segment_step_sub = 0;
188
segment_step_sub_step = delta % NUM_SEGMENTS;
260
unsigned long delta = _new_pulse_at - _last_pulse_at;
261
_segment_step = delta / NUM_SEGMENTS;
262
_segment_step_sub = 0;
263
_segment_step_sub_step = delta % NUM_SEGMENTS;
191
266
// now we have dealt with this pulse, save the pulse time and
192
267
// clear new_pulse_at, ready for the next pulse
193
last_pulse_at = new_pulse_at;
268
_last_pulse_at = _new_pulse_at;
198
273
// wait until it is time to draw the next segment or a new pulse has
200
void waitTillNextSegment( bool reset )
275
void wait_till_end_of_segment( bool reset )
202
277
static unsigned long end_time = 0;
206
end_time = last_pulse_at;
281
end_time = _last_pulse_at;
208
283
// work out the time that this segment should be displayed until
209
end_time += segment_step;
210
segment_step_sub += segment_step_sub_step;
211
if( segment_step_sub >= NUM_SEGMENTS ) {
212
segment_step_sub -= NUM_SEGMENTS;
284
end_time += _segment_step;
285
_segment_step_sub += _segment_step_sub_step;
286
if( _segment_step_sub >= NUM_SEGMENTS ) {
287
_segment_step_sub -= NUM_SEGMENTS;
217
while( micros() < end_time && !new_pulse_at );
292
while( micros() < end_time && !_new_pulse_at );
221
296
// ISR to handle the pulses from the fan's tachiometer
222
void fanPulseHandler()
297
void fan_pulse_handler()
224
299
// the fan actually sends two pulses per revolution. These pulses
225
300
// may not be exactly evenly distributed around the rotation, so
264
341
// if there has been a new pulse, we'll be resetting the display
265
bool reset = new_pulse_at? true : false;
342
bool reset = _new_pulse_at? true : false;
267
347
// only do this stuff at the start of a display cycle, to ensure
268
348
// that no state changes mid-display
351
// calculate segment times
352
calculate_segment_times();
274
354
// keep track of time
275
Time &time = Time::get_instance();
357
// perform button events
279
361
// draw this segment
280
drawNextSegment( reset );
282
// do we need to recalculate segment times?
284
calculateSegmentTimes();
362
draw_next_segment( reset );
286
364
// wait till it's time to draw the next segment
287
waitTillNextSegment( reset );
365
wait_till_end_of_segment( reset );